M365Con 2027 – gratis online conferentie · 11–22 Jan 2027 · 120 sessions m365con.net

Agent card

Concept

In het A2A-protocol is een agentkaart een machineleesbaar document dat op een bekende URL wordt gepubliceerd en de naam, mogelijkheden, vaardigheden, eindpunt, authenticatievereisten en invoer- en uitvoerformaten van een agent beschrijft, zodat andere agents deze kunnen vinden.

✦ CONCEPTAgent cardM365.FM
Titelafbeelding: Agentkaart (Concept)

Ook besproken

Afleveringen over Agent card gaan ook over Microsoft Purview Information Barriers, Context window, Front matter, Agent kill switch, AI red teaming en AI Center of Excellence.

Beschrijving

Een agentkaart is een machineleesbaar document dat wordt gebruikt in het Agent2Agent (A2A)-protocol om een agent te beschrijven. Het wordt gepubliceerd op een bekende URL en bevat metadata zoals de naam van de agent, de beschrijving, de versie, de mogelijkheden, de vaardigheden, het eindpunt, de authenticatievereisten en de invoer- en uitvoerformaten die de agent ondersteunt. Het belangrijkste doel is ontdekking: een client of een andere agent kan de kaart lezen om te weten wat een agent aanbiedt, voordat er een verzoek naar wordt gestuurd.

Het A2A-protocol richt zich op interoperabiliteit tussen agents door in te zetten op een gestandaardiseerde taal, waardoor er voor elke interactie tussen agents geen maatwerkcode nodig is. De agentkaart is het onderdeel van die aanpak waarmee een agent zijn identiteit en mogelijkheden kan adverteren. In plaats van aannames over een externe agent hard te coderen, leest een aanroepende agent de gepubliceerde kaart en bepaalt hij hoe de agent bereikt kan worden en welke soorten gegevens hij kan uitwisselen.

De Microsoft Learn-pagina over A2A-hosting in het Microsoft Agent Framework laat zien hoe dit er in de praktijk uitziet. In het ASP.NET Core-hostingvoorbeeld wordt de kaart aangeboden op een bekend pad dat eindigt op agent-card.json. De mappingmethode die de kaart beschikbaar stelt, komt uit het A2A SDK-pakket en niet uit de hostingpakketten van het Agent Framework. De voorbeeldkaart stelt een naam, een beschrijving en een versie in, standaard invoer- en uitvoermodi, en een ondersteunde interface met een URL, een protocolbinding en een protocolversie. De pagina raadt aan de kaart voor productiegebruik volledig in te vullen, zodat clients complete informatie krijgen over de agent die ze gaan aanroepen.

Een praktische beperking die in de documentatie wordt beschreven, betreft hosting. Eén host kan slechts één agentkaart publiceren op het bekende pad, wat betekent dat daar maar één agent vindbaar is. Andere agents die naast die host draaien, blijven bereikbaar via hun eigen URL's, maar clients moeten deze eindpunten al kennen, omdat de gedeelde bekende locatie ze niet vermeldt. Bij het plannen van een implementatie met meerdere agents heeft dit invloed op hoe ontdekking wordt ontworpen en hoe eindpuntinformatie met gebruikers wordt gedeeld. De documentatiepagina behandelt vaardigheden, authenticatiedetails of handtekeningen van kaarten niet, dus die aspecten worden hier alleen op het niveau van de algemene definitie beschreven.

De aflevering "Agent-to-Agent (A2A) Communication - Simply Explained" gaat in op het concept als onderdeel van een bredere discussie over interoperabiliteit. Daarin wordt de agentkaart gepresenteerd als het mechanisme waarmee agents hun identiteit en mogelijkheden adverteren, wat ontdekking en interactie makkelijker maakt. Dezelfde aflevering koppelt dit aan gestructureerde communicatie, waarbij agents verschillende soorten gegevens uitwisselen, wat samenwerking en het bijhouden van de taakstatus ondersteunt. Ook benadrukt de aflevering dat privacy- en beveiligingsaspecten centraal staan in communicatie tussen agents, en dat iedereen die met deze systemen werkt zich bewust moet zijn van de risico's rond gegevensverwerking. Omdat een agentkaart informatie over een agent en de manier waarop die bereikt kan worden publiceert, maakt het bepalen van wat erin wordt opgenomen en hoe de toegang wordt beheerd deel uit van die bredere beveiligingsoverweging.

Samengevat fungeert de agentkaart als de openbare beschrijving van een A2A-agent. Clients lezen haar voordat er een taak wordt verstuurd, ze wordt aangeboden vanaf een voorspelbare locatie, en ze moet in productie compleet en accuraat zijn. De beperking van één kaart per bekend pad in het ASP.NET Core-hostingvoorbeeld is een ontwerppunt waar rekening mee gehouden moet worden wanneer meer dan één agent vanaf dezelfde host wordt aangeboden.

Overzicht samengesteld met AI op basis van M365.FM-afleveringen en de feiten op deze pagina. Je kunt het verbeteren met de bewerkknop hieronder.

TypeConcept
SoortFormat

Veelgestelde vragen

Vragen met AI zijn met AI geschreven op basis van de feiten op deze pagina.

Wat is een agentkaart in het A2A-protocol? (AI)

Het is een machineleesbaar document, gepubliceerd op een bekende URL, dat de naam, mogelijkheden, vaardigheden, het eindpunt, de authenticatievereisten en de invoer- en uitvoerformaten van een agent beschrijft, zodat andere agents deze kunnen ontdekken.

Waar wordt de agentkaart aangeboden in het voorbeeld van het Microsoft Agent Framework? (AI)

In het ASP.NET Core-hostingvoorbeeld wordt deze aangeboden op een bekend pad dat eindigt op agent-card.json, met een mappingmethode uit het A2A SDK-pakket en niet uit de hostingpakketten van het Agent Framework.

Kan één host meerdere agentkaarten publiceren? (AI)

Volgens de Microsoft Learn-pagina kan één host slechts één agentkaart publiceren op het bekende pad, dus is daar maar één agent vindbaar; andere agents blijven bereikbaar via hun eigen URL's, die clients al moeten kennen.

Woordenlijst

Community wiki

Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.

Experts en bedrijven voor dit onderwerp

Niemand heeft dit onderwerp nog opgegeven. Voeg het toe aan je profiel.

Beheerd door Mirko Peters (Microsoft MVP) · Laatst bijgewerkt: