Agente

Nó de agente autônomo: configure um agente de IA com modelo, solicitações, ferramentas e recursos para raciocinar e concluir tarefas.

O que faz

Executa um agente de IA que você cria na tela. Você dá a ele um modelo, instruções, ferramentas e contexto, e ele raciocina sobre seus dados para concluir uma tarefa e retornar um resultado.

O nó é rotulado como Agente autônomo na paleta. Use-a para decisões baseadas em IA, geração de conteúdo, classificação, extração ou qualquer etapa que se beneficie do raciocínio em vez da lógica fixa.

Um agente autônomo raciocina em um loop. Ele lê os prompts, decide se chama uma ferramenta ou consulta seu contexto, incorpora o que vem em seguida e repete até que tenha uma resposta ou atinja seu limite de iteração. Você molda esse loop com o modelo, prompts e os recursos que você conecta aos identificadores do nó.

Quando usar este processo versus BPMN

Situação	Usar
Você deseja definir o modelo, as solicitações e as ferramentas do agente diretamente neste fluxo	Agente Autônomo
Você deseja invocar um agente que já está publicado na sua organização	Processo BPMN
Você precisa de uma ramificação fixa, baseada em regras e sem raciocínio	Decisão ou Mudar

Um agente autônomo é criado em linha: sua configuração fica no nó e acompanha o fluxo. Um processo BPMN é uma referência a um agente que é versionado e implantado separadamente.

Adicionando um agente

Adicione o nó e, em seguida, configure-o no painel de propriedades.

1. Selecione o botão + em um identificador de saída ou abra a paleta de nós na barra de ferramentas inferior.
2. Selecione a categoria Agente e, em seguida, Agente autônomo. O fluxo adiciona o nó e abre seu painel de propriedades.
3. Configure o modelo e as solicitações conforme descrito abaixo.

Resultado: o nó do Agente autônomo é adicionado à tela com seu painel de propriedades aberto, pronto para configurar.

Referência da configuração

Campo	Required	Padrão	Description
Modelo	Não	Modelo de agente padrão da organização	O grande modelo de linguagem (LLM) que o agente usa. Selecione um modelo no seletor, que lista os modelos disponíveis para sua organização.
Prompt do Sistema	Sim	Nenhum	A função do agente e as instruções em posição: quem é e como deve se comportar. Escreva orientações duráveis que se aplicam a todas as invocações, como a persona, as restrições e as expectativas de saída do agente.
Prompt do Usuário	Sim	Nenhum	A tarefa para esta invocação. Faça referência aos dados do fluxo de trabalho com expressões, por $vars.start.output.request.
Temperatura	Não	0	Aleatoriedade de amostra, de 0 a 1. Valores mais baixos tornam as respostas mais determinísticas; valores mais altos tornam as respostas mais variadas ou criativas.
Máximo de tokens por resposta	Não	16384	Tamanho máximo de cada resposta do modelo. O limite máximo depende do modelo selecionado.
Máx. de iterações	Não	25	Número máximo de etapas de raciocínio e chamada de ferramentas antes que o agente pare. Aceita valores de 1 a 100.
Proteções	Não	Nenhum	Regras que restringem o comportamento e as saídas do agente, como bloquear conteúdo não permitido ou manter o agente dentro de um escopo definido. As proteções aplicam-se ao agente como um todo.

Variáveis de entrada e saída

Declare os dados que o agente troca com o restante do fluxo na aba Variáveis do painel de propriedades.

• Variáveis de entrada são valores que você passa para o agente e associa aos dados do fluxo de trabalho. O agente pode fazer referência a eles enquanto raciocina. Novos agentes começam sem variáveis de entrada.
• Variáveis de saída são os campos estruturados que o agente retorna. Cada agente começa com uma variável de saída, content, que contém o texto da resposta. Adicione mais variáveis de saída para que o agente retorne dados estruturados.

Cada variável de saída que você declara torna-se um campo no objeto output do agente. Dê a cada um um nome e um tipo e, em seguida, instrua o agente no prompt do sistema para preenchê-lo. O agente retorna todos os campos declarados juntos em um único output estruturado.

Recursos

