Usa 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 localmente o se implementa de forma remota. Como el conjunto de operaciones admitidas varía según los frameworks, proporcionamos instrucciones de uso para las plantillas específicas de cada framework:

Framework Descripción
Kit de desarrollo de agentes Diseñado según las prácticas recomendadas internas de Google para los desarrolladores que crean aplicaciones basadas en IA o los equipos que necesitan crear prototipos y, luego, implementar rápidamente soluciones sólidas basadas en agentes.
Agent2Agent (vista previa) El protocolo Agent2Agent (A2A) es un estándar abierto diseñado para permitir la comunicación y 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 gráficos para definir flujos de trabajo, con capacidades avanzadas de interacción humana y de retroceso/repetición.
AG2 (anteriormente AutoGen) AG2 proporciona un framework de conversación multiagente 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 Son los agentes que se desarrollaron y se implementaron sin usar una plantilla específica del framework.

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ías solicitudes a

http://localhost:PORT_NUMBER/API_PATH

donde

  • PORT_NUMBER es el número de puerto en el que el servidor está escuchando (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, enviarías 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 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 del extremo de API correspondiente

Este extremo equivale a reemplazar la URL base de localhost por la URL base del agente implementado.

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

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

Ejecutar 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 Kit de desarrollo de agentes (ADK), puedes usar la consola deGoogle Cloud para interactuar con tu agente:

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

    Ir a Implementaciones de Agent Platform

    Los tiempos 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 él.

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

    • Registro: Registros 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: Es la información sobre el estado de tu agente durante las conversaciones.

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

Asistencia para el área de juegos

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 la plataforma del agente para la persistencia.
Agent2Agent (A2A) Compatible. Requiere que el agente implemente sesiones de la plataforma del agente para la persistencia. Compatible. Requiere que el agente use sesiones de la plataforma de agentes y que envíe el valor de user_id como parte del objeto de contexto. Para ver un ejemplo de cómo pasar el valor de user_id como parte del ejecutor del agente, consulta el notebook Comienza a usar A2A.

¿Qué sigue?