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
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 empause.payload. - Uma chamada ao modelo repetida fica registrada na etapa como
modelAttempts, e cada nova tentativa registramodel.retrying. - Uma solicitação bloqueada é registrada com seu
requestIdereason, 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. CaptureAgentGatewayError 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: