Designing the agent

在 Studio Web 中为对话智能体配置行为、功能和企业系统集成。

This page covers the design-time configuration options for conversational agents in Studio Web's Agent Builder. Use these settings to define your agent's behavior, capabilities, and integration with enterprise systems.

Creating a conversational agent in Agent Builder

1. 转到 studio.uipath.com。
2. 选择“新建”，然后选择“智能体”。
3. 选择“对话”。
4. 向 Autopilot 描述您的智能体，以生成入门配置，或选择“从头开始”。

系统提示

系统提示词是智能体行为的基础。它定义了智能体的角色、目标、约束以及不同场景的处理说明。

要包含的信息

全面的系统提示词应涵盖：

• 身份和角色：使用的是哪个智能体？应使用什么语气？
• 作用域和边界：智能体应处理哪些主题？应拒绝哪些主题？
• 工具使用指南：智能体应在何时使用特定工具？
• 升级条件：智能体应何时将对话移交给人类？
• 响应格式：智能体应如何组织其响应的结构？

系统提示词示例

您是 Contoso Corporation 的 HR Assistant。您的角色是帮助员工回答有关公司政策、福利和 HR 相关程序的问题。

准则

• 沟通保持专业、友好且言简意赅
• 在回答政策相关问题之前，务必先搜索知识库
• 凡提及公司政策，均需注明具体的参考文档来源
• 如果找不到答案，请主动建议转交给 HR 专员

注意事项

• 请勿讨论员工个人的绩效或薪酬情况
• 请勿对政策的例外情况作出承诺
• 将法律相关问题转交到法务部门

使用 Autopilot 生成提示词

Autopilot 可以帮助您创建有效的系统提示词：

1. 在系统提示词部分中，使用自然语言描述您的用例。
2. Autopilot 根据您的描述生成结构化提示词。
3. 审核并优化生成的提示词，以匹配您的特定要求。

提示：

从 Autopilot 生成的提示词开始，根据测试结果进行迭代。调试聊天能够帮助您识别提示词中需要弥补的空白。

使用智能体分数

智能体分数会分析智能体的配置，并提供改进建议。分数会评估：

• 系统提示词质量：清晰度、完整性、一致性、思维链和演示。
• 工具配置：数量、上下文清晰度和完整性。

要查看智能体的分数：

1. 在智能体设计器中，找到“打开运行状况分数”指示器。
2. 选择即可查看详细建议。
3. 应用建议，以提高智能体的有效性。

有关详细信息，请参阅“智能体分数”。

模型选择

对话智能体支持多个大语言模型 (LLM)。根据您对功能、延迟和成本的要求选择模型。

有关选择正确模型的指导，请参阅“为您的智能体选择最佳模型”。

备注：

对话智能体可与 UiPath 托管模型配合使用，并支持 LLM 配置，以便您使用自己的 LLM 订阅。

输入

输入是在数据管理器的对话智能体上定义的命名变量，可以模板化到系统提示词和工具调用参数中。当调用界面希望在每轮都传递额外的上下文给智能体时（超出对话历史记录中的上下文），请使用输入。

重要提示：

对话历史记录（用户消息、智能体消息和过去的工具调用结果）已在每次执行时隐式传递给智能体。只能为智能体无法从对话本身中派生的其他上下文定义输入。从不使用自定义输入开始，并在特定用例需要时引入。

表面如何公开输入

对话界面可以在开始对话时设置初始输入值，也可以在对话过程中的任何时间更新这些值。

• 实例管理和iFrame 嵌入等预构建界面提供了一个表单，用户可以在对话之前或对话期间填写输入值。
• UiPath TypeScript SDK可让您直接控制在自定义表面上设置输入值的方式。例如，您可以将输入连接到网页用户界面状态（或任何其他客户端状态），以便智能体每次都自动收到最新的表面上下文。

工具

工具让智能体的功能不再局限于对话。对话智能体支持与自主智能体相同的工具。

支持的工具类型

工具类型	描述	Use case
上下文基础	搜索知识库索引	基于 RAG 的文档问答
分析文件	使用 LLM 处理上传的文件	文档分析、表单提取
Integration Service 活动	预构建的外部系统连接器	日历、电子邮件、CRM 操作
API 工作流	基于 API 的自定义自动化	后端集成
RPA 工作流	跨平台和基于窗口的自动化	旧版系统交互
自主智能体	嵌套式智能体执行	复杂的多步骤任务
MCP 服务器	模型上下文协议集成	外部工具生态系统
客户端工具	客户端上执行的工具	访问主机应用程序数据，触发用户界面操作
IXP 模型	智能文档处理	结构化文档提取

添加工具

1. 在智能体设计器中，选择“添加工具”。
2. 选择工具类型并配置其参数。
3. 提供智能体应何时以及如何使用该工具的清晰描述。

对于仅执行 API 调用的工作流，请使用 API 工作流，而非 RPA 工作流，以便在实时聊天场景中获得更佳性能。

提示：

如果您的工具使用 Integration Service 连接器，则可以让用户在运行时通过个人连接选择自己的连接。当智能体需要使用用户自己的凭据进行操作（例如从用户的帐户发送电子邮件或访问个人日历）时，此功能非常有用。

工具描述

工具描述可指导智能体何时使用每个工具。编写描述，明确陈述：

• 工具的用途
• 何时使用（可选）

工具描述示例

Search HR Policies: Use this tool to find information about company policies,
benefits, and HR procedures. Always use this tool before answering questions
about policies.

工具防护机制

