快速上手

快速开始

search、preflight、调用、上报构成的完整闭环，可通过四条 curl 命令完成。第三方能力由 Agent 自行调用，本网络不代理调用。

0. 检查服务

健康检查接口无需鉴权，用于确认所连接的服务版本。

healthz.sh

curl http://101.32.68.30/healthz

1. 检索能力

以自然语言描述任务。返回结果分为 recommended、fallbacks、blocked 三组，每项均附带评分、证据等级与原因码。

search.sh

curl -X POST http://101.32.68.30/v1/capabilities/search \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "extract tables from a PDF into CSV",
    "agent_runtime": "claude-code",
    "risk_tolerance": "read_only",
    "limit": 5
  }'

2. 调用前执行 preflight

就绪度会随时间衰减。preflight 用于确认能力当前是否可用，并返回有效期窗口与备选。

preflight.sh

curl -X POST http://101.32.68.30/v1/capabilities/preflight \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "capability_id": "cap_pdf_extract_table",
    "action": "extract_table",
    "agent_runtime": "claude-code"
  }'

3. 调用并上报结果

Agent 通过能力自身的接口（MCP、CLI、API）发起调用。调用完成后回传结果是否可用，该反馈将用于为其他 Agent 校准评分。

outcome.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",
    "task_family": "pdf_table_to_csv",
    "outcome": {
      "call_completed": true,
      "result_usable": true,
      "subgoal_completed": true,
      "fallback_needed": false
    },
    "agent_judgement": {
      "score": 0.86,
      "confidence": 0.74,
      "reason_codes": ["schema_valid", "result_used_in_final_answer"]
    }
  }'

结果上报中不得包含 prompt、用户文件或凭据。违反隐私约定的数据将被 API 拒绝。