answer e risky_clauses.
Como é um resultado
O resultado de uma execução depende das Saídas do Agente:- Sem atributos: o Agente responde em texto livre (Markdown). Você lê o texto ou o repassa adiante.
- Com atributos: o Agente devolve um objeto JSON com exatamente esses atributos. Para o assistente de contratos:
risky_clauses quebra todos os sistemas que o consomem.
Como etapa de um Workflow
Um Workflow pode executar um Agente como uma das suas etapas, para que o julgamento do Agente fique dentro de um processo que você desenhou de antemão: receber o contrato, rodar o assistente, encaminhar o contrato a um advogado sênior quandorisky_clauses não estiver vazio ou, caso contrário, gerar o documento de resumo.
No Workflow, adicione o módulo Agent Existente (Adicione um Agent existente da sua Organização). Clique em Selecionar Agent e escolha o seu; a lista marca cada Agente como Publicado ou Não publicado. Depois clique em Atribuir Inputs: o painel lista os Inputs do Agent de um lado e as Variáveis do Workflow do outro, e você vincula cada entrada do Agente a uma variável do Workflow ou à saída de uma etapa anterior. Entradas obrigatórias ainda não vinculadas ficam destacadas.
Visualizar Agent abre o Agente dentro do contexto do Workflow. Um aviso no topo diz Aberto dentro do workflow, com o nome do Workflow, e mostra Atribuir Inputs com um contador de entradas vinculadas; os seletores ao lado de cada entrada permitem vinculá-las dali mesmo, e Voltar ao Workflow devolve você ao Workflow.
Nas etapas seguintes, digite @ para referenciar a saída da etapa do Agente, do mesmo modo que referencia qualquer etapa anterior; com Saídas estruturadas, answer e risky_clauses são os campos dessa saída. O Agente herda as credenciais do Workflow (veja Credenciais).
A etapa sempre executa a versão publicada do Agente, nunca as suas alterações não publicadas em
main. Publicar uma nova versão do Agente muda o que todo Workflow que o usa faz a partir da próxima execução.Pela API
Depois que o Agente é publicado, o menu… ao lado do título mostra Conectar via API. O diálogo mostra o Agent ID e três requisições prontas para copiar. Use a URL exata mostrada ali: os Agentes rodam em uma API dedicada, e o diálogo já preenche o Agent ID e as entradas que você declarou.
sessionId dela. O corpo da requisição tem uma message, o inputSchema com uma entrada por input declarado e environmentVariables opcionais:
sessionId; o Agente trabalha em segundo plano.
Obter sessão (Consulte este endpoint para verificar o status da execução e obter os resultados) devolve o estado da sessão e, quando ela termina, o resultado: o objeto JSON acima, ou o texto. Encerrar sessão fecha uma conversa de que você não precisa mais.
Para desenvolvedores. Uma entrada de arquivo é uma referência a um arquivo do seu Vault (
vault://…), com um nome de exibição opcional. As execuções são validadas contra as entradas declaradas: um nome desconhecido, um tipo diferente ou uma entrada obrigatória ausente devolve 400. Uma execução bem-sucedida termina no status waiting_messages, não em completed: a sessão fica ociosa, pronta para uma mensagem de acompanhamento, e isso conta como sucesso. Executar um Agente não publicado devolve 400 Agent has no published version. Leia o resultado no último turno do assistente da sessão.Como tarefas
As tarefas permitem que várias pessoas entreguem trabalho a um Agente e revisem os resultados, do jeito que uma Workstation faz para um Canvas. Tarefas de Agente são criadas pela API de tarefas com o ID do Agente: não há App para implantar. Envie umPOST /task com sourceType: "agent", o agentId e até 100 tarefas, cada uma com um name, as rawInput.variables nomeadas como as entradas do Agente e tags opcionais:
created, passa a running, depois a validating quando a saída está pronta e aguarda revisão, e a completed quando aprovada; failed e cancelled são finais. Liste as tarefas de um Agente com GET /task?agentId=… (esse filtro não pode ser combinado com promptApplicationId), leia uma com GET /task/{id} e aprove ou edite com PATCH /task/{id}; em tarefas de Agente, um outputContent editado substitui integralmente a saída armazenada. O resultado de uma tarefa é o mesmo objeto JSON acima, e a tarefa também registra o agentSessionId da execução. Veja a referência da API de tarefas.
Não existe uma página no Tela em que as tarefas de Agente sejam listadas e revisadas como as tarefas da Workstation. Planeje ler e aprovar as tarefas de Agente pela API.
Para desenvolvedores. Os valores de arquivo de uma tarefa de Agente são
{ vaultRef, filename }, um arquivo por variável. Tarefas de Agente não aceitam reexecução, desfazer aprovação, promoção a caso de teste, análises nem versões.Em um agendamento
No menu… ao lado do título, Agendar executa o Agente sozinho em horários definidos, de forma recorrente ou uma única vez. Os agendamentos sempre executam a versão publicada, então publicar muda o que a próxima execução agendada faz. Um Agente precisa estar publicado para ser agendado; cada execução agendada aparece no Usage como qualquer outra sessão. Veja Agendas para frequências, fuso horário e histórico.
Lendo resultados depois
Toda execução, qualquer que seja a origem, fica listada na experiência Usage com status, custo e uma visualização Detalhes da execução com a linha do tempo e o resultado. Veja Usage: o histórico de execuções. Uma execução no Usage pode ser compartilhada por link com colegas que têm acesso ao Agente.Agentes não têm a opção Deploy App que Canvases e Workflows têm no diálogo de publicação. Para dar a um time uma interface em forma de formulário para um Agente, execute-o como etapa de um Workflow e implante esse Workflow como App.