> ## Documentation Index > Fetch the complete documentation index at: https://docs.tela.com/llms.txt > Use this file to discover all available pages before exploring further. # Executando um Agente e obtendo resultados > Use um Agente publicado como etapa de Workflow, a partir dos seus sistemas pela API, em tarefas e em agendamentos, e leia os valores que ele devolve Depois de publicado, um Agente pode ser executado de vários lugares. Esta página cobre cada um deles e como extrair os valores, usando o assistente de contratos do [exemplo da seção](https://docs.tela.com/pt/agent/overview.md#o-exemplo-que-acompanha-a-secao), que devolve `answer` e `risky_clauses`. ## Como é um resultado O resultado de uma execução depende das [Saídas](https://docs.tela.com/pt/agent/inputs-and-outputs.md#saidas) 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: ```json theme={null} { "answer": "The agreement can be terminated by either party with 30 days' written notice (clause 12.1): \"Either Party may terminate this Agreement upon thirty (30) days prior written notice…\"", "risky_clauses": [ "9.2 – Unlimited liability of the Customer for indirect damages", "14.3 – Automatic renewal for successive 24-month periods unless notice is given 180 days in advance" ] } ``` Cada atributo é um valor que você lê pelo nome onde quer que o resultado vá: uma etapa de Workflow, o seu código, uma tarefa. Mantenha os nomes dos atributos estáveis depois que outros sistemas dependerem deles; renomear `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 quando `risky_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](https://docs.tela.com/pt/credentials.md)). ![Etapa Agent Existente em um Workflow com o painel Atribuir Inputs mapeando contract e question](https://mintcdn.com/meistrari/M2w7BduKZAFA1Sbx/images/pt/workflow/existing-agent.png?fit=max\&auto=format\&n=M2w7BduKZAFA1Sbx\&q=85\&s=4d5ec64fa69fcffe898aa4f7a24be65e) > [!NOTE] > > 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. ![Diálogo Conectar via API com o Agent ID e o trecho Executar agent](https://mintcdn.com/meistrari/IBJhAp-onVS37l80/images/pt/agent/connect-api.png?fit=max\&auto=format\&n=IBJhAp-onVS37l80\&q=85\&s=6a2e7241c484e734a2c90459ea236f07) **Executar agent** inicia uma nova sessão, ou continua uma existente quando você inclui o `sessionId` dela. O corpo da requisição tem uma `message`, o `inputSchema` com uma entrada por input declarado e `environmentVariables` opcionais: ```json theme={null} { "message": "Can the customer terminate early, and what should we worry about?", "inputSchema": [ { "type": "file", "name": "contract", "vaultRef": "vault://…", "filename": "services-agreement.pdf" }, { "type": "text", "name": "question", "content": "Can the customer terminate early?" } ], "environmentVariables": {} } ``` A chamada retorna na hora com um `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. > [!NOTE] > > **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](https://docs.tela.com/pt/workstation/workstation.md) 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 um `POST /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: ```json theme={null} { "sourceType": "agent", "agentId": "2f1c7c1e-6b7a-4e0e-9d5a-1b2c3d4e5f60", "tasks": [ { "name": "Acme services agreement", "rawInput": { "variables": { "contract": { "vaultRef": "vault://…", "filename": "acme-services-agreement.pdf" }, "question": "Can the customer terminate early?" } }, "tags": ["acme", "q3-renewals"] } ] } ``` Cada tarefa começa como `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](https://docs.tela.com/api-reference/task/post-task.md). > [!NOTE] > > 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. > [!NOTE] > > **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](https://docs.tela.com/pt/schedules/overview.md) 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](https://docs.tela.com/pt/agent/testing.md#usage-o-historico-de-execucoes). Uma execução no **Usage** pode ser compartilhada por link com colegas que têm acesso ao Agente. > [!NOTE] > > 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](https://docs.tela.com/pt/workstation/creating-apps.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.