AgentCard

Die AgentCard enthält wichtige Informationen zu einem Remote-KI-Agenten. Es handelt sich um eine gekürzte Version der AgentCard, die im A2A-Protokoll definiert ist: https://a2a-protocol.org/dev/specification/#441-agentcard.

JSON-Darstellung 
{
  "name": string,
  "description": string,
  "supportedInterfaces": [
    {
      object (AgentInterface)
    }
  ],
  "version": string,
  "skills": [
    {
      object (AgentSkill)
    }
  ]
}
Felder
name

string

Erforderlich. Ein menschenlesbarer Name für den KI-Agenten.
description

string

Erforderlich. Eine Beschreibung des Handlungsbereichs/Lösungsraums des KI-Agenten.
supportedInterfaces[]

object (AgentInterface)

Erforderlich. Geordnete Liste der unterstützten Schnittstellen. Der erste Eintrag wird bevorzugt.
version

string

Erforderlich. Die Version des KI-Agenten.
skills[]

object (AgentSkill)

Erforderlich. Skills stellen eine Einheit von Fähigkeiten dar, die ein Agent ausführen kann. Das ist vielleicht etwas abstrakt, aber es handelt sich um eine gezieltere Reihe von Aktionen, bei denen der Agent mit hoher Wahrscheinlichkeit erfolgreich sein wird.

AgentInterface

Deklariert eine Kombination aus Ziel-URL, Transport und Protokollversion für die Interaktion mit dem Agent. So können Agenten dieselbe Funktionalität über mehrere Protokollbindungsmechanismen hinweg verfügbar machen.

JSON-Darstellung 
{
  "url": string,
  "protocolBinding": string,
  "tenant": string,
  "protocolVersion": string
}
Felder
url

string

Erforderlich. Die URL, unter der diese Schnittstelle verfügbar ist. Muss eine gültige absolute HTTPS-URL in der Produktion sein. Beispiel: „https://api.beispiel.de/a2a/v1“, „https://grpc.beispiel.de/a2a“
protocolBinding

string

Erforderlich. Die an dieser URL unterstützte Protokollbindung. Dies ist ein offener Formularstring, der sich leicht für andere Protokollbindungen erweitern lässt. Die offiziell unterstützten Kern-APIs sind JSONRPC, GRPC und HTTP+JSON.
tenant

string

Die Mandanten-ID, die in der Anfrage verwendet werden soll, wenn der Agent aufgerufen wird.
protocolVersion

string

Erforderlich. Die Version des A2A-Protokolls, das von dieser Schnittstelle bereitgestellt wird. Verwenden Sie die neueste unterstützte Nebenversion pro Hauptversion. Beispiele: „0.3“, „1.0“

AgentSkill

Stellt eine bestimmte Funktion dar, die ein Agent ausführen kann.

JSON-Darstellung 
{
  "id": string,
  "name": string,
  "description": string,
  "tags": [
    string
  ],
  "examples": [
    string
  ],
  "inputModes": [
    string
  ],
  "outputModes": [
    string
  ]
}
Felder
id

string

Erforderlich. Eine eindeutige Kennung für die Funktion des KI-Agenten.
name

string

Erforderlich. Ein menschenlesbarer Name für den Skill.
description

string

Erforderlich. Eine detaillierte Beschreibung des Skills.
tags[]

string

Erforderlich. Eine Reihe von Keywords, die die Fähigkeiten des Skills beschreiben.
examples[]

string

Beispiel-Prompts oder ‑Szenarien, die diese Skill verarbeiten kann.
inputModes[]

string

Die Menge der unterstützten Eingabemedientypen für diesen Skill, die die Standardeinstellungen des Agenten überschreiben.
outputModes[]

string

Die Menge der unterstützten Ausgabemedientypen für diesen Skill, die die Standardeinstellungen des Agenten überschreiben.