Inteligência artificial

Estes nós põem um modelo de linguagem a trabalhar no meio do fluxo: redigir um texto, separar os itens por assunto, virar um e-mail em campos preenchidos, encurtar um documento longo ou entregar a pergunta a um agente que decide sozinho o que consultar.

Antes de começar: a credencial

Todos eles pedem uma Credencial de IA. Cadastre-a uma vez em Credenciais, no tipo Modelo de linguagem (IA):

• Provedor — OpenRouter (recomendado: uma chave só dá acesso a modelos de vários fabricantes), OpenAI ou Outro compatível com a API da OpenAI.
• Chave de API e Modelo (no OpenRouter, no formato fabricante/modelo, por exemplo anthropic/claude-sonnet-4.5).
• URL base — só quando o serviço é hospedado por você.

Se ainda não houver credencial de IA na sua organização, peça a quem administra.

O que todo nó de IA tem

É uma chamada por item: uma lista de 200 itens faz 200 chamadas. Os campos de texto aceitam expressões ({{ … }}), então o mesmo nó atende a lista inteira com o conteúdo de cada item.

Cada chamada é contabilizada — dá para acompanhar o gasto por agente e por fluxo.

Perguntar à IA

O nó mais simples, e o que resolve a maior parte dos pedidos: redigir, reescrever, traduzir, responder.

• Instruções (papel do modelo) — quem ele é e como deve responder. Já vem preenchido com um texto genérico; curto funciona melhor que longo.
• Pergunta — o que enviar, com os campos do item por dentro. Ex.: Resuma em uma frase: {{ descricao }}.
• Gravar a resposta em — o campo de saída (padrão resposta).

Classificar com IA

Separa os itens por categoria — e, diferente de gravar um campo e pôr um IF depois, cria uma saída para cada categoria. O fluxo já sai ramificado.

• Texto a classificar — ex.: {{ assunto }}.
• Categorias — uma linha por categoria, com o nome e quando usar. A segunda coluna não é enfeite: é ela que faz a classificação acertar.
• Porta para o que não casar — padrão outros.
• Gravar a categoria em — padrão categoria.

Declare ao menos uma categoria. Se o modelo devolver algo fora da lista, o item segue pela porta do que não casou — nunca por uma saída que você não desenhou.

Extrair dados com IA

Transforma texto corrido — um e-mail, a descrição de um chamado, um PDF já convertido em texto — em campos prontos para o próximo nó.

• Texto de onde extrair — ex.: {{ corpo }}.
• Exemplo do JSON desejado — escreva um exemplo preenchido, com as chaves e o tipo de cada valor. O modelo devolve a mesma estrutura com os dados do texto. Já vem um exemplo pronto para você adaptar.
• Prefixo dos campos (opcional) — vazio grava os campos direto no item; preencha para agrupar (ex.: extraido gera extraido.nome).

Campo que não estiver no texto volta vazio, nunca inventado. É a diferença entre "não estava lá" e "estava escrito assim" — e quem lê depois precisa distinguir as duas.

Resumir com IA

• Texto a resumir — ex.: {{ conteudo }}.
• Formato — Um parágrafo corrido, Lista de tópicos ou Uma frase.
• Focar em (opcional) — ex.: decisões tomadas e prazos.
• Gravar o resumo em — padrão resumo.

Quando o texto não cabe numa chamada só, o nó divide em etapas: resume cada trecho e depois resume os resumos. O corte respeita os parágrafos, e nada do texto fica de fora — o contrário de cortar no limite e devolver um resumo convincente só da primeira metade.

Executar agente de IA

Manda a pergunta a um agente cadastrado em Agentes de IA. A diferença para o Perguntar à IA é quem decide: ali você diz exatamente o que pedir; aqui o agente escolhe as ferramentas das competências dele e vai e volta até responder.

• Agente — qual agente responde.
• Pergunta — ex.: O que fazer com este registro? {{ descricao }}.
• Gravar a resposta em — padrão resposta.

Não há credencial nem instruções neste nó: as duas moram no agente, e ajustar lá corrige em todos os fluxos que o acionam.

Além da resposta, cada item sai com _trace (as ferramentas que o agente acionou) e _usos (o que a execução consumiu). Guarde-os: agente que responde errado só se conserta vendo o que ele consultou.

Devolver ao agente

Use quando o fluxo é uma ferramenta de um agente (o gatilho Ferramenta de IA, em Gatilhos). Este nó marca o que volta ao agente, em vez de deixar o retorno ser "a saída do último nó" — que num fluxo com ramificações depende de qual ramo terminou por último.

• Devolver — Os registros (recortados) ou Uma frase escrita por você.
• Texto (no modo frase) — uma linha por registro. Ex.: Pedido {{ numero }}: {{ situacao }}, previsão {{ previsao }}. Frase curta lê melhor que uma tabela.
• Campos a manter (no modo registros) — um por linha, aceitando cliente.nome. Vazio devolve o registro inteiro; campo a mais é contexto gasto e conta na fatura.

O nó não interrompe nada: aplica o recorte e passa os itens adiante, então o mesmo fluxo continua servindo para o que já servia.

Para montar o agente, as competências e as ferramentas, veja Agentes de IA e Skills.