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.

Os dois tipos de agenteCopy Anchor Link

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 é criadoCopy Anchor Link

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 configurarCopy Anchor Link

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 atendeCopy Anchor Link

• 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 você conversar com o agente: no Chatcenter, clique em Nova conversa, escolha Agente, selecione o agente e clique em Criar Conversa. O Título é opcional: sem ele, a conversa leva o nome do agente. A conversa fica só entre você e o agente, sem contato nem canal, e o agente dela já vem selecionado sempre que você a abre. Só aparecem agentes Nativos e Ativos.

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

Como o agente responde no WhatsAppCopy Anchor Link

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 assumeCopy Anchor Link

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 agenteCopy Anchor Link

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

Créditos e custosCopy Anchor Link

• 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 limitesCopy Anchor Link

• 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 frequentesCopy Anchor Link

Veja tambémCopy Anchor Link