Índice da documentação
Visão geral
Documentação do Genius Hub
Tudo o que você precisa para colocar um agente para atender: do primeiro agente à conexão do WhatsApp, até a integração com outros sistemas. A inteligência artificial já vem incluída na plataforma. Você não contrata nem configura nenhum provedor de IA.
Escolha o caminho
Cada guia começa do zero e termina com o que testar antes de seguir em frente.
Primeiros passos
Na ordem. Cada etapa depende da anterior, e tudo pode ser feito no painel, sem instalar nada.
- 1Crie o agenteEm Agentes, escolha um modelo pronto ou comece em branco. Defina a função, o tom e as regras.
- 2Alimente a base de conhecimentoSuba PDFs, planilhas e documentos oficiais: preços, prazos e políticas.
- 3Teste no chatConverse com o agente como um cliente faria, incluindo as perguntas difíceis.
- 4Conecte o WhatsAppCrie o canal e leia o QR Code com o celular que vai atender.
- 5Acompanhe e ajusteEm Conversas você lê tudo, assume quando quiser e devolve para a IA depois.
Conceitos básicos
Três termos aparecem em quase todos os guias.
Base de conhecimento
Os arquivos que o agente consulta. Cada um pode ser lido por busca (o padrão, para quase tudo) ou por completo (para material curto e crítico, que entra em toda mensagem).
O modo “por completo” tem teto de cerca de 12 mil caracteres somados no agente inteiro.
Créditos
O consumo de inteligência artificial é medido em créditos. A tela de Consumo mostra quanto cada agente gastou, por período, antes de a fatura chegar.
Chave de API
Só é necessária para conectar o Hub a outro sistema. Ela começa com ghk_ e tem as mesmas permissões da sua conta, nem mais, nem menos. Para usar o painel, você não precisa de chave.
Problemas comuns
Se algo parou, comece por aqui. Cada linha leva ao guia com o diagnóstico completo.
| Sintoma | Onde olhar |
|---|---|
| O agente não responde no WhatsApp | Status do canal, webhook (na Z-API) e se a conversa está assumida por uma pessoa. |
| Ele não usa um documento que subi | Se o arquivo já está indexado e o que a busca de teste devolve para a pergunta. |
| Ele inventa preço, prazo ou regra | Informação ausente da base, ou duas fontes divergentes. Suba o material oficial. |
| Uma integração parou de funcionar | Situação e último uso da chave em Configurações → Integração (API). Gere outra se preciso. |
Segurança
A chave aparece uma vez
Depois de gerada, a chave só mostra os primeiros caracteres. Revogar não apaga o registro: a trilha de auditoria continua mostrando o que aquela chave fez.
Cada conta enxerga a sua
Agentes, conversas e arquivos são isolados por organização. Uma chave alcança apenas o que a conta dela alcança.
Documentos ficam com o agente
A base de conhecimento de um agente é usada só por ele. Apagar um arquivo apaga também os trechos indexados a partir dele.
Suporte