跳转到主要内容

日志

使用智能体日志来检查智能体运行开始之后发生的事情。在 Fetch Hive 中,这是在编辑器之外查看运行状态、模型使用情况、工具活动、费用和追踪计时的主要位置。

概述

智能体日志位于 agents 部分的 Logs 下。该页面以运行表格为核心。点击某一行后,Fetch Hive 会打开一个运行详情面板,显示概要指标和追踪数据。 本页介绍的是已记录的运行,而不是 Chat 中的临时测试对话。请使用编辑器中的 Chat 来迭代行为,然后使用 Logs 在运行结束后检查运行情况。

如何打开智能体日志?

  1. 在侧边栏中打开 Agents
  2. 在 agents 部分的菜单中点击 Logs
Fetch Hive 会打开智能体日志表格。在该页面中,agents 侧边栏不会显示 Categories 分组,也不会添加在提示词日志和工作流日志中使用的 Source 筛选模式。

智能体日志表格中跟踪了什么?

主日志表格会显示每次运行的概要字段,包括:
  • Completed At
  • Name
  • Model
  • Tools
  • Status
  • Total Tokens
  • Total Cost
  • Duration
  • API Key
  • Collaborator
Tools 列会显示运行中涉及的工具来源。根据具体运行情况,可能包括 Google SearchGPT SearchxAI Web SearchX SearchVector SearchSERPImage Generation Total Tokens 包含父智能体响应、子智能体运行以及报告 token 的图像生成工具调用。在运行详情面板中,将鼠标悬停在 token 信息图标上,可查看按父智能体、图像生成和子智能体细分的明细。

如何筛选智能体日志?

使用顶部的日期范围控件选择自定义范围或可用的预设。预设包括 Last 1 DayLast 7 DaysLast 30 DaysLast 90 Days 等范围,但更长的范围可能需要具有更多日志历史的套餐。 使用 ProviderModelAPI keys 将表格缩小到你关心的运行。 使用 User metadata 按跟踪的元数据属性进行筛选。选择一个属性键以查找存在该键的运行,或添加精确值以匹配标量值,例如 cus_123enterprisetrue12 需要重置当前筛选状态时,点击 Clear filters 需要隐藏或恢复表格列时,使用 Columns

如何检查一次智能体运行?

  1. 点击日志表格中的某一行。
  2. 查看右侧打开的运行详情面板。
面板顶部会在可用时显示请求 ID,否则显示运行 ID 作为后备。它还会显示运行状态、智能体名称和开始时间。 顶部下方的摘要条会显示该运行的 Provider / ModelAgentDurationTokensCreditsCostTool CallsOwnerCharge Type 如果智能体仍然存在且未归档,摘要条中的智能体名称会链接回编辑器。

追踪

使用运行详情面板左侧的追踪瀑布图,可以了解运行随时间推进的过程。 当你选中一个 span 时,右侧会更新以显示该运行该部分的详细信息。根据 span 的不同,可能包括:
  • 模型响应数据
  • 请求详情
  • 用户元数据
  • 元数据
  • 工具输入
  • 工具响应
  • token 和费用详情
当选中的 span 关联到某个工具完成时,Fetch Hive 会显示工具专有的 ResponseInput 面板。当它关联到主模型完成时,Fetch Hive 则会显示该完成的响应和请求部分。 对于子智能体 span,Fetch Hive 还会显示所选子智能体运行的 token 和费用贡献。嵌套的子智能体会被递归计入运行总量,并继续出现在追踪瀑布图中。如果某个子智能体失败,该 span 会被保留,其输入、安全失败响应、child_request_id、元数据诊断,以及在失败前已写入的任何部分子追踪/费用数据也会保留。延迟到达的子运行会在完成后通过 child_request_id 重新对账并并入父追踪。 对于 Claude 智能体完成,请求部分可能包括 Prompt Cache,即分配给该运行的已配置 Anthropic 提示词缓存 TTL。实际的缓存命中和写入计费仍体现在 cached-token 使用字段中。 这是智能体运行的主要调试视图。当你需要了解智能体是直接响应、先进行推理、调用了工具,还是在某一具体步骤上变慢时,请从这里开始。

备注

  • 智能体日志不包括提示词日志和工作流日志中使用的 Source 筛选模式。
  • Fetch Hive 会通过智能体调用持续跟踪用户元数据属性名称,使元数据筛选器能够建议你工作区实际发送过的键。请参阅调用元数据获取请求示例。
  • 此页面不会单独暴露智能体的分析或导出视图。
  • 当你希望从自己的应用中调用智能体时,请使用通过 API 运行;当你希望在编辑器中迭代时,请使用使用聊天测试