<div></div>
Recherche Google pour Discourse AI
Pour configurer un bot de recherche Google avec le plugin Discourse AI, vous devrez configurer un moteur de recherche programmable Google et une clé API de recherche personnalisée. Quel que soit le modèle d’IA que vous utilisez, il devra utiliser cet outil de recherche pour renvoyer les résultats de recherche Google. Lorsque vous configurez un service d’IA pour votre plugin Discourse, par exemple si vous utilisez l’API OpenAI GPT ou Anthropic Claude, et que vous souhaitez utiliser un bot d’assistance pour effectuer des recherches Google, vous devrez configurer un moteur de recherche programmable pour rechercher sur Google et une clé API pour que votre bot chercheur accède au moteur de recherche et renvoie les résultats.
Introduction : Google Cloud, Moteur de recherche programmable et API de recherche personnalisée
Le Moteur de recherche programmable (ou Moteur de recherche personnalisé) est un service de moteur de recherche gratuit que tout le monde peut configurer sur son site Web et qui est identifié par un identifiant de moteur de recherche (ou numéro CX). Une clé API de recherche personnalisée est utilisée pour effectuer des requêtes API auprès du moteur de recherche, et les clés API sont gérées à partir de la console Google Cloud. Ainsi, vous devrez configurer un compte Google Cloud - une carte de crédit est requise pour enregistrer votre compte, mais l’API de recherche personnalisée fournit 100 requêtes de recherche par jour gratuitement avant de payer (les requêtes supplémentaires coûtent 5 $ par 1 000 requêtes, jusqu’à 10 000 requêtes par jour, mais vous devrez acheter plus d’utilisation). Voir comment gérer la facturation.
Vous voudrez également configurer votre clé sous un projet Google Cloud, de préférence un nouveau projet désigné pour la clé de recherche (pour un suivi plus facile). Notez que Google Cloud a des quotas sur le nombre de projets et le nombre de projets attachés à un compte de facturation, et les projets peuvent être ajoutés aux comptes de facturation après leur configuration et la création des clés API.
Liste de contrôle
- Configurer un compte Google Cloud
- Créer un projet pour votre clé API de recherche personnalisée
- Connecter le projet à un compte de facturation
- Créer une clé API
- Configurer la clé API pour la recherche personnalisée
- Configurer un moteur de recherche programmable Google
- Enregistrer la clé API de recherche personnalisée et l’identifiant de recherche personnalisée dans les paramètres de Discourse AI
Étape 1 : Configurer un projet dans Google Cloud
Avant de configurer votre moteur de recherche personnalisé et votre clé API, configurez un projet dans Google Cloud.
Accédez à l’administrateur Google Cloud pour les API pour vous (ou votre organisation), et assurez-vous que vous êtes dans l’organisation parente (vous pouvez la voir dans le champ en haut à côté du logo Google Cloud).
Vous devrez créer un projet pour votre moteur de recherche si vous n’en avez pas déjà un que vous souhaitez utiliser - le lien pour sélectionner ou créer un nouveau projet se trouve près du haut de la page.
Remplissez la page de création d’un nouveau projet (assurez-vous que votre organisation est sélectionnée dans les champs déroulants appropriés).
Pour gérer la facturation de votre projet, vous devrez configurer un compte de facturation pour le projet dans la facturation Google Cloud, en supposant que la facturation est configurée pour votre organisation. Vous (ou votre responsable de compte de facturation) devriez pouvoir le faire plus tard après la création de la clé. Notez qu’il existe des quotas sur les projets et les projets de facturation en fonction du compte Google Cloud de votre organisation.
Pour activer la facturation sur votre projet, accédez à l’onglet Facturation dans le menu de navigation Google Cloud et liez un compte de facturation, ou activez la facturation pour le projet à partir de la page des projets de facturation.
Étape 2 : Créer une clé API
Pour créer une clé API à partir de la console Google Cloud, accédez à l’onglet API et services dans votre console Google Cloud et aux paramètres des identifiants de votre nouveau projet. (Ne vous inquiétez pas du message « configurer l’écran de consentement »). Cliquez sur le lien « + créer des identifiants » près du haut de la page et sélectionnez « Clé API » dans les options déroulantes.
Une nouvelle clé API sera créée pour vous. Copiez-la et conservez-la en lieu sûr, comme un gestionnaire de mots de passe. Ne partagez pas les clés.
Ceci est la clé API de recherche personnalisée Google dont vous aurez besoin pour votre configuration Discourse AI pour
ai_google_custom_search_api_key
Vous devriez maintenant voir votre nouvelle clé répertoriée dans la liste des clés API. Cliquez sur les 3 points dans la colonne Actions à l’extrême droite et sélectionnez « Modifier la clé API ».
Cela ouvrira la page de configuration des identifiants de la clé API, et ici vous pouvez modifier le nom de la clé API pour quelque chose de plus approprié. (Vous pouvez également afficher/copier votre clé API ou la régénérer si nécessaire). Ensuite, allez dans la section « Restrictions API » en bas et sélectionnez « Restreindre la clé », puis choisissez « API de recherche personnalisée ». Cliquez sur OK, puis enregistrez votre clé API.
Si vous ne voyez aucune restriction répertoriée, vous devrez peut-être activer le service API dans la Bibliothèque d’API. Recherchez « google custom search api », puis sélectionnez-la. Ici, vous verrez les détails de l’API de recherche personnalisée, y compris les prix et les liens vers plus de documentation - cliquez sur le lien pour activer l’API.
La nouvelle clé API sera maintenant répertoriée avec son nouveau nom et une coche verte pour indiquer qu’elle est restreinte aux requêtes JSON de l’API de recherche personnalisée.
Étape 3 : Créer un moteur de recherche programmable
Pour créer un moteur de recherche que votre clé API utilisera, accédez à la page Moteur de recherche programmable Google et cliquez sur « Commencer » si vous n’êtes pas déjà connecté (connectez-vous ou créez votre compte). Une fois connecté, accédez à la page de la console du moteur de recherche. Tous vos moteurs de recherche programmables existants seront répertoriés ici.
Cliquez sur le bouton « Ajouter » (ou le lien « Créez votre premier moteur de recherche ! ») pour ouvrir la page du nouveau moteur de recherche. Donnez-lui un nom approprié et remplissez les champs selon les besoins.
Cliquez sur le bouton « Créer » et votre nouveau moteur de recherche sera créé. La page vous donnera la possibilité de copier le script de recherche si vous souhaitez utiliser la boîte de recherche dans une interface Web quelque part, mais ce n’est pas nécessaire ici, car nous ne nous intéressons qu’à l’utiliser pour nos identifiants de clé API pour y accéder.
Sélectionnez le bouton personnaliser pour accéder à la page d’aperçu du moteur de recherche. Ici, nous pouvons maintenant voir l’identifiant du moteur de recherche (numéro CX) nécessaire pour nos paramètres de recherche Google Discourse AI, ainsi que d’autres options configurables. (Notez que si vous faites défiler vers le bas, il y a un lien pour créer des clés API - vous n’avez pas besoin de le faire car vous l’avez fait à l’étape 2 ci-dessus.)
Étape 4 : Configurer la recherche personnalisée Google dans le plugin Discourse AI
Copiez le numéro d’identifiant du moteur de recherche et stockez-le avec la clé API que vous avez créée à l’étape 2. Accédez à Admin - Paramètres du site et dans le filtre Tous les paramètres du site, tapez « recherche personnalisée google » pour afficher les deux paramètres dont vous avez besoin. Collez la clé API dans ai_google_custom_search_api_key et l’identifiant du moteur de recherche (numéro CX) dans ai_google_custom_search_cx de votre instance Discourse et enregistrez les nouveaux paramètres. Configurez vos autres paramètres d’IA selon vos besoins.
Étape 5 : Suivi des clés de recherche API
Vous pouvez voir l’activité de votre clé API de recherche personnalisée dans les détails de l’API et des services de la console Google Cloud et également configurer des quotas dans l’onglet Quota et limites du système. Les rapports de coûts peuvent être consultés dans l’onglet Coût.
Exemples de recherches Discourse AI
Voici un exemple d’OpenAI GPT-4 Turbo utilisant la recherche personnalisée Google pour expliquer ce qu’il fait et comment se configurer.
Voici un exemple d’Anthropic Claude Opus utilisant la recherche personnalisée Google pour expliquer le sens de « centaure inversé ».
Liens pertinents
- Discourse AI
- Documentation du moteur de recherche personnalisé pour développeurs Google
- API de recherche personnalisée Google
- Facturation Google Cloud
- Moteur de recherche programmable Google
