如果你想查看智能体运行时的详细行为与执行过程，首先必须开启调试日志功能。实现方式包括：在 AgentKit 控制台中启用观测服务和日志采集；通过 agentkit.yaml 配置文件将 logging.level 设置为 debug；或者使用 agentkit launch --log-level debug 命令进行临时开启。完成配置后，即可通过实时日志流检查 tool_call 等 debug 日志是否已正常输出，从而确认智能体调试日志是否生效。

在火山引擎 AgentKit 中，如果要查看智能体运行时的详细行为、排查响应延迟，或定位工具调用失败等问题，必须先开启调试日志功能。否则，日志服务默认不会采集运行时内部的执行链路信息，导致关键调试数据无法查看。

通过控制台开启运行时观测与日志采集

登录 AgentKit 控制台 → 在左侧导航树中选择“智能体运行时” → 找到目标运行时并点击名称进入详情页 → 点击右上角“更新配置” → 切换到“观测服务”标签页。

勾选“开启观测服务”，并确认下方“日志采集”开关已开启。该操作会自动绑定已开通的全栈可观测平台实例；【若未提前开通全栈可观测平台，此步骤会报错且无法保存】。

点击“提交更新”后，系统会滚动重启运行时实例以加载新的配置。重启期间通常有约 1～2 分钟不可访问，但现有会话上下文不会丢失。

通过CLI工具启用调试级别日志输出

方法一：在本地 agentkit.yaml 中添加日志配置项

打开项目根目录下的 agentkit.yaml 文件，在 runtime 配置块下新增 logging 字段：

logging:
level: debug
output: stdout

该配置可使运行时在本地沙箱或云端实例中，将工具调用、内存读写、模型输入输出等全链路事件以 debug 级别打印到标准输出，便于排查 Skill 执行中断、RAG 检索结果为空等常见问题。

方法二：使用 agentkit launch 命令临时覆盖日志等级

执行 agentkit launch --log-level debug --env LOG_LEVEL=debug。该命令会强制所有子进程（包括模型适配器、工具调度器）启用调试日志，无需修改配置文件，适合快速验证某次部署是否触发了预期的工具调用链路。

验证日志是否生效

第一步：调用一次智能体接口（例如使用 curl 或 Postman 向运行时 API 地址发送 POST 请求）。

第二步：返回控制台 → 进入“智能体运行时”详情页 → 点击左侧“日志”子菜单 → 选择“实时日志流”。

第三步：在日志过滤栏中输入关键词 tool_call 或 memory_read，观察是否有带 trace_id 的结构化日志条目持续输出；【若 5 秒内没有任何日志刷新，说明观测服务可能尚未真正生效，或实例还未完成配置热加载】。

第四步：在日志流顶部点击“下载最近1000行”，检查 JSON 日志中是否包含 "level": "debug" 字段，以及完整的 span_id 关联信息。