Integração com OpenAI
Funciona com OpenAI
Use este guia para conectar a OpenAI ao ReplyRabbit para uma caixa de correio do FreeScout. A geração de rascunhos da OpenAI está disponível no plano Free do ReplyRabbit. A OpenAI também pode alimentar próximas ações, Sinais de IA, recuperação semântica e outros textos de suporte assistidos por IA quando esses recursos estiverem licenciados e habilitados.
Procurando a visão geral?
Visão geral
O OpenAI é o provedor de IA do plano Free do ReplyRabbit e permanece disponível nos planos pagos. Você o escolhe nas configurações da caixa de correio Provedor de IA configurações, cole sua chave de API da OpenAI, escolha uma opção de modelo e salve a caixa de correio.
O ReplyRabbit continua responsável pelo fluxo de trabalho do FreeScout: contexto da empresa, estilo de resposta, exemplos, verificações de orçamento de tokens e saída de rascunho revisável. O uso do OpenAI é cobrado separadamente pelo OpenAI por meio da conta de provedor conectada à sua chave de API.
Para solicitações de geração direta à OpenAI, o ReplyRabbit envia uma chave de cache de prompt segura quando o contexto da caixa de correio está disponível. Isso dá ao provedor uma dica de roteamento estável para prompts de suporte repetidos sem expor sua chave de API. O Monthly Token Budget ainda conta tokens totais de entrada e saída de forma conservadora.
Pré-requisitos
Antes de começar, certifique-se de ter:
- Uma instalação funcional do FreeScout.
- ReplyRabbit instalado e ativado.
- Uma conta OpenAI com acesso à API.
- Uma chave de API da OpenAI para a conta que você deseja que o ReplyRabbit use.
A geração de rascunhos com OpenAI está disponível no plano Free do ReplyRabbit. A recuperação semântica, provedores adicionais e outros recursos avançados exigem Pro ou Team.
Se você ainda estiver escolhendo um provedor, leia Escolhendo um provedor de IA.
Permissões e chaves de API
Para geração de rascunhos, o ReplyRabbit usa sua chave de API da OpenAI quando o provedor da caixa de correio está definido como OpenAI. A chave é armazenada como segredo e exibida mascarada após salvar.
Se a recuperação semântica estiver licenciada e habilitada, a OpenAI também pode ser selecionada como provedor de embeddings. Nesse caso, o ReplyRabbit pode usar uma chave de API de embeddings dedicada, ou pode recorrer à chave de rascunho da OpenAI quando o provedor de rascunho for a OpenAI.
Se a chave for revogada, rotacionada, limitada por taxa ou estiver sem crédito no provedor, atualize as configurações da caixa de correio antes de gerar mais rascunhos.
Conectar OpenAI
Abrir configurações do ReplyRabbit
No FreeScout, abra a caixa de correio, vá para Configurações, e escolha ReplyRabbit.Escolha OpenAI
No Provedor de IA cartão, selecione OpenAI como o provedor.Cole a chave de API
Cole sua chave de API do OpenAI em Chave de API.Escolha um modelo
Use a opção latest a menos que sua equipe tenha escolhido um preset ou ID de modelo específico da OpenAI. Use Personalizado apenas quando você souber o ID exato do modelo suportado pelo provedor.Defina um orçamento de tokens se necessário
Usar Orçamento Mensal de Tokens se você quiser que o ReplyRabbit pare de gerar após um limite mensal de tokens configurado para a caixa de correio.Salvar e testar
Salve as configurações, abra uma conversa e gere um rascunho. Revise a resposta antes de enviá-la a um cliente.
Notas de configuração
- Provedor: escolha OpenAI no cartão AI Provider.
- Chave de API: use uma chave da sua própria conta OpenAI para geração de rascunhos.
- Modelo: escolha latest, uma predefinição listada ou um ID de modelo personalizado suportado pelo provedor.
- Roteamento de cache de prompt: O ReplyRabbit envia uma chave segura de cache de prompt para solicitações diretas ao OpenAI quando o contexto da caixa de correio está disponível. Não há alternância de cache do OpenAI nas configurações da caixa de correio.
- Recuperação semântica: O OpenAI pode ser selecionado como provedor de embeddings quando a recuperação semântica está licenciada e habilitada. Esse caminho pode usar uma chave de embeddings dedicada e é separado do uso do OpenAI para geração de rascunhos.
- Contexto: mantenha o contexto da empresa, o estilo de resposta e os exemplos atualizados para que os rascunhos correspondam à sua política de suporte.
- Orçamento: defina um orçamento de tokens quando precisar de um limite mensal rígido.
Casos de uso
- Crie rascunhos de respostas a clientes no FreeScout usando a OpenAI como provedor de nuvem selecionado.
- Comece a testar no nível gratuito do ReplyRabbit antes de comparar opções de provedores pagos.
- Use embeddings da OpenAI para recuperação semântica quando esse recurso estiver licenciado e habilitado e sua política de dados permitir embeddings hospedados pelo provedor.
Solução de problemas
| Sintoma | O que verificar |
|---|---|
| Erro de chave de API inválida | Copie novamente a chave da OpenAI e confirme que ela pertence à conta esperada. |
| Erro de modelo | Alterne para a opção mais recente ou confirme se o ID de modelo personalizado é compatível com a OpenAI. |
| Os rascunhos param mais tarde no mês | Verifique o orçamento de tokens da caixa de correio e a cobrança, os limites de taxa ou o crédito da conta do provedor. |
| A recuperação semântica não está disponível | Confirme se a recuperação semântica está habilitada para seu plano e caixa de correio e escolha um provedor de embeddings compatível. |
| A qualidade dos rascunhos é inconsistente | Melhore o contexto da empresa, o estilo de resposta, os exemplos e as fontes de conhecimento habilitadas para a caixa de correio. |
Para correções mais amplas, consulte Solução de problemas do ReplyRabbit.
Notas de privacidade e segurança
Quando o OpenAI é selecionado, o ReplyRabbit envia ao OpenAI o contexto do prompt necessário para o recurso de IA habilitado. Isso pode incluir texto da conversa, contexto da empresa, regras de estilo de resposta, exemplos e contexto de suporte relacionado.
Use um provedor local como o Ollama se sua política exigir que o conteúdo do cliente permaneça no seu próprio hardware.
Próximos passos
- Revise o Integração com OpenAI para FreeScout página quando você precisar da visão geral do fluxo e da compra.
- Compare as vantagens e desvantagens dos provedores em Escolhendo um provedor de IA antes de alterar uma caixa de correio de produção.
- Continuar com Como configurar o ReplyRabbit se o contexto da empresa, os exemplos ou os orçamentos ainda precisam de atenção.
FAQ
Preciso de uma chave de API da OpenAI?
Sim, para geração de rascunho do OpenAI. A recuperação semântica também pode usar o OpenAI com uma chave de embedding dedicada quando esse recurso estiver licenciado e ativado.
O OpenAI está disponível no plano Free do ReplyRabbit?
Sim. O plano ReplyRabbit Free usa o OpenAI como provedor de IA. O uso do OpenAI ainda é cobrado pelo OpenAI através da sua conta de provedor.
Posso escolher o modelo GPT?
Sim. Use uma predefinição configurada, a opção latest ou o campo Custom para um ID de modelo suportado pelo provedor.
O ReplyRabbit usa cache de prompts da OpenAI?
O ReplyRabbit envia uma chave segura de cache de prompt para solicitações diretas ao OpenAI quando o contexto da caixa de correio está disponível. Isso ajuda o OpenAI a rotear prompts de suporte repetidos de forma consistente, mas o ReplyRabbit ainda contabiliza os orçamentos de tokens de forma conservadora.
Os dados de clientes vão para a OpenAI?
Se a OpenAI estiver selecionada, o ReplyRabbit envia à OpenAI o contexto do prompt necessário para o recurso de IA habilitado.