用途：通过 Netra MCP 工具检查追踪数据，并给出符合 schema 的精确输入，支持从追踪搜索到根因分析的排障流程。
主要能力：netra_query_traces 在时间范围内按过滤、排序和游标分页查询追踪；netra_get_trace_by_id 按 traceId 返回完整 span 数组；netra_get_session_details 返回会话级详情及该会话下所有追踪，并聚合成本与 token。
使用方式：query_traces 必填 startTime、endTime（ISO 8601），可选 limit（1-100，默认 20）、cursor、direction（up|down，默认 down）、sortField、sortOrder（asc|desc，默认 desc）、filters。sortField 可取 latency_ms、name、total_cost、has_pii、has_violation、start_time、environment、service、has_error、total_tokens。每个 filter 对象需含 field、value、type、operator，可选 key 用于嵌套过滤。分页时先不带 cursor 查询，取返回的 cursor 并以 direction: down 继续，直到 pageInfo.hasNextPage 为 false。get_trace_by_id 必填 traceId，无效 id 返回 not-found 错误。get_session_details 必须且只能提供 session_id 或 trace_id 之一，可选 startTime、endTime、include_raw_inputs（默认 false）、limit（1-100，默认 50）、cursor；会话内追踪按 start_time 升序，任一追踪 has_error=true 则 status 为 errored，否则 completed。
适用场景：事件排查时先查 has_error=true 的追踪，按 latency_ms 降序定位最差请求，再取单条追踪检查根 span、父子 span 流、慢 span 与工具/模型元数据；若属于多轮会话，用 trace_id 调 get_session_details 查看全部相关追踪、聚合成本及其他轮次是否报错。
限制：include_raw_inputs 为 true 会为会话内每条追踪拉取完整 span 树，响应可能很大，应谨慎使用；初始时间窗口建议保持较短（5-30 分钟），过滤条件先少后多；无结果时先放宽时间范围再放宽过滤。