Integração com OpenRouter
Funciona com OpenRouter
Use este guia para conectar o OpenRouter ao ReplyRabbit para uma caixa de correio do FreeScout. O OpenRouter atua como o provedor de geração de IA, enquanto o ReplyRabbit permanece responsável pelo fluxo de trabalho de suporte do FreeScout.
Procurando a visão geral?
Visão geral
O OpenRouter é uma das opções de provedor de IA em nuvem do ReplyRabbit. Você pode selecionar o OpenRouter nas configurações da caixa de correio Provedor de IA configurações, cole sua chave de API do OpenRouter e escolha uma opção de modelo configurada ou um ID de modelo personalizado.
O ReplyRabbit usa o provedor para geração e depois retorna o rascunho ou a sugestão ao FreeScout para revisão do agente.
Como o OpenRouter pode rotear para muitas famílias de modelos, o ReplyRabbit não envia uma configuração genérica de controle de cache de prompt pelo OpenRouter. Ele registra metadados de uso de cache quando o OpenRouter ou o provedor roteado os retorna.
Pré-requisitos
Antes de começar, certifique-se de ter:
- Uma instalação funcional do FreeScout.
- ReplyRabbit instalado e ativado.
- ReplyRabbit Pro ou Team, que desbloqueia todos os provedores de IA.
- Uma conta OpenRouter.
- Uma chave de API do OpenRouter.
- Acesso ao modelo ou opção de roteamento do OpenRouter que você planeja usar.
Se você ainda estiver escolhendo um provedor, leia Escolhendo um provedor de IA.
Permissões e chaves de API
O ReplyRabbit usa sua chave de API do OpenRouter apenas quando o provedor da caixa de correio está definido como OpenRouter. As chaves salvas são armazenadas como segredos e exibidas mascaradas após salvar.
O uso de IA e o acesso aos modelos são regidos pela sua conta do OpenRouter. Se um modelo não estiver disponível lá, o ReplyRabbit não poderá usá-lo.
Conectar OpenRouter
Abrir configurações do ReplyRabbit
No FreeScout, abra a caixa de correio, vá para Configurações, e escolha ReplyRabbit.Escolha OpenRouter
No Provedor de IA cartão, selecione OpenRouter.Cole a chave de API
Cole sua chave de API do OpenRouter em Chave de API.Escolha um modelo
Escolha a opção de roteador automático configurada, um preset listado ou Personalizado se sua equipe tem um ID de modelo OpenRouter específico.Salvar e testar
Salve as configurações, abra uma conversa no FreeScout e gere um rascunho de teste. Revise a qualidade e o custo antes de usar o OpenRouter em uma caixa de correio movimentada.
Notas de configuração
- Provedor: escolha OpenRouter no cartão AI Provider.
- Chave de API: use uma chave da sua própria conta OpenRouter.
- Modelo: escolha auto-router, uma predefinição ou um ID de modelo personalizado do OpenRouter.
- Cache de prompt: nenhum botão de ativação de cache do OpenRouter é necessário. O uso do cache é registrado quando os metadados do provedor o incluem.
- Orçamento: defina um orçamento mensal de tokens se quiser que o ReplyRabbit pare a geração após um limite configurado da caixa de correio.
- Embeddings: O OpenRouter pode criar embeddings para recuperação semântica com a mesma chave. O modelo padrão é
openai/text-embedding-3-small.
Casos de uso
- Experimente várias famílias de modelos hospedados por meio de uma conta de provedor.
- Use o roteador automático do OpenRouter para uma caixa de correio onde o roteamento de provedores seja útil.
- Compare a qualidade dos provedores sem alterar o fluxo de suporte do FreeScout.
Solução de problemas
| Sintoma | O que verificar |
|---|---|
| O OpenRouter está desabilitado | Confirme se a caixa de correio está no ReplyRabbit Pro ou Team. |
| Erro de chave de API inválida | Copie novamente a chave do OpenRouter e confirme que ela está ativa. |
| Modelo não disponível | Confirme se o ID do modelo existe e se sua conta do OpenRouter pode acessá-lo. |
| Os rascunhos custam mais do que o esperado | Revise o modelo selecionado e defina um orçamento de tokens da caixa de correio. |
| A recuperação semântica não está usando o OpenRouter | Escolha um provedor de embeddings compatível ou conte com o comportamento de fallback configurado. |
Para correções mais amplas, consulte Solução de problemas do ReplyRabbit.
Notas de privacidade e segurança
Quando o OpenRouter é selecionado, o ReplyRabbit envia ao OpenRouter o contexto do prompt necessário para o recurso de IA. Dependendo do modelo roteado pelo OpenRouter, o processamento do lado do provedor pode envolver outros fornecedores de modelo de acordo com sua conta e configurações do OpenRouter.
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 OpenRouter 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 do OpenRouter?
Sim. O ReplyRabbit usa a chave de API do OpenRouter que você fornece nas configurações da caixa de correio.
Posso usar o OpenRouter Auto Router?
Sim. O ReplyRabbit inclui uma opção de auto-router do OpenRouter já configurada.
Posso usar um ID de modelo personalizado do OpenRouter?
Sim. Use a opção Custom quando sua equipe tiver um ID de modelo do OpenRouter suportado pelo provedor.
O ReplyRabbit envia configurações de cache de prompts pelo OpenRouter?
Não. O OpenRouter pode rotear muitas famílias de modelos, então o ReplyRabbit evita campos genéricos de cache-control nas requisições e registra metadados de cache apenas quando o provedor os retorna.
O OpenRouter lida com embeddings de recuperação semântica?
Sim. O OpenRouter pode ser o provedor de embeddings para recuperação semântica, usando a mesma chave de API. O modelo de embeddings padrão é openai/text-embedding-3-small.