把命令用作工具

你可以将 commands（命令）添加为聊天机器人的 tools，使聊天机器人能够代表用户在 Palantir 应用程序中进行交互和操作。commands 直接在用户所在的应用程序中运行，使其能够访问当前应用程序的状态和屏幕。这使得传统后端工具难以支持的集成成为可能。例如，聊天机器人可以使用 commands 来导航用户界面，比如将视图设置到地图上的特定位置。

一旦某个应用程序声明并生成某个 command，聊天机器人就可以将其作为工具使用。要将 commands 作为工具添加到聊天机器人，请在 Chatbot configuration 面板中选择 Add tool > Commands。

在 Search commands... 模态框中搜索并选择一个或多个 commands。如果你需要为该 command 的每个实例配置不同的提示词，可以多次选择同一个 command。将选中的 commands 添加到聊天机器人，并按需应用配置。

在将一个或多个 commands 作为工具添加到聊天机器人后，你可以选择一个 command，打开一个模态框，其中包含聊天机器人用来指导其行为的附加配置。选择 Show more 以显示更多文档，帮助你进一步了解每个工具的可选配置项，例如其输入参数和被调用时的预期行为。

请查看以下各节，以进一步了解其他配置选项。

Additional descriptions

在默认提供的文档之外，提供 command 专属的上下文，以帮助聊天机器人的底层模型理解它将执行的操作。虽然每个 command 都包含帮助聊天机器人将其用作工具的默认文档，但你可以在 Additional documentation 中提供更多细节，帮助聊天机器人准确判断何时以及如何调用该工具。例如，你可以指示 Remove all features command 在绘制新图形之前移除临时图形，前提是现有图形与新的图形以某种方式不相关。

Input parameters

某些 commands 在你将其配置为工具时可以接受输入参数。使用 Input parameters 为 command 参数设置输入值，例如为 Draw polygon command 设置 Fill pattern 或 Stroke width。

默认情况下，聊天机器人会根据你的 Instructions 和用户提示词来确定所有必填参数的值。对于可选参数，聊天机器人可以选择性地根据你的 Instructions 和用户提示词来确定其值。

若要覆盖默认行为，请选择 Add parameter override，选择你要覆盖的参数，并使用以下覆盖选项之一进行配置：

• Chatbot decides（默认）： 由聊天机器人确定该值。这是默认行为。
• Preset values： 硬编码一个静态值，以一致地将相同值用作输入参数。
• Application variable： 使用预先配置的字符串或对象集变量。
• Don't pass the parameter to chatbot： 指示聊天机器人不要为某个可选参数提供值。此选项仅适用于可选参数。

Asks for user approval before execution

默认启用时，在你从提示词执行 command 之前，聊天机器人会要求用户查看 command 的载荷数据，并 Reject（拒绝）或 Approve（批准）该 command 的操作或输出。禁用时，聊天机器人将根据用户提示词直接执行 commands，无需人工批准干预。

在 AIP Chatbot Studio 中配置好 commands 之后，你可以按照以下说明测试聊天机器人并验证其配置，然后再保存并发布，使其在生产应用程序中可用：

1. 在另一个浏览器窗口中，打开生成你的聊天机器人 command 工具的那个应用程序，并将其与包含 AIP Chatbot Studio 中聊天机器人的窗口并排摆放。
2. 对于在另一个浏览器窗口中启动的应用程序（例如 Gaia 地图），选择 Choose an app to pair with... > Pair。

1. 在聊天机器人的聊天输入窗口中输入提示词，以测试其使用你添加为工具的 commands 的能力。

一旦你对聊天机器人的配置感到满意，即可发布该聊天机器人，使其可作为嵌入在 AIP Assist 中的助手使用，或通过 Workshop 在 AIP Chatbot widget 中使用。

通过 App Pairing，你的聊天机器人会自动发现你在浏览器中打开的其他应用程序。若要将聊天机器人与多个应用程序实例配对，请在 Discovered 应用程序旁选择 Add，以创建一个配对 Group。

如果你的聊天机器人未与某个应用程序配对以执行 command，它将提示用户选择一个要配对的应用程序。

虽然你可以使用 AIP Chatbot Studio 配合已配对的应用程序来测试聊天机器人的表现，但为了获得更流畅的用户体验，你应将聊天机器人嵌入到 Workshop 模块或 AIP Assist 面板中。在这两种情况下，聊天机器人都会自动与其交互的应用程序配对。

Publish your chatbot to AIP Assist

若要让你的聊天机器人可在 AIP Assist 中访问，请在 AIP Chatbot Studio 中选择屏幕左侧的火箭图标以打开 Usage 面板，然后选择 AIP Assist 开关。接着，选择屏幕右上角的 Publish。这会将最新发布的聊天机器人版本部署到 AIP Assist，之后你就可以在 AIP Assist 聊天面板的 Chat with an AIP Chatbot 菜单中选择它。

选择聊天机器人后，AIP Assist 会自动与目标应用程序配对，所有配置为工具的相关 commands 都会以该应用程序为目标。如果你的聊天机器人包含面向多个应用程序的工具，但未与这些应用程序配对，那么 AIP Assist 会提示你在已打开的浏览器标签页中选择一个要配对的应用程序。

Add your chatbot to Workshop

使用 Workshop 的 AIP Chatbot widget 将你的聊天机器人嵌入到模块中，你还可以在其中使用 Iframe widget，将一个或多个应用程序嵌入到与 AIP Chatbot widget 相邻的区域（sections）中。Workshop 模块中的 AIP Chatbot widget 与被 iframe 嵌入的应用程序会自动配对，你配置为工具的所有相关 commands 都会以该被 iframe 嵌入的应用程序为目标。