Etapas de controle de agentes

As etapas de controle adicionam lógica e pontos de decisão humana aos agentes. Use-as para pausar a execução para aprovação, ramificar com base na análise de conteúdo ou encaminhar o trabalho de forma diferente, dependendo do que o agente encontrar.

Tipos de etapas de controle

Os agentes são compatíveis com dois tipos de etapas de controle:

As etapas de controle são inseridas na sequência do agente como qualquer outra etapa. Quando a execução chega a uma etapa de controle, o executor a avalia antes de continuar.

Etapas de entrada humana

As etapas de entrada humana pausam um agente até que um usuário designado forneça uma entrada. Elas criam pontos de aprovação, checkpoints de revisão ou pontos de decisão que exigem julgamento humano.

Como funciona a entrada humana

Quando uma execução de agente chega a uma etapa de entrada humana:

1. A execução é pausada: a execução para nessa etapa e persiste seu estado atual.

2. O status mostra que a entrada está pendente: o visualizador da execução exibe a etapa como "aguardando entrada" e indica qual entrada é necessária.

3. O usuário fornece uma resposta: o usuário designado abre a execução, analisa o contexto e envia sua entrada.

4. A execução é retomada: o agente continua a partir do checkpoint, com a entrada do usuário incorporada às etapas seguintes.

Casos de uso comuns

• Revisão pelo sócio antes da entrega: preparar o rascunho do documento, pausar para obter a aprovação do sócio e então finalizar e entregar.

• Pontos de aprovação do cliente: gerar opções, pausar para o cliente escolher e então prosseguir com a abordagem selecionada.

• Checkpoints de qualidade: após a extração por IA, pausar para que um associado verifique os campos principais antes de gerar os resultados finais.

• Decisões de escalonamento: se a IA sinalizar termos ambíguos, pausar para que um advogado esclareça antes de prosseguir.

Como configurar etapas de entrada humana

Ao criar um agente, adicione uma etapa de entrada humana para especificar:

• Quem pode fornecer a entrada: atribua a etapa a uma função ou usuário específico.

• Qual entrada é necessária: defina a pergunta ou decisão necessária — como uma aprovação, uma seleção entre opções ou um texto livre.

• Contexto exibido: especifique quais documentos ou resultados da execução o usuário deve ver durante a revisão.

Etapas de condição

As etapas de condição ramificam a execução do agente com base em uma decisão avaliada. Normalmente, a condição avalia o conteúdo do documento, o estado da execução ou os resultados da análise para determinar qual caminho seguir.

Como funcionam as condições

As condições produzem um resultado ternário:

• Sim: seguir pelo ramo "sim".

• Não: seguir pelo ramo "não".

• Sem resposta: não foi possível determinar a condição — seguir por um caminho alternativo ou sinalizar para revisão.

O agente avalia a condição e encaminha a execução para o ramo apropriado sem pausar.

Casos de uso comuns

• Encaminhamento por cláusula: se o documento contiver uma cláusula de mudança de controle, encaminhá-lo para o fluxo de revisão do especialista em M&A. Caso contrário, prosseguir com a revisão padrão.

• Decisões por limite: se o valor de responsabilidade extraído exceder um limite, sinalizar para revisão do sócio. Caso contrário, prosseguir para a geração do resumo.

• Classificação de problemas: com base no tipo de problema encontrado, encaminhar o documento para o fluxo de trabalho apropriado.

• Controle de qualidade: se a confiança da IA em uma extração for baixa, sinalizar para verificação humana. Se for alta, prosseguir para o resultado.

Como configurar etapas de condição

Ao criar um agente, adicione uma etapa de condição para especificar:

• A condição a ser avaliada: defina o que o agente deve verificar — normalmente com base no conteúdo do documento, nos resultados da extração ou nos metadados da execução.

• Comportamento dos ramos: defina o que acontece nos resultados sim, não e sem resposta.

Combinando etapas de controle

Você pode usar etapas de entrada humana e de condição em conjunto para criar agentes sofisticados:

• Use uma etapa de condição para detectar se um documento requer tratamento especial.

• Se sim, encaminhe para uma etapa de entrada humana para revisão por um especialista.

• Se não, prossiga diretamente para a geração do resultado.

Esse padrão permite automatizar os casos simples e encaminhar as exceções para pessoas.

Execuções pausadas

Somente as etapas de entrada humana pausam a execução do agente. As etapas de condição são avaliadas instantaneamente e fazem o direcionamento sem interromper a execução.

Quando uma execução é pausada em uma etapa de entrada humana:

• A execução aparece na sua lista de execuções com o status "aguardando entrada".

• Abra a execução para ver qual entrada é necessária.

• Forneça sua resposta e envie-a.

• A execução é retomada automaticamente e continua pelas etapas restantes.

Histórico e auditoria das execuções

As etapas de controle são registradas no histórico da execução. Cada registro de execução mostra:

• Quais etapas de controle foram encontradas.

• Qual condição foi avaliada e qual resultado ela produziu.

• Quem forneceu a entrada nas etapas de entrada humana e quando.

• Quanto tempo a execução permaneceu pausada em cada checkpoint.

Isso cria uma trilha de auditoria para agentes que envolvem decisões humanas.

Práticas recomendadas

• Use a entrada humana para decisões verdadeiras: adicione etapas de entrada humana onde o julgamento humano realmente agregue valor — não para etapas que poderiam ser automatizadas.

• Mantenha as condições claras: escreva condições que produzam resultados inequívocos de sim/não. Se o resultado for frequentemente "sem resposta", reconsidere como você está fazendo a avaliação.

• Atribua as etapas de entrada com cuidado: encaminhe a entrada humana para a pessoa certa — revisão pelo sócio para decisões estratégicas e verificação pelo associado para controles de qualidade.

• Teste a lógica de ramificação: execute entradas de teste nas etapas de condição para verificar se cada ramo produz o resultado esperado.

• Documente o comportamento dos ramos: na descrição do agente, registre o que acontece em cada resultado da condição para que os membros da equipe entendam a lógica.

O que ler a seguir

• Visão geral dos agentes para criar e executar agentes

• Gatilhos de agentes para automação baseada em agendamento e eventos

• Playbooks para aplicar padrões da empresa nas etapas dos agentes