Skip to main content
Use esta receita quando um fluxo de suporte precisar:
  • herdar o roteamento e os padrões de prompt de um preset do painel
  • retornar uma saída estruturada estrita
  • pausar casos arriscados para revisão humana
  • manter as falhas do gateway visíveis nos logs em vez de ocultá-las no código do agente

1. Comece com um preset

Crie um preset como support-triage para definir:
  • o modelo roteado padrão ou o destino do roteador
  • preferências de provedor
  • o prompt de sistema do suporte
  • parâmetros de decodificação estáveis
Assim, o código do agente fica focado no controle do fluxo de trabalho, sem duplicar as políticas das solicitações.

2. Defina um contrato de triagem restrito

Mantenha o formato da primeira saída pequeno o suficiente para que a equipe de operação possa inspecioná-lo rapidamente.

3. Crie o agente orientado por preset

O SDK resolve preset: "support-triage" para o formato de alias do gateway @support-triage.

4. Configure o adaptador conectado ao gateway

Use os padrões do adaptador para os elementos que devem permanecer fixos em cada execução da triagem:

5. Execute o fluxo com novas tentativas limitadas

Se a execução pausar para revisão, retome-a explicitamente:

6. Trate falhas do gateway como eventos operacionais

Não oculte falhas ignorando-as dentro da cadeia de callbacks do agente. Em vez disso, capture AgentGatewayError explicitamente:
Depois:
  1. deixe o runtime persistir o estado failed da execução e das etapas
  2. Em fluxos de recuperação posteriores, inspecione loaded.run.errorDetails ou loaded.steps[n].errorDetails quando a exceção original não estiver mais na memória
  3. inspecione os detalhes da solicitação para verificar:
    • aplicação das guardrails
    • detalhes do roteamento
    • execução de plugins
    • IDs das solicitações e dados do provedor
Isso é especialmente importante quando:
  • uma guardrail bloqueia a solicitação
  • a lista de permissões do preset rejeita o modelo solicitado
  • credenciais do provedor ou filtros de ativação removem os candidatos roteados
  • o response healing não consegue recuperar um JSON válido conforme o schema

7. O que verificar

Após uma execução bem-sucedida e outra propositalmente arriscada, confirme:
  • a visualização de detalhes da solicitação mostra o destino definido pelo preset
  • casos de alto risco são pausados em waiting_for_human
  • etapas de modelo repetidas persistem modelAttempts
  • falhas de guardrail ou do preset continuam visíveis nos detalhes da solicitação, sem ficarem ocultas nas exceções do agente

Guias relacionados

Última modificação em 2 de outubro de 2026