- 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 comosupport-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
2. Defina um contrato de triagem restrito
3. Crie o agente orientado por preset
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
6. Trate falhas do gateway como eventos operacionais
Não oculte falhas ignorando-as dentro da cadeia de callbacks do agente. Em vez disso, captureAgentGatewayError explicitamente:
- deixe o runtime persistir o estado
failedda execução e das etapas - Em fluxos de recuperação posteriores, inspecione
loaded.run.errorDetailsouloaded.steps[n].errorDetailsquando a exceção original não estiver mais na memória - 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
- 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