Agent Card ジェネレーターがあなたの AI エージェントのために作成するもの

Agent Card は A2A エージェントの公開インターフェース記述です。他のエージェントがあなたのサービスを呼び出すかどうかを判断する前には、URL 以上のものが必要です。エージェントの目的、技術的な契約、スキル、アクセス要件についての信頼できる説明が必要なのです。

この Agent Card ジェネレーターは、それらの実装詳細を読みやすく A2A v1.0 形式の JSON に変換しながら、意思決定をフォームの近くに保ちます。エージェントのコアロジックを構築した後、デプロイまたは登録する前に使用してください——手書きの JSON ファイルが通常壊れるポイントです。

エージェントを発見可能にする

明確な Agent Card は、A2A クライアントに信頼できる出発点を与えます。エージェントが誰に属し、どこにあり、どのプロトコルバインディングとバージョンを話すかです。

使用可能なインターフェースを記述する

他のエージェントが呼び出しを行う前に必要とする、優先インターフェース、コンテンツモード、ストリーミング動作、プッシュ通知サポートを捉えます。

アクセスに関する期待値を設定する

サービスが公開されているか、API キーを使用するか、OAuth 2.0 を必要とするかを文書化し、統合先が正しい認証フローを選択できるようにします——認証情報を Agent Card に含めることは決してありません。

スキルを明確な契約に変える

エージェントが実行できる作業に名前を付け、v1.0 が要求するタグと有用な例を追加し、人、マーケットプレイス、AI クライアントに境界を理解できるようにします。

Agent Card ジェネレーターの仕組み

サービス詳細から公開可能な Agent Card へ

Agent Card ジェネレーターは、サービスの詳細を明確で公開可能な JSON ドキュメントに変換します。Agent Card を本番環境に送る前に、この短いワークフローに従ってください。

  1. 1

    実際のサービスから始める

    公開の A2A エンドポイント、プロトコルバインディング、プロバイダー詳細、エージェントバージョン、サーバーが受け入れて返すコンテンツタイプを追加します。

  2. 2

    能力とスキルの境界を定義する

    実装がサポートする能力のみを選択し、代表的なスキルを 1 つ、平易で具体的な言葉で記述します。

  3. 3

    生成された JSON を確認する

    ライブプレビューを使用して、欠落しているフィールド、プレースホルダーの URL、デプロイされたサービスを正確に反映していない説明を見つけます。

  4. 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 を公開する前にライブ検証を使用してください。

Agent Card ジェネレーターを開くJSON を検証する