API リファレンス

プリフライト API

検索結果は時間とともに古くなります。プリフライトは、エージェントが呼び出す数ミリ秒前に特定のアクションを再検証します。ライブステータス、処理能力、想定レイテンシ、有効期間を返します。

POST/v1/capabilities/preflight

リクエストボディ

フィールド	説明
capability_id	チェック対象のケイパビリティ。検索結果から取得します。
action	呼び出す特定のアクション。スコアはサービス単位ではなくアクション単位です。
agent_runtime	呼び出し元のランタイム識別子。
task_family	タスクを考慮したスコアリングのためのタスクファミリー（例：pdf_table_to_csv）。
timeout_budget_ms	時間予算。想定レイテンシがこれを超える場合にフラグが立ちます。
risk_level	この呼び出しで許容するリスク。

request.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",
    "task_family": "pdf_table_to_csv",
    "timeout_budget_ms": 10000,
    "risk_level": "read_only"
  }'

応答

status は ready、degraded、blocked のいずれかです。valid_for_seconds は厳格な有効期限として扱ってください。経過後は古い回答を信頼せず、再度プリフライトを行ってください。

response.json

{
  "status": "ready",
  "invoke_now_score": 0.91,
  "confidence": 0.83,
  "valid_for_seconds": 45,
  "expected_p95_latency_ms": 3200,
  "capacity_state": "ok",
  "auth_state": "not_required",
  "warnings": [],
  "fallbacks": [
    {
      "capability_id": "cap_slow_but_local_cli",
      "reason": "local_execution_available"
    }
  ]
}