为工具应用防护机制，以强制执行 Runtime 策略。防护机制可以：

• 限制工具可执行的时间。
• 在执行之前验证输入。
• 筛选或转换输出。

有关详细信息，请参阅“护栏”。

工具调用确认

对在用户审核建议操作之前不应运行的工具使用工具调用确认。例如，工具在创建事件、发送电子邮件、更新业务记录或触发具有外部副作用的自动化之前，需要确认。

要要求确认工具，请执行以下操作：

1. 在智能体设计器中，选择要配置的工具。
2. 在工具护栏设置中，启用“需要确认” 。
3. 保存并发布智能体。

当工具需要确认时，智能体会在运行该工具之前暂停，并向用户显示它计划使用的输入参数。用户可以批准工具调用，在批准之前修改输入值，或拒绝工具调用。

在运行时：

• 如果用户批准不更改，则工具将使用智能体提出的原始输入运行。
• 如果用户修改输入并获得批准，该工具将使用修改后的输入运行。
• 如果用户拒绝确认，则该工具不会运行。

备注：

工具调用确认是按工具配置的。对在执行前需要用户审核的操作启用禁用模式，并对只读工具或可以安全自动运行的工具禁用禁用模式。

Context

上下文将您的智能体连接到上下文锚定知识库索引，实现检索增强生成 (RAG)，从而获得引文支持的准确响应。

添加上下文

1. 选择添加上下文。
2. 从可用索引中选择上下文锚定索引。
3. 配置搜索参数（可选）。

当索引与用户问题相关时，智能体会自动查询索引，并在其响应中包含引文。

有关创建和管理索引的详细信息，请参阅“上下文”。

文件处理

对话智能体可以处理聊天期间上传的文件。它支持文档分析、表单处理和图像解释等用例。

启用文件上传

要启用文件分析，请添加能够处理文件的工具：

• 分析文件：内置工具，用于利用 LLM 进行常规文件分析。
• IXP 模型：用于结构化文档提取。

支持的文件类型

文件类型	建议的工具
图像（GIF、JPE、JPEG、PNG、WEBP）	分析文件
PDF 文档	分析文件、IXP

重要提示：

文件上传限制为 5MB。

升级

在无法自信地解决请求时，智能体可以通过升级将对话移交给人类。

升级如何运行

1. 智能体确定其需要人工协助（根据您的系统提示词标准）。
2. 智能体在 Action Center 中创建升级任务。
3. 对话将暂停，直到人类解决升级问题。
4. 解决后，智能体继续处理人类的输入。

配置升级

1. 在智能体设计器中，选择“添加升级”。
2. 配置升级类型。
3. 务必在系统提示词中定义升级条件。

备注：

Conversations run synchronously during escalation. The agent pauses all interaction until the escalation is resolved. If you need to launch escalations without blocking the chat, build your chat assistant in Maestro Flow instead, and run a Human Task node on a parallel branch, so the conversation keeps moving while the approval happens in the background.

有关详细信息，请参阅“升级和智能体记忆”。

连接注意事项

当您的智能体使用依赖 Integration Service 连接器的工具时，请考虑如何在运行时管理连接。

• 共享连接由管理员在 Orchestrator 文件夹中配置。在设计和调试期间配置的共享连接可确保智能体在发布后有权访问所需连接器。
• 个人连接（公开预览）允许个人用户在运行时选择自己的 Integration Service 连接。当智能体需要使用用户自己的凭据时，该功能非常有用，例如，从用户帐户发送电子邮件或访问个人日历。

在设计支持个人连接的智能体时，请记住以下几点：

• 要为用户启用个人连接，必须按照个人连接设置说明设置每个智能体工具。
• 智能体工具必须使用支持个人连接的连接器（例如，Outlook、Slack、Salesforce）。
• 有可用匹配连接时，智能体会在用户个人工作区中自动配置连接，从而确保大多数用户无缝设置。
• 如果自动配置的连接失败或未找到匹配的连接，系统会提示用户选择或创建一个新连接。
• 如果未为连接器配置个人连接，智能体将回退使用 Orchestrator 文件夹中的共享连接。
• 使用外部应用程序时，只有来自用户个人工作区的连接可用。不显示共享文件夹连接。

有关用户如何在 Runtime 配置个人连接的详细信息，请参阅个人连接。

设计最佳实践

从明确的角色开始

为智能体定义一个明确的身份，而非采用通用身份。清晰的角色有助于智能体保持一致的语气和行为。

不太有效：“您是一位乐于助人的助理。”更有效：“您是 Contoso Corporation 一位非常友好的人事助理，专门负责帮助员工了解公司政策和福利。”

针对不可预测性的设计

用户可能会提供不完整、模糊或不正确的信息。您的系统提示词应指示智能体：

• 在需要时提出澄清问题。
• 以合理的方式处理部分信息。
• 从误解中恢复。

明确指示工具用途

不要假设智能体知道何时使用工具。包含明确指示：

## Tool usage
- ALWAYS search the knowledge base before answering policy questions
- Use the calendar tool when the user asks about scheduling
- NEVER create calendar events without explicit user confirmation

通过评估进行迭代

为预期（正常路径）和非预期（边缘用例）场景创建测试用例。根据评估结果更新智能体配置。

后续步骤

• 评估：测试智能体的行为
• 部署：发布和部署智能体

Need more advanced conversation modeling — routing, hand-off between specialist agents, or backend automations running in parallel with the conversation? See Build in Maestro Flow to model the whole chat as a conversational Flow.