Cómo usar un agente

Usa el SDK de Agent Platform

Cuando se usa el SDK de Agent Platform, el código para consultar un agente es el mismo independientemente de si se ejecuta de forma local o remota. Como el conjunto de operaciones admitidas varía según los frameworks, proporcionamos instrucciones de uso para las plantillas específicas del framework:

Framework Descripción
Kit de desarrollo de agentes Diseñado según las prácticas recomendadas internas de Google para desarrolladores que crean aplicaciones de IA o equipos que necesitan crear prototipos y, luego, implementar rápidamente soluciones sólidas basadas en agentes
Agent2Agent (versión preliminar) El protocolo Agent2Agent (A2A) es un estándar abierto diseñado para permitir la comunicación y la colaboración sin problemas entre agentes de IA.
LangChain Es más fácil de usar para casos de uso básicos debido a sus configuraciones y abstracciones predefinidas.
LangGraph Es un enfoque basado en grafos para definir flujos de trabajo, con capacidades avanzadas de interacción humana y de rebobinado/repetición.
AG2 (antes AutoGen) AG2 proporciona un framework de conversación de varios agentes como una abstracción de alto nivel para crear flujos de trabajo de LLM.
LlamaIndex (versión preliminar) La canalización de consultas de LlamaIndex ofrece una interfaz de alto nivel para crear flujos de trabajo de generación mejorada por recuperación (RAG).
Personalizado Agentes que se desarrollaron y se implementaron sin el uso de una plantilla específica del framework
Contrato de tiempo de ejecución Especificación de la API de HTTP para agentes personalizados basados en contenedores

Usa agentes que se publican en localhost

Si publicas agentes a través de un servidor de API que escucha solicitudes en http://localhost:PORT_NUMBER, enviarás solicitudes a

http://localhost:PORT_NUMBER/API_PATH

donde

  • PORT_NUMBER es el número de puerto en el que escucha el servidor (p. ej., 8080).
  • API_PATH es la ruta de acceso del extremo de API correspondiente (como run o run_sse).

Usa agentes implementados a través de su API subyacente

Si implementaste un agente, entonces enviarás solicitudes al extremo correspondiente:

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

donde

  • PROJECT_ID es el Google Cloud ID del proyecto en el que implementaste el agente.
  • LOCATION es la región en la que se implementa el agente.
  • RESOURCE_ID es el ID del agente implementado como un reasoningEngine recurso
  • API_PATH es la ruta del extremo de API correspondiente.

Este extremo equivale a reemplazar la URL base de localhost por la URL base del agente implementado. Si implementas un contenedor personalizado, los extremos de API y las estructuras de solicitud y respuesta se definen mediante el contrato de tiempo de ejecución.

Para dar algunos ejemplos, si implementaste el servidor de API del ADK desde un Dockerfile o una imagen de contenedor, invoca los extremos de API de la siguiente manera:

Ejecuta el agente (respuesta única) 

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?"}]
  }
}'

Ejecuta el agente (transmisión) 

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
}'

Usa agentes implementados en la Google Cloud consola

Para los agentes implementados desarrollados con el Kit de desarrollo de agentes (ADK), puedes usar la Google Cloud consola para interactuar con tu agente:

  1. En la Google Cloud consola, ve a la página Deployments de Agent Platform.

    Ir a Agent Platform Deployments

    Los tiempos de ejecución que forman parte del proyecto seleccionado aparecen en la lista. Puedes usar el campo Filter para filtrar la lista por la columna especificada.

  2. Haz clic en el nombre de tu tiempo de ejecución.

  3. Haz clic en la pestaña Playground.

  4. Puedes escribir un mensaje para interactuar con tu agente y hacer clic en New Session para iniciar una nueva sesión con tu agente.

  5. Si habilitaste seguimientos a través de OpenTelemetry, puedes ver detalles sobre el comportamiento de tu agente durante tus interacciones:

    • Trace: Seguimientos de tus conversaciones con el agente

    • Evento: Un gráfico de las APIs invocadas y los detalles de los eventos durante tus conversaciones con el agente.

    • Estado: Información sobre el estado de tu agente durante tus conversaciones.

    • Sessions: Una lista de sesiones asociadas con tu agente (para obtener más información, consulta Administra con la Google Cloud consola o las llamadas a la API )

Compatibilidad con Playground

Puedes usar los siguientes frameworks para probar tu agente:

Framework Chatear con un agente Ver sesiones
Kit de desarrollo de agentes (ADK) Admitido Compatible. Requiere que el agente implemente sesiones de Agent Platform para la persistencia.
Agent2Agent (A2A) Compatible. Requiere que el agente implemente sesiones de Agent Platform para la persistencia. Compatible. Requiere que el agente use sesiones de Agent Platform y que el agente deba enviar el valor user_id como parte del objeto de contexto (para obtener un ejemplo de cómo pasar el valor user_id como parte del ejecutor del agente, consulta el notebook Comienza a usar A2A )

¿Qué sigue?