M365Con 2027 – die kostenlose Online-Konferenz · 11–22 Jan 2027 · 120 sessions m365con.net

Agent card

Konzept

Im A2A-Protokoll ist eine Agent Card ein maschinenlesbares Dokument, das unter einer bekannten URL veröffentlicht wird. Es beschreibt Name, Fähigkeiten, Skills, Endpunkt, Authentifizierungsanforderungen und Ein- und Ausgabeformate eines Agenten, damit andere Agenten ihn finden können.

✦ KONZEPTAgent cardM365.FM
Titelbild: Agent card (Konzept)

Ebenfalls besprochen

In Folgen zu Agent card geht es auch um Microsoft Purview Information Barriers, Context window, Front matter, Agent kill switch, AI red teaming und AI Center of Excellence.

Beschreibung

Eine Agent Card ist ein maschinenlesbares Dokument, das im Agent2Agent-Protokoll (A2A) verwendet wird, um einen Agenten zu beschreiben. Es wird unter einer bekannten URL veröffentlicht und enthält Metadaten wie den Namen des Agenten, seine Beschreibung, Version, Fähigkeiten, Skills, Endpunkt, Authentifizierungsanforderungen sowie die Eingabe- und Ausgabeformate, die er unterstützt. Ihr Kernzweck ist die Erkennung: Ein Client oder ein anderer Agent kann die Card lesen, um zu erfahren, was ein Agent anbietet, bevor eine Anfrage an ihn gesendet wird.

Das A2A-Protokoll adressiert die Interoperabilität zwischen Agenten, indem es auf eine standardisierte Sprache setzt, wodurch in jeder Interaktion zwischen Agenten kein individueller Code mehr nötig ist. Die Agent Card ist der Teil dieses Ansatzes, der es einem Agenten ermöglicht, seine Identität und Fähigkeiten zu veröffentlichen. Anstatt Annahmen über einen entfernten Agenten fest zu codieren, liest ein aufrufender Agent die veröffentlichte Card, ermittelt daraus, 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 Card unter einem bekannten Pfad bereitgestellt, der auf agent-card.json endet. Die Zuordnungsmethode, die die Card verfügbar macht, stammt aus dem A2A-SDK-Paket und nicht aus den Hosting-Paketen des Agent Framework. Die Beispiel-Card legt einen Namen, eine Beschreibung und eine Version fest, außerdem Standard-Ein- und Ausgabemodi sowie eine unterstützte Schnittstelle mit URL, Protokollbindung und Protokollversion. Die Seite empfiehlt, die Card für den Produktivbetrieb vollständig auszufüllen, damit Clients vollständige Informationen über den Agenten erhalten, den sie aufrufen werden.

Eine praktische Einschränkung, die in der Dokumentation beschrieben wird, betrifft das Hosting. Ein einzelner Host kann nur eine Agent Card 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, Clients müssen diese Endpunkte jedoch bereits kennen, da der gemeinsame bekannte Speicherort sie nicht auflistet. Bei der Planung einer Bereitstellung mit mehreren Agenten wirkt sich das darauf aus, wie die Erkennung gestaltet und wie Endpunktinformationen an Nutzer weitergegeben werden. Die Dokumentationsseite behandelt Skills, Authentifizierungsdetails oder Card-Signaturen nicht, weshalb diese Aspekte der Card hier nur auf der Ebene der allgemeinen Definition beschrieben werden.

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 Card als Mechanismus dar, über den Agenten ihre Identität und Fähigkeiten bekanntgeben, was Erkennung und Interaktion erleichtert. Dieselbe Episode verknüpft dies mit strukturierter Kommunikation, bei der Agenten verschiedene Datentypen austauschen, was Zusammenarbeit und die Nachverfolgung des Aufgabenstatus unterstützt. Außerdem betont sie, dass Datenschutz- und Sicherheitsfragen in der Kommunikation zwischen Agenten zentral sind und dass alle, die mit solchen Systemen arbeiten, die mit dem Umgang mit Daten verbundenen Risiken kennen sollten. Da eine Agent Card Informationen über einen Agenten und darüber veröffentlicht, wie er erreichbar ist, gehört die Entscheidung darüber, was enthalten ist und wie der Zugriff kontrolliert wird, zu dieser übergeordneten Sicherheitsbetrachtung.

Zusammengefasst dient die Agent Card als öffentliche Beschreibung eines A2A-Agenten. Sie wird von Clients gelesen, bevor eine Aufgabe gesendet wird, sie wird von einem vorhersehbaren Ort aus bereitgestellt, und sie sollte im Produktivbetrieb vollständig und korrekt sein. Die Einschränkung auf eine Card pro bekanntem Pfad im Beispiel für das Hosting mit ASP.NET Core ist ein Gestaltungspunkt, den man berücksichtigen muss, sobald mehr als ein Agent über denselben Host bereitgestellt wird.

Überblick, mit KI aus M365.FM-Folgen und den Fakten dieser Seite zusammengestellt. Du kannst ihn unten über „Bearbeiten“ verbessern.

TypKonzept
ArtFormat

Häufige Fragen

Mit KI markierte Fragen wurden mit KI aus den Fakten dieser Seite geschrieben.

Was ist eine Agent Card im A2A-Protokoll? (KI)

Es ist ein maschinenlesbares Dokument, das unter einer bekannten URL veröffentlicht wird und den Namen, die Fähigkeiten, Skills, Endpunkt, Authentifizierungsanforderungen sowie Ein- und Ausgabeformate eines Agenten beschreibt, damit andere Agenten ihn finden können.

Wo wird die Agent Card im Beispiel des Microsoft Agent Framework bereitgestellt? (KI)

Im Beispiel für das Hosting mit ASP.NET Core wird sie unter einem bekannten Pfad bereitgestellt, der auf agent-card.json endet, mit einer Zuordnungsmethode aus dem A2A-SDK-Paket und nicht aus den Hosting-Paketen des Agent Framework.

Kann ein Host mehrere Agent Cards veröffentlichen? (KI)

Laut der Microsoft-Learn-Seite kann ein einzelner Host nur eine Agent Card 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.

Glossar

Community-Wiki

Oben die Kurzinfo, unten das Wissen der Community: ergänze praktische Tipps, Beispiele oder Korrekturen. Neue Beiträge werden zuerst geprüft, bewährte Mitglieder veröffentlichen direkt.

Experten und Firmen zu diesem Thema

Dieses Thema hat noch niemand im Profil angegeben. Trag es in deinem Profil ein.

Gepflegt von Mirko Peters (Microsoft MVP) · Zuletzt aktualisiert: