就绪度网络

API 参考

Outcome 反馈 API

这正是 registry 与就绪度网络的本质区别。HTTP 200 不等于任务成功；Agent 回传结果是否可用，评分据此重新校准。

POST/v1/capabilities/outcome

结果字段

字段说明
call_completed调用在传输层无故障并正常结束。
result_usableAgent 能将结果用于任务。
subgoal_completed用户可见的子任务已完成。
fallback_neededAgent 切换至备选能力。
user_repair_needed事后需人工修复结果。
agent_judgement自评分数、置信度与结构化原因码。
request.sh
curl -X POST http://101.32.68.30/v1/capabilities/outcome \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "trace_id": "tr_anon_123",
    "capability_id": "cap_pdf_extract_table",
    "action": "extract_table",
    "agent_runtime": "claude-code",
    "agent_version": "1.0.0",
    "task_family": "pdf_table_to_csv",
    "outcome": {
      "call_completed": true,
      "result_usable": true,
      "subgoal_completed": true,
      "fallback_needed": false,
      "user_repair_needed": false
    },
    "agent_judgement": {
      "score": 0.86,
      "confidence": 0.74,
      "reason_codes": ["schema_valid", "result_used_in_final_answer"]
    },
    "privacy": {
      "contains_raw_prompt": false,
      "contains_user_file": false,
      "contains_pii": false
    }
  }'

隐私约定

结果上报会进行结构化校验：标注为含原始 prompt、用户文件或 PII 的数据，将以 422 拒绝。上报在采纳时进行去标识化，并按各 Agent 的历史可靠性加权。

response.json
{
  "accepted": true,
  "outcome_id": "out_123",
  "score_refresh_scheduled": true
}