agents
latest
false
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。
智能体用户指南
上次更新日期 2026年5月21日
概述
使用 iFrame 将您的对话智能体嵌入到网页应用程序中。使用这种方法将对话智能体添加到第三方应用程序中或使用 iFrame 组件将其添加到 UiPath Apps 中。
目标用户：希望将对话智能体嵌入到自定义网页应用程序或 UiPath Apps 中的开发者和管理员。
功能可用性
| 功能 | 可用 |
|---|---|
| 发起新聊天 | ✅ |
| 聊天记录 | ✅ |
| 删除聊天会话 | ✅ |
| 设置 | ✅ |
| 启动提示词 | ✅ |
| 文件上传 | ✅ |
| 引文 | ✅* |
| HTML 预览 | ✅ |
| 复制响应 | ✅ |
| 反馈（赞） | ✅ |
| Debug 转储 | ❌ |
* 当 iFrame 嵌入 UiPath Apps 时，引文查看器不起作用。
先决条件
要嵌入对话智能体，请完成以下设置步骤：
管理员或开发者设置
- 将对话智能体发布到您所需的 Orchestrator 文件夹。
- 从实例管理中检索智能体发行版 ID。
- 对于 UiPath Apps，请在 UiPath Studio 中创建一个 Apps 项目。
- 对于第三方应用程序，确保网页应用程序支持 iFrame 嵌入。
查找智能体 ID
- 在实例管理中，导航到“智能体 > 已部署的智能体”。
- 在所需的智能体中选择“聊天”。
- 从 URL 中复制智能体 ID。例如，在 URL
https://cloud.uipath.com/conversationalagents/agents_/deployed/chat/342061中，智能体 ID 为342061。
用户要求
- 经过身份验证的用户必须拥有 UiPath 帐户以及智能体访问权限。
- 匿名用户必须拥有嵌入智能体的应用程序或表面的访问权限。
嵌入智能体
URL 构建
将 iFrame 来源设置为以下格式的 URL：
https://cloud.uipath.com/<organization>/<tenant>/autopilotforeveryone_/conversational-agents/?agentId=<agent_id>&mode=<mode>
https://cloud.uipath.com/<organization>/<tenant>/autopilotforeveryone_/conversational-agents/?agentId=<agent_id>&mode=<mode>
备注：
组织和租户名称区分大小写。
URL 参数
| 参数 | 必填 | 描述 |
|---|---|---|
agentId | 是 | 已发布智能体的发行版 ID |
mode | 否 | embedded 对于右侧边栏体验，全屏为 fullscreen（默认：fullscreen） |
title | 否 | 显示在聊天标头中的标题（默认：智能体名称） |
welcomeTitle | 否 | 首次运行欢迎屏幕的标题 |
welcomeDescription | 否 | 首次运行欢迎屏幕的描述 |
suggestions | 否 | 首次运行建议提示词矩阵 |
showHistory | 否 | 显示/隐藏聊天历史记录面板（默认：true） |
URL 示例
Basic embedded mode
https://cloud.uipath.com/myorg/mytenant/autopilotforeveryone_/conversational-agents/?agentId=12345&mode=embedded
https://cloud.uipath.com/myorg/mytenant/autopilotforeveryone_/conversational-agents/?agentId=12345&mode=embedded
With welcome message and suggestions
https://cloud.uipath.com/myorg/mytenant/autopilotforeveryone_/conversational-agents/?agentId=12345&mode=embedded&title=HR Assistant&welcomeTitle=Welcome!&welcomeDescription=I can help you with HR questions&suggestions=["What is the PTO policy?","How do I submit expenses?"]
https://cloud.uipath.com/myorg/mytenant/autopilotforeveryone_/conversational-agents/?agentId=12345&mode=embedded&title=HR Assistant&welcomeTitle=Welcome!&welcomeDescription=I can help you with HR questions&suggestions=["What is the PTO policy?","How do I submit expenses?"]
在 UiPath Apps 中嵌入
要在 UiPath Apps 中嵌入对话智能体，请使用 iFrame 组件。
-
在 UiPath Apps Studio 中打开您的应用程序。
-
将 iFrame 组件添加到您的页面。
-
将 iFrame“源”属性设置为构建的 URL。
-
发布应用程序。
在 UiPath Apps 中嵌入对话智能体时，应使用双引号对建议矩阵进行转义，如以下示例所示：
suggestions=[""What is the PTO policy?"",""How do I submit expenses?""]
suggestions=[""What is the PTO policy?"",""How do I submit expenses?""]
这是必要步骤，因为 UiPath Apps 将值作为字符串进行验证。
在第三方应用程序中嵌入
您可以将对话智能体嵌入到任何支持 iFrame 嵌入的网页应用程序中。
HTML 示例
<iframe
src="https://cloud.uipath.com/myorg/mytenant/autopilotforeveryone_/conversational-agents/?agentId=12345&mode=embedded"
width="400"
height="600"
frameborder="0"
allow="clipboard-write"
></iframe>
<iframe
src="https://cloud.uipath.com/myorg/mytenant/autopilotforeveryone_/conversational-agents/?agentId=12345&mode=embedded"
width="400"
height="600"
frameborder="0"
allow="clipboard-write"
></iframe>
注意事项
- 跨源策略：确保应用程序的内容安全策略允许从
uipath.com嵌入。 - 响应式设计：配置适当的宽度和高度值，以确保在不同尺寸的屏幕上正确呈现。
- 剪贴板访问权限：包含
allow="clipboard-write"，以实现复制响应功能。
聊天功能
嵌入式聊天体验使用实例管理聊天用户界面，提供相同的聊天功能，但存在以下例外和限制。
限制
以下功能在嵌入模式下不可用：
| 功能 | 注意 |
|---|---|
| 引文 | 引文预览不可用 |
| Debug 转储 | 不可用。使用实例管理进行调试。 |
身份验证选项
经过身份验证的用户
对于拥有 UiPath 帐户的内部用户：
- 用户通过标准 UiPath 身份验证进行身份验证。
- 智能体可以访问用户的身份信息，例如姓名和电子邮件地址。
- 根据用户的许可证对消耗量进行跟踪。
匿名用户
对于外部或未经身份验证的场景：
- 必须在管理门户中配置机密外部应用程序。
- 需要由您的组织托管的令牌端点。
- 不需要个人用户许可证。
- 消耗量从租户的单元池中扣除。
有关设置说明，请参阅“匿名访问设置”。
有关许可详细信息，请参阅“许可”。
警告：
匿名访问权限允许没有 UiPath 帐户的用户与您的智能体交互。我们强烈建议将匿名智能体隔离在您自己的门户或登录名后面，以减少滥用。
故障排除
iFrame 未加载
- 验证 URL 是否构建正确。
- 检查智能体 ID 是否有效。
- 确保智能体已发布且正在运行。
- 检查浏览器控制台是否存在内容安全策略错误。
复制不起作用
- 确保 iFrame 包含
allow="clipboard-write"属性。 - 检查浏览器是否有剪贴板访问权限。