- 入门指南
- UiPath 对话智能体
- Studio Web 中的 UiPath 智能体
- UiPath 编码智能体
- 使用编码智能体构建
上下文
将索引或一组 Data Fabric 实体添加为智能体上下文,然后配置其搜索策略、作用域或实体类型,以控制智能体检索的内容。
在智能体中使用索引
索引使智能体可以访问经过许可的知识库。这有助于智能体使用业务专属数据进行推理。有关有效利用上下文的指导,请参阅“上下文工程最佳实践”。
要为上下文锚定功能配置自定义模型,请参阅“配置 LLM”。
要将索引添加为智能体的上下文,请在上下文部分执行以下步骤:
- 选择“添加上下文” ,然后选择“上下文锚定索引” 。
- 从可用列表中选择一个索引,或选择新建,在 Orchestrator 中新建索引。有关详细信息,请参阅“索引”。
- 请为您的上下文提供描述。
- 使用“属性”面板配置 搜索策略。 您可以使用以下设置控制查询类型、精度和相关性:
- 语义:如果您正在使用文本数据源,请选择此选项进行语义查询。
- 相关性评分阈值:指在检索和重新排序相关数据块后应用的相似度评分阈值。评分低于此阈值的任何相关数据块都不会返回。使用此字段可提高结果的精确性。将数字提高,上下文锚定就会仅筛选出分数最高的提示词,并将其作为基础。
- 生成的最多结果:指上下文锚定从用户的查询中返回的块数。 它有助于减小 LLM 生成的基础负载(LLM 调用的总令牌大小),并且可以帮助您对从上下文锚定获得的结果进行额外筛选。随着结果数增加,返回的数据块数量也会增加。
- 查询 – 搜索策略的查询。此字段支持静态值、静态模式、参数模式和动态模式。
- 结构化 (预览):如果您使用的是表格数据源,请为结构化查询选择此选项。 支持 CSV 数据格式。
- DeepRAG:选择此选项以启用高级多文档合成和检索。 有关详细信息,请参阅“使用 DeepRAG”。
- 启用引用 – 启用 DeepRAG 查询的引用功能。
- 提示词 – DeepRAG 查询的提示词。此字段支持静态值、静态模式、参数模式和动态模式。
- 语义:如果您正在使用文本数据源,请选择此选项进行语义查询。
- 使用以下设置限制搜索作用域:
- 文件夹路径前缀 – 使用此字段指定存储目标文档的文件夹路径。您可以手动输入静态路径(如
/documents/project),或使用动态参数,使智能体能够根据 runtime 输入搜索不同的文件夹。
备注:默认情况下,仅会对直接位于指定文件夹中的文件进行索引。 存储在子文件夹中的文件不会自动包括在内。 要包含子文件夹中的文件,请将
/**附加到路径中(例如/documents/project/**)。如果不包含子文件夹中的文件,您可能会看到以下错误:“没有可用于 DeepRAG 的有效文件。请更新并重新同步您的索引,或使用其他匹配模式。”- 文件扩展名 – 选择索引中包含的文件类型。对于 DeepRAG,仅支持 PDF 文件。
- 文件夹路径前缀 – 使用此字段指定存储目标文档的文件夹路径。您可以手动输入静态路径(如
在智能体中使用 Data Fabric 实体
除索引外,智能体还可以直接使用 Data Fabric 实体作为上下文。这使智能体可以直接从企业系统查询记录系统,并对当前值进行推理,而您无需创建或维护索引。
支持将原生和联合实体类型添加为上下文。原生实体将其记录存储在 UiPath 中,而联合实体自己不保存数据,而是在每次查询时从外部系统或原生实体中实时读取。有关每种类型支持的内容的完整比较,请参阅实体类型。有关创建和配置实体的详细信息,请参阅创建实体。
要将 Data Fabric 实体集添加为智能体的上下文,请在“上下文”部分中执行以下步骤:
- 选择“添加上下文” ,然后选择“Data Fabric 实体” 。
备注:
此视图仅显示文件夹级别的实体。
- 搜索并从列表中选择最多五个实体。实体被分组到“当前解决方案”和“可用资源”中,每个实体都显示一个原生或联合标签。您可以选择使用“查看”按钮查看实体的详细信息。
- 选择添加,将选定的实体添加到您的智能体中。
备注:
连接到外部系统的联合实体可能具有必需的参数,具体取决于系统连接器读取数据所需的内容。如果您添加的实体具有任何属性,则会在其属性面板中列出这些属性。输入所需参数的值,然后智能体可以查询该实体。
这些实体显示为智能体的上下文,每个实体都带有原生或联合标签,可供查询。