Um agente autônomo compõe com nós de recursos que você conecta aos seus identificadores. O nó tem três identificadores de recursos, cada um com seu próprio rótulo na tela: Ferramentas, Contexto e Escalonamentos. Conecte um recurso a um identificador e, em seguida, configure esse recurso no próprio painel de propriedades. Os recursos acompanham o fluxo.

Cada identificador aceita apenas seu tipo de recurso correspondente. A tela bloqueia conexões que não se encaixam, então você não pode, por exemplo, conectar uma ferramenta ao identificador de contexto.

Ferramentas

Conecte ferramentas ao identificador de Ferramentas para fornecer ao agente recursos que ele pode chamar durante o raciocínio. O agente decide durante seu loop se e quando chamar cada ferramenta conectada. Cada ferramenta carrega uma descrição que informa ao agente para que é a ferramenta; portanto, escreva descrições claras quando uma ferramenta expõe uma ferramenta.

Os tipos de ferramentas que você pode conectar são:

• Ferramentas integradas, três ferramentas prontas descritas abaixo.
• Ferramentas de conector, que permitem que o agente chame uma operação do Integration Service, por exemplo, enviando um e-mail ou criando um registro em um sistema downstream.
• Fluxo de trabalho de RPA e ferramentas de função de API , que permitem que o agente invoque um processo de RPA publicado ou fluxo de trabalho de API como uma ferramenta.
• Ferramentas de servidor de Protocolo de Contexto do Modelo (MCP) , que expõem as ferramentas publicadas em um servidor MCP.

Ferramentas integradas

Três ferramentas integradas são fornecidas com o Flow. Cada um é um recurso independente que você conecta ao identificador de Ferramentas e configura em seu próprio painel.

• Analisar arquivos: analisa um ou mais arquivos com um LLM para extrair, sintetizar ou responder a perguntas sobre seu conteúdo. Descreva os arquivos que o agente passará e a tarefa de análise a ser executada neles.
• Transformação em lote: processa e transforma um arquivo CSV, linha por linha. Forneça o arquivo de origem, descreva a tarefa por linha e defina as colunas de saída que a ferramenta adiciona. Você pode habilitar ou desabilitar o embasamento de pesquisa na web para a transformação.
• Resumir: produz uma síntese entre documentos (até 1.000 páginas) com citações. Forneça a origem, descreva o que sintetizar e escolha a extensão do arquivo. Quando a origem é um PDF, é possível ativar ou desativar as citações.

Context

Conecte um recurso de contexto ao identificador de contexto para fundamentar o agente em seus dados. O agente utiliza esses dados de fundamentação enquanto raciocina, em vez de depender apenas do modelo. Um recurso de contexto aponta para um índice de contexto em sua organização.

Configure como o agente se recupera do índice, incluindo o modo de recuperação (semântico, estruturado, DeepRAG ou transformação em lote), a consulta, o número de resultados a serem retornados, um limite de relevância e se deve incluir citações. Para criar um novo índice de contexto, use a ação Criar novo contexto no painel de adição do identificador, que abre a criação do índice em uma nova guia.

Escalonamento

Conecte o identificador de Escalonamentos para rotear para uma pessoa quando o agente chegar a um caso que não deve decidir sozinho. O agente pausa, um humano atua no escalonamento e o agente retoma com o resultado. Você pode anexar um de dois recursos de escalonamento:

• Escalonamento: direciona para uma tarefa de aplicativo de ação. Configure o aplicativo de ação, destinatários, notificações, as entradas passadas para o aplicativo e como o resultado do aplicativo mapeia de volta para o agente.
• Escalonamento de aplicativo de ação: roteia para um aplicativo de ação codificado, com a mesma configuração de destinatários, notificação, entrada e mapeamento de resultados.

Ambos os recursos de escalonamento são configurados da mesma maneira. Escolha o Escalonamento do App de ação quando seu destino de escalonamento for um aplicativo de ação codificado em vez de um aplicativo de ação padrão. A anexação de qualquer recurso requer a versão 1.2 ou posterior do nó do Agente Autônomo.

Entradas e saídas

Entrada

O agente recebe dados do nó upstream por meio do seu identificador de entrada e de quaisquer variáveis de entrada que você declarar.

Saída

O agente retorna um objeto output contendo as variáveis de saída que você declararam. O campo padrão é content, o texto da resposta. Acesse um campo com $vars.<node>.output.<field>, por exemplo:

