用途:在 Firetiger 中诊断问题或事故,启动或读取一次调查(investigation),用遥测数据排查根因,并处理相关 Issue。
主要能力:调查是自主 AI 智能体会话,不是填写文档。给出问题陈述后,investigate 智能体会基于受影响的服务和未关闭 Issue 展开,运行遥测查询并推理根因;你读取并引导该会话,而不是手工编辑 findings 字段。也可选择自己直接查询数据(firetiger-query 技能)。
使用方式:启动调查时在 investigations 集合上创建,body 含 display_name 与 description,资源 ID 即会话 ID,创建即启动智能体。读取已有调查可用 resolve_url 解析 URL,再用 read_agent_messages 读取会话;也可用内置 MCP 提示 read-investigation。引导调查用 send_agent_message 向会话发消息,默认等待智能体完成本轮;status 为 WAITING 表示需要输入。直接诊断可用 SQL:遥测数据位于按服务划分的 Iceberg 表,用 SHOW TABLES; 发现表,时长 = end_time - start_time,错误 = status.code = 2,先过滤时间列并用 LIMIT 限制结果。
Issue:Issue(Known Issue)是智能体发现真实问题后提交的记录,ID 形如 FT-{number},资源名 issues/FT-{number}(服务端生成),支持完整 CRUD。工作流状态为 INVESTIGATING → ACTIONABLE → VERIFYING_FIX → CLOSED,关闭需 closure.reason(RESOLVED、ACCEPTED_RISK、FALSE_POSITIVE、DUPLICATE、NOT_USEFUL),无 severity 字段。Issue 由自主 Issue Expert 智能体(expert_session)分诊和丰富,应通过 send_agent_message 与其沟通,而非手工编辑字段。
限制与常见错误:调查没有 findings、root_cause、resolution、time_range、services 字段,不要写入;status 由服务端设置(EXECUTING/WAITING),不能标记为 resolved;不要编造 Issue ID;关闭 Issue 必须提供原因;不要查询通用 traces 表,数据按服务划分;不要用 status_code = 'ERROR' 或 duration_ns。相关技能:firetiger-query、firetiger-create-agent、firetiger-monitor-deploy。