Este guia mostra como ligar a busca semântica da sua Central de Ajuda. Leva poucos minutos.
Antes de começar
Você vai precisar de uma chave de API de um provedor de embeddings. Hoje o envia.click suporta:
- OpenRouter (compatível com modelos da OpenAI)
- Google Gemini (integração direta com o Google)
💡 Use o provedor para o qual você já consegue uma chave. Se não tem chave da OpenAI, o Gemini costuma ser o caminho mais fácil.
Passo 1 — Abrir a página
No menu lateral, vá em Configurações → Vector Store.
Passo 2 — Escolher provedor e modelo
- Em Provedor, escolha OpenRouter ou Google Gemini.
- Em Modelo, selecione um dos modelos recomendados no menu suspenso:
- OpenRouter:
openai/text-embedding-3-small(recomendado — melhor custo‑benefício),openai/text-embedding-3-large(maior qualidade) ouopenai/text-embedding-ada-002. - Google Gemini:
gemini-embedding-001(recomendado). - Precisa de um modelo específico? Escolha "Outro (digitar manualmente)" e informe o identificador.
- OpenRouter:
⚠️ O modelo precisa gerar vetores de 1536 dimensões. Os modelos recomendados já atendem a esse requisito. O botão Testar modelo confirma isso antes de você salvar.
Passo 3 — Informar a chave de API
Cole sua chave no campo Chave de API. Ela fica criptografada no servidor e nunca é exibida de volta.
(O campo Base URL é opcional — só preencha se o seu provedor exigir um endereço diferente do padrão.)
Passo 4 — Testar
Clique em Testar modelo. Se aparecer "Modelo OK — 1536 dimensões", está tudo certo. Se der erro, revise a chave e o modelo.
Passo 5 — Ativar e salvar
- Marque Ativar indexação por IA.
- Clique em Salvar configuração.
A partir daí, todo artigo publicado que você criar ou editar é indexado automaticamente.
Passo 6 — Indexar o conteúdo que já existe
Para indexar os artigos que já estavam publicados antes da ativação, clique em Reindexar tudo na seção Status da Indexação. Acompanhe o progresso pelos números de Artigos indexados / Artigos publicados.
Pronto!
Agora seus agentes de IA usam a busca semântica automaticamente. Para testar, faça uma pergunta parafraseada (com outras palavras) sobre um tema que existe nos seus artigos e veja a IA encontrar a resposta certa.
Dúvidas comuns
Preciso reindexar sempre? Não. Após a configuração, novos artigos e edições são indexados sozinhos. O Reindexar tudo serve para a carga inicial ou se você trocar de modelo.
Trocar de modelo/provedor depois? Pode. Ajuste os campos, Testar, Salvar e rode Reindexar tudo para recriar os vetores com o novo modelo.
Minha chave fica exposta? Não. Ela é criptografada e usada apenas no momento de gerar os embeddings.