XBASE

Como funciona

Agentes de IA na XBASE

Um agente de IA é um assistente que conversa com os seus contatos nos canais da empresa, como o WhatsApp. Ele responde sozinho, com base no que sabe sobre o seu negócio, e a equipe assume a conversa quando quiser.

Na XBASE, os agentes ficam em Agentes IA, no menu. Para criar o primeiro, siga o passo a passo.

Atualizado em 7 min de leitura

Nesta página

Os dois tipos de agente

TipoO que éPara quem
Nativoa IA da XBASE lê o site, o Instagram e as suas instruções e monta o agente para vocêquem quer um agente pronto, sem programar
Externoum agente que já roda fora da XBASE (por exemplo, no n8n ou numa API própria). A XBASE manda cada mensagem para o endereço dele e entrega a resposta ao contatoquem já tem um agente e só quer ligá-lo aos canais da XBASE

O tipo aparece no card de cada agente, ao lado do status. O agente Externo é configurado fora da XBASE: aqui ficam só o endereço, o token e os canais.

Como o agente Nativo é criado

Na criação, você informa o site, o Instagram e os objetivos do agente, e pode escrever instruções adicionais. A IA da XBASE:

  • lê a página inicial do site e até 7 páginas internas;
  • lê o perfil público do Instagram: nome, bio e o que aparece sem login;
  • monta as instruções do agente, com um roteiro de conversa para cada objetivo.

A tela mostra o andamento. No fim, ela lista O que o agente ainda não sabe e as fontes que não puderam ser lidas. Complete essas lacunas nas instruções do agente.

O modelo de IA do agente Nativo é definido pela XBASE: você não escolhe na criação.

O que dá para configurar

Abra o agente em Agentes IA. No agente Nativo, as principais áreas são:

  • Painel: os cards Canais Conectados (onde o agente atende), Instruções do Agente (o texto que define o papel, o tom e as regras do agente), Modelo de Inteligência, Observabilidade & Análise e Objetivos do Agente.
  • Memória → Conhecimento: arquivos que o agente consulta para responder, como catálogos e políticas.
  • Aprendizados: sugestões de melhoria tiradas das conversas, quando a avaliação automática está ligada.
  • Webchat: aparência e código do chat do site.

As instruções têm Histórico de versões: dá para voltar a uma versão anterior.

No agente Externo, o Painel mostra o card Webhook do agente (endereço, token e tempo máximo de resposta, com o botão Testar webhook) e os canais.

Onde o agente atende

CanalNativoExterno
WhatsApp (API oficial da Meta)ainda nãosim
Chat do sitesimnão
Instagram (mensagens diretas)ainda nãonão
  • Cada número ou conta é atendido por um agente só. Um agente pode atender vários números.
  • Para escolher os canais, use o card Canais Conectados, no Painel do agente: um interruptor por número. O botão Adicionar canal conecta um canal novo.
  • Ligar o agente num número que já tem outro agente pede confirmação: o novo agente passa a atender o número, inclusive as conversas em andamento.
  • Só quem tem permissão para gerenciar integrações muda os canais de um agente.

Para colocar o agente no seu site, veja como colocar o chat no seu site.

Como o agente responde no WhatsApp

Em cada número, o bloco Como o agente responde define:

  • Esperar antes de responder (segundos): mensagens seguidas do contato dentro desse tempo são respondidas juntas. No agente Nativo, vem com 10 segundos; no Externo, com 0 (responde na hora). O máximo é 600.
  • Formato: Uma mensagem só ou Várias mensagens curtas (um parágrafo por mensagem). No segundo caso, cada mensagem curta é cobrada pela Meta separadamente.
  • Pausar quando um atendente assumir: já vem ligada. Com ela, o agente para de responder quando alguém da equipe responde a conversa.

O bloco fica na janela Agente de IA do número, em Canais. Os detalhes de templates e da janela de 24 horas estão em WhatsApp no Chatcenter.

Quando o agente para e a equipe assume

O agente não responde uma conversa quando:

  • alguém da equipe assume a conversa: no cabeçalho dela, o seletor IA responde / Humano mostra quem está atendendo;
  • a conversa tem a etiqueta "Atendimento Humano";
  • o agente está Pausado. O interruptor de status fica no topo da página do agente, e pausar pede confirmação: o agente para de responder em todos os canais até você ativá-lo de novo;
  • os créditos de IA do workspace acabaram (veja abaixo).

Para devolver a conversa, clique em IA responde, no cabeçalho da conversa. O agente volta a responder a partir da próxima mensagem do cliente. Mais detalhes em WhatsApp no Chatcenter.

Status do agente

StatusO que quer dizer
Ativoo agente responde nos canais ligados a ele
Pausadovocê desligou o agente; ele não responde em nenhum canal
Rascunhoo agente Nativo ainda não terminou de ser criado, ou a criação falhou
Falhahouve um erro com o agente

Só um agente Ativo pode ser ligado a um canal.

Créditos e custos

  • Agente Nativo: cada resposta usa um modelo de IA e consome créditos de IA do saldo do workspace. A criação do agente com a IA da XBASE também consome créditos. O consumo aparece em Uso e consumo.
  • Agente Externo: o processamento é feito fora da XBASE e não consome créditos de IA.
  • Sem créditos: o agente Nativo para de responder. A conversa mostra, só para a equipe, o aviso "IA pausada: créditos esgotados", e nada é enviado ao cliente. Quando o saldo volta, o agente responde a partir da próxima mensagem; as mensagens que ficaram para trás não são respondidas.
  • Mensagens do WhatsApp: as respostas do agente pelo WhatsApp também seguem a cobrança da Meta, como as da equipe. Veja Cobrança do WhatsApp.
  • Avaliação automática: se você ligar a Observabilidade, cada avaliação também consome créditos. Veja Avaliação automática das conversas.

Os planos e a recarga de créditos estão em Planos, créditos e faturamento e na página de preços.

Regras e limites

  • Para criar um agente Nativo, informe pelo menos uma fonte: o site, o Instagram ou instruções adicionais com 30 caracteres ou mais.
  • Objetivos: de 1 a 5 por agente. O primeiro é o principal.
  • Instruções adicionais: até 4.000 caracteres.
  • O Instagram precisa ser um perfil público. Perfil privado ou que só abre com login não pode ser lido.
  • Agente Externo: o endereço do webhook precisa começar com https://, e o tempo máximo de resposta vai de 1 a 120 segundos (padrão: 60).
  • Criar e editar agentes exige permissão para gerenciar agentes no workspace.

Perguntas frequentes

Qual tipo de agente devo escolher?

Escolha Nativo se você quer que a XBASE monte o agente a partir do seu site, do Instagram e das suas instruções. Escolha Externo só se você já tem um agente rodando fora da XBASE, com um endereço de webhook.

Posso escolher o modelo de IA do agente Nativo?

Na criação, não: o modelo é definido pela XBASE. Ele aparece no card Modelo de Inteligência, no Painel do agente.

Posso editar as instruções que a IA escreveu?

Sim. No Painel do agente, abra o card Instruções do Agente e edite em tela cheia. O Histórico de versões guarda as versões anteriores.

Um número de WhatsApp pode ter dois agentes?

Não. Cada número é atendido por um agente só. Ao ligar outro agente, ele passa a atender o número no lugar do anterior.

O agente Externo funciona no chat do site?

Não. O chat do site só funciona com agente Nativo. O agente Externo atende pelo WhatsApp.

O que acontece quando os créditos acabam?

O agente Nativo para de responder e a conversa mostra o aviso IA pausada: créditos esgotados, só para a equipe. Depois da recarga, ele volta a responder a partir da próxima mensagem do cliente.

Como faço o agente parar de responder uma conversa?

No cabeçalho da conversa, clique em Humano e confirme em Assumir. Para parar o agente em todos os canais, pause o agente no interruptor de status, no topo da página dele.

Veja também