Agentes de IA

Crie agentes de IA que atendem sozinhos e transferem para humano quando preciso.

Configurar seu provedor de IA (chave própria)

Cadastre a sua própria chave de IA (OpenAI ou Anthropic) para que os agentes possam pensar e responder — é o primeiro passo antes de criar qualquer agente.

🧩 Este recurso faz parte do módulo Agentes Inteligentes. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja [Entender planos, módulos e o que está incluído](/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido).

Objetivo

Salvar uma chave de IA própria (BYO-key) em Provedores, deixando-a pronta para ser usada pelos agentes.

Pré-requisitos

Tempo estimado

5 minutos.

Caminho de acesso

Bots → Agentes Inteligentes → botão Provedores

Passo a passo

  1. Na tela Agentes Inteligentes, clique em Provedores, no topo direito. Abre a janela Provedores.

🖼️ PRINT — Janela Provedores com a lista de credenciais e o botão Adicionar provedor na base.

  1. Clique em Adicionar provedor.
  2. Preencha o Nome — é só um rótulo interno para você reconhecer a chave (ex.: "OpenAI (produção)").
  3. Em Tipo, escolha OpenAI (ChatGPT) ou Anthropic (Claude), conforme o provedor da sua chave.
  4. Cole a chave em Chave da API. Ela é do tipo senha e não fica visível na tela.
  5. Clique em Salvar. A chave é validada junto ao provedor no momento de salvar.

Resultado esperado

Aparece a mensagem "Provedor criado" e a credencial passa a constar na lista, mostrando o tipo e apenas uma dica final da chave (as chaves nunca são exibidas de volta por segurança). Ao editar, o campo Chave da API fica vazio — digite uma nova chave só quando quiser substituir a atual.

Erros comuns

Artigos relacionados

Criar um agente de IA no builder

Monte um agente de IA que atende os seus contatos automaticamente, passando pelo assistente em quatro passos: identidade, comportamento, conhecimento e configurações.

🧩 Este recurso faz parte do módulo Agentes Inteligentes. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja [Entender planos, módulos e o que está incluído](/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido).

📹 VÍDEO — Passo a passo completo: abrir o assistente, preencher o passo Perfil, escrever as instruções em Comportamento, vincular uma base em Conhecimento e escolher o provedor em Configurações. Cole o embed do YouTube neste ponto.

Objetivo

Criar um agente de IA no assistente e salvá-lo pronto para uso.

Pré-requisitos

Tempo estimado

10 minutos.

Caminho de acesso

Bots → Agentes Inteligentes → aba Agentes → Novo agente

Passo a passo

  1. Na aba Agentes, clique em Novo agente. Abre o assistente com os passos Perfil, Comportamento, Conhecimento e Configurações na lateral.

🖼️ PRINT — Janela Novo agente com a navegação lateral (Perfil, Comportamento, Conhecimento, Configurações) e o passo Perfil aberto.

  1. No passo Perfil, preencha o Nome (obrigatório) e, se quiser, um Apelido. Defina o Tom (ex.: Consultivo e Acolhedor), o Formato / comprimento, o Perfil (ex.: Vendedor, SDR, Suporte) e o Objetivo do agente. Use Assinar a conversa para acrescentar a assinatura ao fim de cada resposta.
  2. No passo Comportamento, escreva as Instruções (system prompt) que orientam o agente e, se necessário, Outras regras / restrições. Dicas de redação em Escrever boas instruções (prompt) para o agente.
  3. No passo Conhecimento, marque as bases que o agente pode consultar. Para criar bases, veja Alimentar a base de conhecimento (upload de documentos / RAG).
  4. No passo Configurações, escolha o Provedor (obrigatório) e o Modelo. Ajuste, se quiser, Máx. turnos, Máx. tokens e a Transferência para humano (veja Definir supervisão humana e hand-off para agente humano).
  5. Clique em Salvar.

Resultado esperado

Aparece a mensagem "Agente criado" e o agente passa a constar na aba Agentes como um card. Todo agente novo nasce como Rascunho — ao editá-lo, mude o Status para Ativo no passo Configurações quando estiver pronto para atender.

Erros comuns

Artigos relacionados

Alimentar a base de conhecimento (upload de documentos / RAG)

Ensine o agente com os seus próprios materiais — cole textos ou envie arquivos (FAQ, manual, catálogo) e o AtendeBot indexa tudo para o agente consultar durante o atendimento.

🧩 Este recurso faz parte do módulo Agentes Inteligentes. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja [Entender planos, módulos e o que está incluído](/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido).

📹 VÍDEO — Passo a passo completo: criar uma base em Nova base, indexar um texto colado e um arquivo enviado, e reindexar. Cole o embed do YouTube neste ponto.

