# Funções de IA: coletar dados e acionar fluxos

> Crie uma função de IA para o agente coletar dados na conversa, guardar em campos, agendar e acionar um fluxo. Depois, ligue a função no agente.

Endereço: https://help.nextags.com.br/tutoriais/ia/funcoes-do-agente/
Tipo: Tutorial · Avançado

Atualizado em: 25/10/2026

> **Resposta rápida**
>
> No menu **AI Hub**, abra **Ferramentas de IA** › **Funções de IA** e clique em **Adicionar Novo**. Dê um nome, explique em **O que este acionador faz?** quando usar a função, ligue os dados aos campos e escolha o fluxo. Depois, marque a função nas **Ferramentas de IA** do agente.

**Antes de começar**

- Um agente de IA criado. Veja [Criar um agente de IA](https://help.nextags.com.br/tutoriais/ia/criar-agente/).
- Os campos que vão guardar os dados e o fluxo que a função aciona. Veja [Criar campos personalizados](https://help.nextags.com.br/tutoriais/fluxos/campos-personalizados/) e [Criar um fluxo](https://help.nextags.com.br/tutoriais/fluxos/criar-fluxo/).
- Para agendar: um calendário na conta. Veja [Criar um calendário](https://help.nextags.com.br/tutoriais/agenda/criar-calendario/).

> **Função ou Ação de IA?:**
> As [Ações de IA](https://help.nextags.com.br/tutoriais/ia/acoes-do-agente/) fazem tarefas rápidas na conversa, como etiquetar ou transferir. A função coleta vários dados de uma vez, pode agendar e aciona um fluxo.

## Passo a passo

### Passo 1: Crie a função

No menu **AI Hub**, clique na aba **Ferramentas de IA** e em **Funções de IA**.

![AI Hub, aba Ferramentas de IA, em Funções de IA: a lista de funções e o botão Adicionar Novo.](https://help.nextags.com.br/_img/ia-recursos/funcoes-lista.webp)
*1. Funções de IA. 2. Adicionar Novo. 3. As funções da conta.*

1. **Funções de IA**: as funções que os agentes podem usar.
2. **Adicionar Novo**: abre a janela da função.
3. As funções da conta. Clique numa para editar. No menu ⋮ ficam **Duplicar** e **Excluir**.

### Passo 2: Diga o que a função faz e que dados ela coleta

Na janela da função, preencha:

![Função de IA agendar_consultoria: nome, o que ela faz e os dados que coleta, data_horario e email, cada um ligado a um campo do contato.](https://help.nextags.com.br/_img/ia-recursos/funcao-dados.webp)
*1. Nome. 2. O que este acionador faz? 3. Um dado. 4. Adicionar Novo.*

1. **Nome**: até 64 caracteres. Use o formato do exemplo do campo, `book_appointment`: letras minúsculas, sem espaços, com sublinhado.
2. **O que este acionador faz?**: quando a IA deve usar a função e para quê, em até 500 caracteres. O campo vazio sugere *Permite ao usuário agendar um horário.*
3. **Quais dados coletar?**: à esquerda, o nome do dado (até 40 caracteres); à direita, o campo do contato que guarda o dado, como **Endereço de e-mail**. O × tira o dado.
4. **Adicionar Novo**: mais um dado. A função aceita até 30.

### Passo 3: Escolha o calendário, o fluxo e a mensagem

Mais abaixo, na mesma janela:

![Parte de baixo da função agendar_consultoria: Reserve no calendário, Qual fluxo é acionado, Qual mensagem é emitida? e o botão Continuar.](https://help.nextags.com.br/_img/ia-recursos/funcao-fluxo.webp)
*1. Reserve no calendário. 2. Qual fluxo é acionado. 3. Qual mensagem é emitida? 4. Continuar.*

1. **Reserve no calendário**: aparece quando um dado vai para um campo de data e hora e a conta tem calendário. À esquerda, o dado com o horário; à direita, o calendário. Veja [Agendar pela conversa: fluxo, IA ou Caixa de Entrada](https://help.nextags.com.br/tutoriais/agenda/agendar-pelo-fluxo/).
2. **Qual fluxo é acionado**: o fluxo que roda depois, ou **Nenhum**.
3. **Qual mensagem é emitida?**: opcional, até 100 caracteres. O campo vazio sugere *Você reservou um horário com sucesso.*
4. **Continuar**: salva a função.

### Passo 4: Ligue a função no agente

Na aba **Agentes de IA**, clique no agente. No cartão **Ferramentas de IA**, clique na lista e marque a função.

![Lista de Ferramentas de IA do agente com as funções de IA da conta, cada uma com o tipo Function à direita.](https://help.nextags.com.br/_img/ia-recursos/ferramentas-funcoes.webp)
*1. Uma função, com o tipo Function à direita.*

1. As funções aparecem com o tipo **Function**, à direita. As marcadas ganham ✓ e entram no campo, em cima.

Depois, clique em **Salvar**, no topo da tela.

## Pronto: como conferir

- Converse com o agente e peça o que a função faz, como marcar um horário. Veja [Testar e ajustar o agente](https://help.nextags.com.br/tutoriais/ia/testar-agente/).
- Na **Caixa de Entrada**, abra a conversa e confira no painel do contato os campos preenchidos.

## Se não funcionou

### A IA não usou a função

Deixe claro em **O que este acionador faz?** quando usar a função, com as palavras que o contato usa. Confira se a função está marcada nas **Ferramentas de IA** do agente que responde e se você clicou em **Salvar**.

### Não aparece Reserve no calendário

Um dos dados precisa ir para um campo de data e hora, e a conta precisa ter um calendário. Veja [Criar campos personalizados](https://help.nextags.com.br/tutoriais/fluxos/campos-personalizados/) e [Criar um calendário](https://help.nextags.com.br/tutoriais/agenda/criar-calendario/).

### O campo ficou vazio

Dê ao dado um nome claro, que diga o que coletar, como `email` ou `cidade`, e confira se ele está ligado ao campo certo.

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
Vou criar uma função de IA na NexTags. Leia este tutorial: https://help.nextags.com.br/tutoriais/ia/funcoes-do-agente.md

O que a função deve fazer: [descreva, por exemplo: registrar um pedido de orçamento]. Sugira o Nome no formato do exemplo, o texto de "O que este acionador faz?" (até 500 caracteres), a lista de dados para coletar com um nome claro para cada um e a mensagem de confirmação (até 100 caracteres).
```

> **Funções pela API:**
> Para listar as funções a partir do seu sistema, use a API: [Listar funções dos agentes](https://docs.nextags.com.br/referencia/agentes-de-ia/listar-funcoes-dos-agentes/).