AIP Logic 快速入门

本指南演示如何访问 AIP Logic，介绍 AIP Logic 界面，并说明如何通过组合 LLM block 并在 Debugger 中查看 LLM 的思维链（chain of thought，CoT）来搭建一个基本的 Logic 函数。

可以从平台的工作区导航栏访问 AIP Logic，也可以使用快速搜索快捷键 CMD + J（macOS）或 CTRL + J（Windows）。或者，你可以在 Files 中通过选择 +New 然后选择 AIP Logic 来新建一个 Logic 函数，如下所示。

打开 AIP Logic 后，你可以创建一个新的 Logic 文件，该文件必须保存在项目文件夹中，而不是你的主文件夹中。

AIP Logic 的界面有三个主要组成部分，在下面的示意截图中按从左到右的顺序编号：

1. 输入、block 和输出配置
2. Debugger
3. 运行面板

一个典型的 AIP Logic 工作流从在左侧面板（1）中配置输入（A）、block（B）和输出（C）开始。使用运行面板（3）生成一个示例输出。Logic 运行后，Debugger（2）会显示 LLM 为生成该输出所使用的思维链（CoT）提示和步骤。将 Debugger 与运行面板配合使用即可可视化最终输出。运行面板还会显示最近的 Logic 运行记录，并允许你创建单元测试。右侧边栏提供了与 Automate 和 AIP Evals 的集成。

当你初次开始使用 AIP 时，会看到右侧的 Run 面板，以及左侧的三种 board：输入（inputs），用于可选地选择某个对象及其属性；block，用于定义你的 Logic 指令；以及输出（outputs），表示期望的 Logic 函数结果。一个 block 的输出可以馈入后续 block。

下面的截图展示了在 Run 面板折叠状态下的输入、block 和输出配置区域。

AIP Logic 接受多种输入。在 Inputs block 中（在应用界面指南中标记为「A」），你可以指定输入的名称和类型。支持的输入包括 array、boolean、date、double、float、integer、long、media reference、model、object、object list、object set、short、string、struct 和 timestamp。要在 Use LLM block 中引用某个输入，参见 Prompts。

一个 AIP Logic 函数由多个 block 组成（在应用界面指南中标记为「B」）。Block 类型包括创建变量（create variable）、应用 action（apply action）、执行函数（execute function）、使用 LLM（use LLM）、循环（loops）和条件（conditionals）。一个 block 的输出可以在后续 block 中使用。更多信息请参见 Blocks。

你可以为每个 Logic block 定义中间输出。Logic 路径中的最后一个 block 就是该 Logic 函数的输出，在应用界面指南中标记为「C」。

• Block 输出： 在 block 之间传递的中间输出。你的 block 的输出可以是基本类型，也可以是供后续 block 使用的对象。

• Logic 函数输出： 你想要返回的 Logic 函数的输出。它可以是某个值（基本类型或对象），也可以是你函数所做的全部 Ontology 编辑。

编写完 Logic 函数后，你可以通过选择视图右侧的 Run 来测试该 Logic 函数。Logic 运行后，Debugger 将打开并显示 LLM 的思维链（CoT）。

Debugger 允许你展开和折叠 block 卡片、清空工具调用，并轻松查看生成的 prompt，从而更易于理解思维链。

在 Run 面板中，你可以运行和评估你的 Logic，并查看最近的运行记录。右侧边栏让你可以设置单元测试、运行自动化，以及查看运行历史。

在 Run 面板底部，你还可以选择任一最近的运行记录来查看其输出和调试日志。

选择单元测试图标（<img src="./media/unit-tests-icon.png" alt="单元测试图标。" width="30">）即可保存一份你的输入的版本，用于性能评估。

要编辑测试用例的参数名称、类型和可选性，请选择 Modify columns。在 schema 编辑器中添加参数。

在 Run history 中，选择 Add as test case 即可将历史执行结果转换为新评估套件或现有评估套件的测试用例。

Evaluate your Logic with AIP Evals

要为你的 Logic 函数生成评估套件，请打开右侧边栏中的 Evals 标签页，并选择 Generate evals。AIP Evals 会根据你的函数创建测试用例、配置评估器并设置指标。你可以编辑生成的测试用例和评估器，以细化覆盖范围和评分。更多信息请参见 AIP Evals：快速入门。

Logic 函数的使用方式与你在平台中使用常规的对象函数（function on objects，FoO）相同。

• 你可以用 Logic 函数来支撑一个 action，然后从 Workshop 调用该 action。

• 你还可以调用 Logic 函数来支撑 Workshop 中的 Markdown widget；在这种情况下，Logic 函数的输出类型必须是字符串。

• 你可以通过 AIP Logic 中的 Ontology function 工具，在其他 Logic 函数中以及对象函数中调用 Logic 函数。

Running a Logic function via the command line

在 Uses 标签页中，你可以复制一条 curl 请求，以便在终端中于 Foundry 之外运行该 logic。请注意，此功能不适用于会返回 ontology 编辑的 Logic。

在 Logic 中运行该函数时，你会在 Debugger 中看到你的 scenario 中的所有拟议 Ontology 编辑。这些编辑实际上不会被执行。如果你希望将编辑应用到 Ontology，可以采取以下任一方式：

• 从某个 action 中调用你的 Logic 函数；或，
• 从某个自动化中调用你的 Logic 函数。你可以使用位于右侧的 Automations <img src="./media/automate-icon.png" alt="Automate 图标" width="30"> 选项，从你的 Logic 仪表盘开始创建新的自动化。

要让 Logic 函数能够编辑 Ontology，你必须：

1. 在 Logic 函数可以调用的 Use LLM block 中设置一个 Apply actions 工具。这允许 LLM 编辑 Ontology。

1. 当你完成 Logic 函数的迭代后，找到并选择位于保存旁边的 Publish 选项来发布该 Logic 函数。

1. 接下来，创建一个由你刚刚发布的 Logic function 支撑的新 action。

1. 现在你就可以在 Workshop 模块中使用这个新 action 来驱动一个业务工作流。 <img src="./media/use-action-in-workshop.png" alt="Workshop 配置面板，下拉菜单中已选定 Flight Change action。" width="400">

使用 Foundry branching 可以隔离地开发和测试 Logic 函数。你可以发布它们，以便在 Workshop 等支持分支的应用中使用，并通过审批提案来合并更改。更多信息请参见对 AIP Logic 使用分支。

在版本历史标签页中，你可以比较一个 logic 的两个版本，查看它们之间的变化，具体包括哪些 block 被编辑、添加或移除。

如果你有 AIP Logic 的访问权限，我们建议你开始尝试用 LLM block 与你的 Ontology 交互，并构建你自己的用例。你可能会发现，查阅平台中关于函数（Functions）的文档会有所帮助。