腾讯混元智能体需v2.3.0+版本并开启DEBUG级全链路日志（含工具上下文）及X-HY-Log-Mode: full请求头，才能获取base64编码的x-hy-execution-trace结构化执行轨迹用于调试审计。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元智能体在执行复杂任务（如多步工具调用、联网搜索、条件分支判断）时，若未开启完整执行日志，系统默认只返回最终结果，中间推理链、函数调用参数、错误重试过程全部不可见，导致调试困难、审计缺失、故障归因失败。
确认智能体运行环境支持日志捕获
进入腾讯云控制台 → 【AI与大模型】→ 【混元智能体平台】→ 选择已部署的智能体实例 → 查看右上角“版本信息”。【必须为 v2.3.0 及以上版本】，低于此版本不支持结构化执行日志输出，升级需重新发布智能体配置。
旧版用户若看到“执行轨迹”灰显或无该选项，说明当前实例尚未启用日志能力，需先点击“编辑配置”→“高级设置”→勾选“启用全链路执行追踪”，再保存并重新部署。
在智能体配置中开启结构化日志开关
方法一：控制台图形化配置
1. 进入智能体详情页 → 点击左侧菜单【运行配置】→ 展开【日志与监控】板块；
2. 将“执行过程日志”切换为【开启】；
3. 在“日志级别”下拉框中选择【DEBUG】——仅选 INFO 或 WARNING 会丢失函数入参、工具返回原始响应、重试次数等关键字段；
4. 勾选“记录工具调用上下文”，否则第三方API请求体与响应体将被脱敏为[REDACTED]。
方法二：通过 API 更新配置（适用于批量管理）
调用 UpdateAgentConfig 接口，传入 JSON body 中的 log_config 字段必须包含：{"enable": true, "level": "DEBUG", "include_tool_context": true}。缺少任一字段都将导致日志截断。
调用时强制触发完整日志生成
使用 OpenAI 兼容接口调用智能体时，在请求 payload 中添加额外 header：X-HY-Log-Mode: full。不加此 header 即使后台已开启日志，单次请求仍按 minimal 模式输出。
若使用腾讯云 SDK，则需在初始化 client 后显式设置：client.set_log_mode("full")。Python SDK v3.8.2+ 支持该方法，低版本需手动注入 header。
注意：该 header 仅对当次请求生效，无法全局持久化。每次需要审计的调用都必须携带。
从响应体中提取原始日志数据
开启日志后，智能体返回的 JSON 响应中会新增 x-hy-execution-trace 字段，其值为 base64 编码的结构化日志对象。
直接解码该字段即可获得标准 JSON 格式的执行轨迹，包含：start_time、steps（含每步的 action、input、output、duration_ms）、tool_calls（含 request_id、status、raw_response）、error_stack（如有）。
不要依赖响应中的 content 字段反推执行路径——它可能被模板渲染覆盖，而 x-hy-execution-trace 是唯一权威来源。