Objetivo

Criar uma base de conhecimento e alimentá-la com textos e documentos para o agente responder com base neles (RAG).

Pré-requisitos

Tempo estimado

10 minutos.

Caminho de acesso

Bots → Agentes Inteligentes → aba Base de conhecimento → Nova base

Passo a passo

  1. Abra a aba Base de conhecimento e clique em Nova base.

🖼️ PRINT — Aba Base de conhecimento com o botão Nova base destacado no topo direito.

  1. Preencha o Nome e escolha o Tipo: Grupo de arquivos, Perguntas e Respostas ou Tabela.
  2. Em Quando usar, descreva quando o agente deve consultar esta base (ex.: "Use para responder sobre preços e disponibilidade de produtos"). Esse texto vira a descrição da ferramenta que o agente usa para decidir quando abrir a base.
  3. Escolha o Provedor (obrigatório, exceto no tipo Tabela, que usa consulta exata) e clique em Criar base.
  4. Com a base salva, no tipo Grupo de arquivos aparece o editor de conteúdo. Cole um texto no campo Colar texto e clique em Adicionar texto, ou clique em Enviar arquivo para subir um documento (txt, md, csv, pdf, docx).

🖼️ PRINT — Editor da base com o campo Colar texto, os botões Adicionar texto e Enviar arquivo, e a lista de Arquivos com a contagem de trechos.

  1. Confira a lista Arquivos, que mostra quantos trechos foram indexados. Para reprocessar tudo após mudanças, clique em Reindexar.

Resultado esperado

Cada texto ou arquivo indexado aparece na lista com o número de trechos, e o card da base mostra o total de "trechos indexados". Deixe a base com Status Ativo e vincule-a ao agente no passo Conhecimento (veja Criar um agente de IA no builder).

Erros comuns

Artigos relacionados

Escrever boas instruções (prompt) para o agente

Escreva instruções claras para o agente saber quem é, o que deve fazer e o que nunca pode fazer — é o que separa um atendimento bom de um genérico.

🧩 Este recurso faz parte do módulo Agentes Inteligentes. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja [Entender planos, módulos e o que está incluído](/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido).

Objetivo

Preencher bem as Instruções (system prompt) e o Objetivo do agente para que ele responda no tom e nos limites certos.

Pré-requisitos

Tempo estimado

15 minutos.

Caminho de acesso

Bots → Agentes Inteligentes → aba Agentes → abra o agente → passo Comportamento

Passo a passo

  1. Abra o agente e vá ao passo Comportamento.

🖼️ PRINT — Passo Comportamento com o campo Instruções (system prompt) e o campo Outras regras / restrições.

  1. No campo Instruções (system prompt), descreva em texto corrido: quem é o agente, o público que atende, o objetivo da conversa e como ele deve se comportar. Seja específico — "Você é o atendente virtual da Loja X, especializado em tênis de corrida" funciona melhor do que "Seja útil".
  2. Liste no campo Outras regras / restrições os limites inegociáveis, um por linha (ex.: "Nunca prometer descontos", "Não falar de concorrentes", "Quando não souber, transferir para um humano").
  3. No passo Perfil, alinhe o Tom (Consultivo e Acolhedor, Neutro e Equilibrado ou Formal e Institucional), o Formato / comprimento e o Objetivo com o que você escreveu nas instruções — eles se reforçam.
  4. Clique em Salvar e teste o agente em uma conversa real antes de deixá-lo Ativo.

Resultado esperado

O agente responde no tom escolhido, mantém o foco no objetivo e respeita as restrições que você listou. Ao pré-visualizar o Tom e o Formato / comprimento no passo Perfil, você vê um exemplo de resposta no estilo selecionado.

Erros comuns

Artigos relacionados

Definir supervisão humana e hand-off para agente humano

Garanta que ninguém fique preso conversando com a IA: configure quando e para qual equipe o agente deve passar a conversa a um atendente humano.

🧩 Este recurso faz parte do módulo Agentes Inteligentes. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja [Entender planos, módulos e o que está incluído](/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido).

Objetivo

Definir a Transferência para humano do agente, indicando a equipe e a mensagem para quando o contato pede um humano ou quando há problema com o agente.

Pré-requisitos

Tempo estimado

5 minutos.

Caminho de acesso

Bots → Agentes Inteligentes → aba Agentes → abra o agente → passo Configurações

Passo a passo

  1. Abra o agente e vá ao passo Configurações. Role até o bloco Transferência para humano.

