读一次 LLM 生成的审计（平台超管）

GET /api/v1/admin/llm-generation-runs/{jobId} · adminGetLLMGenerationRun

审计读面（验收：审计能回答一次生成使用了什么模型、Prompt、证据和输入版本，但不泄露密钥或跨租户内容）。返回该 generation job 最近一次 LLM 生成运行的结构化审计：promptVersion / modelId / surveyVersionId / marketSnapshotId / 引用的 evidence IDs / 输出 hash / token 用量 / 成本 / 时延 / 状态 / errorCode。绝不返回 apiKey、prompt 原文、模型原始输出。要求平台超管。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

参数

jobId（必填）: string

响应字段 · 200

jobId（必填）: string
promptVersion（必填）: string
modelId（必填）: string
surveyVersionId: string
marketSnapshotId: string
evidenceIds: string[]
outputHash: string
promptTokens: integer
completionTokens: integer
totalTokens: integer
costAmount: number
costCurrency: string
latencyMs: integer
finishReason: string
status（必填）: enum；取值：succeeded / needs_review / failed
errorCode: string
createdAt: string

错误

401：Problem 错误响应
403：Problem 错误响应
404：Problem 错误响应

请求示例（curl）

curl -X GET "https://你的项目.workflow.games/api/v1/admin/llm-generation-runs/{jobId}" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "jobId": "018f3c2e-0000-7000-8000-000000000000",
  "promptVersion": "示例文本",
  "modelId": "018f3c2e-0000-7000-8000-000000000000",
  "status": "succeeded"
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引