Solução de problemas do ReplyRabbit
A maioria dos problemas do ReplyRabbit se resume a uma de três coisas: uma chave de API ausente ou errada, usar um provedor que seu nível de plano não permite, ou um cache obsoleto do FreeScout. Percorra a seção correspondente abaixo, onde cada problema lista primeiro o sintoma e depois a correção.
Nenhum rascunho é gerado
Sintoma: você abre uma conversa, mas nenhum rascunho de IA aparece e nada parece acontecer.
Correção: abra as configurações do ReplyRabbit da caixa de correio (Caixa de correio > Configurações > ReplyRabbit) e confirme que um provedor está selecionado e sua chave de API está definida. No plano Free, o único provedor disponível é a OpenAI, então se você escolheu outro, volte para a OpenAI ou faça upgrade. Depois verifique se o ReplyRabbit está ativado para a caixa de correio em que você está trabalhando, pois os rascunhos só são gerados para caixas de correio ativadas.
Erro de chave de API inválida ou de provedor
Sintoma: você vê um erro mencionando uma chave inválida, falha de autenticação ou um provedor que não pode ser acessado.
Correção: verifique novamente a chave em busca de erros de digitação e espaços extras, confirme que é a chave do provedor que você realmente selecionou (uma chave da OpenAI não funcionará com a Anthropic) e certifique-se de que a chave ainda tem crédito e acesso no painel do provedor. Uma chave sem saldo restante ou com acesso revogado produz o mesmo erro.
Erros após atualizar o PHP
Sintoma: após uma atualização do servidor (por exemplo, para Ubuntu 26.04 com PHP 8.5), Testar conexão falha ou os trabalhos em segundo plano param, e o log do FreeScout mostra mensagens terminando em is deprecated since 8.5.
Correção: mantenha o ReplyRabbit e seus outros módulos atualizados em Gerenciar > Módulos, então execute php artisan freescout:clear-cache e php artisan queue:restart. O ReplyRabbit oferece suporte a PHP 8.0 até 8.5. Veja Corrigir erros "deprecated since 8.5" no FreeScout para descobrir de qual módulo vem uma mensagem.
O menu do ReplyRabbit está ausente
Sintoma: O ReplyRabbit não aparece nos menus ou configurações do FreeScout após a instalação.
Correção: primeiro certifique-se de que o módulo está ativado em Gerenciar > Módulos. Depois limpe o cache a partir da raiz do seu FreeScout:
php artisan freescout:clear-cacheSe ainda estiver faltando, verifique as permissões do usuário: um usuário sem acesso à caixa de correio relevante ou às configurações de administrador não verá as opções do ReplyRabbit.
Os rascunhos pararam depois de um tempo
Sintoma: os rascunhos funcionaram no início e depois pararam de ser gerados mais tarde no mês.
Correção: o plano Free permite 10 rascunhos por mês. Ao atingir esse limite, os rascunhos pausam até o próximo mês. Pro e Team não têm limite de rascunhos. Em qualquer plano, os rascunhos também pausam se o Orçamento Mensal de Tokens está esgotado, então verifique essa configuração também (0 significa sem orçamento).
O cache de prompt não altera a contagem mensal de tokens
Sintoma: rascunhos repetidos parecem elegíveis para o cache de prompt do provedor, mas o uso de tokens do ReplyRabbit ainda mostra o total completo de entrada e saída.
Correção: isso é esperado. O ReplyRabbit mantém os orçamentos mensais conservadores e conta o total de tokens, mesmo quando um provedor cobra a entrada em cache de forma diferente. As economias de cache do provedor dependem do provedor, do modelo, de prefixos de prompt repetidos e do relatório do provedor. O controle de cache da Anthropic é usado apenas para trabalho de rascunho repetido elegível e recorre à geração normal quando não é suportado.
Os tickets do Linear não estão sendo criados
Sintoma: as próximas ações são detectadas, mas nenhum ticket do Linear é criado.
Correção: nas configurações do ReplyRabbit, verifique a chave de API do Linear, a equipe selecionada e se os tickets estão em um estado pendente aguardando confirmação. Confirme também se seu nível inclui Linear: a criação manual de tickets do Linear é um recurso Pro, e a criação automática de tickets é um recurso Team.
As issues do Jira não estão sendo criadas
Sintoma: uma conversa precisa de trabalho de engenharia, mas nenhuma issue do Jira é criada.
Correção: nas configurações do ReplyRabbit, confirme se o Jira está selecionado como rastreador de problemas da caixa de correio. Verifique a URL do site do Jira Cloud, o e-mail da conta, o token de API, o projeto padrão e o tipo de problema padrão. Confirme também se seu nível inclui criação de problemas: a criação manual de problemas do Jira é um recurso Pro, e a criação automática de problemas é um recurso Team. Para o caminho completo de configuração, consulte Integração com Jira.
As Tags de Workflow não estão sendo aplicadas
Sintoma: você esperava tags como rr_priority_critical, rr_no_reply_needed, ou rr_linear_issue_created, mas a conversa não tem tags do ReplyRabbit.
Correção: abra as configurações do ReplyRabbit da caixa de correio e confirme Ativar sincronização de workflow e Aplicar tags do FreeScout estão ativados no Tags de Workflow seção. Se as tags de sinal estiverem faltando, confirme Sinais de IA está ativado e a conversa foi analisada. Se as tags do Linear estiverem faltando, confirme se a conversa tem um problema do Linear criado pelo ReplyRabbit.
Se as receitas do FreeScout Workflows não estiverem disparando, primeiro confirme que o ReplyRabbit está adicionando a tag esperada do FreeScout. Depois teste se o módulo Workflows instalado reage a alterações programáticas de tags. O ReplyRabbit pode aplicar as tags, mas o módulo Workflows controla se uma receita é executada a partir dessa alteração de tag.
Fontes de conhecimento: um rascunho não usou minhas páginas de ajuda, Base de Conhecimento, produtos ou respostas anteriores
Sintoma: um rascunho ignorou informações que você sabe que estão nas suas páginas de ajuda, Base de Conhecimento, lista de produtos ou respostas anteriores.
Correção: comece pela linha abaixo do rascunho no editor de resposta. Ela lista o que o rascunho usou, por exemplo "Incluído: 2 páginas de ajuda, 1 artigo da Base de Conhecimento, 3 respostas anteriores a este cliente". Clique nela para ver os links, além de uma nota para cada fonte ativada que não acrescentou nada:
- Ativado, mas nada indexado ainda: a indexação não terminou. Verifique o worker da fila (veja abaixo) e aguarde a conclusão da indexação.
- Nenhuma correspondência boa para esta mensagem: a fonte está boa, mas nada nela correspondeu à mensagem deste cliente com proximidade suficiente. Adicione ou melhore conteúdo que responda a esse tipo de pergunta.
- Índice acima do limite de busca: depois que o índice ultrapassar 6.000 seções indexadas, apenas a correspondência por palavras-chave é executada, não a correspondência por significado. Remova fontes que você não precisa para voltar ao limite.
- Seu plano não inclui: essa fonte não está disponível no seu plano atual.
- O módulo Base de Conhecimento não está instalado ou ativo: instale ou ative-o em Gerenciar > Módulos.
Avisos de status da configuração
O banner de status de configuração nas configurações da caixa de correio agora avisa quando:
- O worker da fila parece não estar em execução. A indexação e os rascunhos automáticos nunca terminam sem ele. O FreeScout executa a fila através do cron job
php artisan schedule:runou umqueue:workprocesso, então certifique-se de que um deles esteja configurado. - Nenhuma fonte de conhecimento está ativada. Ative pelo menos uma em Mailbox settings, Knowledge sources.
- Uma fonte está ativada, mas ainda não foi indexada. Deixe a indexação terminar.
Fontes do site
- O rastreamento para em 200 páginas por padrão, e a fonte agora informa isso, com um botão para aumentar o limite. Salve suas configurações depois e rastreie novamente.
- As páginas que não podem ser lidas são contadas com um motivo, por exemplo bloqueadas pelo site (403), não encontradas (404), muitas solicitações (429), um erro do servidor, muito grandes ou sem texto legível (geralmente uma página criada com JavaScript). Peça ao seu host para permitir a passagem do rastreador ou aponte a fonte para páginas que não precisam de JavaScript.
- Páginas muito longas são encurtadas para cerca de 24.000 caracteres. Quando a correspondência semântica está ativada, a fonte mostra quantas páginas foram encurtadas. Divida páginas longas se a parte que você precisa estiver perto do final.
Contorno e correspondência baseada em significado
- A sincronização do Outline para em 1.000 documentos. Documentos além disso não são sincronizados.
- A correspondência baseada em significado (semântica) precisa de um provedor de embeddings. Alguns modelos de embedding ainda não estão calibrados para correspondências apenas de significado e mostram um aviso, então troque para um modelo de embedding diferente se você o vir.
Ainda com problemas?