Comece a usar o Agente de IA do Knocket

Visão geral — como o console está organizado

O Agente de IA fica entre uma mensagem recebida de um visitante e sua caixa de entrada. Se conseguir responder com confiança usando o conhecimento que você forneceu, ele responde instantaneamente no idioma do visitante. Se não conseguir — ou se o visitante pedir para falar com uma pessoa —, ele transfere o chat discretamente e envia uma notificação pelos seus canais de notificação.

Na barra lateral esquerda do console, Agente de IA é um grupo com três subpáginas. Todo este tutorial segue essa mesma hierarquia para que você encontre cada tela rapidamente:

• Configuração — a página principal de configuração, com quatro cartões recolhíveis em uma única tela
  • Agente de IA — controle principal, quais canais o agente atende e quando está ativo
  • Bot — avatar, nome, saudação e prompt do sistema que os visitantes veem
  • LLM — provedor, chave de API, endpoint e modelo que geram as respostas
  • Transferência — frases de acionamento e para onde as notificações de transferência são enviadas
• Conhecimento — três abas em uma única página: pares de Perguntas frequentes, rastreamento de URLs e uploads de Arquivos que o agente consulta no momento da resposta
• Uso — solicitações diárias, consumo de tokens por modelo, distribuição por canal

Configuração — uma página, quatro cartões

Clique em Agente de IA → Configuração na barra lateral. Você chegará a uma página com quatro cartões recolhíveis: Agente de IA, Bot, LLM e Transferência. Cada um exibe um ponto verde quando está totalmente configurado. Um único botão Salvar, na parte inferior, aplica as alterações nos quatro.

O Agente de IA cartão — ative-o, escolha os canais e os horários

O cartão superior é o controle principal. Ative o botão no canto superior direito; o selo Conectado fica verde assim que a comunicação com o LLM é estabelecida.

Canais do Agente de IA — escolha em quais dos seus três pontos de entrada o agente deve responder. Ative qualquer combinação:

• Widget Web — o balão de chat no seu site.
• Widget para dispositivos móveis — o balão de chat incorporado ao seu aplicativo nativo / RN / Flutter.
• Página de Contacto — a página de perfil partilhável da knocket.ai.

Um canal desativado ainda encaminhará mensagens para a sua caixa de entrada — elas simplesmente irão direto para uma pessoa, sem passar primeiro pela IA.

Tempo de suporte do agente de IA:

• Sempre — o agente responde 24 horas por dia, 7 dias por semana, em paralelo com sua equipe.
• Quando estiver offline — o agente só responde fora do horário de expediente, portanto suas respostas humanas continuam sendo o padrão quando você está disponível.

O Robô cartão — avatar, nome, saudação, prompt do sistema

Expanda o cartão Bot. Isto é o que o visitante vê e como o modelo se comporta. São quatro campos, todos obrigatórios, exceto o avatar:

• Avatar — JPG/JPEG/PNG, até 1 MB. Arraste e largue ou clique para carregar. Se ficar em branco, o widget apresentará um cabeçalho apenas com texto.
• Nome — o nome de exibição no cabeçalho do chat (por exemplo, Assistente de IA, Pergunte à Acme).
• Saudação — até 400 caracteres. A primeira mensagem que o agente envia quando um visitante abre o chat.
• Prompt do sistema — até 2.000 caracteres. Um resumo em linguagem simples que o modelo lê no início de cada conversa.

O modelo predefinido de instruções do sistema incluído na consola é um bom ponto de partida — mantenha-o curto, defina explicitamente as responsabilidades e as regras e recorra à base de conhecimento em vez de instruir o modelo a memorizar factos:

Você é um agente de suporte ao cliente com tecnologia de IA. Você ajuda os visitantes do site respondendo a perguntas sobre os produtos, a documentação, os preços e os serviços da empresa. Suas responsabilidades: - Pesquisar e usar a base de conhecimento fornecida para responder às perguntas dos usuários. - Fornecer respostas claras, precisas e concisas. - Direcionar os usuários a recursos úteis quando disponíveis. - Encaminhar para o suporte humano quando não puder resolver o problema. Regras: - Nunca invente informações. - Responda apenas com base nas fontes de conhecimento fornecidas. - Se as informações não estiverem disponíveis, informe isso educadamente. - Mantenha um tom profissional de suporte ao cliente.

O LLM cartão — provedor, chave, endpoint, modelo

Expanda o cartão LLM. Isso conecta o agente a qualquer provedor compatível com o protocolo Chat Completions da OpenAI. As credenciais de embeddings da base de conhecimento são gerenciadas pela plataforma Knocket — aqui, você só configura o lado das conclusões de chat.

