Wenn Sie Agenten oder MCP-Server (Model Context Protocol) manuell in Agent Registry registrieren, indem Sie eine Service-Ressource erstellen, stellen Sie JSON-Konfigurationsdateien bereit, in denen ihre Funktionen deklariert werden. Die Agent Registry validiert diese Dateien anhand von Open-Source-Spezifikationen, bevor sie indexiert werden, damit Nutzer die A2A-Fähigkeiten und MCP-Tools des Agenten finden können. Verwenden Sie die folgenden JSON-Strukturen und Beispiele, um Ihre Agentenkarten und MCP-Tools zu formatieren.
Agentenkarte-Schema
Beim Registrieren eines A2A-konformen KI-Agenten muss die Nutzlast von agent-card.json der offiziellen Agent2Agent-Spezifikation (A2A) entsprechen.
Die maximale Dateigröße für die Spezifikationsdatei beträgt 10 KB.
Die Arrayfelder skills unterstützen den Suchindex für Keywords.
Die Agent Registry unterstützt die Versionen 1.0 und 0.3 der A2A-Agentenkarte. Wählen Sie eine Version aus, um das JSON-Schema und die Felddefinitionen aufzurufen:
Version 1.0 (empfohlen)
Für Version 1.0 von A2A-Agentenkarten muss die Nutzlast der offiziellen A2A-Spezifikation v1.0 entsprechen. In dieser Spezifikation deklarieren Sie Transportendpunkte in einem supportedInterfaces-Array:
{
"name": "string",
"description": "string",
"version": "string",
"supportedInterfaces": [
{
"url": "string",
"protocolBinding": "string",
"protocolVersion": "string",
"tenant": "string"
}
],
"capabilities": {
"streaming": false,
"pushNotifications": false,
"extendedAgentCard": false
},
"defaultInputModes": [
"text/plain"
],
"defaultOutputModes": [
"text/plain"
],
"skills": [
{
"id": "string",
"name": "string",
"description": "string",
"tags": [
"string"
],
"examples": [
"string"
]
}
]
}
Felddefinitionen
name: Der menschenlesbare Name des KI-Agenten.description: Eine allgemeine Zusammenfassung des Zwecks des KI-Agenten.version: die Version des Agenten, z. B.1.0.0.supportedInterfaces: ein Array unterstützter Transport- und URL-Kombinationen. Jede Schnittstelle enthält Folgendes:url: die Endpunkt-URL, über die diese Schnittstelle erreicht wird.protocolBinding: die an dieser URL unterstützte Protokollbindung, z. B.HTTP+JSON,JSONRPCoderGRPC.protocolVersion: die A2A-Protokollversion, die diese Schnittstelle bereitstellt, z. B.1.0.0.tenant(optional): die ID des Agenteninhabers.
capabilities(optional): Gibt unterstützte Betriebsfunktionen an, z. B.:extensions(optional): ein Array von Protokollerweiterungen.streaming(optional): Ein boolescher Wert, der angibt, ob der Agent Streamingantworten unterstützt.pushNotifications(optional): Ein boolescher Wert, der angibt, ob Push-Benachrichtigungen für Aufgabenaktualisierungen unterstützt werden.extendedAgentCard(optional): Ein boolescher Wert, der angibt, ob der Agent nach der Authentifizierung eine erweiterte Agentenkarte bereitstellt.
defaultInputModes(optional): Ein Array von MIME-Typen, die als Eingabe akzeptiert werden.defaultOutputModes(optional): ein Array von MIME-Typen, die als Ausgabe erzeugt werden.skills: ein Array mit beschreibenden A2A-Fähigkeiten, die der Agent besitzt:id: Eine eindeutige programmatische Kennung für den A2A-Skill.name: Ein menschenlesbarer Name für den A2A-Skill.description: eine detaillierte Erklärung der Funktion des A2A-Skills.tags: Ein Array von Keyword-Strings, die zur Kategorisierung des A2A-Skills verwendet werden.examples: Ein Array mit Beispiel-Prompts oder ‑Szenarien, die dieser A2A-Skill verarbeitet.
Version 0.3
Für Version 0.3 der A2A-Agentenkarten muss die Nutzlast der Spezifikation v0.3.0 entsprechen. In dieser Spezifikation werden die primäre Inferenz-URL und die Protokollversion als Felder der obersten Ebene deklariert:
{
"name": "string",
"description": "string",
"version": "string",
"protocolVersion": "string",
"url": "string",
"skills": [
{
"id": "string",
"name": "string",
"description": "string",
"tags": [
"string"
],
"examples": [
"string"
]
}
],
"capabilities": {
"streaming": false,
"pushNotifications": false,
"stateTransitionHistory": false
},
"defaultInputModes": [
"text/plain"
],
"defaultOutputModes": [
"text/plain"
]
}
Felddefinitionen
name: Der menschenlesbare Name des KI-Agenten.description: Eine allgemeine Zusammenfassung des Zwecks des KI-Agenten.version: die Version des Agenten, z. B.1.0.2.protocolVersion: die Version des A2A-Protokolls, die der Agent implementiert. Da dieses Feld auf oberster Ebene in Version1.0verworfen wird, muss der Wert für dieses Schema0.3oder eine beliebige0.3-Patchversion sein, z. B.0.3.1.url: die Endpunkt-URL, unter der der Agent erreichbar ist.capabilities(optional): Ein Objekt, das die unterstützten operativen Funktionen des KI-Agenten angibt, z. B.streaming,pushNotificationsoderstateTransitionHistory.defaultInputModes(optional): Ein Array von Strings, die die Standard-MIME-Typen definieren, die der Agent als Eingabe akzeptiert, z. B.["text/plain"].defaultOutputModes(optional): Ein Array von Strings, die die Standard-MIME-Typen definieren, die der KI-Agent als Ausgabe erzeugt, z. B.["text/plain"].skills: ein Array mit beschreibenden A2A-Fähigkeiten, die der Agent besitzt:id: Eine eindeutige programmatische Kennung für den A2A-Skill.name: Ein menschenlesbarer Name für den A2A-Skill.description: eine detaillierte Erklärung der Funktion des A2A-Skills.tags: Ein Array von Keyword-Strings, die zur Kategorisierung des A2A-Skills verwendet werden.examples: Ein Array mit Beispiel-Prompts oder ‑Szenarien, die dieser A2A-Skill verarbeitet.
MCP-Toolschema
Beim Registrieren eines MCP-Servers muss die Nutzlast von toolspec.json eine Liste von Tools umfassen, die dem Objektschema für MCP-Tool entsprechen.
Die erwartete Nutzlast ist ein JSON-Objekt mit einem einzelnen tools-Feld, genau wie es von der Standard-MCP-Tools- oder Listenanfrage zurückgegeben wird.
Die maximale Dateigröße für diese Spezifikationsdatei beträgt 10 KB.
{
"tools": [
{
"name": "string",
"description": "string",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "string",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true
}
}
]
}
Felddefinitionen
tools: ein Array von Tools, die vom Server bereitgestellt werden:name: die programmatische Kennung für das Tool.description: eine menschenlesbare Erklärung des Zwecks des Tools.inputSchema: Ein JSON-Schemaobjekt, das die erwarteten Parameter für das Tool definiert.annotations: Verhaltenshinweise, die festlegen, wie Orchestrator-Agenten mit dem Tool interagieren:title: ein menschenlesbarer Titel für das Tool.readOnlyHint: Wenntrue, ruft das Tool nur Daten ab und ändert seine Umgebung nicht. Der Standardwert istfalse.destructiveHint: Wenntrue, führt das Tool Vorgänge aus, die zu dauerhaften Änderungen führen können. Der Standardwert isttrue.idempotentHint: Wenntruefestgelegt ist, hat das wiederholte Aufrufen des Tools keine zusätzlichen Auswirkungen. Der Standardwert istfalse.openWorldHint: Wenntrue, interagiert das Tool mit externen Systemen. Der Standardwert isttrue.