用途：查询 AI Gateway 的请求追踪数据，用于排查流量、分析成本、延迟、错误率、模型使用、单用户活动、MCP 工具调用等。不适用于为自建应用添加埋点、配置网关模型或限流、查看容器日志或检查平台连通性。
必要用法：每条查询必须提供 tracingProjectFqn 或 dataRoutingDestination 之一，并给 startTime；建议先用 status 技能确认 TFY_BASE_URL 与 TFY_API_KEY 有效。直接调用 API 时需将 TFY_API_SH 设为该技能 scripts/tfy-api.sh 的完整路径。核心端点为 POST /api/svc/v1/spans/query，请求体含时间范围、过滤条件（SpanFieldFilter、SpanAttributeFilter、GatewayRequestMetadataFilter，操作符 eq、neq、contains、not_contains、starts_with、ends_with）、limit、sortDirection、pageToken、applicationNames、createdBySubjectSlugs 等。结果含 spanAttributes，其中 gen_ai.usage.cost 与 tfy.request_cost 为费用，gen_ai.usage.input_tokens/output_tokens 为 Token 数；durationNs 需除以 1e9 转为秒。分页时把上一响应的 pagination.nextPageToken 作为 pageToken 传入，直到为空。
常见场景：近期请求、成本分析、错误列表、模型用量、单用户请求、MCP 调用、按应用或端点名过滤。结果建议以表格呈现。限制：不支持埋点、网关配置与日志查询；无数据时需检查时间范围、目标是否存在及过滤是否过严；pageToken 过期需重新发起查询。