用例开发WorkshopAIP widgetsAIP互动

注意:以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。

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 Agent提供了较传统模式更多的优势,包括在AIP Agent Studio中的配置用户界面、版本控制、指标、会话历史记录、下载等。传统模式将不再包含任何新功能,因此我们强烈建议迁移到AIP Agent。为了使这一过程尽可能简单,我们在微件的传统模式中添加了一个迁移选项。传统模式将很快进入淘汰阶段,所有用户应尽快迁移。

在传统模式中,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 PlaysPlaybook 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互动微件时,我们建议考虑以下事项:

  • 从特定、受限的上下文开始,以确保更可靠的结果。
  • LLM是随机的;利用Workshop的可扩展性克服LLM的限制,为用户提供与其应用程序有效互动的备选方案。例如,您可以在筛选药丸微件中显示LLM的输出查询。
  • 对您的AIP互动开发过程保持意图明确;在使用微件之前,绘制出LLM互动的路径和模式。

注意:AIP功能的可用性可能会更改,并且可能因客户而异。