- 文档首页
火山引擎 Agent Toolkit
场景指南
故障诊断
故障诊断
故障诊断默认只读,先收集证据并确定故障域,不直接修改配置或资源。
- 提取已有错误信息,只补充询问缺失的最少字段;处理前移除 AK/SK、Session Token、Authorization Header、签名 URL、Cookie、连接串和个人信息。
- 区分调用、账号权限、计费配额、计算网络、存储数据库等故障域。
- 验证本地工具和当前身份链路。Agent 不直接查看或输出凭据文件;CLI 按正常认证流程使用配置中的凭据。
- 使用只读 API、指标和资源状态补充证据;日志和审计可获取时作为补充来源。
诊断阶段不安装依赖、不登录、不写配置,也不修改云资源。处理建议如果涉及权限、配置或资源变更,需要单独确认后才能执行。
- 可以确认的原因、尚缺少的证据和判断置信度;缺少数据或权限时明确说明,不对未取得的数据补写结论。
使用 volcengine-troubleshooting 先确认错误来自 TOS、调用凭据还是客户端配置,再按官方规格检查身份策略、桶策略及目标范围。不要只凭 403 判断为缺少某项权限;必要信息缺失时说明需要补充什么。
诊断结果应包含证据和最小处理建议。需要改权限、更新工具或重新上传时,另行确认;完整密钥、签名 URL、Cookie 和原始敏感日志不应提交到聊天或公开反馈。
最近更新时间:2026.10.29 15:14:27