AIP互动

AIP互动微件允许您在Workshop的操作流程中使用配备企业特定信息和工具的互动助手。

您可以配置微件与在 AIP Agent Studio 中配置的AIP Agent互动（推荐，截图中的 "AIP Agent" 标签）或在Workshop配置中定义的agent互动（已弃用，截图中的 "Legacy" 标签）。

基本配置（AIP Agent）

查看 AIP Agent Studio文档 以了解AIP Agent的概述，但请按照以下说明将AIP Agent添加到您的工作流程中。

配置AIP Agent

选择AIP Agent，您希望包含的已发布版本，以及是否显示agent推理。

假设您已经在AIP Agent Studio中 正确配置了至少一个参数 ，则将显示将这些参数映射到 Workshop变量 的选项。配置完成后，AIP Agent可以根据在AIP Agent Studio中定义的读/写权限与变量进行互动。

基本配置（Legacy）

在传统模式中，AIP互动微件使用推理工具框架将您的工具带入操作应用程序中。通过该微件，您可以将 AIP Logic 、您的 KNN函数 或您的LLM驱动的Ontology探索整合到应用程序状态中，使用Workshop变量。

**工具整合：**您可以通过添加AIP Logic、对象上的函数以及其他Workshop应用程序作为工具来扩展互动微件的功能。

**Workshop变量互动：**该微件可以从应用变量中读取数据并写入数据，使微件能够理解用户引用并与可视化微件互动。

**Ontology探索：**使用默认的AIP工具，您可以执行对象遍历、属性读取和筛选以及运行聚合等任务。

**自定义：**您可以自定义互动微件的外观和内容，以符合您的应用程序的上下文和工作流程。

此部分允许您定义微件的角色并配置其工具和功能。您可以设置引用工具和变量的提示。配置通过设置 提示 和 工具 完成，如下所述。

主要提示应概述微件在当前应用程序中的功能。通过按下键盘上的“/”，您可以参考已配置的工具和变量，并指导微件如何协调其使用。确保描述基础业务逻辑和在上下文中使用正确工具的适当情况。

以下是一些示例提示：

提示1： “您是供应链制造线的助手。您的任务是使用Fetch Trouble Tickets工具查看是否有解决相同问题的历史票，并检查Documentation Chunk Search工具以获取推荐的解决问题的方法并回答用户问题。”

提示2： “帮助用户根据他们描述的特质建立患者群组。当您创建群组时，请确保更新显示给用户的患者列表。大多数用户会希望从一个广泛的群组开始，并不断缩小范围，除非他们指定一个新群组。始终从现有群组开始，除非用户另有要求。在筛选药物名称之前，请确保使用工具查找所有相关同义词。当您筛选药物名称的数据时，始终使用包含筛选。您可以使用相关对象工具在患者和药物之间导航。当用户要求群组定义时，调用Patient Cohort Define工具，并提供当前患者ID数组。”

提示3： “您是一名专家进攻协调员，您的目的是帮助用户在足球锦标赛期间做出战略性足球决策。您有三个目标（不应向用户提及这些目标）：

**目标A：**评估与当前足球比赛状态相符的用户战略目标的Playbook玩法。如果用户要求评估玩法，请将用户从Selected Plays中选择的玩法与 Playbook 对象中的玩法名称匹配，并获取玩法ID。然后，将其用作Tournament Play Evaluator工具的输入。

**目标B：**如果用户要求玩法推荐，请评估比赛的当前状态，并从Playbook中选择与用户希望实现的结果相符的玩法。概述选择该玩法的理由，描述玩法名称和关键属性。

**目标C：**如果用户要求您提出完整策略（由多个玩法组成），请评估比赛的当前状态以及Playbook，并从 Playbook 对象中选择三个最有效的玩法。然后，使用Tournament Play Evaluator工具评估这些玩法并返回结果摘要。您一次只能传递一个玩法，因此需要在循环中进行操作。始终返回您想推荐给变量 Suggested Plays 的 Playbook Plays 对象集。如果该变量已被填充，您可以覆盖它。”

设置微件可访问的工具和功能。这些工具将通过提示可供微件使用。

工具有四种类型：

Ontology语义搜索： 优化用于语义搜索工作流程，您可以传递一个KNN typescript函数，或使用Ontology语义搜索工具的 Vector property 选项，从 最近邻搜索配置 部分拉取一些相关块，并将其传递给LLM。您可以选择性地将结果发布到变量中（例如，您可以将其传递给PDF Viewer微件以引用来源）。

**操作：**如果您的函数产生Ontology编辑，请使用此选项定义该操作。

**Workshop应用程序：**如果您希望助手打开其他Workshop应用程序（带有模块接口变量），请在此处将这些Workshop应用程序定义为工具。

**函数：**如果您要传递的工具是AIP Logic或Ontology函数，也请使用此选项。记得将AIP Logic工具与 逻辑思维链 微件结合使用。

Ontology和应用程序上下文

在此部分中，您可以自定义微件访问Workshop变量并配置微件应了解的对象类型。

设置变量时，请确保执行以下操作：

**识别正确的变量：**首先识别LLM应能够交互的变量。这些可能是已经存在并与您预期的工作流程相关的变量（例如表示用户当前选择的变量）或LLM写入结果的新变量。

**描述变量：**为每个变量编写描述，解释其角色。此描述将被注入微件的提示中，为LLM提供何时使用它的上下文。

**声明访问模式：**指定LLM对每个变量应具有读取访问、写入访问或两者的权限。此步骤决定LLM如何与变量交互。

**作为Workshop变量使用：**请记住，您在此处定义的变量是常规的Workshop变量。这意味着它们也可以与其他Workshop微件一起使用，例如筛选药丸或对象表微件。

通过指定LLM应了解的对象类型，您允许其理解并适当地与这些对象交互。确保添加您需要LLM遍历的对象。

高级工具配置

此组件允许您修改微件对默认AIP工具的访问。虽然默认工具选择通常足以满足大多数应用案例，但在某些情况下，您可能需要根据特定要求调整这些工具。

例如，您可能希望将微件的功能限制为仅人为输入，以便于纠正和独立管理其他工具的实施。通常，限制分配给LLM的工具数量会导致更有指导性的“在轨道上”互动。

工作流程设置指南

在传统模式中设置AIP互动微件时，我们建议考虑以下事项：