上下文

在智能体中使用索引

索引使智能体可以访问经过许可的知识库。这有助于智能体使用业务专属数据进行推理。有关有效利用上下文的指导，请参阅“上下文工程最佳实践”。

要为您的智能体添加上下文，请在上下文部分执行以下步骤：

1. 选择添加上下文。
2. 从可用列表中选择一个索引，或选择新建，在 Orchestrator 中新建索引。有关详细信息，请参阅“索引”。
3. 请为您的上下文提供描述。
4. 使用“属性”面板配置 搜索策略。 您可以使用以下设置控制查询类型、精度和相关性：
   • 语义：如果您正在使用文本数据源，请选择此选项进行语义查询。
     • 相关性评分阈值：指在检索和重新排序相关数据块后应用的相似度评分阈值。评分低于此阈值的任何相关数据块都不会返回。使用此字段可提高结果的精确性。将数字提高，上下文锚定就会仅筛选出分数最高的提示词，并将其作为基础。
     • 生成的最多结果：指上下文锚定从用户的查询中返回的块数。 它有助于减小 LLM 生成的基础负载（LLM 调用的总令牌大小），并且可以帮助您对从上下文锚定获得的结果进行额外筛选。随着结果数增加，返回的数据块数量也会增加。
     • 查询 – 搜索策略的查询。此字段支持静态值、静态模式、参数模式和动态模式。
   • 结构化 （预览）：如果您使用的是表格数据源，请为结构化查询选择此选项。 支持 CSV 数据格式。
   • DeepRAG：选择此选项以启用高级多文档合成和检索。 有关详细信息，请参阅“使用 DeepRAG”。
     • 启用引用 – 启用 DeepRAG 查询的引用功能。
     • 提示词 – DeepRAG 查询的提示词。此字段支持静态值、静态模式、参数模式和动态模式。
5. 使用以下设置限制搜索作用域：
   • 文件夹路径前缀 – 使用此字段指定存储目标文档的文件夹路径。您可以手动输入静态路径（如 /documents/project），或使用动态参数，使智能体能够根据 runtime 输入搜索不同的文件夹。
   备注：

   默认情况下，仅会对直接位于指定文件夹中的文件进行索引。 存储在子文件夹中的文件不会自动包括在内。 要包含子文件夹中的文件，请将 /** 附加到路径中（例如 /documents/project/**）。如果不包含子文件夹中的文件，您可能会看到以下错误：“没有可用于 DeepRAG 的有效文件。请更新并重新同步您的索引，或使用其他匹配模式。”

   • 文件扩展名– 选择索引中包含的文件类型。对于 DeepRAG，仅支持 PDF 文件。

使用文件实现即时上下文

即时上下文让您能够在运行时为智能体提供文件，而无需管理长时间存在的索引或持久性数据源。智能体直接处理文件，而不是将文件同步到永久索引。这种做法可减少运营开销，提高吞吐量，并避免不必要的存储成本。当您的用例需要智能体在运行时处理提供的文件，且不需要在之后保留已建立索引的数据时，请使用即时上下文。

1. 选择“添加上下文”，然后选择“使用文件输入”。仅当在数据管理器中为智能体定义了“文件类型”参数时，此选项才可用。

2. 使用“名称”字段为文件索引设置描述性名称。
3. （可选）在“描述”中，记录此上下文将提供什么类型的文档。
4. 在“文件”中，绑定包含文件或附件的输入（例如来自对话或工具的文档数组）。
5. 就像配置常规索引一样配置其余设置。

在执行期间，会根据您的配置创建临时索引并进行查询，随后将其丢弃。智能体在其推理过程中会接收提取出的相关上下文，而无需您管理数据源、索引同步或清理工作。

要求和限制

使用实时上下文时，适用以下约束：

• 输入附件：每次运行最多 25 个附件，总大小上限为 128 MB。
• 支持的文件类型：上下文锚定支持的所有文件类型。
• 输出格式：与现有上下文锚定工具的标准输出格式匹配。
• TTL（生存时间）：临时索引将在最后一次使用后 24 小时自动删除。这使您可以在调试期间重复使用同一索引，而无需重新摄取数据。
• 每个租户最多可同时激活 1,000 个临时索引。可以根据具体情况请求更高的配额。