UiPath Documentation
maestro
latest
false
Maestro 用户指南
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。

对话式智能体

对话智能体节点在聊天对话中运行 LLM 驱动的轮次,遍历推理和工具调用并将其流式传输到聊天中。

操作​

运行您在画布中创作的对话 AI 智能体的单轮。您可以配置模型、说明和工具,然后传递从“等待消息”节点发出的对话上下文(包括聊天历史记录)。智能体执行推理和工具调用的循环,并将其流式传输到聊天中。

备注:

智能体只能在用户启动的交换中进行回复,这意味着用户必须先发送消息,然后对话代理节点才能运行。尚不支持流启动的交互,即在没有事先轮询用户的情况下发送消息。

何时使用此选项​

情况使用
您需要由 LLM 驱动的流式对话响应,并可能调用工具。对话式智能体
您需要在对话中获得确定的回复(非 LLM)。发送消息
您需要由 LLM 驱动的执行,且可进行工具调用,但不会流式传输到对话。自主式智能体
备注:

由于对话智能体节点会自动流式传输其响应并将其附加到聊天记录中,因此您无需使用“发送消息”来发出智能体对对话的响应。

请访问构建聊天智能体工作流,获取将对话智能体节点与其他聊天节点结合使用的分步示例。

添加智能体​

添加节点,然后在属性面板中对其进行配置。

  1. 选择输出句柄上的+按钮,或从底部工具栏中打开节点面板。
  2. 选择“智能体”类别,然后选择“对话智能体” 。Flow 会添加节点并打开其属性面板。
  3. 配置模型、系统提示和对话上下文绑定,如下所述。

结果: “对话智能体”节点将添加到画布中,且其属性面板处于打开状态,可供配置。

配置参考​

字段必填默认描述
模型否组织默认智能体模型智能体使用的大型语言模型 (LLM)。从选取器中选择一个模型,该选取器列出了您组织可用的模型。
系统提示是无智能体的角色和长期指令:它是谁以及它应该如何表现。适用于每一轮对话,因此请编写持久的指导原则 — 例如角色、语气、目标以及何时调用工具。
温度否0采样随机性,从0到1 。值越低,响应的确定性越高;值越高,响应就越多样化或更具创意。
每个响应的最大令牌数量否8192每轮内每个模型响应的最大长度。上限取决于所选模型。
对话上下文是无上游的“等待消息”中的对话上下文对象 — 包含聊天历史记录,例如$vars.waitForMessage1.output.conversationContext

输出变量​

除了智能体的对话响应外,您还可以选择在属性面板的输出部分中配置结构化输出变量。

用户在聊天中看不到这些输出 — 相反,它们可用于设置面向目标的变量或路由变量,以在流中的下游节点中使用。

您声明的每个输出变量都将成为智能体 output 对象上的一个字段,以 $vars.<agentName>.output.<name> 的形式引用。为每个变量指定名称和类型,然后在变量的“描述”字段中指示智能体如何填充。

重要提示:

智能体的对话响应仅由其系统提示词驱动,而智能体输出的生成则由其系统提示词和输出变量描述共同驱动。为确保智能体不会将结构化输出数据发送到聊天中,请使用系统提示告诉智能体如何在聊天中回复,同时使用输出描述来指示智能体如何填写输出。

例如:

系统提示词:“感谢用户结束对话。”

输出变量:endConversation(布尔值)。说明:“当用户打算结束对话时设置为 true。”

根据结果创建分支​

通过“决策”或“切换”关注智能体,以在结构化输出字段上路由。例如:

Wait for Message → Conversational Agent (supervisor) → Switch on $vars.agent.output.intent
  → 'intent-a':  Route to a loop with specialist conversational agent A
  → 'intent-b':  Route to a loop with specialist conversational agent B
  → 'off-topic': Send Message ("Message is off-topic") → back to first Wait for Message.
Wait for Message → Conversational Agent (supervisor) → Switch on $vars.agent.output.intent
  → 'intent-a':  Route to a loop with specialist conversational agent A
  → 'intent-b':  Route to a loop with specialist conversational agent B
  → 'off-topic': Send Message ("Message is off-topic") → back to first Wait for Message.

资源​

对话智能体与您连接到其句柄的资源节点组成。节点具有三个资源句柄,每个句柄在画布中都有自己的标签:工具、上下文和升级。将资源连接到句柄,然后在该资源自己的属性面板中配置该资源。资源随流移动。

每个句柄仅接受其匹配的资源类型。画布会阻止无法容纳的连接,因此您无法将工具连接到上下文句柄。

工具​

将工具连接到工具句柄,为智能体提供在推理时可以调用的功能。智能体在其循环中决定是否以及何时调用每个已连接的工具。每个工具都带有描述,告诉智能体该工具的用途,因此请在工具公开时编写清晰的描述。

