In diesem Dokument werden die wichtigsten Begriffe und Konzepte im Zusammenhang mit der Agent Registry erläutert.
Agent
Ein autonomer Akteur in Ihrem KI-Ökosystem, der durch seine Kennung und die spezifischen Fähigkeiten definiert wird, die er besitzt.
Agent-ID
Ein global eindeutiger, unveränderlicher Name für den Agent. Dieser logische Identifier bietet eine stabile Referenz für Nutzer, um den Agent aufzurufen. Er bleibt unabhängig von Änderungen an der zugrunde liegenden Infrastruktur konstant.
Agent-Kennungen werden während der Aufnahme automatisch von der Agent Registry generiert und folgen einem Uniform Resource Name-Format (URN). Das genaue Format hängt davon ab, wo der Agent bereitgestellt wird. Hier einige Beispiele:
- Vertex AI Agent Engine:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:reasoningEngines:AGENT_ID - Cloud Run-Dienste:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:services:SERVICE_NAME - GKE-Deployments:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:containers:CLUSTER_NAME:namespace:NAMESPACE:deployment:DEPLOYMENT_NAME - Gemini Enterprise:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:discoveryengine:INSTANCE_ID:root - Google Workspace:
urn:agent:googleapis.com:locations:global:workspaceagent:workspaceagent--a2a - Manuell registrierte Agents:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVICE_ID
Agent-Hauptkonto
Die eindeutige IAM-Kennung, die einem Agent zugewiesen wird, damit er Berechtigungen haben und geprüft werden kann. Sie hat die Form eines überprüfbaren Google CloudDienstkontos oder einer verwalteten Arbeitslastidentität, z. B. einer SPIFFE-ID, die an einen Agent oder Server gebunden ist.
Da diese Identität direkt an die Computeressource der Laufzeit des Agents gebunden ist, enthält der Prinzipalstring den genauen Pfad zu dieser zugrunde liegenden Ressource. Ein Agent-Principal für eine Vertex AI Agent Engine-Bereitstellung sieht beispielsweise so aus:
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID
In der Agent Registry wird diese Identität als reines Ausgabeargument angezeigt, wenn Sie die Details eines Agenten aufrufen.
Agentischer Workflow
Eine Abfolge von Schritten, in denen ein KI-Agent unabhängig voneinander die Tool-Nutzung, die Argumentation und die Ausführungspfade zur Erledigung einer Aufgabe bestimmt.
Autorisierungsanbieter
Eine Konfiguration im Authentifizierungsmanager für die Identität von KI-Agenten zum Speichern, Abrufen und Verwalten von Anmeldedaten wie API-Schlüsseln oder OAuth-Tokens, um Ihren Agenten mit bestimmten externen Tools und Anwendungen zu verbinden und den Authentifizierungstyp zu definieren.
Bindung
Eine Verbindung zwischen einem Quell-Agenten und einer Zielressource, z. B. einem anderen Agenten, einem MCP-Server oder einem Endpunkt. Durch das Erstellen von Bindungen stellen Sie explizite Beziehungen her, die es Ihren Orchestrator-Agents ermöglichen, mit Downstream-Funktionen zu interagieren. Bindungen werden auch verwendet, um einen Agent mit einem Authentifizierungsanbieter zu verknüpfen, um delegierte Berechtigungen zu unterstützen.
Datenressource
Ein bestimmter Datenkontext oder ein bestimmter Datensatz, der von einem MCP-Server bereitgestellt wird und auf den ein KI-Agent zugreifen kann, um seine Antworten zu fundieren oder seine Aktionen zu informieren.
Discovery
Der Prozess, bei dem die Registry nach vorhandenen Agents oder MCP-Tools anhand von Beschreibungen, Tags oder Skills durchsucht wird. Die Erkennung nach Fähigkeiten ist für Agenten verfügbar, die ihre Funktionen über eine Agentenkarte offenlegen, z. B. für Agenten, die das Agent2Agent-Protokoll (A2A) implementieren.
Endpunkt
Für die Agent Registry API eine Ressource, die eine Ziel-URL darstellt, in der Regel eine REST API, auf die über einen Agent zugegriffen wird. Durch die Abstraktion dieser Ziele in verwaltbare Ressourcen können Sie mit der Agent Registry zentral steuern, auf welche externen Dienste ein Agent zugreifen kann.
Model Context Protocol (MCP)
Der offene Standard, der verwendet wird, um KI-Modelle mit Datenquellen und Tools zu verbinden. Er ersetzt benutzerdefinierte Plug-ins.
MCP-Server (oder Server)
Ein Dienst, der das Model Context Protocol (MCP) implementiert, um KI-Agents standardisierte Tools und Datenressourcen zur Verfügung zu stellen.
MCP-Server-ID
Ein global eindeutiger, unveränderlicher Uniform Resource Name (URN) für einen MCP-Server. Ähnlich wie bei KI-Agent-Kennungen bietet dieser Name eine stabile Referenz zum Auffinden bestimmter Toolsets.
Das Format hängt davon ab, ob es sich um einen integrierten Google-Dienst oder einen registrierten externen Server handelt. Hier einige Beispiele:
- Google Cloud Remote-MCP-Server:
urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVICE_NAME - Manuell registrierte MCP-Server:
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVICE_ID
Anmeldung
Der Vorgang zum Hinzufügen eines Dienstes zur Registry. Die Agent Registry bietet die folgenden Registrierungsmechanismen:
- Automatische Registrierung: Automatische Aufnahme unterstützter Google CloudArbeitslasten, z. B. in Vertex AI Agent Engine.
- Manuelle Registrierung: Manuelles Onboarding von benutzerdefinierten oder externen Arbeitslasten.
Ressourcen-URI
Der physische Laufzeitspeicherort oder die Infrastruktur, auf der ein KI-Agent oder ein MCP-Server gehostet wird. Der Uniform Resource Identifier (URI) ist die eindeutige Zeichenfolge, die diese Laufzeitressource identifiziert. Ein Ressourcen-URI kann beispielsweise ein Vertex AI-Endpunkt, eine GKE-Bereitstellung oder ein Cloud Run-Dienst sein.
Der Ressourcen-URI unterscheidet sich vom KI-Agent-Identifier oder MCP-Server-Identifier. Diese Werte sind die eindeutigen Namen im URN-Format, mit denen Ihre Agents und MCP-Server in der Registrierung identifiziert werden. Der Ressourcen-URI verweist dagegen auf die tatsächliche Compute-Ressource, auf der der Agent oder Server ausgeführt wird.
Der Pfad zum Ressourcen-URI eines Agents ist in den String agent-Prinzipal eingebettet, um diesen Workload in IAM-Richtlinien eindeutig zu identifizieren.
In der Agent Registry wird dieser URI als reines Ausgabeargument angezeigt, wenn Sie die Details eines KI-Agenten aufrufen.
Mit dem Ressourcen-URI können Sie Abfragen im Topologiegraphen erstellen, um Traffic-Flüsse und Beziehungen für bestimmte Agents zu visualisieren. In der Agent Registry API wird dieser Wert durch das Attribut agentregistry.googleapis.com/system/RuntimeReference dargestellt.
Dienst
Für die Agent Registry API ist das die beschreibbare Ressource, die zum manuellen Registrieren benutzerdefinierter oder externer Arbeitslasten in der Registry verwendet wird. Ein Dienst stellt einen KI-Agenten, einen MCP-Server oder einen Endpunkt dar, der manuell in Ihre Registry aufgenommen wurde. Sie erstellen und verwalten eine Service-Ressource, um den Endpunkt und die Metadaten für Arbeitslasten zu definieren, die nicht automatisch von Agent Registry aufgenommen werden.
Je nach der von Ihnen angegebenen Spezifikation wird dieser Dienst in der Agent Registry automatisch als schreibgeschützte Agent-, McpServer- oder Endpoint-Ressource für die Suche auf der Verbraucherseite projiziert.
Sie verwenden immer die Service-Ressource, um Registrierungseinträge zu erstellen, zu bearbeiten oder zu löschen. Wenn Sie diese Einträge abrufen, auflisten oder danach suchen möchten, fragen Sie jedoch die schreibgeschützten Ressourcen Agent, McpServer oder Endpoint ab.
Skill
Eine Funktion auf hoher Ebene, die ein A2A-Agent bietet. Skills werden aus A2A-Agentenkarten extrahiert und dienen als primäre Datenpunkte für die Ermittlung von Agenten.
Tool
Eine deterministische Funktion, die von einem MCP-Server bereitgestellt wird und die ein KI-Agent aufrufen kann.