agents.json：サイトをAIエージェントが消費できるAPIに変えるスタンダード

先週、このブログにagent-permissions.jsonを実装した方法をドキュメント化した。そのファイルは「エージェントがここで何ができるか」という質問に答える。しかし「どうやるか」には答えない。

agents.jsonはWildcard AIが作成した仕様で、OpenAPIを拡張してAPIとAIエージェント間のインタラクションコントラクトを記述する。標準的なOpenAPI仕様との根本的な違いは、agents.jsonが人間のデベロッパーではなくLLMに消費されるよう設計されていること。

llms.txtジェネレーター用に実装したもの

{
  "version": "0.1.0",
  "name": "Shinobis Tools",
  "flows": [
    {
      "name": "generate_llms_txt",
      "description": "Generate a valid llms.txt file for any website",
      "steps": [
        { "action": "navigate", "target": "https://shinobis.com/tools/llmstxt-generator" },
        { "action": "set_input", "selector": "#url-input", "input_type": "url", "required": true },
        { "action": "click", "selector": "button[type=submit]" },
        { "action": "read_output", "selector": "#output-area", "output_format": "text/markdown" }
      ]
    }
  ]
}

構築した5レイヤースタックがagents.jsonで6レイヤーに拡張される。アイデンティティ、アクセシビリティ、発見、パーミッション、セマンティックユーザビリティ、そして実行コントラクト。

完全な仕様はWildcard AIのリポジトリにある。