智能体用户指南

批量转换

• 使用模型生成的分数、标签或分类来丰富 CSV 文件
• 将业务规则或决策逻辑应用于大型数据集
• 在生成自动化决策的同时生成解释或理由

数据源​

• 批量转换仅支持 JIT 数据源。
• 仅支持将 CSV 文件作为输入。
• 文件直接通过智能体输入进行传递，在运行时自动解析。
• 无需配置外部存储或创建索引。

配置批量转换​

1. 在设计模式下打开您的智能体。
2. 在内置工具列表中，将“批量转换”添加到智能体。

• 源文件：源是指文件输入（例如 input-csv）。在运行时，源会自动解析为智能体运行时提供的文件。

  备注：

  您必须在数据管理器中配置文件类型参数。

• 批量转换任务 - 工具专属指令，用于定义应如何执行批量转换。该字段用于确切地告知工具如何处理输入文件，包括：

  • 要生成哪些新列或行
  • 每行应如何处理
  • 要应用的任何规则、条件或决策逻辑

  例如，您可以指示工具根据每行的内容生成两个新列，例如分数和推荐标志。这不是智能体提示词。智能体应仅包含详细指令，说明何时调用批次转换，以及最终输出应如何呈现。

  

• 输出列 — 为批量转换生成的任何新列定义架构。为每列指定：

  • 列名称
  • 关于列代表什么以及应如何解释其值的描述

  您可以添加新的输出列，编辑现有列名称或描述，或根据需要移除列。批量转换任务应描述用于填充这些配置列的逻辑。

• 启用后，模型可以在处理每行时使用从网页检索到的信息为输入文件数据做补充。
• 禁用时，将严格使用输入文件的内容、任务中定义的指令以及明确提供给智能体的任何上下文进行转换。

运行批量转换​

• 输入文件在运行时传递给工具。
• 工具对文件进行逐行处理。
• 生成转换后的输出文件。
• 返回输出文件，作为智能体输出的一部分。

• 输入 - 工具使用的输入文件，包括文件名称、类型和元数据（可在工具调用输出中查看）。
• 输出 - 生成的输出文件，包括文件 ID、文件名和 MIME 类型（定义文件输出时，在工具调用输出中显示）。
• 提示词上下文 - 智能体运行期间使用的系统和用户提示词，有助于解释转换任务是如何执行的。

评估批量转换​

逐行评估​

• 每行都代表一个独立的决策或分类。
• 对于大型文件，您需要提供细粒度通过/失败指标。
• 您希望深入了解每次失败的具体情况。

配置逐行评估​

1. 在评估集配置中启用逐行评估。
2. 选择要评估的输出文件。当智能体生成多个输出文件时，这是必要的步骤。
3. 指定评估器应操作的文件类型（例如 CSV）。

CSV 列精确匹配评估器​

• 在预期输出和实际输出之间比较一个或多个指定的列
• 执行精确的字符串匹配
• 为每行返回通过/失败结果

运行和审核评估​

1. 使用输入文件和相应的批量转换输出文件创建评估运行。
2. 计划或运行评估。
3. 在两个级别审核结果：
   • 文件级汇总，显示总共有多少行通过或失败。
   • 行级深入分析，显示每一行的通过/失败状态、值和元数据。

• 清晰地了解哪些记录成功或失败。
• 更快地调试转换逻辑。
• 获得定量指标，可跟踪一段时间内的改进情况。