• Provedor — escolha uma predefinição (OpenAI, Hunyuan, DeepSeek etc.) ou selecione Personalizado para usar seu próprio endpoint.
• Chave de API — o segredo do provedor selecionado. Armazenada de forma criptografada; fica visível como pontos após salvar.
• URL da API — a URL base do endpoint compatível com a OpenAI (por exemplo, https://tokenhub.tencentmaas.com/v1).
• Modelo LLM — a string de identificação do modelo esperada pelo endpoint (por exemplo, kimi-k3, deepseek-v4-flash).

Compatibilidade: este cartão requer uma API compatível com o OpenAI Chat Completions. Qualquer provedor que ofereça um cliente OpenAI diretamente substituível funcionará.

O Transferência cartão — frases e canais de notificação

Expanda o cartão Transferência — o último na página de Configurações. Ele determina quando um chat deixa a IA e quem recebe a notificação.

Frases para transferência a um atendente humano — um dicionário de frases de acionamento. Se a mensagem de um visitante corresponder a qualquer frase, o chat será encaminhado para um atendente humano antes a IA sequer é executada — determinístico, instantâneo, sem chamada ao modelo. O Knocket inclui uma biblioteca padrão em 47 idiomas (Transferir para um atendente, humano, agente humano, …); pressione Adicionar para adicionar gatilhos específicos do domínio, como falar com o faturamento ou escalar. Veja a biblioteca completa: Frases padrão de transferência para atendente (47 idiomas) →

Canais de notificação — para onde o próprio encaminhamento é enviado:

• Notificações push do navegador — a aba do console emite um alerta sempre que um chat é transferido. Configure a permissão correspondente do navegador nas configurações gerais de Notificações; o atalho Ir para Notificações leva você até lá.
• Telegram — envia um resumo da transferência para o bot do Telegram conectado. Ative essa opção após configurar o bot do Telegram em Integrações e Notificações.

As notificações de encaminhamento são separadas dos seus alertas normais de mensagem recebida — você pode manter os alertas de mensagens desativados e receber notificações apenas sobre encaminhamentos, que é a configuração com menos ruído adotada pela maioria dos fundadores individuais.

Conhecimento — Abas de perguntas frequentes, URL e arquivo

Clique em Agente de IA → Conhecimento na barra lateral. Esta página é o que impede alucinações. Cada fonte adicionada é dividida em trechos, convertida em embeddings e recuperada no momento da resposta — o agente cita apenas o que encontra, de acordo com as regras do prompt do sistema. Há três tipos de fonte, cada um em sua própria aba, com um limite compartilhado de 10 itens por aba.

O FAQ aba — pares de perguntas e respostas selecionados manualmente

Adicione pares de perguntas e respostas que o agente deve priorizar acima de qualquer outra coisa. Ideal para preços, política de reembolso, diferenças entre planos — qualquer assunto para o qual você queira uma resposta oficial. Cada linha exibe um selo Indexado assim que a incorporação é concluída (geralmente em segundos).

O URL aba — rastrear uma página

Cole qualquer URL público e o Knocket irá rastreá-lo, extrair texto limpo e indexá-lo. Ideal para o seu site de marketing, páginas de documentação, registos de alterações e páginas de detalhes de funcionalidades. A coluna Última sincronização indica quando cada URL foi atualizado pela última vez; elimine uma linha para forçar um novo rastreamento.

O Arquivo aba — carregar documentos

Arraste e solte ou clique para enviar. Formatos compatíveis: PDF, TXT, DOC, DOCX, HTML, MD, CSV, XLSX. Tamanho máximo de 10 MB por arquivo. Assim que a linha exibir Indexado, o agente poderá citá-lo.

Uso — solicitações, tokens, canais

Clique em Agente de IA → Uso na barra lateral. Esta página apresenta o relatório operacional do agente. Seletor de período na parte superior (Hoje / Ontem / Últimos 7 dias / Últimos 14 dias / período personalizado com data de início e fim).

Três KPIs principais:

• Solicitações de IA — número de mensagens de visitantes às quais o agente realmente respondeu no período.
• Transferências — número de chats transferidos para uma pessoa (acionados por uma frase ou decididos pelo modelo).
• Tempo médio de resposta — mediana do tempo decorrido, em segundos, entre a chegada da mensagem e o envio da resposta.

Abaixo dos KPIs:

• Gráfico de Solicitações de IA — gráfico de barras diário das mensagens respondidas pelo agente. Identifique picos de volume e dias sem atividade.
• Tabela de Uso do modelo — consumo de tokens agrupado por provedor e modelo. As colunas Tokens de entrada / Tokens de saída mostram qual modelo está fazendo o trabalho e aproximadamente quanto ele está custando.
• Tabela de distribuição por canal — Solicitações à IA / Transferências / Tempo médio de resposta / Participação, dividida por canal (web_widget, mobile_widget, contact_page). Útil para identificar um canal que esteja sobrecarregando o agente.

FAQ

O Agente de IA é gratuito?

Sim — o próprio Agente de IA está incluído no plano gratuito. Você fornece suas próprias credenciais de LLM (de qualquer provedor compatível com a OpenAI), portanto, o único custo variável são os tokens que você consome no modelo escolhido. A incorporação vetorial da base de conhecimento é gerenciada pela plataforma e está incluída.

Quais provedores de LLM posso integrar?

Qualquer solução compatível com o protocolo Chat Completions da OpenAI. O menu suspenso Provedor inclui predefinições para as opções mais comuns; Personalizado aceita qualquer URL base + chave + ID do modelo.

Quantas fontes de conhecimento posso adicionar?

Até 10 itens por aba — 10 perguntas frequentes, 10 URLs e 10 arquivos. Cada arquivo pode ter até 10 MB. Esse limite costuma ser suficiente para um pequeno SaaS; entre em contato conosco se estiver prestes a atingi-lo.

Em que idiomas o agente responde?

Independentemente do idioma em que o visitante escreva — o modelo subjacente cuida disso. A biblioteca integrada de frases de transferência cobre 47 idiomas prontos para uso.

Posso desativar o agente para um canal específico?

Sim — desmarque esse canal em Definições → Agente de IA → Canais do Agente de IA. As mensagens desse canal irão diretamente para a caixa de entrada dos atendentes.

O Knocket utiliza a minha base de conhecimentos para treinar modelos de terceiros?

Não. O conteúdo da base de conhecimento e as transcrições das conversas são usados apenas para recuperação de informações no momento da resposta e para análises dentro da sua própria conta.