Maak je agent vindbaar
Een duidelijke Agent Card geeft A2A-clients een betrouwbaar startpunt: van wie de agent is, waar deze zich bevindt, en welke protocolbindingen en versies deze spreekt.
Wat een Agent Card generator creëert voor jouw AI-agent
Een Agent Card is de publieke interfacebeschrijving van een A2A-agent. Voordat een andere agent kan beslissen of hij jouw service moet aanroepen, heeft hij meer nodig dan een URL: hij heeft een betrouwbaar overzicht nodig van het doel van de agent, het technische contract, de skills en de toegangsvereisten.
Deze Agent Card generator zet die implementatiedetails om in leesbaar JSON in A2A v1.0-vorm, terwijl de besluitvorming dicht bij het formulier blijft. Gebruik het nadat je de kernlogica van de agent hebt gebouwd en voordat je deze implementeert of vermeldt — het punt waarop een handgeschreven JSON-bestand meestal breekt.
Beschrijf een bruikbare interface
Leg de voorkeursinterface, contentmodi, streaminggedrag en ondersteuning voor pushmeldingen vast die een andere agent nodig heeft voordat deze een aanroep doet.
Stel verwachtingen voor toegang vast
Documenteer of de service openbaar is, een API-sleutel gebruikt, of OAuth 2.0 vereist, zodat integraties de juiste authenticatieflow kunnen kiezen — zonder ooit een credential in de Agent Card te plaatsen.
Maak van skills duidelijke contracten
Benoem het werk dat jouw agent kan uitvoeren, voeg de tags toe die v1.0 vereist plus nuttige voorbeelden, en maak de grenzen ervan begrijpelijk voor mensen, marketplaces en AI-clients.
Hoe de Agent Card Generator werkt
Van servicedetails naar een publiceerbare Agent Card
De Agent Card Generator zet servicedetails om in een duidelijk, publiceerbaar JSON-document. Volg deze korte workflow voordat je de Agent Card naar productie stuurt.
- 1
Begin met de echte service
Voeg het publieke A2A-endpoint, de protocolbinding, providergegevens, de agentversie, en de contenttypes toe die jouw server accepteert en retourneert.
- 2
Definieer capability- en skillgrenzen
Selecteer alleen de capabilities die jouw implementatie ondersteunt, en beschrijf vervolgens één representatieve skill in eenvoudige, specifieke taal.
- 3
Controleer de gegenereerde JSON
Gebruik de live preview om ontbrekende velden, placeholder-URL's of beschrijvingen op te sporen die de geïmplementeerde service niet nauwkeurig weergeven.
- 4
Valideer en publiceer
Laat de Agent Card door de validator lopen en plaats het gecontroleerde document vervolgens op /.well-known/agent-card.json op jouw servicedomein.
Wie gebruikt de Agent Card Generator
Gemaakt voor iedereen die Agent Cards maakt, uitbrengt of beoordeelt
De Agent Card Generator helpt bouwers, platformteams en beoordelaars om consistente A2A-agentmetadata te maken zonder te beginnen bij een leeg JSON-bestand.
AI- en onafhankelijke ontwikkelaars
Vervang een handgeschreven agent-card.json door een compleet, spec-conform startpunt bij het lanceren van een A2A-compatibele agent.
Prompt engineers en productmanagers
Stel een geloofwaardig discovery-document op vanuit een servicebeschrijving zonder JSON-syntax aan te raken, en geef het vervolgens door aan engineering voor beoordeling.
Platform- en DevOps-teams
Standaardiseer hoe interne agents endpoints, authenticatie en skills beschrijven voordat ze een bedrijfsagentcatalogus of CI-pipeline ingaan.
Marketplace-uitgevers
Bereid providermetadata, skilltags en beveiligingsverklaringen voor die beoordelaars en rankingsystemen daadwerkelijk kunnen parseren.
Veelgestelde vragen
Vragen over de Agent Card generator
Zorg dat de essentie klopt voordat een A2A-client jouw endpoint vindt.
Wat is een A2A Agent Card?
Een A2A Agent Card is een JSON-discoverydocument voor een AI-agent. Het communiceert identiteit, providerinformatie, ondersteunde interfaces, capabilities, skills, geaccepteerde contentmodi, en beveiligingsvereisten aan potentiële clients — het agent-tot-agent-equivalent van een README plus een API-overzicht.
Waarom een Agent Card generator gebruiken in plaats van JSON met de hand te schrijven?
Met de hand geschreven Agent Card missen routinematig verplichte velden, gebruiken veldnamen van vóór v1.0, of bevatten syntaxfouten. De generator produceert de huidige A2A v1.0-vorm — supportedInterfaces, provider.organization, verplichte skilltags — en valideert terwijl je typt, zodat structurele fouten nooit productie bereiken.
Op welke A2A-versie richt de gegenereerde Agent Card zich?
De generator produceert de A2A v1.0-structuur: een geordende supportedInterfaces-array met protocolBinding en protocolVersion per interface, een agentversie op het hoogste niveau, en capabilities inclusief extendedAgentCard. Agent Card met url- of preferredTransport-velden op het hoogste niveau zijn van vóór v1.0.
Moet gegenereerde JSON worden beoordeeld voor productie?
Ja. De generator maakt een praktisch startdocument, geen vervanging voor jouw geïmplementeerde contract. Bevestig dat endpoints, protocolbindingen, skills en authenticatie overeenkomen met de service die gebruikers daadwerkelijk zullen bereiken.
Waar publiceer ik een Agent Card?
Publiceer de gecontroleerde JSON op hetzelfde domein als jouw A2A-service op https://jouw-domein/.well-known/agent-card.json, het well-known pad dat is geregistreerd door de A2A-specificatie. Veel oudere integraties controleren ook /.well-known/agent.json, dus beide serveren is een veilige overgangsstrategie.
Klaar om te publiceren
Ga terug naar de Agent Card Generator voordat je publiceert.
Rond de details af, controleer de gegenereerde JSON, en gebruik live validatie voordat je jouw Agent Card publiceert.