Agent card
Concept
A2Aプロトコルにおけるエージェントカードとは、エージェントの名前、機能、スキル、エンドポイント、認証要件、入出力形式を記述した、機械可読なドキュメントです。既知のURLで公開され、他のエージェントがそれを見つけて利用できるようにします。
あわせて取り上げられたテーマ
Agent cardに関するエピソードでは、Microsoft Purview Information Barriers、Context window、Front matter、Agent kill switch、AI red teaming、AI Center of Excellenceも取り上げられています。
Description
エージェントカードとは、Agent2Agent (A2A) プロトコルでエージェントを説明するために使われる、機械可読な文書です。既知のURLで公開され、エージェントの名前、説明、バージョン、機能、スキル、エンドポイント、認証要件、対応する入力および出力の形式などのメタデータを含みます。その中心的な目的は検出にあります。クライアントや他のエージェントは、リクエストを送る前にカードを読むことで、そのエージェントが何を提供しているかを把握できます。
A2Aプロトコルは、標準化された言語を重視することでエージェント間の相互運用性に取り組み、各エージェント間のやり取りごとにカスタムコードを用意する必要をなくします。エージェントカードは、このアプローチのうち、エージェントが自身の識別情報と機能を公開する部分にあたります。呼び出し側のエージェントは、リモートエージェントについての前提をコードに固定するのではなく、公開されたカードを読み取り、そのエージェントへの接続方法と交換できるデータの種類を判断します。
Microsoft Agent FrameworkにおけるA2AホスティングについてのMicrosoft Learnのページは、これが実際にどのように見えるかを示しています。ASP.NET Coreのホスティング例では、カードは agent-card.json で終わる既知のパスで提供されます。カードを公開するマッピングメソッドは、Agent Frameworkのホスティングパッケージではなく、A2A SDKパッケージから提供されます。サンプルのカードでは、名前、説明、バージョン、既定の入力および出力モード、そしてURL、プロトコルバインディング、プロトコルバージョンを含む対応インターフェイスを設定しています。このページは、本番利用に向けてカードを完全に記述することを推奨しており、そうすることでクライアントは呼び出そうとしているエージェントについて完全な情報を受け取れます。
ドキュメントに記載されている実際的な制約は、ホスティングに関するものです。1つのホストは既知のパスに1つのエージェントカードしか公開できず、そのためそこで検出できるエージェントは1つだけです。同じホスト上で稼働する他のエージェントは、それぞれ自身のURLを通じて引き続き到達可能ですが、共有の既知の場所にはそれらが一覧されないため、クライアントはそのエンドポイントをあらかじめ知っている必要があります。複数のエージェントを配置する計画を立てる際には、これが検出の設計方法や、エンドポイント情報を利用者と共有する方法に影響します。このドキュメントのページはスキル、認証の詳細、カードの署名については扱っていないため、ここではそれらの側面を一般的な定義のレベルでのみ説明しています。
エピソード「Agent-to-Agent (A2A) Communication - Simply Explained」は、相互運用性についてのより広い議論の一部として、この概念に触れています。エージェントカードを、エージェントが自身の識別情報と機能を公開し、検出と相互作用を容易にする仕組みとして紹介しています。同じエピソードでは、これを、エージェントが様々な種類のデータを交換し、協働やタスク状態の追跡を支える構造化された通信と結び付けています。また、エージェント間通信においてはプライバシーとセキュリティが中心的な関心事であり、これらのシステムに携わる人は、データ処理に伴うリスクを認識しておくべきだと強調しています。エージェントカードはエージェントに関する情報とその到達方法を公開するため、何を含めるか、そしてアクセスをどのように制御するかを決めることは、こうした広いセキュリティ上の検討の一部となります。
要約すると、エージェントカードはA2Aエージェントの公開された説明として機能します。タスクが送られる前にクライアントによって読まれ、予測可能な場所から提供され、本番環境では完全かつ正確であるべきです。ASP.NET Coreのホスティング例における「既知のパスごとに1つのカード」という制約は、同じホストから複数のエージェントを公開する場合に考慮すべき設計上のポイントです。
Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.
| Type | Concept |
|---|---|
| Kind | Format |
Frequently asked questions
Questions marked with AI were written with AI from the facts on this page.
A2Aプロトコルにおけるエージェントカードとは何ですか? (AI)
エージェントの名前、機能、スキル、エンドポイント、認証要件、入力および出力の形式などを記述した機械可読な文書で、既知のURLで公開され、他のエージェントが検出できるようにするものです。
Microsoft Agent Frameworkの例では、エージェントカードはどこで提供されますか? (AI)
ASP.NET Coreのホスティング例では、agent-card.json で終わる既知のパスで提供されます。Agent Frameworkのホスティングパッケージではなく、A2A SDKパッケージのマッピングメソッドを使用します。
1つのホストが複数のエージェントカードを公開できますか? (AI)
Microsoft Learnのページによると、1つのホストは既知のパスに1つのエージェントカードしか公開できないため、そこで検出できるエージェントは1つだけです。他のエージェントは独自のURLで引き続き到達可能ですが、クライアントはそのURLをあらかじめ知っている必要があります。
Community wiki
Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.
Experts and companies for this topic
Nobody has listed this topic yet. Add it to your profile.
Maintained by Mirko Peters (Microsoft MVP) · Last updated: