Utiliser un agent

Utiliser le SDK Agent Platform

Lorsque vous utilisez le SDK Agent Platform, le code permettant d'interroger un agent est le même, qu'il s'exécute localement ou soit déployé à distance. Étant donné que l'ensemble des opérations compatibles varie selon les frameworks, nous fournissons des instructions d'utilisation pour les modèles spécifiques aux frameworks :

Framework Description
Agent Development Kit Conçue sur la base des bonnes pratiques internes de Google pour les développeurs qui créent des applications d'IA ou les équipes qui ont besoin de prototyper et de déployer rapidement des solutions robustes basées sur des agents.
Agent2Agent (aperçu) Le protocole Agent2Agent (A2A) est une norme ouverte conçue pour permettre une communication et une collaboration fluides entre les agents d'IA.
LangChain Plus facile à utiliser pour les cas d'utilisation de base grâce à ses configurations et abstractions prédéfinies.
LangGraph Approche basée sur les graphiques pour définir les workflows, avec des fonctionnalités avancées d'intervention humaine et de retour en arrière/relecture.
AG2 (anciennement AutoGen) AG2 fournit un framework de conversation multi-agents en tant qu'abstraction de haut niveau pour la création de workflows LLM.
LlamaIndex (bêta) Le pipeline de requête de LlamaIndex offre une interface de haut niveau pour créer des workflows de génération augmentée par récupération (RAG).
Personnalisée Agents développés et déployés sans utiliser de modèle spécifique à un framework.

Utiliser des agents diffusés sur localhost

Si vous diffusez des agents via un serveur d'API qui écoute les requêtes sur http://localhost:PORT_NUMBER, vous devez envoyer les requêtes à

http://localhost:PORT_NUMBER/API_PATH

Où :

  • PORT_NUMBER est le numéro de port sur lequel le serveur écoute (par exemple, 8080).
  • API_PATH correspond au chemin d'accès du point de terminaison de l'API correspondant (par exemple, run ou run_sse).

Utiliser des agents déployés via leur API sous-jacente

Si vous avez déployé un agent, vous devez envoyer les requêtes au point de terminaison correspondant :

https://LOCATION-aiplatform.googleapis.com/reasoningEngines/v1/projects/PROJECT_NUMBER/locations/<var>LOCATION</var>/reasoningEngines/RESOURCE_ID/api/API_PATH

Où :

  • PROJECT_ID correspond à l'ID du projet Google Cloud dans lequel vous avez déployé l'agent.
  • LOCATION est la région dans laquelle l'agent est déployé.
  • RESOURCE_ID est l'ID de l'agent déployé en tant que ressource reasoningEngine.
  • API_PATH correspond au chemin d'accès du point de terminaison de l'API.

Ce point de terminaison équivaut à remplacer l'URL de base localhost par l'URL de base de l'agent déployé.

Par exemple, si vous avez déployé le serveur d'API ADK à partir d'un Dockerfile ou d'une image de conteneur, appelez les points de terminaison d'API comme suit :

Exécuter l'agent (réponse unique) 

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/api/run -d '{
  "appName": "my_sample_agent",
  "userId": "u_123",
  "sessionId": "s_abc",
  "newMessage": {
    "role": "user",
    "parts": [{"text": "What is the capital of France?"}]
  }
}'

Exécuter l'agent (streaming) 

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/api/run_sse -d '{
  "appName": "my_sample_agent",
  "userId": "u_123",
  "sessionId": "s_abc",
  "newMessage": {
    "role": "user",
    "parts": [{"text": "What is the weather in New York?"}]
  },
  "streaming": true
}'

Utiliser des agents déployés dans la console Google Cloud

Pour les agents déployés développés à l'aide d'Agent Development Kit (ADK), vous pouvez utiliser la consoleGoogle Cloud pour interagir avec votre agent :

  1. Dans la console Google Cloud , accédez à la page Déploiements de la plate-forme d'agent.

    Accéder aux déploiements Agent Platform

    Les runtimes faisant partie du projet sélectionné apparaissent dans la liste. Vous pouvez utiliser le champ Filtrer pour filtrer la liste en fonction de la colonne spécifiée.

  2. Cliquez sur le nom de votre environnement d'exécution.

  3. Cliquez sur l'onglet Playground.

  4. Vous pouvez saisir un message pour interagir avec votre agent et cliquer sur Nouvelle session pour démarrer une nouvelle session avec votre agent.

  5. Si vous avez activé les traces via OpenTelemetry, vous pouvez afficher des informations sur le comportement de votre agent lors de vos interactions :

    • Trace : traces de vos conversations avec l'agent.

    • Événement : graphique des API appelées et détails des événements lors de vos conversations avec l'agent.

    • État : informations sur l'état de votre agent lors de vos conversations.

    • Sessions : liste des sessions associées à votre agent. Pour en savoir plus, consultez Gérer à l'aide de la console Google Cloud ou des appels d'API.

Assistance Playground

Vous pouvez utiliser les frameworks suivants pour tester votre agent :

Framework Discuter avec un agent Afficher les sessions
Agent Development Kit (ADK) Compatible Compatible L'agent doit implémenter les sessions Agent Platform pour la persistance.
Agent2Agent (A2A) Compatible L'agent doit implémenter les sessions Agent Platform pour la persistance. Compatible L'agent doit utiliser les sessions Agent Platform, et l'agent doit envoyer la valeur user_id dans l'objet de contexte. Pour obtenir un exemple de transmission de la valeur user_id dans l'exécuteur d'agent, consultez le notebook Premiers pas avec A2A.

Étapes suivantes