$vars.agent1.output.content

Se o agente falhar, o nó preencherá um objeto error em vez disso. Consulte o Tratamento de erros para obter o formato de erro e como rotear nele.

{
  "output": {
    "content": "string. The agent's response text, plus any output variables you declared."
  },
  "error": "object. Populated only on failure. See Error handling."
}

Ramificando no resultado

Siga o agente com uma Decisão para rotear o que ele retornou:

Autonomous Agent → Decision ($vars.agent1.output.content.includes("approved"))
  → True:  continue processing
  → False: escalate or terminate

Leia um campo de saída declarado em um nó de Script downstream:

return $vars.agent1.output.content;

Exemplos

Exemplo 1: classificar uma solicitação de entrada

O que faz: classifica uma solicitação de suporte como um reembolso, uma reclamação ou uma pergunta e retorna o rótulo como saída estruturada.

Prompt do sistema:

You are a support triage assistant. Classify each request into exactly one category: refund, complaint, or question. Respond with only the category.

Prompt do Usuário:

Classify this request: $vars.start.output.request

Declare uma variável de saída category (string). O agente retorna:

{
  "output": {
    "category": "refund"
  }
}

Roteie em $vars.agent1.output.category com um Switch downstream.

Exemplo 2: Resolver uma consulta de fatura de ponta a ponta

O que faz: responde à pergunta de fatura de um cliente lendo a fatura, fundamentando a resposta na política, chamando um fluxo de trabalho quando ele precisa agir e escalonando quando o valor excede um limite.

Conecte os identificadores do agente:

• Contexto: um índice de contexto que contém sua política de faturamento, para que o agente fundamenta sua resposta na orientação aprovada.
• Ferramentas: uma ferramenta integrada Analisar arquivos para ler a fatura anexada e uma ferramenta de fluxo de trabalho de RPA que emite um reembolso no sistema de cobrança.
• Escalonamentos: um recurso de escalonamento que roteia casos de alto valor para um revisor em um aplicativo de ação.

Prompt do sistema:

You are a billing support agent. Use the billing policy in your context to answer invoice questions. Read the attached invoice before answering. If a refund is warranted and the amount is at or below 200, issue it with the refund workflow. If the amount exceeds 200, escalate for review instead of acting. Always return a structured result.

Prompt do Usuário:

Resolve this customer query: $vars.start.output.query
Invoice: $vars.start.output.invoiceFile

Declare variáveis de saída resolution (string), refundIssued (booleano) e amount (número). Um caso resolvido retorna:

{
  "output": {
    "resolution": "Refund issued for duplicate charge.",
    "refundIssued": true,
    "amount": 48.5
  }
}

Siga o agente com uma Decisão sobre $vars.agent1.output.refundIssued para ramificar entre uma mensagem de confirmação e um caminho de acompanhamento. O agente lida com o próprio caso acima do limite escalonando, para que a ramificação não precise de lógica extra no fluxo.

Problemas comuns

Um erro de validação de entrada aparece antes que você possa depurar. O Modelo, o prompt do sistema e o prompt do usuário são todos necessários. O nó relatará um erro de validação até que cada um seja definido.

Uma expressão para um item de loop não é resolvida dentro do agente. Quando você fizer referência ao item atual de um loop em um prompt, use a expressão do item atual do loop, por exemplo, $vars.loop1.currentItem.<field>. Referenciar o escopo errado deixa o valor não resolvido no runtime.

O agente retorna o texto quando você esperava dados estruturados. Por padrão, o agente retorna apenas content. Declare uma variável de saída para cada campo estruturado que você deseja e instrua o agente no prompt do sistema para preenchê-las.

Uma ferramenta de transformação em lote conectada relata um erro de validação. A Transformação em lote exige pelo menos uma coluna de saída. Defina as colunas que a ferramenta deve adicionar antes de depurar o fluxo.

Você não pode conectar um Escalonamento de aplicativo de ação ao agente. O Escalonamento de Aplicativos de ação requer a versão 1.2 ou posterior do nó Agente Autônomo. Atualize o nó se a conexão estiver bloqueada.

Páginas relacionadas

• Orquestrar um agente de IA
• Processo BPMN
• Tarefa humana