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.
Empresas
Cadastre e mantenha os tenants disponíveis nesta instalação.
Nova empresa
O slug identifica a empresa em integrações e URLs de webhook.
Empresas cadastradas
Selecionar troca imediatamente o contexto operacional do painel.
| Nome | Slug | Estado | ID | Ações |
|---|
Usuários e acessos
Gerencie credenciais e atribua cada usuário a uma ou várias empresas.
Novo usuário
A senha é enviada somente ao backend e nunca volta para o painel.
Usuários cadastrados
A nova senha é opcional durante a edição.
| 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.
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.
Prompts por contexto
Instruções persistidas para o tenant. Use o Prompt principal para editar tom, saudação personalizada e como apresentar dados retornados pelas APIs. Regras de segurança contra invenção e exposição de dados pessoais 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 |
|---|
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 | Ú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.
Ciclo controlado de aprendizagem
Nada é aprendido ou publicado sozinho. Primeiro você registra o que aconteceu e a resposta correta. Depois o sistema cria uma proposta legível. Antes de aprovar, abra Ver conteúdo para ler exatamente o texto sugerido; aprovar ainda não publica, e publicar é uma etapa separada.
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 |
|---|