Pesquisa Google para Discourse AI
Para configurar um bot de pesquisa do Google com o plugin Discourse AI, você precisará configurar um Mecanismo de Pesquisa Programável do Google e uma chave de API de Pesquisa Personalizada. Qualquer modelo de IA que você usar precisará usar essa ferramenta de pesquisa para retornar resultados de pesquisa do Google. Ao configurar um serviço de IA para o seu Plugin Discourse, por exemplo, se você estiver usando a API OpenAI GPT ou Anthropic Claude, e desejar usar um bot auxiliar para fazer pesquisas no Google, você precisará configurar um Mecanismo de Pesquisa Programável para pesquisar no Google e uma chave de API para que seu bot pesquisador acesse o mecanismo de pesquisa e retorne os resultados.
Introdução: Google Cloud, Mecanismo de Pesquisa Programável e API de Pesquisa Personalizada
O Mecanismo de Pesquisa Programável (ou Mecanismo de Pesquisa Personalizada) é um serviço de mecanismo de pesquisa gratuito que qualquer pessoa pode configurar em seu site e é identificado por um ID de mecanismo de pesquisa (ou número CX). Uma chave de API de Pesquisa Personalizada é usada para fazer solicitações de API ao mecanismo de pesquisa, e as chaves de API são gerenciadas a partir do console do Google Cloud. Assim, você precisará configurar uma conta do Google Cloud - um cartão de crédito é necessário para registrar sua conta, mas a API de Pesquisa Personalizada oferece 100 consultas de pesquisa por dia gratuitamente antes de você pagar (solicitações adicionais custam US$ 5 por 1.000 consultas, até 10.000 consultas por dia, mas você terá que comprar mais uso). Veja como gerenciar faturamento.
Você também desejará configurar sua chave em um projeto do Google Cloud, preferencialmente um novo designado para a chave de pesquisa (para facilitar o rastreamento). Observe que o Google Cloud tem cotas tanto no número de projetos quanto no número de projetos anexados a uma conta de faturamento, e os projetos podem ser adicionados a contas de faturamento após serem configurados e as chaves de API serem criadas.
Lista de verificação
- Configurar conta do Google Cloud
- Criar um projeto para sua chave de API de pesquisa personalizada
- Conectar projeto à conta de faturamento
- Criar chave de API
- Configurar chave de API para Pesquisa Personalizada
- Configurar um Mecanismo de Pesquisa Programável do Google
- Salvar chave de API de pesquisa personalizada e ID de pesquisa personalizada nas configurações do Discourse AI
Etapa 1: Configurar um Projeto no Google Cloud
Antes de configurar seu mecanismo de pesquisa personalizado e chave de API, configure um projeto no Google Cloud.
Acesse o admin do Google Cloud para APIs para você (ou sua organização) e certifique-se de estar na organização pai (você pode vê-la no campo superior ao lado do logotipo do Google Cloud).
Você terá que criar um projeto para seu mecanismo de pesquisa se ainda não tiver um que deseja usar - o link para selecionar ou criar um novo projeto fica perto do topo da página.
Preencha a página de criação de novo projeto (certifique-se de que sua organização esteja selecionada nos campos de menu suspenso apropriados).
Para gerenciar o faturamento do seu projeto, você precisará configurar uma conta de faturamento para o projeto no faturamento do Google Cloud, assumindo que você tenha o faturamento configurado para sua organização. Você (ou seu gerente de conta de faturamento) poderá fazer isso mais tarde, após a criação da chave. Observe que existem cotas para projetos e projetos de faturamento, dependendo da conta do Google Cloud de sua organização.
Para habilitar o faturamento em seu projeto, vá para a guia Faturamento no menu de navegação do Google Cloud e vincule uma conta de faturamento, ou habilite o faturamento para o projeto na página de projetos de faturamento.
Etapa 2: Criar uma Chave de API
Para criar uma chave de API no Google Cloud Console, vá para a guia API e Serviços no seu console do Google Cloud e para as configurações de Credenciais do seu novo projeto. (Não se preocupe com a mensagem “configurar tela de consentimento”). Clique no link “+ criar credenciais” perto do topo da página e selecione “Chave de API” nas opções de menu suspenso.
Uma nova chave de API será criada para você. Copie-a e guarde-a em um local seguro, como um gerenciador de senhas. Não compartilhe chaves.
Esta é a chave de API de Pesquisa Personalizada do Google que você precisará inserir nas configurações do Discourse AI para
ai_google_custom_search_api_key
Agora você verá sua nova chave listada na lista de chaves de API. Clique nos 3 pontos na coluna Ações, à extrema direita, e selecione “Editar chave de API”.
Isso abrirá a página de configuração de credenciais da chave de API, e aqui você pode editar o nome da chave de API para algo mais apropriado. (Você também pode visualizar/copiar sua chave de API ou regenerá-la, se necessário). Em seguida, vá para a seção “Restrições de API” na parte inferior e selecione “Restringir chave” e, em seguida, escolha “API de Pesquisa Personalizada”. Clique em OK e, em seguida, Salve sua chave de API.
Se você não vir nenhuma restrição listada, talvez precise habilitar o serviço de API na Biblioteca de API. Procure por “google custom search api” e selecione-a. Aqui você verá os detalhes da API de Pesquisa Personalizada, incluindo preços e links para mais documentação - clique no link para habilitar a API.
A nova chave de API agora será listada com seu novo nome e um sinal de verificação verde para indicar que está restrita a solicitações JSON da API de Pesquisa Personalizada.
Etapa 3: Criar um Mecanismo de Pesquisa Programável
Para criar um mecanismo de pesquisa para sua chave de API usar, vá para a página Mecanismo de Pesquisa Programável do Google e clique em “Começar” se você ainda não estiver logado (faça login ou crie sua conta). Uma vez logado, vá para a página do console do mecanismo de pesquisa. Todos os seus mecanismos de pesquisa programáveis existentes serão listados aqui.
Clique no botão “Adicionar” (ou no link “Crie seu primeiro mecanismo de pesquisa!”) para abrir a página do novo mecanismo de pesquisa. Dê um nome adequado e preencha os campos conforme aplicável.
Clique no botão “Criar” e seu novo mecanismo de pesquisa será criado. A página lhe dará a opção de copiar o script de pesquisa se você quiser usar a caixa de pesquisa em uma interface web em algum lugar, mas isso não é necessário aqui, pois estamos apenas interessados em usá-la para nossas credenciais de chave de API para acesso.
Selecione o botão personalizar para ir para a página de visão geral do mecanismo de pesquisa. Aqui podemos ver o ID do Mecanismo de Pesquisa (número CX) necessário para nossas configurações de pesquisa do Google do Discourse AI, bem como algumas outras opções que é possível configurar. (Observe que, se você rolar para baixo até o final, há um link para criar chaves de API - você não precisa fazer isso, pois o fez na etapa 2 acima.)
Etapa 4: Configurar a Pesquisa Personalizada do Google no Plugin Discourse AI
Copie o número do ID do Mecanismo de Pesquisa e armazene-o com a chave de API que você criou na etapa 2. Vá para Admin - Configurações do site e, no filtro Todas as Configurações do Site, digite “google custom search” para exibir as duas configurações que você precisa. Cole a chave de API em ai_google_custom_search_api_key e o ID do Mecanismo de Pesquisa (número CX) em ai_google_custom_search_cx da sua instância do Discourse e salve as novas configurações. Configure suas outras configurações de IA conforme necessário.
Etapa 5: Rastreamento de Chaves de Pesquisa de API
Você pode ver a atividade da sua chave de API de Pesquisa Personalizada no Google Cloud Console API e Serviços Detalhes e também configurar cotas na guia Cota e Limite de Sistemas. Relatórios de custos podem ser visualizados na guia Custo.
Exemplos de Pesquisas do Discourse AI
Aqui está um exemplo do OpenAI GPT-4 Turbo usando a Pesquisa Personalizada do Google para explicar o que ele faz e como se configurar.
Aqui está um exemplo do Anthropic Claude Opus usando a Pesquisa Personalizada do Google para explicar o significado de “centauro reverso”.
Links Relevantes
- Discourse AI
- Documentação do Mecanismo de Pesquisa Personalizada do Google Developer
- API de Pesquisa Personalizada do Google
- Faturamento do Google Cloud
- Mecanismo de Pesquisa Programável do Google
