必须先开启调试日志功能才能查看智能体运行时详细行为；需在AgentKit控制台启用观测服务与日志采集，或通过agentkit.yaml配置logging.level: debug，或用agentkit launch --log-level debug临时启用，再通过实时日志流验证tool_call等debug日志是否输出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在火山引擎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 的结构化日志条目持续刷出；【若5秒内无任何日志刷新，说明观测服务未真正生效或实例尚未完成配置热加载】。
第四步：在日志流顶部点击“下载最近1000行”，检查 JSON 日志中是否包含 "level": "debug" 字段及完整 span_id 关联信息。
