Visão geral
Saúde da infraestrutura e atividade recente.
Configuração rápida
Use estes atalhos depois de entrar no Admin.
Infraestrutura
Resultado do setup e testes de saúde.
Atividade recente
Últimos eventos registrados pelo Gateway.
Bots / empresas
Cada empresa possui identidade, prompts, Chatwoot, RAG, regras e conversas isolados.
Novo bot / empresa
A criação inicial não copia conhecimento nem inventa um canal Chatwoot. O slug identifica a empresa nas integrações.
Bots cadastrados
Configurar troca o contexto do painel; nada de uma empresa é carregado na outra.
| Empresa | Bot | Slug | Estado | ID | Ações |
|---|
Usuários e acessos
Gerencie credenciais e atribua cada usuário a uma ou várias empresas.
Conta local de recuperaçãoAcesso técnico do Gateway
Cadastre contas locais e limite cada usuário às empresas autorizadas.
Usuários cadastrados
Contas recebidas por SSO são somente leitura; contas locais permanecem editáveis.
| Usuário / nome | Perfil / estado | Empresas | Nova senha | Ação |
|---|
Identidade e mensagens
Personalize a empresa e o comportamento visível do assistente.
Prévia do logo
Imagens pequenas são recomendadas quando salvas como data URL.
IA e providers / chaves
Prompts, embeddings, modelos, credenciais e ordem de fallback.
Bot em configuração: —
Os prompts abaixo, as regras e o RAG pertencem somente ao bot/empresa ativo no seletor superior. Providers podem ser compartilhados conforme o escopo configurado.
Onde cadastrar as API keys
Você está em Admin → IA e providers / chaves. Na tabela “Providers e fallback”:
- Marque o provider como Habilitado e defina a prioridade — o menor número responde primeiro.
- Confira modelo e Base URL, informe a chave no campo API key e clique em Salvar.
- Clique em Testar e confirme que a saúde ficou “saudável”.
Cloudflare AI: além do token, informe a Base URL https://api.cloudflare.com/client/v4/accounts/SEU_ACCOUNT_ID/ai/v1, substituindo SEU_ACCOUNT_ID pelo Account ID exibido no dashboard Cloudflare. O token deve ter permissões Workers AI Read e Workers AI Edit.
Persistência e segurança: as chaves são cifradas pelo Gateway e gravadas no PostgreSQL persistente. Elas sobrevivem a reinícios dos containers; mantenha a GATEWAY_ENCRYPTION_KEY estável e faça backup do banco. Nunca coloque chaves de providers no Cloudflare Pages, em JavaScript/frontend, no Git ou em arquivos publicados. Depois de salvar, a chave não é exibida novamente.
Agentes especializados e prompts
Um único bot atende o canal, mas roteia internamente entre Triagem, Comercial, SAC e Assistência Técnica. O agente de Qualidade valida a saída antes do envio. Regras contra prompt injection e invenção permanecem protegidas no código.
Providers globais, API keys e fallback
A menor prioridade é tentada primeiro. Cada provider atende todas as empresas ou somente as selecionadas; não existem cópias locais.
| Provider | Ativo / prioridade | Escopo | Modelo / endpoint | Geração / timeout | Custos por milhão | Credencial | Saúde | Ações |
|---|
Nova credencial de provider
Cadastre quantas credenciais forem necessárias, inclusive várias contas do mesmo tipo, cada uma com nome, prioridade e escopo próprios.
Integração Chatwoot
Entrega de respostas, múltiplos canais, webhook e transferência humana.
Roteamento por setor
Cada plataforma continua sendo uma inbox técnica do Chatwoot, mas todas pertencem à mesma empresa. Quando houver transferência humana, o Gateway escolhe a equipe pelo assunto da conversa, independentemente de ela ter começado no WhatsApp, Instagram, Facebook ou site.
Compra, preço, disponibilidade e negociação.
Dúvidas, configuração e ajuda técnica.
Pedido, pagamento, entrega, troca e garantia.
Os IDs padrão acima continuam sendo usados quando o setor ainda não puder ser identificado ou não possuir uma rota específica.
Horário comercial
Dias 0 a 6 representam domingo a sábado.
Conhecimento / RAG
Documentos, chunks e embeddings indexados no pgvector.
Como indexar a planilha inicial
Você está em Admin → Conhecimento / RAG. Clique em escolher arquivo, selecione data/rag/respostas_rapidas.xlsx dentro do projeto e depois clique em Importar e indexar. Quando concluir, confirme abaixo que o documento está com status ready e que possui chunks e embeddings.
A indexação é persistida no PostgreSQL/pgvector e continua disponível após reiniciar os containers. O mesmo conhecimento recuperado é enviado ao provider principal ou ao provider de fallback; não é necessário importar uma cópia para cada IA.
Importar documento
Formatos: XLSX, PDF, DOCX, Markdown, TXT e HTML. Limite de 25 MB.
Fontes indexadas
Exclusão remove todos os chunks da fonte selecionada.
| Documento | Fonte / identificador | Chunks | Embeddings | Última indexação | Status | Ações |
|---|
Tools
Conecte APIs externas reais; testes nunca usam respostas mockadas.
| Tool | Ativa / endpoint | Timeout | Autenticação | Status | Ações |
|---|
Atualização de catálogo
Atualiza preço e estoque no RAG em segundo plano.
Sem fonte configurada.
Operação e regras
Conversas, regras por empresa, modelos utilizados, logs, tokens e custo estimado.
Regras de negócio da empresa
Edite o conhecimento conversacional derivado do bot.json somente para a empresa ativa.
Carregar um arquivo não salva automaticamente. Revise o JSON e clique em “Salvar regras”.
Conversas
| Conversa | Status | Agente | Última IA | Última mensagem | Atualização |
|---|
Logs e custos
| Data | Conversa | Provider / modelo | Tokens | Custo | Latência / Tools | Resultado |
|---|
Melhoria contínua
Resultados reais, revisão humana, datasets e publicação segura de prompts.
Aprendizado autônomo com aprovação enxuta
O Gateway consolida muitas conversas em poucos candidatos de comportamento. Repetição não é tratada como verdade: são exigidos clientes distintos, resultados verificados, baixa contradição e confiança mínima. Preço, desconto, garantia e política nunca são aprendidos do texto das conversas; permanecem bloqueados até existir RAG, regra ou Tool oficial.
Candidatos consolidados
Revise cards agregados, não respostas temporárias. Uma aprovação aplica apenas a tática segura; fatos comerciais continuam obrigatoriamente consultados em fontes atuais.
| Candidato | Evidência | Confiança / risco | Estado |
|---|
Conversa em foco
Informe o identificador externo ou escolha uma conversa na tabela abaixo. Os quatro controles usam este mesmo ID.
Resultado comercial
Use uma evidência real; não deduza venda apenas pelo texto da IA.
Pedido ou pagamento
Vincule o identificador da fonte e registre se a evidência foi verificada.
Feedback humano
Avalie uma resposta específica ou a conversa inteira e registre a resposta esperada quando necessário.
Conversas e resultados
Dados retornados pelo resumo de melhoria contínua.
| Conversa | Resultado | Comércio | Feedback | Última avaliação | Ação |
|---|
Datasets versionados
Materializar dataset
Cria uma versão imutável a partir dos exemplos elegíveis atuais.
Datasets e versões
Publicar promove somente a versão selecionada.
| Dataset | Versão | Itens | Status | Criação | Ação |
|---|
Avaliações automáticas
Resultados produzidos pelo avaliador para conversas selecionadas.
| Conversa | Status | Nota | Resultado | Versão de prompt | Data |
|---|
Prompts: versão, comparação e publicação
Criar versão candidata
O conteúdo só chega à produção após aprovação e release.
Aguardando o bundle atual.
Comparar versões
Registra uma comparação reproduzível entre base e candidata.
Versões de prompt
Definição: assistant-bundle
| Versão | Status | Descrição | Criador / aprovação | Data | Ação |
|---|
Conteúdo proposto
Este é o texto exato que você está avaliando.
Publicar release
Use canário para limitar a candidata a uma parcela das conversas.
Histórico de releases
| Tipo | Principal / canário | Data |
|---|
Comparações registradas
| Base | Candidata | Resultado | Data |
|---|