Cómo usar un agente

Usa el SDK de Agent Platform

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

Framework Descripción
Kit de desarrollo de agentes (ADK) Se diseñó en función de las prácticas recomendadas internas de Google para desarrolladores que crean aplicaciones de IA o equipos que necesitan crear prototipos e 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 fluidas 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 Enfoque basado en grafos para definir flujos de trabajo, con capacidades avanzadas de intervención humana y retroceso/reproducció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 usar una plantilla específica del framework.
Contrato del entorno de ejecución Especificación de la API de HTTP para agentes basados en contenedores personalizados.

Usa agentes que se publiquen en localhost

Si entregas agentes a través de un servidor de la API que escucha solicitudes en http://localhost:PORT_NUMBER, enviarías 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).

Usar agentes implementados a través de su API subyacente

Si implementaste un agente, enviarías solicitudes al extremo correspondiente:

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

donde

  • PROJECT_ID es el ID del proyecto de Google Cloud 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 recurso reasoningEngine
  • API_PATH es la ruta de acceso 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 la API y las estructuras de solicitud y respuesta se definen mediante el contrato del entorno de ejecución.

Por ejemplo, si implementaste el servidor de la API de ADK desde un Dockerfile o una imagen de contenedor, invoca los endpoints de la 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 consola de Google Cloud

En el caso de los agentes implementados que se desarrollaron con el ADK, puedes usar la consola deGoogle Cloud para interactuar con tu agente:

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

    Ir a Implementaciones de Agent Platform

    Los entornos de ejecución que forman parte del proyecto seleccionado aparecen en la lista. Puedes usar el campo Filtro para filtrar la lista según la columna que especifiques.

  2. Haz clic en el nombre de tu entorno 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 Nueva sesión para iniciar una nueva sesión con tu agente.

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

    • Seguimiento: Seguimientos de tus conversaciones con el agente.

    • Evento: Es 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 las conversaciones.

    • Sesiones: Es una lista de sesiones asociadas con tu agente. Para obtener más información, consulta Administra con la consola de Google Cloud o las llamadas a la API.

Asistencia de Playground

Puedes usar los siguientes frameworks para probar tu agente:

Framework Chatear con un agente Ver sesiones
ADK Admitido Compatible. Requiere que el agente implemente Agent Platform Sessions para la persistencia.
Agent2Agent (A2A) Compatible. Requiere que el agente implemente Agent Platform Sessions para la persistencia. Compatible. Requiere que el agente use sesiones de Agent Platform y que envíe el valor user_id como parte del objeto de contexto. Para ver 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?