您可以连接的工具类型包括:

  • 内置工具,三个现成的工具,如下所述。
  • 连接器工具,使智能体可以调用 Integration Service 操作,例如发送电子邮件或在下游系统中创建记录。
  • RPA 工作流和API 函数工具,使智能体可以将已发布的 RPA 流程或 API 工作流作为工具调用。
  • 模型上下文协议 (MCP) 服务器工具,公开在 MCP 服务器上发布的工具。

内置工具​

Flow 附带三个内置工具。每个都是独立的资源,您可以连接到工具句柄,并在其自己的面板中进行配置。

  • 分析文件:使用 LLM 分析一个或多个文件,以提取、合成或回答有关其内容的问题。描述智能体将传递的文件以及要对这些文件运行的分析任务。
  • 批量转换:逐行处理和转换 CSV 文件。提供源文件,描述每行的任务,并定义该工具添加的输出列。您可以为转换启用或禁用网页搜索锚定。
  • 汇总:生成带有引文的跨文档合成(最多 1,000 页)。提供来源,描述要合成的内容,然后选择文件扩展名。当来源是 PDF 时,您可以打开或关闭引文。
MCP 服务器工具​

连接模型上下文协议 (MCP) 服务器,以将其工具公开给智能体。从服务器中选择一个或多个工具时,会在工具选取器下方添加一个“工具配置”部分,每个工具都有一个可展开面板。在该面板中,您可以编辑每个参数的描述,查看工具的完整输入和输出架构,并选择参数获取其值的方式:由智能体在运行时决定;将值绑定到作用域内的智能体变量;或者将值绑定已修复(也可以选择将其标记为敏感)。

MCP 服务器的工具列表可以来自两种发现模式:

  • 已缓存: 连接服务器后生成服务器工具的快照。使用服务器上的“刷新”工具按需拉取更新的快照。
    • 默认情况下,工具配置面板中的“调用前刷新架构”切换开关会在每次调用前重新检查服务器中的工具当前架构,因此,无需再更改服务器上的架构(例如,重命名或添加参数)。手动刷新。禁用后,该工具将始终使用上一个快照中的架构。
  • 动态:每次调用时在 Runtime 发现工具,包括在配置节点后添加到服务器的工具。

对于远程 MCP 服务器,刷新会轮询服务器的发现端点,以获取异步完成情况。对于平台 MCP 服务器(UiPath 原生服务,例如 Document Understanding),工具列表将来自 UiPath Platform 服务目录。

如果尚未连接 MCP 服务器,请从节点面板的 MCP 服务器条目中添加一个。“新建”选项组按子类型创建服务器 — Platform 、 Remote 、 Command 、 Coded和UiPath 。选择“平台”将打开一个对话框,用于在当前解决方案中(前提是您的环境支持)创建服务器;其他子类型会在 Orchestrator 中打开相应的创建页面。有关更多详细信息,请参阅关于 MCP 服务器。

备注:

内联对话智能体节点尚不支持个人连接、客户端工具或工具调用确认。要使用这些连接,请在 Agent Builder 中构建智能体,并将其作为节点导入您的流中。

Context​

将上下文资源连接到上下文句柄,使智能体基于您的数据。智能体在推理时会利用这些基础数据,而不是仅依赖模型。上下文资源指向组织中的上下文索引。

配置智能体从索引中检索的方式,包括检索模式(语义、结构化、DeepRAG 或批量转换)、查询、要返回的结果数量、相关性阈值以及是否包含引文。要创建新的上下文索引,请使用句柄的“添加”面板上的“新建上下文”操作,该操作将在新选项卡中打开索引创建内容。

升级​

连接升级句柄,以便在智能体遇到不应该单独决策的案例时路由到人员。智能体暂停,人工处理升级,智能体得出结果继续。您可以附加以下两个升级资源中的任何一个:

  • 升级: 路由到 Action 应用任务。配置操作应用程序、收件人、通知、传递给应用程序的输入以及应用程序的结果如何映射回智能体。
  • Action 应用升级:路由到编码 Action 应用程序,具有相同的收件人、通知、输入和结果映射配置。

两个升级资源的配置方式相同。当您的升级目标是编码操作应用程序而不是标准操作应用程序时,请选择操作应用程序升级。

重要提示:

来自对话智能体的升级会阻止对话轮回,即用户在聊天界面上等待人工操作。对于长时间运行的审批或交接(其中对话应继续进行),请改为从 并行分支 运行 人工 节点,以便在后台审批的同时聊天可以继续。

常见问题​

系统会先显示输入验证错误,然后您才能进行调试。模型、系统提示词和对话上下文都是必需的。在每个设置完成之前,节点会报告验证错误。

在智能体触发升级后,聊天会长时间阻塞。直接与智能体关联的升级会暂停整个轮次,直到人工采取行动。对于长时间运行的审批,请将人工步骤移至与对话一起运行的并行人工节点分支中。

连接的批量转换工具报告验证错误。批量转换需要至少一个输出列。定义工具在调试流程之前应添加的列。

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新