はじめる

クイックスタート

検索、プリフライト、呼び出し、報告というループ全体を、4 つの curl コマンドで実行します。実際のサードパーティ呼び出しはエージェントが行い、ネットワークがプロキシすることはありません。

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.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. 呼び出し後に結果を報告

エージェントは自身のインターフェース（MCP、CLI、API）を通じてケイパビリティを呼び出します。その後、結果が実際に利用可能だったかを報告します。これが他のすべてのエージェントのスコアを較正します。

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"]
    }
  }'

結果の報告には、プロンプト、ユーザーファイル、認証情報を一切含めてはなりません。プライバシー契約に違反するペイロードは API が拒否します。