エージェントを発見可能にする
明確な Agent Card は、A2A クライアントに信頼できる出発点を与えます。エージェントが誰に属し、どこにあり、どのプロトコルバインディングとバージョンを話すかです。
Agent Card ジェネレーターがあなたの AI エージェントのために作成するもの
Agent Card は A2A エージェントの公開インターフェース記述です。他のエージェントがあなたのサービスを呼び出すかどうかを判断する前には、URL 以上のものが必要です。エージェントの目的、技術的な契約、スキル、アクセス要件についての信頼できる説明が必要なのです。
この Agent Card ジェネレーターは、それらの実装詳細を読みやすく A2A v1.0 形式の JSON に変換しながら、意思決定をフォームの近くに保ちます。エージェントのコアロジックを構築した後、デプロイまたは登録する前に使用してください——手書きの JSON ファイルが通常壊れるポイントです。
使用可能なインターフェースを記述する
他のエージェントが呼び出しを行う前に必要とする、優先インターフェース、コンテンツモード、ストリーミング動作、プッシュ通知サポートを捉えます。
アクセスに関する期待値を設定する
サービスが公開されているか、API キーを使用するか、OAuth 2.0 を必要とするかを文書化し、統合先が正しい認証フローを選択できるようにします——認証情報を Agent Card に含めることは決してありません。
スキルを明確な契約に変える
エージェントが実行できる作業に名前を付け、v1.0 が要求するタグと有用な例を追加し、人、マーケットプレイス、AI クライアントに境界を理解できるようにします。
Agent Card ジェネレーターの仕組み
サービス詳細から公開可能な Agent Card へ
Agent Card ジェネレーターは、サービスの詳細を明確で公開可能な JSON ドキュメントに変換します。Agent Card を本番環境に送る前に、この短いワークフローに従ってください。
- 1
実際のサービスから始める
公開の A2A エンドポイント、プロトコルバインディング、プロバイダー詳細、エージェントバージョン、サーバーが受け入れて返すコンテンツタイプを追加します。
- 2
能力とスキルの境界を定義する
実装がサポートする能力のみを選択し、代表的なスキルを 1 つ、平易で具体的な言葉で記述します。
- 3
生成された JSON を確認する
ライブプレビューを使用して、欠落しているフィールド、プレースホルダーの URL、デプロイされたサービスを正確に反映していない説明を見つけます。
- 4
検証して公開する
Agent Card をバリデーターに通し、レビュー済みのドキュメントをサービスドメインの /.well-known/agent-card.json に配置します。
Agent Card ジェネレーターを使う人
Agent Card を作成、出荷、またはレビューするすべての人のために
Agent Card ジェネレーターは、開発者、プラットフォームチーム、レビュアーが、空の JSON ファイルから始めることなく一貫した A2A エージェントメタデータを作成できるよう支援します。
AI および独立系開発者
A2A 互換エージェントを立ち上げる際、手書きの agent-card.json を、仕様に沿った完全な出発点に置き換えます。
プロンプトエンジニアとプロダクトマネージャー
JSON の構文に触れることなく、サービスの説明から信頼できるディスカバリードキュメントを作成し、レビューのためにエンジニアリングに引き渡します。
プラットフォームおよび DevOps チーム
社内エージェントが会社のエージェントカタログや CI パイプラインに入る前に、エンドポイント、認証、スキルの記述方法を標準化します。
マーケットプレイスの公開者
レビュアーとランキングシステムが実際に解析できる、プロバイダーメタデータ、スキルタグ、セキュリティ宣言を準備します。
よくある質問
Agent Card ジェネレーターに関するよくある質問
A2A クライアントがあなたのエンドポイントを見つける前に、基本を正しく整えましょう。
A2A Agent Card とは何ですか？
A2A Agent Card は AI エージェントのための JSON ディスカバリードキュメントです。潜在的なクライアントに、身元、プロバイダー情報、サポートするインターフェース、能力、スキル、受け入れ可能なコンテンツモード、セキュリティ要件を伝えます——README と API 概要を組み合わせたエージェント間版と言えます。
なぜ JSON を手書きする代わりに Agent Card ジェネレーターを使うのですか？
手書きの Agent Card は、必須フィールドの欠落、v1.0 以前のフィールド名、構文エラーが常態化しがちです。ジェネレーターは現在の A2A v1.0 形式——supportedInterfaces、provider.organization、必須のスキルタグ——を生成し、入力するたびに検証するため、構造的なミスが本番環境に到達することはありません。
生成された Agent Card はどの A2A バージョンを対象としていますか？
ジェネレーターは A2A v1.0 構造を出力します。インターフェースごとに protocolBinding と protocolVersion を持つ順序付き supportedInterfaces 配列、トップレベルのエージェント version、extendedAgentCard を含む capabilities です。トップレベルの url や preferredTransport フィールドを持つ Agent Card は v1.0 以前のものです。
生成された JSON は本番環境の前にレビューが必要ですか？
はい。ジェネレーターは実用的な出発点となるドキュメントを作成しますが、デプロイ済みの契約の代替にはなりません。エンドポイント、プロトコルバインディング、スキル、認証がユーザーが実際にアクセスするサービスと一致することを確認してください。
Agent Card はどこに公開すればよいですか？
A2A サービスと同じドメイン上の https://your-domain/.well-known/agent-card.json に、レビュー済みの JSON を公開します。これは A2A 仕様に登録された well-known パスです。多くの古い統合は /.well-known/agent.json もチェックするため、両方を提供することが安全な移行戦略です。
公開の準備ができました
公開する前に Agent Card ジェネレーターに戻りましょう。
詳細を仕上げ、生成された JSON を確認し、Agent Card を公開する前にライブ検証を使用してください。
ブログから
A2A ディスカバリーの実践ガイド。v1.0 仕様に基づいて執筆しています。
How-to
How to create an agent.json file for A2A v1.0
Learn how to create an agent.json file for A2A v1.0, including required Agent Card fields, the well-known URL, response headers, and common mistakes.
11 min readガイドを読むIntegrationPublishing an Agent Card from ADK, LangGraph, CrewAI or Semantic Kernel
Learn how to publish an A2A Agent Card from Google ADK, LangGraph, CrewAI, or Semantic Kernel by mapping framework concepts to standard discovery fields.
10 min readガイドを読むComparisonA2A vs MCP: two protocols solving two different problems
Compare A2A vs MCP: what each protocol connects, where they overlap, and why production AI agent systems often use both for tools and agent collaboration.
9 min readガイドを読む記事は英語で公開されています。