Skip to main content
Use os Agent SDKs da Phaseo quando seu aplicativo precisar de mais do que uma geração isolada:
  • loops de ferramentas com várias etapas
  • ferramentas de runtime local
  • turnos de modelo conectados ao gateway
  • estado de execução retomável controlado pelo aplicativo
  • aprovações de chamadas exatas, ferramentas com participação humana, ferramentas manuais e continuação retomável
  • validação em runtime, ferramentas que informam progresso e erros de ferramenta recuperáveis
  • saída de modelo em streaming com consumidores de eventos que podem ser reproduzidos
  • configuração dinâmica de turnos, condições de parada combináveis e uso/custo normalizados
  • novas tentativas de modelo, timeouts de ferramentas, concorrência limitada de ferramentas e eventos do ciclo de vida
  • captura local com o Phaseo Devtools
  • roteamento consistente de solicitações nas mesmas linguagens dos principais SDKs de cliente

​
Linguagens compatíveis

As linguagens atuais do Agent SDK correspondem ao conjunto principal de SDKs de cliente apresentado no início rápido da Phaseo:

​
Modelo comum

Todos os Agent SDKs mantêm o mesmo modelo de runtime:
  • definir um agente
  • definir zero ou mais ferramentas locais
  • criar um cliente de modelo conectado ao gateway
  • executar um loop limitado sobre a API responses
  • inspecionar eventos do ciclo de vida ou um rastreamento do Devtools
  • persistir a execução retornada e retomá-la após uma decisão humana
TypeScript é a referência de design da API. Python, Go, C#, PHP e Ruby expõem o contrato multilíngue mais amplo usando callbacks e primitivas próprias da linguagem para concorrência, timeout e cancelamento. Rust é um runtime síncrono compatível, com ferramentas locais e externas, aprovações por ID exato, revisão humana, novas tentativas de modelo, estado de execução serializável, callbacks de ciclo de vida e agregação de uso. Java e C++ continuam em desenvolvimento.
O Agent SDK de Rust é publicado como phaseo-agent. Ainda não inclui streaming, execução assíncrona, ferramentas locais concorrentes, validação de esquema em runtime nem captura do Devtools.

​
Contrato de recursos entre linguagens

PHP e Ruby expõem eventos de streaming do provedor pelas APIs normais de iteração síncrona. Eles não precisam de um runtime hospedado nem de um serviço da Phaseo em segundo plano.

​
SDK de cliente, Agent SDK e API

Os adaptadores de gateway do Agent SDK delegam os turnos de modelo ao SDK de cliente correspondente. Linguagens com um hook requestOptions ou equivalente podem enviar campos adicionais da API Responses, enquanto o Agent SDK continua responsável por model, input, instructions e pelas ferramentas de função locais. O adaptador Rust 0.1 atualmente envia os campos normalizados do agente sem um hook adicional de opções de solicitação.

​
Receitas

O cookbook inclui fluxos de trabalho em TypeScript e pontos de partida específicos por linguagem:
Última modificação em 2 de outubro de 2026