Pular para o conteúdo principal
Execute um agente em Go que responde a uma pergunta operacional chamando uma ferramenta local de status, dentro de um único serviço e sem um sistema de jobs. Ao final, você terá um único main.go que imprime uma resposta curta sobre a latência atual dos provedores. A ferramenta retorna dados de exemplo fixos, então o programa é ilustrativo; substitua-a pela sua própria chamada de status ou de métricas. Ele serve para um serviço em Go cujo contexto já existe como chamadas locais ou internas.

Crie o agente

1

Instale

O módulo principal sdk-go/v3 vem junto. Veja Instalação do Agent SDK de Go para os requisitos.
2

Escreva o agente

main.go
3

Execute

Verifique se funcionou

  • O programa imprime completed e depois uma resposta que menciona latência degradada em uma rota de provedor.
  • Em Configurações → Uso → Registros, o primeiro turno do modelo mostra uma chamada à ferramenta read-status.
  • Sem PHASEO_API_KEY, CreateGatewayAgentClient retorna PHASEO_API_KEY is required.

Antes da produção

MaxSteps tem padrão 8 no SDK de Go; defina o menor número que conclua o trabalho. Quando uma ferramenta recebe argumentos, dê a ela um esquema Parameters e um validador InputSchema que retorne erro para qualquer coisa inesperada, porque os argumentos vêm do modelo. Mantenha as ferramentas somente leitura, a menos que uma pessoa aprove a chamada (RequireApproval: true). A referência do Agent SDK de Go cobre aprovações, estado e streaming, e fundamentação com web fetch mostra como ler uma página conhecida em vez de usar uma ferramenta local.
Última modificação em 5 de novembro de 2026