Contratos de saída do agente e saídas específicas por ramificação
Os contratos de saída do agente definem o que um agente deve produzir ao concluir sua execução. Cada agente tem uma única saída de fallback ou um conjunto de saídas específicas por ramificação. O mecanismo impõe o contrato ao final da execução, e ela falha se o agente produzir o tipo de saída incorreto para a ramificação selecionada.
Tipos de saída
O mecanismo do agente é compatível com três tipos de saída:
Tipo | O que o agente deve entregar |
|---|---|
resposta | Uma resposta somente de chat. O agente não deve criar nem enviar um documento. |
documento | Um documento gerado ou enviado. O agente deve produzir um arquivo de documento. |
tabela | Uma tabela ou pasta de trabalho estruturada. O agente deve produzir a saída tabular. |
Saída de fallback versus saídas específicas por ramificação
Quando todas as ramificações terminais de um agente produzem o mesmo resultado, configure uma única saída de fallback. Quando diferentes ramificações produzem resultados diferentes, use saídas específicas por ramificação.
Saída de fallback — um contrato de saída aplicado a todas as ramificações terminais.
Saídas específicas por ramificação — um contrato de saída por ramificação, para que o resultado corresponda ao caminho da ramificação seguido.
Exatamente uma ramificação de saída deve ser concluída durante uma execução. Se o agente produzir o tipo incorreto para a ramificação selecionada, a execução falhará com um erro explícito.
Imposição do contrato
O mecanismo verifica a saída ao final de cada execução. As falhas comuns de contrato incluem:
Produzir um documento quando o contrato da ramificação espera uma resposta.
Concluir a execução sem produzir a saída de documento obrigatória.
Concluir a execução sem produzir qualquer saída obrigatória.
Quando nenhum contrato de saída está configurado, a página de detalhes do agente exibe a mensagem: "Nenhum contrato de saída explícito está definido."
Como configurar saídas específicas por ramificação
No criador de agentes, abra a seção de saída.
Adicione um bloco de saída para cada ramificação que precise de um resultado distinto.
Selecione o tipo de saída para cada bloco: resposta, documento ou tabela.
Vincule cada bloco de saída à sua ramificação de destino.
Teste o agente para verificar se cada ramificação produz o tipo de saída correto.
Quando uma saída específica por ramificação é definida, o mecanismo verifica apenas o contrato da ramificação selecionada. As ramificações não selecionadas são ignoradas, e seus contratos de saída não são considerados.
O que ler a seguir
Visão geral dos agentes para criar e executar agentes
Retomar uma execução de agente aguardando entrada humana para retomar execuções pausadas pelo chat
Playbooks para aplicar padrões rigorosos de forma consistente