Pular para o conteúdo principal
Crie um agente de triagem em TypeScript cujo modelo, prompt e regras de provedor vêm de uma predefinição do painel, para que o código cuide apenas do fluxo de trabalho. Ao final, ele retorna uma decisão de triagem em JSON estrito, pausa os casos que precisam de uma pessoa, repete chamadas ao modelo um número limitado de vezes e registra as falhas do gateway com os IDs de que você precisa para encontrá-las. O script está pronto para produção depois que a predefinição existir e você armazenar as execuções pausadas, como no loop persistente. Uma versão empacotada está em packages/sdk/agent-sdk-ts/examples/support-triage-agent.ts.

Crie o agente

1

Crie a predefinição

Em Configurações → Predefinições, crie support-triage com o modelo roteado, as preferências de provedor, o prompt de sistema de suporte e parâmetros de decodificação estáveis. O modelo precisa suportar saída com JSON Schema. Predefinições explica como uma predefinição se combina com cada solicitação.
2

Instale

3

Escreva o agente

triage-agent.ts
4

Execute

Para concluir um caso pausado, continue-o com a decisão do revisor:

Verifique se funcionou

Execute um ticket rotineiro e um arriscado e depois confira:
  • Em Configurações → Uso → Registros, o modelo da solicitação mostra que a predefinição foi usada.
  • O caso arriscado termina em waiting_for_human, com a decisão em pause.payload.
  • Uma chamada ao modelo repetida fica registrada na etapa como modelAttempts, e cada nova tentativa registra model.retrying.
  • Uma solicitação bloqueada é registrada com seu requestId e reason, e a mesma solicitação nos registros mostra o motivo.

Mantenha as falhas do gateway visíveis

Não engula erros dentro dos callbacks do agente. Capture AgentGatewayError na borda, registre os IDs e lance o erro de novo. Quando uma execução falha, o estado salvo dela guarda os mesmos detalhes em run.errorDetails e steps[n].errorDetails, para que um job de recuperação posterior possa lê-los depois que a exceção já tiver passado. Essas falhas vêm da política do Gateway, não do agente, então a solicitação nos registros é onde você deve olhar:
Última modificação em 5 de novembro de 2026