> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 日志

> 在 Fetch Hive 中查看智能体运行、筛选活动、检查追踪并调试工具使用

# 日志

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

## 概述

智能体日志位于 agents 部分的 **Logs** 下。该页面以运行表格为核心。点击某一行后,Fetch Hive 会打开一个运行详情面板,显示概要指标和追踪数据。

本页介绍的是已记录的运行,而不是 **Chat** 中的临时测试对话。请使用编辑器中的 **Chat** 来迭代行为,然后使用 **Logs** 在运行结束后检查运行情况。

## 如何打开智能体日志? <a href="#open-agent-logs" id="open-agent-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 Search**、**GPT Search**、**xAI Web Search**、**X Search**、**Vector Search**、**SERP** 或 **Image Generation**。

**Total Tokens** 包含父智能体响应、子智能体运行以及报告 token 的图像生成工具调用。在运行详情面板中,将鼠标悬停在 token 信息图标上,可查看按父智能体、图像生成和子智能体细分的明细。

## 如何筛选智能体日志? <a href="#filter-agent-logs" id="filter-agent-logs" />

使用顶部的日期范围控件选择自定义范围或可用的预设。预设包括 **Last 1 Day**、**Last 7 Days**、**Last 30 Days** 和 **Last 90 Days** 等范围,但更长的范围可能需要具有更多日志历史的套餐。

使用 **Provider**、**Model** 和 **API keys** 将表格缩小到你关心的运行。

使用 **User metadata** 按跟踪的元数据属性进行筛选。选择一个属性键以查找存在该键的运行,或添加精确值以匹配标量值,例如 `cus_123`、`enterprise`、`true` 或 `12`。

需要重置当前筛选状态时,点击 **Clear filters**。

需要隐藏或恢复表格列时,使用 **Columns**。

## 如何检查一次智能体运行? <a href="#inspect-agent-run" id="inspect-agent-run" />

1. 点击日志表格中的某一行。
2. 查看右侧打开的运行详情面板。

面板顶部会在可用时显示请求 ID,否则显示运行 ID 作为后备。它还会显示运行状态、智能体名称和开始时间。

顶部下方的摘要条会显示该运行的 **Provider / Model**、**Agent**、**Duration**、**Tokens**、**Credits**、**Cost**、**Tool Calls**、**Owner** 和 **Charge Type**。

如果智能体仍然存在且未归档,摘要条中的智能体名称会链接回编辑器。

## 追踪 <a href="#traces" id="traces" />

使用运行详情面板左侧的追踪瀑布图,可以了解运行随时间推进的过程。

当你选中一个 span 时,右侧会更新以显示该运行该部分的详细信息。根据 span 的不同,可能包括:

* 模型响应数据
* 请求详情
* 用户元数据
* 元数据
* 工具输入
* 工具响应
* token 和费用详情

当选中的 span 关联到某个工具完成时,Fetch Hive 会显示工具专有的 **Response** 和 **Input** 面板。当它关联到主模型完成时,Fetch Hive 则会显示该完成的响应和请求部分。

对于子智能体 span,Fetch Hive 还会显示所选子智能体运行的 token 和费用贡献。嵌套的子智能体会被递归计入运行总量,并继续出现在追踪瀑布图中。如果某个子智能体失败,该 span 会被保留,其输入、安全失败响应、`child_request_id`、元数据诊断,以及在失败前已写入的任何部分子追踪/费用数据也会保留。延迟到达的子运行会在完成后通过 `child_request_id` 重新对账并并入父追踪。

对于 Claude 智能体完成,请求部分可能包括 **Prompt Cache**,即分配给该运行的已配置 Anthropic 提示词缓存 TTL。实际的缓存命中和写入计费仍体现在 cached-token 使用字段中。

这是智能体运行的主要调试视图。当你需要了解智能体是直接响应、先进行推理、调用了工具,还是在某一具体步骤上变慢时,请从这里开始。

## 备注

* 智能体日志不包括提示词日志和工作流日志中使用的 **Source** 筛选模式。
* 智能体流式响应中的客户端断开连接会被视为静默取消,因此不会显示为失败运行或计费事件,除非提供商已经完成并提交了用量。
* Fetch Hive 会通过智能体调用持续跟踪用户元数据属性名称,使元数据筛选器能够建议你工作区实际发送过的键。请参阅[调用元数据](../user-tracking/invoke-metadata)获取请求示例。
* 此页面不会单独暴露智能体的分析或导出视图。
* 当你希望从自己的应用中调用智能体时,请使用[通过 API 运行](./run-with-api);当你希望在编辑器中迭代时,请使用[使用聊天测试](./testing-with-chat)。