🖼️ PRINT — Bloco Transferência para humano com os dois seletores de equipe (Equipe — pedido do contato e Equipe — problema com o agente) e os campos de mensagem.

  1. Em Equipe — pedido do contato, escolha para qual equipe vai a conversa quando o próprio contato pede para falar com um humano. Deixe em Equipe padrão do canal para usar a fila padrão.
  2. Se quiser, escreva a mensagem que o contato recebe no momento dessa transferência.
  3. Em Equipe — problema com o agente, escolha a equipe que recebe a conversa quando o agente não consegue seguir (ex.: erro ou assunto fora da competência). Também aceita Equipe padrão do canal e uma mensagem opcional.
  4. Confira, no passo Comportamento, se a habilidade Transferir atendimento está ativa — é ela que permite ao agente encaminhar a conversa quando o contato pede.
  5. Clique em Salvar.

Resultado esperado

Quando o contato pede um humano — ou quando o agente encontra um problema — a conversa sai da IA e entra na fila da equipe escolhida, com a mensagem de transferência que você definiu. Se você deixou Equipe padrão do canal, a conversa segue a regra padrão do canal.

Erros comuns

Artigos relacionados

Configurar um Supervisor de IA

Use um Supervisor de IA quando você tem vários agentes especialistas: ele lê cada conversa e a encaminha ao agente certo, funcionando como uma recepção inteligente.

🧩 Este recurso faz parte do módulo Agentes Inteligentes. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja [Entender planos, módulos e o que está incluído](/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido).

Objetivo

Criar um Supervisor de IA que roteia cada conversa para o agente especialista mais adequado.

Pré-requisitos

Tempo estimado

10 minutos.

Caminho de acesso

Bots → Agentes Inteligentes → aba Supervisores → Novo supervisor

Passo a passo

  1. Abra a aba Supervisores e clique em Novo supervisor. Abre o assistente com os passos Perfil, Roteamento e Configurações.

🖼️ PRINT — Janela Novo supervisor com a navegação lateral (Perfil, Roteamento, Configurações).

  1. No passo Perfil, preencha o Nome (ex.: "Recepção") e, se quiser, a Descrição.
  2. No passo Roteamento, escreva as Instruções de roteamento dizendo como decidir o destino (ex.: "dúvidas técnicas → Suporte; preços e planos → Vendas"). Logo abaixo, selecione os agentes que fazem parte deste supervisor.
  3. No passo Configurações, escolha o Provedor (obrigatório) e o Modelo de roteamento.
  4. No bloco Transferência para humano, defina a Equipe — sem agente compatível (quando nenhum agente serve) e a Equipe — problema no roteamento, cada uma com uma mensagem opcional.
  5. Clique em Salvar.

Resultado esperado

Aparece a mensagem "Supervisor criado" e ele passa a constar na aba Supervisores como um card. Ao editá-lo, mude o Status para Ativo quando quiser colocá-lo para rotear conversas.

Erros comuns

Artigos relacionados

Monitorar uso e custos do agente

Acompanhe quanto os seus agentes consumiram no mês, veja o gasto por agente e defina um teto para não ter surpresas na fatura da IA.

🧩 Este recurso faz parte do módulo Agentes Inteligentes. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja [Entender planos, módulos e o que está incluído](/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido).

Objetivo

Consultar o uso e os custos de IA do mês e, se quiser, definir um teto mensal de gasto.

Pré-requisitos

Tempo estimado

5 minutos.

Caminho de acesso

Bots → Agentes Inteligentes → botão Uso e Custos

Passo a passo

  1. Na tela Agentes Inteligentes, clique em Uso e Custos, no topo direito. Abre a janela Uso e Custos de IA.

🖼️ PRINT — Janela Uso e Custos de IA com os cartões Custo estimado, Tokens e Turnos e a tabela Por agente.

  1. Confira os cartões do mês atual: Custo estimado, Tokens e Turnos. Os custos são estimativas em dólar, conforme o modelo usado.
  2. Na tabela Por agente, veja o consumo detalhado de cada agente — Turnos, Tokens, Custo e Latência méd.
  3. Para limitar o gasto, ative Limitar gasto mensal, informe o valor em Teto mensal (US$) e clique em Salvar teto. A barra Uso do teto mostra o quanto já foi consumido.

Resultado esperado

Aparece a mensagem "Teto atualizado" e a barra Uso do teto passa a acompanhar o percentual consumido. Ao atingir o teto, novos turnos de IA são transferidos automaticamente para um atendente humano — os agentes param de responder sozinhos até o próximo mês ou até você aumentar o limite.

Ajuste o consumo por agente

O gasto de cada agente depende de dois limites definidos no passo Configurações do agente (veja Criar um agente de IA no builder):

Reduzir esses valores diminui o custo por conversa; aumentá-los deixa o agente mais "conversador" e mais caro.

Erros comuns

Artigos relacionados