Seminar A2A Agent Cards, Discovery und Skill-Verträge

A2A-Agenten werden in Unternehmen erst dann zuverlässig nutzbar, wenn Fähigkeiten eindeutig beschrieben, sicher auffindbar und über stabile Verträge konsumierbar sind. Dieses Seminar konzentriert sich auf die Discovery-Schicht und die Gestaltung aussagekräftiger Agent Cards.

Neben dem Datenmodell werden Freigabeprozesse, Vertrauensgrenzen, Kompatibilitätsregeln und die Einbindung in interne Servicekataloge behandelt. Übungen führen von einer fachlichen Fähigkeit bis zu einer validierten, konsumierbaren Agent Card.

Zielgruppe

• Softwarearchitekten und Plattformarchitekten
• Entwickler von Agentenplattformen und Integrationsdiensten
• API-Management-, IAM- und Governance-Teams
• Technical Product Owner für agentische Anwendungen

Vorkenntnisse

• Grundkenntnisse in HTTP, JSON und API-Design
• Grundverständnis von Authentifizierung und Autorisierung
• Programmiererfahrung ist für die Übungen hilfreich

Seminarinhalte

A2A 1.0 und die Discovery-Schicht

• Rollen von Client Agent, Remote Agent und Enterprise-Plattform
• Abgrenzung von Discovery, Kommunikation, Aufgabenbearbeitung und Werkzeugzugriff
• A2A-1.0-Versionierung je AgentInterface und Auswahl kompatibler Protokollbindungen
• Supported Interfaces für HTTP mit JSON, JSON-RPC und gRPC konsistent beschreiben
• Öffentliche, partnerbezogene und interne Bereitstellung von Agenteninformationen

Agent Cards fachlich und technisch gestalten

• Identität, Beschreibung, Supported Interfaces, Fähigkeiten, Eingabe- und Ausgabemodalitäten
• Security Schemes und Anforderungen an die Anmeldung ohne Geheimnisse in Metadaten
• Skills mit stabilen Kennungen, verständlichen Beschreibungen, Beispielen und Tags
• Extended Agent Cards über die Capability ausweisen und abgestufte Sichtbarkeit umsetzen
• Kanonisierung, JWS-Signaturen, Integritätsprüfung und Vertrauensbewertung

Skill-Verträge und Governance

• Fachliche Vor- und Nachbedingungen sowie zulässige Nebenwirkungen
• Fehlerklassen, Wiederholbarkeit, Idempotenz und Abbruchverhalten
• Schema-Evolution, Deprecation, parallele Versionen und Verbraucherkommunikation
• Freigabeworkflow, Verantwortlichkeiten, Eigentümer und Prüfstatus
• Katalogisierung, Auffindbarkeit, Mandantentrennung und Lebenszyklus

Clientseitige Auswahl und Schutzmaßnahmen

• Validierung von Struktur, Herkunft, Signatur und erlaubten Endpunkten
• Auswahl von Interface, Protokollversion, Erweiterungen und Skill anhand der Anforderungen
• Allowlisting, Vertrauensstufen und Regeln gegen manipulierte Agent Cards
• Caching, Aktualisierung und Verhalten bei nicht kompatiblen Änderungen

Praktische Übungen

• Eine Agent Card für einen internen Fachagenten aus Anforderungen ableiten
• Skills mit Eingaben, Ausgaben, Fehlern und Sicherheitsanforderungen beschreiben
• Eine Agent Card automatisiert gegen Struktur- und Unternehmensregeln prüfen
• Kompatible und inkompatible Änderungen in einer Versionsübung bewerten
• Einen Freigabe- und Vertrauensworkflow für den internen Agentenkatalog entwerfen

Methodik

• Kurze Theorieblöcke mit kommentierten Datenmodellen
• Geführte Konfigurations- und Validierungsübungen
• Architekturentscheidungen anhand eines durchgängigen Unternehmensszenarios
• Review der erstellten Verträge anhand einer Prüfliste