Die Agent Card

Discovery ist ein GET-Request. Jede Praxis stellt eine A2A Agent Card bereit, die jedem Agenten sagt, was hier möglich ist und wo gesprochen wird:

GET /api/a2a/{public-token}/agent-card.json

Live-Beispiel, sofort aufrufbar: https://www.founderexecute.com/api/a2a/a2a_4adce6dd8c149abd94d885bbe7a32323cfc9745edfa53b8e/agent-card.json

Die Antwort:

{
  "protocolVersion": "0.2.6",
  "name": "Founder Execute Physio — AI Reception",
  "description": "Termine bei Founder Execute Physio buchen, verschieben oder absagen, im Gespräch mit der KI-Rezeption. Die Identität wird per SMS-Code an das Telefon des Patienten verifiziert.",
  "url": "https://<ihre-domain>/api/a2a/{public-token}",
  "version": "1.0.0",
  "capabilities": { "streaming": false, "pushNotifications": false },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain"],
  "skills": [
    {
      "id": "reception",
      "name": "Appointment reception",
      "description": "Konversationaler Empfang: Verfügbarkeit finden, Termine buchen und (mit SMS-Verifizierung) bestehende Termine verschieben oder absagen.",
      "tags": ["healthcare", "appointments", "booking", "reception"],
      "examples": ["Buch mir einen Termin bei Founder Execute Physio am Donnerstagnachmittag"]
    }
  ]
}

Worauf es ankommt

• Ein Skill. Die Rezeption ist konversational, kein Katalog starrer Operationen. Agenten können Gespräche gut; 40-Felder-Formulare können sie schlecht.
• Das Token scoped die Praxis, sonst nichts. Es ist bewusst öffentlich, wie eine Telefonnummer. Die Identität des Patienten entsteht später, im Gespräch, per SMS-Code.
• Kein Streaming. capabilities.streaming ist false; Anfragen bekommen einfache JSON-Antworten. Das hält jeden Serverless- und Firmen-Client glücklich.
• Die Card ist White-Label. Name und Beschreibung tragen die Praxis, ausgeliefert von der Domain Ihrer Plattform. Wir tauchen nirgends auf.

Jede Praxis bekommt zusätzlich einen menschenlesbaren Landing-Link (eine Seite für QR-Code oder Website-Button), dessen Metadaten-Endpunkt dieselben Konnektor-URLs liefert:

GET /api/a2a/link/{slug}
→ { "practiceName", "enabled", "connectorUrl", "a2aUrl", "agentCardUrl" }