Saltar al contenido principal
Ejecuta un agente de Go que responde a una pregunta operativa llamando a una herramienta local de estado, dentro de un único servicio y sin un sistema de trabajos. Al terminar tendrás un main.go que imprime una respuesta breve sobre la latencia actual de los proveedores. La herramienta devuelve datos de ejemplo fijos, así que el programa es ilustrativo; sustitúyela por tu propia llamada de estado o métricas. Encaja en un servicio de Go cuyo contexto ya existe como llamadas locales o internas.

Créalo

1

Instala

El módulo principal sdk-go/v3 se instala con él. Consulta los requisitos en Instalación del Agent SDK de Go.
2

Escribe el agente

main.go
3

Ejecútalo

Comprueba que funciona

  • El programa imprime completed y después una respuesta que menciona la latencia degradada en una ruta de proveedor.
  • En Ajustes → Uso → Registros, el primer turno del modelo muestra una llamada a la herramienta read-status.
  • Sin PHASEO_API_KEY, CreateGatewayAgentClient devuelve PHASEO_API_KEY is required.

Antes de pasar a producción

En el SDK de Go, MaxSteps vale 8 de forma predeterminada; ajústalo al número más pequeño que complete el trabajo. Cuando una herramienta reciba argumentos, dale un esquema Parameters y un validador InputSchema que devuelva un error ante cualquier cosa inesperada, porque los argumentos vienen del modelo. Mantén las herramientas en solo lectura salvo que una persona apruebe la llamada (RequireApproval: true). La referencia del Agent SDK de Go explica las aprobaciones, el estado y el streaming, y grounding con web fetch muestra cómo leer una página conocida en lugar de usar una herramienta local.
Última modificación el 5 de noviembre de 2026