Logica: Agente IA

Quando usar

• Classificar automaticamente o assunto de um e-mail ou mensagem recebida


• Extrair dados estruturados de um texto livre (ex: nome, telefone, endereco de uma mensagem)


• Resumir documentos, reunioes transcritas ou conversas longas


• Gerar respostas automaticas personalizadas com base em dados do fluxo

---

Como funciona

O node envia um prompt para um modelo de IA e retorna a resposta. Voce configura as instrucoes do sistema (que definem o comportamento da IA), o prompt do usuario (a pergunta ou tarefa em si), e opcionalmente ferramentas que o agente pode usar durante a execucao.

Saidas (portas)

| Porta | Descricao |
|-------|-----------|
| Sucesso | O fluxo segue por aqui quando a IA processa com sucesso |
| Erro | O fluxo segue por aqui se houver falha na chamada da IA |

---

Configuracoes

Instrucoes do Sistema

Campo de texto (multiline) que define o comportamento da IA. Aqui voce descreve quem a IA e, o que ela deve fazer e como deve se comportar. Aceita variaveis de nodes anteriores.

Exemplo:
```
Voce e um classificador de tickets. Analise a mensagem e retorne a categoria.
```

Prompt do Usuario

Campo de texto (multiline) que define a tarefa ou pergunta especifica para a IA. Normalmente inclui variaveis com os dados a serem processados.

Exemplo:
```
Analise o seguinte texto: {{trigger.body.message}}
```

Contexto / Historico

Campo opcional para passar um array de mensagens anteriores como contexto. Util quando voce quer que a IA considere interacoes passadas na sua resposta.

Aceita uma variavel que contenha um array de mensagens no formato de chat.

Ferramentas

Secao onde voce define ferramentas (tools) que o agente pode usar durante a execucao. As ferramentas sao acoes do Brife (como buscar registros em tabelas, criar contatos, consultar projetos, etc.) que a IA pode chamar autonomamente quando julgar necessario.

Um contador mostra quantas ferramentas estao configuradas. As ferramentas disponiveis incluem operacoes com:

• Tabelas (buscar, criar, atualizar, deletar registros)


• Contatos (buscar, criar, atualizar, deletar)


• Projetos (buscar, criar, atualizar, deletar, gerenciar membros)


• Agendas (buscar, criar, atualizar, deletar)


• Reunioes (buscar, criar, atualizar, deletar salas e eventos)

Modelo

Seletor do modelo de IA a ser utilizado. A lista mostra os modelos disponiveis com nome e provedor (ex: "GPT-4o" da OpenAI, "Claude" da Anthropic). O primeiro modelo da lista e selecionado automaticamente.

Formato de saida

Define como a IA deve formatar a resposta.

| Formato | Descricao |
|---------|-----------|
| Texto (Livre) | A IA responde em texto livre, sem estrutura fixa |
| JSON | A IA retorna um objeto JSON estruturado conforme um schema definido por voce |

Quando o formato JSON* e selecionado, um painel adicional aparece para voce configurar a *Estrutura JSON usando o construtor de schema. Nele voce define os campos, tipos e estrutura que a IA deve retornar.

Avancado

Secao colapsavel com configuracoes avancadas:

#### Temperatura

Slider de 0 a 1 (em incrementos de 0.1) que controla a "criatividade" da IA.

| Valor | Comportamento |
|-------|---------------|
| 0 | Respostas mais precisas e deterministicas (ideal para classificacao e extracao de dados) |
| 0.7 | Valor padrao, equilibrio entre precisao e criatividade |
| 1 | Respostas mais criativas e variadas (ideal para geracao de texto) |

#### Maximo de Tokens

Campo numerico que limita o tamanho da resposta da IA. Deixe vazio para nao impor limite (a IA decide o tamanho adequado).

---

Dados de saida

Quando o formato de saida e Texto:

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `response` | Texto | Resposta completa gerada pela IA |

Quando o formato de saida e JSON*, as variaveis de saida sao *dinamicas e correspondem aos campos definidos no schema JSON. Por exemplo, se voce definiu campos `categoria` (string) e `prioridade` (number), as variaveis de saida serao `categoria` e `prioridade`.

---

Dicas

• Seja o mais especifico possivel nas Instrucoes do Sistema. Quanto mais claro o comportamento esperado, melhores os resultados.


• Use o formato JSON quando voce precisa dos dados estruturados para uso em nodes seguintes (ex: extrair `nome`, `email` e `telefone` de uma mensagem).


• A temperatura deve ser baixa (0 a 0.3) para tarefas de classificacao, extracao e analise. Aumente (0.5 a 1.0) para geracao criativa de texto.


• As ferramentas permitem que a IA consulte e manipule dados do Brife autonomamente. Por exemplo, a IA pode buscar informacoes em uma tabela antes de responder, sem que voce precise criar nodes separados para isso.


• O campo Contexto / Historico e util para manter continuidade entre chamadas, como em um fluxo que processa varias mensagens de uma conversa.


• Sempre conecte a porta Erro a algum tratamento (notificacao, log, fallback) para nao perder visibilidade sobre falhas.