智能体用户指南
此页面记录了对话智能体的当前限制,并提供常见问题的答案。
当前限制
我们正在积极为该产品扩展新的功能。下表列出了当前的限制,这些限制计划在后续版本中会加以解决。
| 限制 | 描述 |
|---|---|
| 本地桌面自动化 | 智能体无法通过 Assistant 在用户的本地桌面上运行自动化。 |
| 个人连接 | 仅可使用共享的 Integration Service 连接。不支持个人连接。 |
| 工具确认 | 智能体在执行工具之前不会要求用户确认。 |
| PII 掩码 | PII 检测和掩码不可用。 |
| 提示注入防护机制 | 用于提示注入的智能体级防护机制不可用。 |
| 文件大小 | 文件上传限制为 5MB。 |
| 语音交互 | 仅文本交互。不支持按键通话和双向语音功能。 |
| IVR 集成 | 交互式语音响应集成不可用。 |
渠道功能可用性
并非所有功能在每个部署渠道中都可用。有关完整的功能比较,请参阅部署。
主要区别:
| 功能 | 适用的地方。 | 不适用的地方。 |
|---|---|---|
| 启动提示词 | 实例管理、iFrame | Autopilot for Everyone、Teams、Slack |
| HTML 预览 | 实例管理、iFrame | Autopilot for Everyone、Teams、Slack |
| 文件上传 | 实例管理、Autopilot for Everyone、iFrame、Teams、Slack、TypeScript SDK | — |
| 引文 | 实例管理、Autopilot for Everyone、Teams、Slack、TypeScript SDK | iFrame* |
| Debug 转储 | 实例管理、Autopilot for Everyone | Teams、Slack、iFrame |
其他渠道限制:
- Teams 和 Slack:仅支持直接消息。频道讨论和 @提及不可用。
- 引文预览:仅可用于 PDF 文档。
- “iFrame 引用”:将 iFrame 嵌入 UiPath App 时,引用查看器无法工作。
常见问题
对话智能体概述
对话智能体与自主智能体有何不同?
对话智能体专为与用户进行多轮、来回对话而设计。自主智能体基于单个提示执行任务。当您的场景需要持续澄清、个性化指导或实时交互时,可使用对话智能体。
有关详细比较,请参阅对话智能体。
对话智能体与 Autopilot for Everyone 有何关系?
它们可并行协作:
- Autopilot for Everyone:UiPath™ 用于生产力任务的通用 Assistant。
- 对话智能体:您为特定用例构建的专用智能体。
您可以从 Autopilot for Everyone 访问对话智能体,使其成为您所有对话需求的集中枢纽。
许可和消耗
如何计算 Free Actions?
Free Actions 按用户单独计数,不会在用户之间汇总共享。每个用户根据其许可证类型拥有各自独立的免费额度:
- Express:每年 50 次 Free Actions
- 基本:每月 50 次 Free Actions
- Plus/Pro:无限制(但需遵守公平使用原则)
如果用户 A 发送 20 条消息,用户 B 发送 80 条消息,则用户 A 仍剩余 30 条 Free 消息,而用户 B 已超过其免费层级。
工具调用是否会产生额外花费?
某些工具除了基本操作成本之外还有额外消耗:
- 无需额外成本:上下文锚定(语义搜索)、Integration Service 连接器、MCP 工具
有关完整详细信息,请参阅许可。
什么构成操作?
一个操作等于发送到对话智能体的一条用户消息。基于该消息生成多少智能体响应并不重要。字符数为 8 个或更少且未执行工具的消息不计算在内。
模型和配置
我能使用我自己的 LLM 吗?
可以。对话智能体支持 LLM 配置,因此您可以使用您自己的 LLM 订阅。此功能处于预览阶段。在预览期间,不按每条消息收费,但某些工具使用的额外消耗仍然适用。
用户可以上传哪些文件类型?
您必须添加文件分析工具(分析文件、智能提取处理 (IXP) 或自定义工作流),才能启用文件上传。支持的类型:
- 图像:GIF、JPE、JPEG、PNG、WEBP
- 文档:PDF(小于 5MB)
部署和访问
为什么我的对话智能体无法在“实例管理”中启动?
检查以下内容:
- 确保已将一个 Unattended Robot 账户分配给解决方案文件夹。
- 验证您位于智能体解决方案所在的正确租户中。
- 如果您使用跨平台 RPA 工具,请检查是否分配了无服务器机器人。
运行工具时,为什么会出现连接错误?
智能体需要访问设计时使用的相同连接:
- 在共享 Orchestrator 文件夹中创建 Integration Service 连接。
- 在设计和调试期间使用共享连接。
- 在同一共享文件夹中将解决方案作为子文件夹进行发布。
这样可确保解决方案会自动继承父文件夹的连接。
如何限制哪些用户可以访问特定的对话智能体?
用户访问权限通过 Orchestrator 文件夹权限进行控制。 用户需要对包含智能体解决方案的文件夹拥有适当的权限。在管理门户中配置文件夹访问权限。
嵌入和集成
如何在我的应用程序中嵌入对话 Agents?
使用 iFrame 嵌入。 有关 URL 构造和参数,请参阅 Apps 嵌入。
我是否可以为没有 UiPath™ 账户的用户嵌入智能体?
可以。请使用匿名访问权限为外部用户嵌入智能体。这需要设置外部应用程序和令牌端点。匿名用户从租户的单元池中消耗用量,不享有免费额度。
渠道特定问题
我可以通过 API 访问对话智能体吗?
可以。您可以通过 UiPath TypeScript SDK 获取 Conversational Agents。请参阅 UiPath TypeScript SDK 了解功能可用性。
为什么在 Teams、Slack 或 Autopilot for Everyone 中未显示起始提示?
起始提示仅在“实例管理”和 iFrame 嵌入中受支持。由于平台限制,其他渠道不会传递这些提示。
智能体能否在 Slack 频道或 Teams 频道中响应?
不可以。对话智能体仅支持通过 UiPath Autopilot 插件发送直接消息。不支持频道讨论和 @提及。
为什么我在 Teams 或 Slack 中看不到 HTML 预览?
HTML 预览仅在“实例管理”和 iFrame 嵌入中可用。 在其他渠道中,HTML 内容显示为原始文本或 Markdown。
为什么我无法在 Teams 中创建对话?
如果对话无法开始:
- 验证智能体是否已在 Orchestrator 中发布和部署。
- 检查您是否已将 Teams 应用程序连接到您的 UiPath 账户。
- 使用注销命令并重新连接以刷新您的会话。
- 使用切换智能体命令验证智能体是否可用。
上下文基础
为什么智能体找不到我的上下文锚定索引?
如果您收到“未找到索引”错误:
- 验证索引是否存在并处于“就绪”状态。
- 检查智能体是否有权访问包含索引的文件夹。
- 确保自配置以来未移动或删除索引。
- 进行任何索引更改后需重新发布智能体。
为什么引文不正确或缺失?
引文质量取决于:
- 索引质量:确保来源文档结构良好
- 块大小:非常大或小的块都会影响引文的准确性
- 查询相关性:模糊的查询可能会检索到相关性较低的内容
注意:引文预览仅可用于 PDF 文档。
性能
哪些因素影响响应时间?
多个因素会影响延迟:
- 模型选择:不同的模型具有不同的延迟特征
- 上下文窗口大小:对话历史记录越长,处理时间越长
- 工具执行:RPA 工作流和 API 调用会添加执行时间
- 上下文锚定:RAG 搜索根据索引大小添加延迟
要优化:
- 对于仅涉及 API 的操作,请使用 API 工作流,而不是 RPA。
- 保持对话上下文清晰且集中。
- 针对您的延迟要求选择适当的模型。
合规性和监管
如何审核 LLM 调用和智能体行为?
AI Trust Layer 提供完整的审核追踪。通过管理门户访问审核日志,以获得:
- 模型交互的完整历史记录。
- 令牌使用情况跟踪。
- 策略合规性验证。
详细信息请参阅可观察性。
数据存储空间
聊天历史记录存储在何处?
聊天历史存储在 Azure 数据库中,并限定在租户范围内。 用户只能访问其有权使用的智能体的聊天历史记录。
上传的文件存储在何处?
上传的文件将存储在相关租户的系统存储桶中。 无法从 Orchestrator 用户界面访问此存储。
上传的文件将保留多长时间?
文件遵循“Orchestrator 的保留策略”。保留计时器会在作业完成后才开始计时。Community 和 Enterprise 版本的默认保留期为 30 天,可以在 Orchestrator 设置中配置,最长可达 6 个月。
自定义
我可以自定义欢迎消息吗?
通过 iFrame 嵌入时,请使用 welcomeTitle、welcomeDescription,和 suggestions URL 参数。详细信息请参阅 Apps 嵌入。
在“实例管理”中,欢迎体验会使用智能体的配置设置。
获取帮助
如果您遇到此处未包含的问题:
- 查看智能体追踪记录以获取调试信息。
- 使用 Debug 转储功能(在“实例管理”中使用 Ctrl+Alt+D)捕获诊断信息。
- 请联系 UiPath™ 支持团队,获取 Debug 转储和相关追踪记录信息。