For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/messaging/ai-agents.md.
  • Português

      • Crie um agente de IA com a sua chave

      Em Configurações → Central de Contas → Meus agentes — ou, pelo caminho do CRM, em Contatos & Comercial → Configurações do CRM → Meus agentes, que abre a mesma lista — clique em Novo agente, cadastre a chave de API do seu provedor (OpenAI ou Anthropic), escolha o modelo, escreva a persona e teste a conversa. O agente nasce como rascunho; Publicar alterações cria a primeira versão e o deixa Ativo.

      Papel: qualquer membro do workspace com acesso às Configurações pode criar agentes e cadastrar chaves.

      Antes de começar

      • Uma conta na OpenAI ou na Anthropic com uma chave de API ativa e crédito disponível. As chamadas do agente são cobradas pelo provedor, na sua conta.
      • O Clickmax valida a chave no provedor antes de salvar. A chave fica cifrada e nunca é exibida de novo: a tela mostra só os 4 últimos dígitos.

      Passos

      1. Abra Configurações e, no grupo Central de Contas da lateral, clique em Meus agentes. Clique em Novo agente.
      2. No passo Provedor, escolha OpenAI ou Anthropic, cole a chave em Chave de API e clique em Validar e salvar chave. Se o workspace já tem uma chave cadastrada, use Usar uma chave já cadastrada e selecione-a. Clique em Continuar.
      3. No passo Modelo, escolha um modelo entre os disponíveis na sua conta (modelos que a conta não enxerga aparecem como Indisponível) e ajuste a Temperatura.
      4. No passo Identidade, informe o Nome e o Objetivo. A Persona e instruções começa com um exemplo genérico; reescreva como quiser ou use Voltar ao exemplo.
      5. Em Revisão, confira o resumo e clique em Criar agente. Você é levado à tela do agente. Ele nasce sem regras de escalonamento: crie as suas na aba Escalonamento.
      6. Na aba Testar, envie mensagens como se fosse o cliente para conferir a persona. Cada mensagem usa a sua chave no provedor.
      7. Quando estiver satisfeito, clique em Publicar alterações. O agente fica Ativo e passa a exibir a versão publicada. Use o botão Ativo para pausar e reativar sem perder a configuração.

      Ajustes posteriores (persona, ferramentas, modelo, escalonamento) ficam marcados como Alterações não publicadas até você clicar em Publicar alterações de novo.

      Para remover um agente, abra o detalhe e clique em Excluir. Ele sai da lista e para de responder; a chave do provedor continua cadastrada e as conversas ficam registradas.

      As chaves cadastradas aparecem em Chaves de API, abaixo da lista de agentes. Remover tira a chave do workspace; se algum agente ativo ainda a usa, troque a chave desse agente primeiro.

      Fontes de conhecimento

      Na aba Conhecimento, clique em Adicionar fonte e escolha o Tipo de fonte:

      • Documento: PDF, TXT, MD, CSV, JSON ou HTML até 20 MB. DOCX e PPTX só na OpenAI.
      • Página web: cole o Endereço e lemos o texto da página na hora.
      • FAQ: pares de Pergunta e Resposta que você escreve na tela (Adicionar pergunta para incluir mais; de 1 a 200 itens).

      O conteúdo fica na sua conta do provedor (OpenAI ou Anthropic), não no Clickmax. O agente consulta as fontes antes de responder; se a resposta não estiver nelas, ele diz que vai confirmar com o time em vez de inventar. Limite de 20 fontes por agente.

      Cada fonte aparece na lista com o status Sincronizado, Sincronizando ou Erro (em Erro, o motivo aparece abaixo do nome). Sincronizar de novo aparece em páginas web (relemos o endereço na hora, útil quando a página mudou), em fontes Sincronizando e em FAQs com Erro. Documento com Erro precisa ser removido e enviado de novo.

      Com Anthropic, cada mensagem envia todas as fontes ao modelo (e o provedor cobra como entrada); mantenha a base enxuta — até 10 MB somados. Com OpenAI, o modelo busca só os trechos relevantes.

      Fontes não passam por Publicar alterações: valem assim que aparecem como Sincronizado, mesmo com o agente em rascunho.

      Onde acompanhar

      • Meus agentes: a lista mostra os agentes em blocos; com muitos agentes, clique em Carregar mais no fim da lista para ver os seguintes.
      • Logs: todas as conversas do agente, com filtros por resultado, canal e período. Ver transcrição abre as mensagens; com muitas conversas, Carregar mais no fim da tabela traz as seguintes. Uma pergunta sem resposta na transcrição indica que o provedor falhou naquele envio (por exemplo, chave inválida ou limite de uso).
      • Métricas: conversas, taxa resolvida pelo agente, escalonadas e duração média dos últimos 30 dias.

      Relacionados

      Se não funcionou

      • "O provedor recusou a chave": a chave está errada, expirada ou sem permissão. Gere uma nova no painel do provedor e cadastre de novo. Chaves da OpenAI começam com sk-; da Anthropic, com sk-ant-.
      • "O provedor limitou as chamadas desta conta": sua conta no provedor atingiu o limite de uso. Aguarde alguns minutos ou aumente o limite no provedor.
      • O modelo que eu queria não aparece: a lista mostra só os modelos que a sua conta no provedor enxerga. Habilite o modelo no provedor e recarregue a página.
      • "Publique o agente antes de ativar ou pausar": o botão Ativo só funciona depois da primeira publicação.
      • Não consigo remover uma chave: há agentes usando essa chave. Troque a credencial deles antes de removê-la.
      • "Este provedor não aceita esse tipo de arquivo": converta para PDF ou TXT. A Anthropic não lê DOCX/PPTX.
      • "Não conseguimos ler essa página. Confira o endereço.": o endereço precisa ser público (http ou https), ter até 5 MB e responder em até 10 segundos. Se aparecer "A página não respondeu. Tente de novo.", o site demorou ou está fora do ar.
      • "Remova as fontes de conhecimento antes de trocar de provedor": os arquivos estão na conta do provedor atual. Use Remover em cada fonte na aba Conhecimento, troque a credencial e cadastre as fontes de novo.