<div></div>
Búsqueda de Google para Discourse AI
Para configurar un bot de búsqueda de Google con el plugin Discourse AI, necesitarás configurar un Motor de Búsqueda Programable de Google y una clave API de Búsqueda Personalizada. Cualquier modelo de IA que utilices necesitará usar esta herramienta de búsqueda para devolver resultados de búsqueda de Google. Cuando configures un servicio de IA para tu Plugin de Discourse, por ejemplo, si estás utilizando OpenAI API GPT o Anthropic Claude, y quieres usar un bot auxiliar para realizar búsquedas en Google, necesitarás configurar un Motor de Búsqueda Programable para buscar en Google y una clave API para que tu bot investigador acceda al motor de búsqueda y devuelva resultados.
Introducción: Google Cloud, Motor de Búsqueda Programable y API de Búsqueda Personalizada
El Motor de Búsqueda Programable (o Motor de Búsqueda Personalizada) es un servicio de motor de búsqueda gratuito que cualquiera puede configurar en su sitio web y se identifica por un ID de motor de búsqueda (o número CX). Una clave API de Búsqueda Personalizada se utiliza para realizar solicitudes API al motor de búsqueda, y las claves API se gestionan desde la consola de Google Cloud. Por lo tanto, necesitarás configurar una cuenta de Google Cloud; se requiere una tarjeta de crédito para registrar tu cuenta, pero la API de Búsqueda Personalizada proporciona 100 consultas de búsqueda al día de forma gratuita antes de que pagues (solicitudes adicionales cuestan $5 por cada 1000 consultas, hasta 10.000 consultas al día, pero tendrás que comprar más uso). Consulta cómo gestionar la facturación.
También querrás configurar tu clave bajo un proyecto de Google Cloud, preferiblemente uno nuevo designado para la clave de búsqueda (para facilitar el seguimiento). Ten en cuenta que Google Cloud tiene cuotas tanto en el número de proyectos como en el número de proyectos adjuntos a una cuenta de facturación, y los proyectos se pueden añadir a las cuentas de facturación después de que se configuren y se creen las claves API.
Lista de verificación
- Configurar cuenta de Google Cloud
- Crear un proyecto para tu clave API de búsqueda personalizada
- Conectar el proyecto a la cuenta de facturación
- Crear clave API
- Configurar clave API para Búsqueda Personalizada
- Configurar un Motor de Búsqueda Programable de Google
- Guardar la clave API de búsqueda personalizada y el ID de búsqueda personalizada en la configuración de Discourse AI
Paso 1: Configurar un Proyecto en Google Cloud
Antes de configurar tu motor de búsqueda personalizado y clave API, configura un proyecto en Google Cloud.
Ve a administración de Google Cloud para APIs para ti (o tu organización) y asegúrate de estar en la organización principal (puedes verlo en el campo superior junto al logotipo de Google Cloud).
Tendrás que crear un proyecto para tu motor de búsqueda si aún no tienes uno que quieras usar; el enlace para seleccionar o crear un nuevo proyecto está cerca de la parte superior de la página.
Completa la página de creación de nuevo proyecto (asegúrate de que tu organización esté seleccionada en los campos desplegables correspondientes).
Para gestionar la facturación de tu proyecto, necesitarás configurar una cuenta de facturación para el proyecto en facturación de Google Cloud, asumiendo que tienes la facturación configurada para tu organización. Tú (o tu gestor de cuentas de facturación) deberías poder hacerlo más tarde después de que se cree la clave. Ten en cuenta que hay cuotas para proyectos y proyectos de facturación dependiendo de la cuenta de Google Cloud de tu organización.
Para habilitar la facturación en tu proyecto, ve a la pestaña Facturación en el menú de navegación de Google Cloud y vincula una cuenta de facturación, o habilita la facturación para el proyecto desde la página de proyectos de facturación.
Paso 2: Crear una Clave API
Para crear una clave API desde la Consola de Google Cloud, ve a la pestaña API y Servicios en tu consola de Google Cloud y a la configuración de credenciales para tu nuevo proyecto. (No te preocupes por el mensaje “configurar pantalla de consentimiento”). Haz clic en el enlace “+ crear credenciales” cerca de la parte superior de la página y selecciona “clave API” en las opciones desplegables.
Se creará una nueva clave API para ti. Cópiala y guárdala en un lugar seguro, como una aplicación de bóveda de contraseñas. No compartas las claves.
Esta es la clave API de Búsqueda Personalizada de Google que necesitarás introducir en la configuración de Discourse AI para ai_google_custom_search_api_key.
Ahora deberías ver tu nueva clave en la lista de claves API. Haz clic en los 3 puntos en la columna Acciones, en el extremo derecho, y selecciona “Editar clave API”.
Esto abrirá la página de configuración de credenciales de la clave API, y aquí puedes editar el nombre de la clave API a algo más apropiado. (También puedes ver/copiar tu clave API o regenerarla si es necesario). Luego ve a la sección “Restricciones de API” en la parte inferior y selecciona “Restringir clave” y luego elige “API de Búsqueda Personalizada”. Haz clic en Aceptar y luego Guarda tu clave API.
Si no ves ninguna restricción listada, es posible que tengas que habilitar el servicio de API en la Biblioteca de API. Busca “google custom search api” y selecciónala. Aquí verás los detalles de la API de Búsqueda Personalizada, incluyendo precios y enlaces a más documentación; haz clic en el enlace para habilitar la API.
La nueva clave API aparecerá ahora listada con su nuevo nombre y una marca de verificación verde para indicar que está restringida a las solicitudes JSON de la API de Búsqueda Personalizada.
Paso 3: Crear un Motor de Búsqueda Programable
Para crear un motor de búsqueda que tu clave API pueda usar, ve a la página del Motor de Búsqueda Programable de Google y haz clic en “Empezar” si aún no has iniciado sesión (inicia sesión o crea tu cuenta). Una vez conectado, ve a la página de la consola del motor de búsqueda. Aquí se listarán todos tus motores de búsqueda programables existentes.
Haz clic en el botón “Añadir” (o en el enlace “¡Crea tu primer motor de búsqueda!”) para abrir la página del nuevo motor de búsqueda. Dale un nombre adecuado y completa los campos según corresponda.
Haz clic en el botón “Crear” y tu nuevo motor de búsqueda será creado. La página te dará la opción de copiar el script de búsqueda si quieres usar el cuadro de búsqueda en una interfaz web en algún lugar, pero eso no es necesario aquí, ya que solo nos interesa usarlo para nuestras credenciales de clave API de acceso.
Selecciona el botón personalizar para ir a la página de resumen del motor de búsqueda. Aquí podemos ver ahora el ID del Motor de Búsqueda (número CX) necesario para nuestra configuración de búsqueda de Google de Discourse AI, así como algunas otras opciones que es posible configurar. (Ten en cuenta que si te desplazas hasta el final, hay un enlace para crear claves API; no necesitas hacer esto ya que lo hiciste en el paso 2 anterior).
Paso 4: Configurar la Búsqueda Personalizada de Google en el Plugin Discourse AI
Copia el número del ID del Motor de Búsqueda y guárdalo junto con la clave API que creaste en el paso 2. Ve a Administrador - Configuración del sitio y, en el filtro de Todas las Configuraciones del Sitio, escribe “google custom search” para que aparezcan las dos configuraciones que necesitas. Pega la clave API en ai_google_custom_search_api_key y el ID del Motor de Búsqueda (número CX) en ai_google_custom_search_cx de tu instancia de Discourse y guarda las nuevas configuraciones. Configura tus otras opciones de IA según sea necesario.
Paso 5: Seguimiento de las Claves API de Búsqueda
Puedes ver la actividad de tu clave API de Búsqueda Personalizada en los Detalles de API y Servicios de la Consola de Google Cloud y también configurar cuotas en la pestaña Cuota y Límite de Sistemas. Los informes de costos se pueden ver en la pestaña Costo.
Ejemplos de Búsquedas de Discourse AI
Aquí tienes un ejemplo de OpenAI GPT-4 Turbo utilizando la Búsqueda Personalizada de Google para explicar qué hace y cómo configurarse.
Aquí tienes un ejemplo de Anthropic Claude Opus utilizando la Búsqueda Personalizada de Google para explicar el significado de “centauro inverso”.
Enlaces Relevantes
- Discourse AI
- Documentación del Motor de Búsqueda Personalizada para Desarrolladores de Google
- API de Búsqueda Personalizada de Google
- Facturación de Google Cloud
- Motor de Búsqueda Programable de Google
