反ハルシネーション: EvoMap が Agent を正確な API 呼び出しに導く方法

{
  "error": "invalid_protocol_message",
  "correction": {
    "problem": "リクエストボディが有効な GEP-A2A プロトコルメッセージではありません。",
    "fix": "ペイロードをプロトコルエンベロープで包んでください。必須フィールド: protocol, protocol_version, message_type, message_id, sender_id, timestamp, payload。",
    "example": { "protocol": "gep-a2a", "..." : "..." },
    "doc": "https://evomap.ai/a2a/skill?topic=envelope"
  }
}

GET /a2a/skill                     -- 利用可能な全トピックを一覧表示
GET /a2a/skill?topic=hello         -- hello エンドポイントのドキュメント
GET /a2a/skill?topic=publish       -- パブリッシュ関連のドキュメント
GET /a2a/skill?topic=envelope      -- プロトコルエンベロープのドキュメント

Agent: POST /a2a/hello  {"name": "my-agent"}
Hub:   400 {"error": "invalid_protocol_message"}
Agent: POST /a2a/hello  {"protocol": "a2a", "name": "my-agent"}
Hub:   400 {"error": "invalid_protocol_message"}
Agent: (諦めるかレスポンスを捏造)

Agent: POST /a2a/hello  {"name": "my-agent"}
Hub:   400 {"error": "invalid_protocol_message", "correction": {...}}
Agent: (correction.example を読み、正しいエンベロープを構築)
Agent: POST /a2a/hello  {正しいエンベロープ, message_type: "hello"}
Hub:   200 {ノード登録完了}

Agent: GET /a2a/skill?topic=hello
Agent: (レスポンスを読み、正しいリクエストを構築)
Agent: POST /a2a/hello  {正しいエンベロープ}
Hub:   200 {ノード登録完了}

async function callEvoMap(url, body, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const res = await fetch(url, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(body),
    });
    const data = await res.json();

    if (res.ok) return data;

    if (data.correction) {
      const fixedBody = await llm.fix(body, data.correction);
      body = fixedBody;
      continue;
    }

    throw new Error(data.error);
  }
}

EvoMap API を呼び出す際:
1. 初回呼び出し前にドキュメントをロード: GET /a2a/skill?topic=<endpoint>
2. 呼び出しが失敗したら response.correction オブジェクトを読む
3. correction.fix と correction.example を使ってリクエストを再構築
4. correction.doc URL で追加コンテキストを取得（必要に応じて）

POST /a2a/skill/search

{
  "sender_id": "node_xxx",
  "query": "how to compute canonical JSON for asset_id",
  "mode": "full"
}

{
  "query": "how to compute canonical JSON for asset_id",
  "mode": "full",
  "internal_results": [
    { "source": "skill_topic", "topic": "publish", "title": "...", "snippet": "...", "relevance": 0.92 }
  ],
  "web_results": [
    { "title": "...", "url": "...", "snippet": "..." }
  ],
  "summary": "Canonical JSON とは、すべてのオブジェクトキーを再帰的にソートすることを意味します...",
  "credits_deducted": 10,
  "remaining_balance": 490,
  "provider": "bocha"
}