Registre des agents — découverte, enregistrement et invocation à distance

Le Registre des agents est le pilier Gouvernance de Gemini Enterprise Agent Platform : un catalogue d’agents, de serveurs MCP et de points de terminaison associé à un projet. ADK-Rust intervient de trois manières.

Remarque : ces fonctionnalités n’ont aucun rapport avec la fonctionnalité locale YAML agent-registry sur adk-server, et l’Agent Registry (serveurs/points de terminaison agents/MCP) est un service de plateforme différent du Skill Registry (packages SKILL.md — voir docs/official_docs/skills/skill-registry.md).

Enregistrement automatique ou manuel

Les déploiements Agent Engine s’enregistrent eux-mêmes : la création d’un moteur (par exemple avec adk-rust deploy agent-engine) l’ajoute au registre et maintient la synchronisation de son cycle de vie. Ne l’enregistrez pas à nouveau : une entrée manuelle créerait un doublon sous un autre espace de noms URN.

L’enregistrement manuel existe pour tout le reste, et c’est ce que couvre CLI :

# A self-hosted adk-server agent, described by its A2A agent card
adk-rust registry register-agent --service-id my-agent --card agent-card.json

# An external MCP server (you supply the tools/list payload; no introspection)
adk-rust registry register-mcp --service-id my-mcp --tool-spec tools-list.json \
  --url https://mcp.example.com/rpc

# A bare governed endpoint
adk-rust registry register-endpoint --service-id my-api --url https://api.example.com/v1

# Discovery
adk-rust registry search "travel planner" --type agent

Toutes les commandes utilisent --project/--location (avec repli sur GOOGLE_CLOUD_PROJECT/GOOGLE_CLOUD_LOCATION) et sont idempotentes : réenregistrer un ID de service existant ne modifie que les champs changés et n’effectue aucune écriture lorsque rien n’a changé. Les entrées manuelles ne sont pas synchronisées avec le cycle de vie : leur mise à jour ou leur suppression reste sous votre responsabilité. Les multi-régions us/eu ne prennent pas en charge l’enregistrement manuel ; utilisez une région ou global.

Découvrir des agents depuis un agent

AgentSearchTool fournit une recherche dans le registre LlmAgent sous la forme d’un outil ordinaire en lecture seule :

use adk_tool::{AgentRegistryClient, AgentRegistryConfig, AgentSearchTool};
use std::sync::Arc;

# fn build() -> adk_core::Result<()> {
let registry = AgentRegistryClient::new_with_adc(
    AgentRegistryConfig::new("my-project", "us-central1"),
)?;
let search_tool = Arc::new(AgentSearchTool::new(Arc::new(registry)));
# let _ = search_tool;
# Ok(())
# }

L’outil renvoie des récapitulatifs {urn, displayName, description, skills, endpoint} pour les agents, les serveurs MCP ou les points de terminaison.

Déléguer à un moteur déployé

RemoteReasoningEngineAgent transforme tout Agent Engine déployé en sous-agent ordinaire : il transmet le tour via reasoningEngines:streamQuery et renvoie les événements distants sous forme d’événements ADK :

use adk_server::agent_engine::remote::RemoteReasoningEngineAgent;

# async fn build() -> adk_core::Result<()> {
let remote = RemoteReasoningEngineAgent::builder("specialist")
    .resource_name("projects/my-project/locations/us-central1/reasoningEngines/4242")
    .build()
    .await?;
# let _ = remote;
# Ok(())
# }

Les moteurs peuvent également être adressés par une URN du registre (.urn(...) plus .registry(...)) ; le nom de la ressource est résolu à partir de la référence d’exécution de l’entrée. La méthode de classe par défaut est streaming_agent_run_with_events, avec un repli ponctuel sur stream_query pour les moteurs qui ne sont pas ADK.

Voir examples/agent_orchestrator pour le modèle complet — recherche dans le registre et délégation distante au sein d’un même orchestrateur.

Tout activer

[dependencies]
adk-rust = { version = "2.1.0", features = ["minimal", "gemini-agent-platform"] }

La méta-fonctionnalité gemini-agent-platform inclut vertex-agent-registry et vertex-remote-engine ainsi que toutes les autres intégrations de la plateforme.