Agent card
Concept
Dalam protokol A2A, kartu agen (agent card) adalah dokumen yang dapat dibaca mesin dan dipublikasikan di URL well-known. Dokumen ini menjelaskan nama agen, kemampuan, keterampilan, endpoint, persyaratan autentikasi, serta format input dan output agar agen lain dapat menemukannya.
Juga dibahas
Episode tentang Agent card juga membahas Microsoft Purview Information Barriers, Context window, Front matter, Agent kill switch, AI red teaming, dan AI Center of Excellence.
Description
Eine Agent-Karte ist ein maschinenlesbares Dokument, das im Agent2Agent-Protokoll (A2A) zur Beschreibung eines Agenten verwendet wird. Sie wird unter einer festgelegten, bekannten URL veröffentlicht und enthält Metadaten wie den Namen des Agenten, seine Beschreibung, Version, Fähigkeiten, Skills, Endpunkt, Authentifizierungsanforderungen sowie die unterstützten Eingabe- und Ausgabeformate. Ihr Hauptzweck ist die Erkennung: Ein Client oder ein anderer Agent kann die Karte lesen, um zu erfahren, was ein Agent anbietet, bevor er eine Anfrage an ihn sendet.
Das A2A-Protokoll adressiert die Interoperabilität zwischen Agenten, indem es auf eine standardisierte Sprache setzt, die individuellen Programmieraufwand für jede Interaktion zwischen Agenten überflüssig macht. Die Agent-Karte ist der Teil dieses Ansatzes, mit dem ein Agent seine Identität und seine Fähigkeiten bekannt machen kann. Anstatt Annahmen über einen entfernten Agenten fest zu codieren, liest ein aufrufender Agent die veröffentlichte Karte und ermittelt, wie er den Agenten erreicht und welche Arten von Daten er austauschen kann.
Die Microsoft-Learn-Seite zum A2A-Hosting im Microsoft Agent Framework zeigt, wie das in der Praxis aussieht. Im Beispiel für das Hosting mit ASP.NET Core wird die Karte unter einem bekannten Pfad bereitgestellt, der auf agent-card.json endet. Die Zuordnungsmethode, die die Karte verfügbar macht, stammt aus dem A2A-SDK-Paket und nicht aus den Hosting-Paketen des Agent Framework. Die Beispielkarte legt einen Namen, eine Beschreibung und eine Version fest, außerdem Standard-Eingabe- und Ausgabemodi sowie eine unterstützte Schnittstelle, die eine URL, eine Protokollbindung und eine Protokollversion umfasst. Die Seite empfiehlt, die Karte für den Produktivbetrieb vollständig auszufüllen, damit Clients vollständige Informationen über den Agenten erhalten, den sie aufrufen wollen.
Eine praktische Einschränkung, die in der Dokumentation beschrieben wird, betrifft das Hosting. Ein einzelner Host kann nur eine Agent-Karte unter dem bekannten Pfad veröffentlichen, sodass dort nur ein Agent auffindbar ist. Andere Agenten, die auf demselben Host laufen, bleiben über ihre eigenen URLs erreichbar, doch Clients müssen diese Endpunkte bereits kennen, da der gemeinsame bekannte Speicherort sie nicht auflistet. Bei der Planung einer Bereitstellung mit mehreren Agenten wirkt sich dies darauf aus, wie die Erkennung gestaltet wird und wie Endpunktinformationen an Nutzer weitergegeben werden. Die Dokumentationsseite behandelt keine Skills, keine Details zur Authentifizierung und keine Signaturen der Karte; diese Aspekte werden hier daher nur auf der Ebene der allgemeinen Definition beschrieben.
Die Episode "Agent-to-Agent (A2A) Communication - Simply Explained" greift das Konzept im Rahmen einer breiteren Diskussion zur Interoperabilität auf. Sie stellt die Agent-Karte als Mechanismus dar, über den Agenten ihre Identität und Fähigkeiten bekannt machen, wodurch Erkennung und Interaktion erleichtert werden. Dieselbe Episode verbindet dies mit strukturierter Kommunikation, bei der Agenten verschiedene Datentypen austauschen, was Zusammenarbeit und die Verfolgung des Aufgabenstatus unterstützt. Außerdem betont sie, dass Datenschutz und Sicherheit bei der Kommunikation zwischen Agenten zentral sind und dass alle, die mit solchen Systemen arbeiten, sich der mit der Datenverarbeitung verbundenen Risiken bewusst sein sollten. Da eine Agent-Karte Informationen über einen Agenten und seine Erreichbarkeit veröffentlicht, gehört die Entscheidung, was aufgenommen wird und wie der Zugriff kontrolliert wird, zu dieser übergreifenden Sicherheitsbetrachtung.
Zusammenfassend dient die Agent-Karte als öffentliche Beschreibung eines A2A-Agenten. Clients lesen sie, bevor sie eine Aufgabe senden; sie wird von einem vorhersehbaren Ort aus bereitgestellt; und im Produktivbetrieb sollte sie vollständig und korrekt sein. Die Einschränkung auf eine Karte pro bekanntem Pfad im Beispiel für ASP.NET Core ist ein Gestaltungspunkt, der immer dann zu berücksichtigen ist, wenn von demselben Host mehr als ein Agent bereitgestellt wird.
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.
Was ist eine Agent-Karte im A2A-Protokoll? (AI)
Es ist ein maschinenlesbares Dokument, das unter einer bekannten URL veröffentlicht wird und den Namen, die Fähigkeiten, Skills, Endpunkt, Authentifizierungsanforderungen sowie Eingabe- und Ausgabeformate eines Agenten beschreibt, damit andere Agenten ihn finden können.
Wo wird die Agent-Karte im Beispiel des Microsoft Agent Framework bereitgestellt? (AI)
Im Beispiel für ASP.NET Core wird sie unter einem bekannten Pfad bereitgestellt, der auf agent-card.json endet, und zwar mit einer Zuordnungsmethode aus dem A2A-SDK-Paket und nicht aus den Hosting-Paketen des Agent Framework.
Kann ein Host mehrere Agent-Karten veröffentlichen? (AI)
Laut der Microsoft-Learn-Seite kann ein einzelner Host nur eine Agent-Karte unter dem bekannten Pfad veröffentlichen, sodass dort nur ein Agent auffindbar ist; andere Agenten bleiben über ihre eigenen URLs erreichbar, die Clients bereits kennen müssen.
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: