Intégrez l’API SERP de Bright Data dans un agent IA dans IBM watsonx.

Dans ce tutoriel, vous découvrirez :

• Comment IBM watsonx prend en charge le développement d’agents IA.
• Pourquoi l’intégration de l’API SERP de Bright Data améliore les agents IBM watsonx Orchestrate.
• Les étapes exactes pour créer un agent IA alimenté par l’API SERP de Bright Data dans IBM Watsonx Orchestrate.

C’est parti !

Qu’est-ce que la fonctionnalité de création d’agents IA dans IBM Watsonx ?

IBM Watsonx Orchestrate, un système d’IA générative et d’automatisation prêt à l’emploi pour les entreprises, offre des fonctionnalités de création d’agents IA. Cette solution vous fournit tout ce dont vous avez besoin pour concevoir, déployer et gérer des agents IA autonomes qui exécutent des tâches, prennent des décisions et interagissent avec des systèmes critiques pour l’entreprise.

La création d’agents dans IBM watsonx est disponible à la fois via une interface web low-code et une approche basée sur le code via la bibliothèque Python Agent Development Kit (ADK). Dans cet article, nous nous concentrerons sur l’intégration du workflow low-code à l’aide de l’application web.

Les agents du service Orchestrate peuvent collaborer grâce à l’orchestration multi-agents, se connecter à divers outils externes, exploiter le RAG (Retrieval-Augmented Generation) pour des réponses fondées sur les connaissances, et bien plus encore.

La plateforme comprend également des fonctionnalités de gouvernance et d’observabilité pour garantir la conformité, la transparence et la surveillance des performances. Une fois créés, les agents peuvent être déployés sur plusieurs canaux tels que le chat web, Slack, Microsoft Teams et autres.

Pourquoi les agents IBM watsonx ont-ils besoin d’accéder à l’API SERP de Bright Data ?

Les grands modèles linguistiques, y compris ceux disponibles dans IBM watsonx, sont limités par les données sur lesquelles ils ont été formés. En termes plus simples, leurs connaissances s’arrêtent à un certain moment dans le temps.

C’est pourquoi les LLM ont tendance à produire des réponses obsolètes ou inexactes. Ce problème devient encore plus grave pour les agents IA chargés de prendre des décisions ou de produire des rapports pour soutenir la prise de décision…

La solution consiste à doter votre agent d’outils lui permettant de récupérer et de traiter des données fiables. Par exemple, l’agent pourrait interroger les moteurs de recherche pour recueillir des informations vérifiées et actualisées, puis apprendre à partir de ces données afin de réduire les hallucinations. Il en résulterait des décisions plus précises et une plus grande confiance dans le fait que les réponses de l’agent sont basées sur des connaissances du monde réel.

Le moyen le plus simple d’y parvenir est d’utiliser une API SERP ou un outil de recherche web, tel que l’API SERP de Bright Data. Cette API de niveau entreprise pour la récupération de données des moteurs de recherche gère les proxys, le déblocage et le formatage des données à votre place. En d’autres termes, vous n’avez pas à vous soucier des défis habituels liés à la collecte de données des moteurs de recherche lorsque vous travaillez avec des agents IA.

L’API SERP de Bright Data s’intègre directement à IBM watsonx Orchestrate (ainsi qu’à de nombreuses autres plateformes de création d’agents IA), permettant à vos agents IA d’accéder aux résultats de recherche et de produire des résultats plus contextuels, fiables et vérifiables.

Développement d’un agent IA avec intégration de l’API SERP dans IBM watsonx.ai : guide étape par étape

Dans cette section, vous apprendrez comment intégrer l’API SERP de Bright Data en tant qu’outil dans un agent IA dans IBM watsonx Orchestrate.

Parmi les nombreux cas d’utilisation possibles, ce guide pratique se concentre sur la création d’un agent de recommandation de contenu. Son objectif est de suggérer des idées de contenu basées sur les tendances récentes liées à un sujet donné (par exemple, découvrir les dernières actualités dignes d’intérêt pour rédiger des articles ou créer des vidéos YouTube à des fins marketing).

Remarque: il ne s’agit que d’un exemple parmi d’autres, et vous pouvez adapter la même intégration de l’API SERP pour alimenter de nombreux autres cas d’utilisation basés sur l’IA.

Suivez les étapes ci-dessous !

Prérequis

Pour suivre ce tutoriel, assurez-vous de disposer des éléments suivants :

• Un IBMid pour vous connecter à votre IBM watsonx Orchestrate (un essai gratuit suffit).
• Un compte Bright Data avec une clé API active.

Ne vous inquiétez pas pour la configuration de votre compte Bright Data, vous serez guidé tout au long du processus ultérieurement.

Il est également utile de se familiariser avec le fonctionnement de l’API SERP de Bright Data, la manière dont les agents IA utilisent les outils et les bases des spécifications OpenAPI pour la définition des outils.

Étape n° 1 : créer un nouvel agent IA IBM watsonx

Connectez-vous à IBM watsonx Orchestrate à l’aide de votre compte IBM. Vous arriverez sur cette page :

Ici, appuyez sur le bouton « Créer un nouvel agent » à gauche pour ouvrir le formulaire de création d’un nouvel agent. Remplissez le formulaire « Créer un agent » comme suit :

• Sélectionnez l’option « Créer à partir de zéro ».
• Donnez un nom à votre agent, par exemple « Agent de recommandation de contenu ».
• Fournissez une description telle que : « Cet agent peut récupérer des informations à jour à partir des moteurs de recherche via l’intégration de l’API SERP de Bright Data afin de recommander du contenu pertinent et intéressant en fonction d’une entrée donnée. »
  
  Une fois cela fait, appuyez sur le bouton « Créer » dans le coin inférieur gauche pour continuer. Vous accéderez alors à la page de gestion des agents :
  
  Super ! Vous venez d’initialiser votre agent IA de recommandation de contenu dans IBM watsonx Orchestrate. Celui-ci sera bientôt intégré à l’API SERP de Bright Data pour récupérer les derniers résultats de recherche.

Étape n° 2 : personnalisez votre agent

Sur la page de gestion des agents, vous pouvez personnaliser plusieurs options, telles que la voix de l’agent, le modèle IA, les invites de démarrage, le message d’accueil, et bien plus encore.

Pour modifier le modèle, ouvrez le menu déroulant à droite de la section « IA modèle » :

Dans la version d’essai d’IBM Watsonx, vous avez accès aux deux modèles suivants :

1. llama-3-2-90b-vision-instruct: optimisé pour la reconnaissance visuelle, le raisonnement par image, le sous-titrage et la réponse à des questions sur des images. Il s’agit du modèle par défaut.
2. llama-3-405b-instruct: LLM avancé pour la génération de données synthétiques, la distillation et l’inférence pour les chatbots, le codage et les tâches spécifiques à un domaine. Développé par Meta.

Sélectionnez le modèle qui correspond le mieux à l’objectif de votre agent.

Ensuite, pensez à mettre à jour le message d’accueil afin qu’il soit plus adapté à la fonction de votre agent. Par exemple, écrivez quelque chose comme « Quels conseils de recommandation de contenu souhaitez-vous ? ».

Mettez également à jour les invites de démarrage rapide afin de fournir des exemples d’interactions aux utilisateurs :

• « Recommandez-moi des films récents que je devrais absolument voir. »
• « Montrez-moi les articles d’actualité les plus récents sur IBM watsonx. »
• « Trouvez les sujets de blog tendance sur l’IA en 2025 et suggérez-moi cinq idées de contenu que je pourrais écrire. »

Étant donné que cet agent s’appuiera principalement sur des outils (en particulier l’API SERP de Bright Data), il est également logique de le définir comme un agent ReAct. Si vous n’êtes pas familier avec cette architecture, un agent ReAct suit le flux suivant :

• Réflexion: le LLM planifie la prochaine étape.
• Action: exécute des actions à l’aide d’outils.
• Observation: observe les résultats et affine l’approche.

Cette boucle continue permet à l’agent de traiter des requêtes complexes, de recouper des informations et de valider les résultats intermédiaires avant de fournir une réponse finale.

Une fois toutes les configurations terminées, allez dans la section « Aperçu » à droite et appuyez sur le bouton « Réinitialiser le chat » pour recharger l’aperçu de votre agent :

Vous verrez alors l’agent mis à jour avec toutes vos personnalisations appliquées :

Étape n° 3 : commencez à utiliser l’API SERP de Bright Data

Avant de poursuivre la définition de l’agent IA, vous devez préparer votre compte Bright Data et configurer le service API SERP. Pour ce faire, suivez la documentation officielle de Bright Data ou les instructions ci-dessous.

Si vous n’avez pas encore de compte, créez un compte Bright Data. Sinon, connectez-vous simplement. Une fois connecté, accédez à la page « Proxys & Scraping » (Proxys et scraping). Dans la section « My Zones » (Mes zones), recherchez une ligne intitulée « API SERP » dans le tableau :

Si vous ne voyez pas de ligne intitulée « API SERP », cela signifie qu’aucune zone n’a encore été configurée. Faites défiler vers le bas jusqu’à la section « API SERP » et cliquez sur « Create zone » (Créer une zone) pour en ajouter une :

Créez une zone API SERP et attribuez-lui un nom, tel que serp_api (ou tout autre nom de votre choix). Notez le nom de la zone, car vous en aurez besoin pour accéder au service dans IBM watsonx.

Sur la page du produit API SERP, activez le bouton « Activer » pour activer la zone :

Enfin, suivez le tutoriel officiel pour générer votre clé API Bright Data. Conservez-la dans un endroit sûr, car vous en aurez bientôt besoin.

Nous vous recommandons également de consulter la documentation de l’API SERP de Bright Data pour vous familiariser avec la manière d’appeler l’API, ses options disponibles et d’autres détails.

Parfait ! Vous avez maintenant tout ce qu’il faut pour utiliser l’API SERP de Bright Data dans votre agent IA IBM watsonx.

Étape n° 4 : Ajouter l’outil API SERP

Dans le cadre des options de personnalisation, vous avez également la possibilité d’ajouter des outils à votre agent. Voici comment connecter un agent IA à l’API SERP de Bright Data. Passons en revue la définition et l’intégration de cet outil personnalisé (ce qui prendra les trois étapes suivantes).

Pour ajouter un nouvel outil à votre agent, rendez-vous dans la section « Outils » et cliquez sur le bouton « Ajouter un outil » :

Normalement, vous pourriez envisager de sélectionner l’option« Créer un flux de travail d’agent »et d’écrire le code Python pour vous connecter à l’API SERP de Bright Data. Cependant, à l’heure où nous écrivons ces lignes, les modules Python disponibles (que vouspouvez importer et utiliser dans des nœuds de code Python personnalisés) sont fixes et ne peuvent pas être étendus. Comme les clients HTTP Python ne sont pas inclus, l’approche du code personnalisé ne fonctionnera pas. Vous pouvez plutôt intégrer l’API SERP dans un outil via une spécification OpenAPI.

Plus précisément, vous devez ajouter l’outil API Bright Data à l’aide d’une définition OpenAPI. Pour ce faire, créez un fichier nommé bright-data-serp-api.yml sur votre machine locale avec la spécification suivante :

openapi: 3.0.3
info:
  title: Bright Data API SERP
  version: 1.0.0
  description: >
    Bright Data API SERP fournit des résultats réels d'utilisateurs en grand volume pour tous les principaux moteurs de recherche. Prend en charge les formats de sortie bruts et Markdown.
servers:
  - url: https://api.brightdata.com
paths:
  /request:
    post:
      summary: Envoyer une requête SERP
      description: >
        Soumettez une requête de scraping SERP à l'aide de votre zone API SERP Bright Data.
      tags:
        - SERP
      requestBody:
        required: true
        content:
          application/json:
            schema :
              type : objet
              requis :
                - zone
                - url
              propriétés :
                zone :
                  type : chaîne
                  description : Nom de votre zone API SERP.
                  par défaut : <YOUR_BRIGHT_DATA_SERP_API_ZONE_NAME>
                url :
                  type : chaîne
                  description : URL du moteur de recherche à interroger (par exemple, https://www.google.com/search?q=<search_query>)
                  exemple : https://www.google.com/search?q=pizza&hl=en&gl=us
                format :
                  type : chaîne
                  description : Format de réponse
                  par défaut : brut
                data_format :
                  type : chaîne
                  description : Format des données de sortie
                  par défaut : markdown
réponses :
        « 200 » :
          description : Réponse réussie avec résultats de recherche
          contenu :
            text/plain :
              schéma :
                type : chaîne
        « 400 » :
          description : Demande non valide
        « 401 » :
          description : Non autorisé - clé API non valide
        « 500 » :
          description : Erreur interne du serveur
      sécurité :
        - bearerAuth : []
composants :
  securitySchemes :
    bearerAuth :
      type : http
      scheme : bearer
      bearerFormat : API_KEY

Important: remplacez <YOUR_BRIGHT_DATA_SERP_API_ZONE_NAME> par le nom réel de votre zone API SERP créée précédemment (par exemple, serp_api).

Le code YAML ci-dessus définit une spécification OpenAPI v3.0.3 pour l’intégration de l’API SERP de Bright Data. Les points clés à noter sont les suivants :

• Le corps de l’API définit les paramètres suivants :
  • zone: le nom de votre zone API SERP.
  • url: l’URL de la page du moteur de recherche à interroger.
  • format: spécifie comment l’API doit produire les données de sortie. « raw » signifie que l’API renverra les données récupérées directement dans le corps de la réponse, sans les imbriquer dans un objet structuré.
  • data_format: détermine le format de réponse, tel que HTML, JSON analysé ou Markdown. Dans ce cas, il est défini par défaut sur « markdown », car il s’agit d’un format de données idéal pour l’ingestion par l’IA.
• La section bearerAuth sous securitySchemes indique que la connexion à l’API est authentifiée à l’aide d’une clé API fournie par l’utilisateur dans l’en-tête Authorization via le mécanisme Bearer (qui correspond à la manière dont vous authentifiez les requêtes vers l’API SERP à l’aide de votre clé API Bright Data).

Ce qui importe ici, c’est de comprendre que la spécification OpenAPI ci-dessus définit un appel API SERP Bright Data qui renvoie des données au format Markdown. Pour tous les détails ci-dessus, y compris la signification de chaque paramètre et option, consultez la documentation officielle.

Pour transmettre ce fichier YAML à IBM watsonx, dans la fenêtre modale « Ajouter un nouvel outil », sélectionnez « Ajouter à partir d’un fichier ou d’un serveur MCP » :

Ensuite, choisissez « Importer à partir d’un fichier » :

Conseil: pour simplifier l’accès aux produits Bright Data compatibles avec l’IA, vous pouvez également sélectionner l’option « Importer depuis le serveur MCP » et configurer le Web MCP de Bright Data via son instance distante.

Dans la fenêtre modale « Importer un outil », faites glisser et déposez votre fichier bright-data-api-serp.yml ou cliquez pour le télécharger :

Une fois la validation terminée, vous devriez voir le message de confirmation suivant :

Réussite ! Votre spécification OpenAPI pour l’intégration de l’API SERP de Bright Data a été acceptée. Appuyez sur « Suivant » et poursuivez l’intégration de l’outil dans votre agent.

Étape n° 5 : terminer l’authentification de l’outil API SERP

Après avoir cliqué sur le bouton « Suivant », vous verrez la ligne « Envoyer une requête SERP » dans le tableau « Opérations » :

Cochez-la, puis cliquez sur le bouton « Suivant ». Vous accéderez alors à la section « Connexions », où vous devrez définir la connexion requise pour authentifier les requêtes API SERP à l’aide de votre clé API Bright Data. Commencez par cliquer sur le bouton « Ajouter un nouvel élément » :

Dans la section « Ajouter une nouvelle connexion », attribuez un identifiant à la connexion, par exemple bright-data-api-key:

Appuyez sur « Enregistrer et continuer » et configurez votre connexion en sélectionnant :

• Type d’authentification: « Bearer Token »
• Type d’identifiants: « Identifiants d’équipe »

Dans le champ de saisie « Bearer token » qui apparaît après avoir sélectionné l’option « Identifiants d’équipe », collez votre clé API Bright Data. Appuyez ensuite sur « Connecter » :

Une fois la connexion vérifiée, vous devriez voir une confirmation comme celle-ci :

Ensuite, appuyez sur « Terminer » et sélectionnez bright-data-api-key dans le tableau « Connexions » :

Enfin, terminez la configuration de l’authentification en appuyant sur « Done ».

Félicitations ! Vous avez réussi à authentifier votre outil personnalisé « Envoyer une requête SERP » pour l’intégration de l’API SERP de Bright Data.

Étape n° 6 : finaliser la configuration de l’outil API SERP

Dans la page de gestion de l’agent, vous verrez désormais l’outil « Envoyer une requête SERP » disponible dans la section « Ensemble d’outils » :

Pour personnaliser davantage l’outil, appuyez sur le bouton « ⋮ » et sélectionnez l’option « Modifier les détails ». Sur la page de configuration, vérifiez tous les paramètres pour vous assurer que tout est correct et configuré comme prévu :

Vous verrez la description de l’API et les paramètres du corps de la requête, ainsi que leurs valeurs par défaut, tels que définis dans la spécification YAML téléchargée précédemment.

Et voilà ! Vous avez enfin terminé l’intégration de l’API SERP de Bright Data dans votre agent IBM watsonx à l’aide d’un outil personnalisé défini via une spécification OpenAPI.

Étape n° 7 : tester l’agent

Votre agent IBM watsonx IA est désormais configuré pour accéder à un outil de récupération SERP. Testez-le avec une invite qui nécessite des données de moteur de recherche en direct, par exemple :

Trouvez les dernières actualités sur les robots humanoïdes IA et suggérez cinq idées de contenu que je pourrais écrire pour explorer ce sujet.

(Remarque: il s’agit simplement d’un exemple, vous pouvez tester n’importe quelle invite nécessitant des résultats de recherche sur le Web).

Il s’agit d’une invite idéale, car elle demande des informations actuelles que le modèle de base seul ne connaît peut-être pas, « les robots humanoïdes IA » étant un sujet d’actualité avec des nouvelles constamment mises à jour.

Exécutez cette invite dans la section « Aperçu » de votre agent, et vous devriez obtenir un résultat similaire à celui-ci :

L’agent basé sur ReAct appellera l’outil « Envoyer une requête SERP », récupérera les résultats et traitera les informations SERP pour générer une réponse cohérente.

Si vous avez déjà essayé de récupérer les résultats de recherche Google, vous savez à quel point cela peut être difficile en raison de la détection des bots, des interdictions d’IP, du rendu JavaScript (qui a même conduit à une crise des données SERP) et d’autres problèmes. L’API SERP de Bright Data s’occupe de tout cela pour vous, en renvoyant les SERP récupérées dans un format Markdown (ou HTML, JSON, etc.) optimisé pour l’IA.

Pour vous assurer que l’API SERP a été appelée par l’agent, développez la section « Raisonnement » de la réponse. Concentrez-vous sur « Étape 1 » :

Remarquez comment la première étape correspond à l’appel de l’outil API SERP de Bright Data pour la requête « dernières nouvelles robots humanoïdes IA » (qui a été déduite de l’invite). Ensuite, la réponse de l’outil est la version Markdown de la page SERP pour cette requête de recherche.

Dans ce cas, voici la réponse produite par l’agent IA :

Sur la base des résultats de recherche, voici cinq idées de contenu pour explorer le sujet des robots humanoïdes IA :
1. « L'avenir du travail : comment les robots humanoïdes IA révolutionnent les industries » - Cet article pourrait explorer les différentes façons dont les robots humanoïdes IA sont utilisés dans différentes industries, telles que la fabrication, les soins de santé et le service à la clientèle.
2. « L'éthique des robots humanoïdes IA : faut-il leur accorder des droits humains ? » - Cet article pourrait approfondir les implications éthiques de la création de robots de plus en plus semblables à des humains et se demander s'ils devraient se voir accorder des droits humains.
3. « Les dernières avancées en matière de robots humanoïdes dotés d'IA : ce que vous devez savoir » - Cet article pourrait donner un aperçu des derniers développements en matière de robots humanoïdes dotés d'IA, y compris les nouvelles technologies et innovations utilisées pour créer des robots plus avancés.
4. « Les risques et avantages potentiels des robots humanoïdes dotés d'IA à domicile » - Cet article pourrait explorer les risques et avantages potentiels liés à la présence de robots humanoïdes dotés d'IA à domicile, notamment leur capacité à aider aux tâches ménagères et à tenir compagnie.
5. « L'impact des robots humanoïdes dotés d'IA sur la société : un regard vers l'avenir » - Cet article pourrait examiner l'impact potentiel des robots humanoïdes dotés d'IA sur la société, notamment leur capacité à changer notre façon de vivre et de travailler, ainsi que les conséquences potentielles de la création de robots de plus en plus semblables à des humains.

C’est une excellente réponse qui fournit des informations précieuses pour la création de contenu !

Il est maintenant temps d’aller encore plus loin avec votre agent. Essayez de tester des invites liées à la vérification des faits, à la surveillance des marques, à l’analyse des tendances du marché ou à d’autres scénarios afin d’évaluer ses performances dans différents cas d’utilisation RAG et agentique.

Et voilà ! Vous venez de créer un agent IA dans IBM Watsonx intégré à l’API SERP de Bright Data. Votre agent peut désormais récupérer à la demande des données de recherche web actualisées, fiables et contextuelles afin de fournir des recommandations de contenu intelligentes.

Conclusion

Dans cet article, vous avez appris à intégrer l’API SERP de Bright Data dans un agent IA IBM Watsonx à l’aide d’un workflow low-code.

Cette approche est idéale pour les utilisateurs professionnels qui souhaitent créer des agents IA contextuels sur IBM tout en tirant parti des fonctionnalités évolutives et prêtes à l’emploi de l’API SERP de Bright Data. Pour aller encore plus loin dans vos workflows IA, explorez l’infrastructure IA de Bright Data.

Inscrivez-vous dès aujourd’hui à Bright Data et commencez à tester gratuitement nos solutions de données web prêtes pour l’IA !