Pular para o conteúdo principal
Execute um agente em Ruby que consulta uma nota interna com uma ferramenta local e responde em um parágrafo curto, sem entregar a orquestração a outro sistema. Ao final, você terá um único script que resume sua nota sobre predefinições. A ferramenta retorna dados de exemplo fixos, então o script é ilustrativo; substitua-a por uma consulta ao seu próprio armazenamento de notas. Ele serve para um app Ruby que já é dono dos dados e tem entradas de ferramenta simples e determinísticas.

Crie o agente

1

Instale

Ou adicione gem "phaseo_agent_sdk" ao seu Gemfile. Ele instala o phaseo_sdk junto e precisa do Ruby 3.2 ou mais recente. Veja Instalação do Agent SDK de Ruby.
2

Escreva o agente

notes.rb
3

Execute

Verifique se funcionou

  • O script imprime completed e depois um parágrafo sobre predefinições.
  • Em Configurações → Uso → Registros, o primeiro turno do modelo mostra uma chamada lookup-note com {"topic": "presets"}.

Antes da produção

Mantenha a ferramenta somente leitura e mantenha max_steps tão baixo quanto o trabalho permitir (o padrão é 12). Se o seu armazenamento de notas for grande, retorne apenas o trecho correspondente em vez de documentos inteiros, para que cada turno do modelo continue pequeno. Para salvar execuções e retomá-las depois, veja o loop persistente; a opção state: do SDK de Ruby funciona da mesma forma. A referência do Agent SDK de Ruby cobre estado, aprovação e streaming.
Última modificação em 5 de novembro de 2026