火山引擎Agentkit智能体调试日志开启配置方式

想要查看智能体运行时的详细行为，必须先开启调试日志功能。要实现这一点，你可以在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 发送 POST 请求到运行时 API 地址）。

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

第三步：在日志过滤栏输入关键词 tool_call 或 memory_read，观察是否有带 trace_id 的结构化日志条目持续刷出；

。

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