Mache deinen Agenten auffindbar
Eine klare Agent Card gibt A2A-Clients einen verlässlichen Ausgangspunkt: wem der Agent gehört, wo er lebt, und welche Protokollbindungen und Versionen er spricht.
Was ein Agent Card Generator für deinen KI-Agenten erstellt
Eine Agent Card ist die öffentliche Schnittstellenbeschreibung eines A2A-Agenten. Bevor ein anderer Agent entscheiden kann, ob er deinen Dienst aufruft, braucht er mehr als eine URL: eine verlässliche Darstellung des Zwecks, des technischen Vertrags, der Skills und der Zugriffsanforderungen des Agenten.
Dieser Agent Card Generator wandelt diese Implementierungsdetails in lesbares, A2A-v1.0-förmiges JSON um und hält die Entscheidungsfindung dabei nah am Formular. Verwende ihn, nachdem du die Kernlogik des Agenten gebaut hast und bevor du ihn bereitstellst oder listest — genau dort, wo eine handgeschriebene JSON-Datei normalerweise bricht.
Beschreibe eine nutzbare Schnittstelle
Erfasse die bevorzugte Schnittstelle, Content-Modi, Streaming-Verhalten und Push-Notification-Unterstützung, die ein anderer Agent vor einem Aufruf benötigt.
Setze Erwartungen für den Zugriff
Dokumentiere, ob der Dienst öffentlich ist, einen API-Schlüssel verwendet oder OAuth 2.0 erfordert, damit Integrationen den richtigen Authentifizierungsablauf wählen können — ohne jemals ein Credential in die Agent Card zu setzen.
Verwandle Skills in klare Verträge
Benenne die Arbeit, die dein Agent leisten kann, füge die von v1.0 geforderten Tags sowie nützliche Beispiele hinzu, und mache seine Grenzen für Menschen, Marketplaces und KI-Clients verständlich.
So funktioniert der Agent Card Generator
Von Servicedetails zu einer veröffentlichungsfertigen Agent Card
Der Agent Card Generator wandelt Servicedetails in ein klares, veröffentlichungsfertiges JSON-Dokument um. Folge diesem kurzen Workflow, bevor du die Agent Card in Produktion schickst.
- 1
Beginne mit dem echten Dienst
Füge den öffentlichen A2A-Endpunkt, die Protokollbindung, Anbieterdetails, die Agentenversion und die Content-Typen hinzu, die dein Server akzeptiert und zurückgibt.
- 2
Definiere Capability- und Skill-Grenzen
Wähle nur die Capabilities aus, die deine Implementierung unterstützt, und beschreibe dann einen repräsentativen Skill in klarer, konkreter Sprache.
- 3
Überprüfe das generierte JSON
Nutze die Live-Vorschau, um fehlende Felder, Platzhalter-URLs oder Beschreibungen zu erkennen, die den bereitgestellten Dienst nicht genau widerspiegeln.
- 4
Validieren und veröffentlichen
Lasse die Agent Card durch den Validator laufen und platziere das geprüfte Dokument dann unter /.well-known/agent-card.json auf deiner Service-Domain.
Wer den Agent Card Generator nutzt
Gemacht für alle, die Agent Cards erstellen, veröffentlichen oder prüfen
Der Agent Card Generator hilft Entwicklern, Plattformteams und Prüfern, konsistente A2A-Agentenmetadaten zu erstellen, ohne bei einer leeren JSON-Datei zu beginnen.
KI- und unabhängige Entwickler
Ersetze eine handgeschriebene agent-card.json beim Start eines A2A-kompatiblen Agenten durch einen vollständigen, spezifikationsgerechten Ausgangspunkt.
Prompt-Engineers und Produktmanager
Entwerfe ein glaubwürdiges Discovery-Dokument aus einer Servicebeschreibung, ohne JSON-Syntax anzufassen, und übergib es dann zur Prüfung an die Entwicklung.
Plattform- und DevOps-Teams
Standardisiere, wie interne Agenten Endpunkte, Auth und Skills beschreiben, bevor sie in einen Unternehmens-Agentenkatalog oder eine CI-Pipeline gelangen.
Marketplace-Publisher
Bereite Anbietermetadaten, Skill-Tags und Sicherheitsangaben vor, die Prüfer und Ranking-Systeme tatsächlich parsen können.
FAQ
Fragen zum Agent Card Generator
Bring die Grundlagen in Ordnung, bevor ein A2A-Client deinen Endpunkt findet.
Was ist eine A2A Agent Card?
Eine A2A Agent Card ist ein JSON-Discovery-Dokument für einen KI-Agenten. Sie kommuniziert Identität, Anbieterinformationen, unterstützte Schnittstellen, Capabilities, Skills, akzeptierte Content-Modi und Sicherheitsanforderungen an potenzielle Clients — das Agent-zu-Agent-Äquivalent aus README plus API-Überblick.
Warum einen Agent Card Generator statt JSON von Hand zu schreiben verwenden?
Handgeschriebene Agent Card fehlen regelmäßig erforderliche Felder, verwenden Feldnamen von vor v1.0 oder enthalten Syntaxfehler. Der Generator erzeugt die aktuelle A2A-v1.0-Form — supportedInterfaces, provider.organization, erforderliche Skill-Tags — und validiert während der Eingabe, sodass strukturelle Fehler nie in die Produktion gelangen.
Welche A2A-Version zielt die generierte Agent Card an?
Der Generator gibt die A2A-v1.0-Struktur aus: ein geordnetes supportedInterfaces-Array mit protocolBinding und protocolVersion pro Schnittstelle, eine Agentenversion auf oberster Ebene, und capabilities einschließlich extendedAgentCard. Agent Card mit url- oder preferredTransport-Feldern auf oberster Ebene sind vor v1.0.
Muss generiertes JSON vor der Produktion geprüft werden?
Ja. Der Generator erstellt ein praktisches Ausgangsdokument, keinen Ersatz für deinen bereitgestellten Vertrag. Bestätige, dass Endpunkte, Protokollbindungen, Skills und Authentifizierung mit dem Dienst übereinstimmen, den Nutzer tatsächlich erreichen werden.
Wo veröffentliche ich eine Agent Card?
Veröffentliche das geprüfte JSON auf derselben Domain wie deinen A2A-Dienst unter https://deine-domain/.well-known/agent-card.json, dem well-known Pfad, der von der A2A-Spezifikation registriert wird. Viele ältere Integrationen prüfen auch /.well-known/agent.json, daher ist es eine sichere Übergangsstrategie, beide bereitzustellen.
Bereit zur Veröffentlichung
Kehre vor der Veröffentlichung zum Agent Card Generator zurück.
Vervollständige die Details, überprüfe das generierte JSON, und nutze die Live-Validierung, bevor du deine Agent Card veröffentlichst.