AI

IBM watsonxのAIエージェントにBright DataのSERP APIを統合する

このガイドでは、正確なリアルタイム検索結果を得るために、IBM watsonx Orchestrate AIエージェントをBright DataのSERP APIに接続する方法を示します。
3 分読
Watsonx_SERP API blog image

このチュートリアルでは、以下の内容を学びます:

  • IBM watsonxがAIエージェント開発をどのように支援するか。
  • Bright DataのSERP APIを統合することでIBM Watsonx Orchestrateエージェントが強化される理由
  • IBM Watsonx Orchestrate内でBright DataのSERP APIを活用したAIエージェントを構築する具体的な手順。

さあ、始めましょう!

IBM watsonxのAIエージェント構築機能とは?

エンタープライズ対応の生成AIおよび自動化システムであるIBM watsonx Orchestrateは、AIエージェント構築機能を提供します。このソリューションにより、タスクの実行、意思決定、ビジネスクリティカルなシステムとの連携を行う自律型AIエージェントの設計、デプロイ、管理に必要なすべてが実現します。

IBM watsonxでのエージェント構築は、ローコードWebインターフェースと、Agent Development Kit(ADK)Pythonライブラリを用いたコードベースの両方から利用可能です。本記事ではWebアプリケーションを使用したローコードワークフロー統合に焦点を当てます。

Orchestrateサービスのエージェントは、マルチエージェントオーケストレーションによる連携、各種外部ツールへの接続、知識基盤型応答のためのRAG(Retrieval-Augmented Generation)の活用など、多様な機能を備えています

また、コンプライアンス、透明性、パフォーマンス監視を確保するためのガバナンスおよび可観測性機能も備えています。構築されたエージェントは、Webチャット、Slack、Microsoft Teamsなど複数のチャネルに展開可能です。

IBM watsonxエージェントがBright DataのSERP APIを必要とする理由

IBM watsonxを含む大規模言語モデル(LLM)は、訓練データに依存して性能が制限されます。平たく言えば、その知識は特定の時点までに留まります。

そのためLLMは時代遅れまたは不正確な応答を生成しがちです。意思決定支援やレポート作成を任されたAIエージェントでは、この問題がさらに深刻化します…

解決策は、エージェントに信頼性の高いデータを取得・処理するツールを装備することです。例えば、エージェントが検索エンジンにクエリを実行して検証済みかつ最新の情報を収集し、そのデータから学習することで幻覚現象を低減できます。その結果、意思決定の精度が向上し、エージェントの応答が現実世界の知識に基づいているという確信が高まります。

これを実現する最も簡単な方法は、SERP APIや Bright DataのSERP APIのような ウェブ検索ツールを利用することです。このエンタープライズグレードの検索エンジンデータ取得APIは、プロキシ処理、ブロック解除、データフォーマットを自動的に行います。つまり、AIエージェントと連携する際の検索エンジンデータ収集における典型的な課題を気にする必要はありません。

Bright DataのSERP APIはIBM watsonx Orchestrate(その他多数のAIエージェント構築プラットフォームとも)に直接統合され、AIエージェントが検索結果にアクセスし、より文脈に沿った信頼性・検証可能性の高い出力を生成することを可能にします。

IBM watsonx.ai における SERP API 統合による AI エージェント開発:ステップバイステップガイド

このセクションでは、IBM watsonx Orchestrate内のAIエージェントにBright Data SERP APIをツールとして統合する方法を学びます。

数多くのユースケースの中から、本ガイドではコンテンツ推薦エージェントの構築に焦点を当てます。その目的は、特定のトピックに関連する最近のトレンドに基づいてコンテンツのアイデアを提案することです(例:マーケティング向けに記事やYouTube動画を作成する価値のある最新の話題を発見する)。

:これは一例に過ぎず、同じ SERP API 統合を他の多くのAI 駆動ユースケースに応用できます。

以下の手順に従ってください!

前提条件

このチュートリアルを実践するには、以下の準備が必要です:

  • IBM Watsonx Orchestrateへのログイン用IBMID(無料トライアルで十分です)。
  • 有効なAPIキーを持つBright Dataアカウント

Bright Dataアカウントの設定については、後ほど手順を説明しますので、現時点では心配する必要はありません。

Bright Data SERP APIの動作、AIエージェントによるツールの使用方法、およびツール定義のためのOpenAPI仕様の基本について、ある程度理解していると便利です。

ステップ #1: 新しい IBM watsonx AI エージェントを作成する

IBMアカウントでIBM watsonx Orchestrateにログインします。以下のページが表示されます:
Pressing the “Create new agent” button in IBM watsonx Orchestrate
左側の「Create new agent」ボタンを押して、新しいエージェント作成フォームを開きます。「Create an agent」フォームを以下のように入力してください:

  • 「ゼロから作成」オプションを選択します。
  • エージェントに名前を付けます(例:「コンテンツ推薦エージェント」)。
  • 説明文を入力します(例):「このエージェントは、Bright DataのSERP API統合を介して検索エンジンから最新情報を取得し、与えられた入力に基づいて関連性が高く興味深いコンテンツを推薦します。」
    Filling out the “Create an agent” form
    入力後、左下の「作成」ボタンを押して続行します。エージェント管理ページにアクセスします:
    The “Content Recommendation Agent” page
    完了!これでIBM watsonx Orchestrateにおけるコンテンツ推薦AIエージェントの初期設定が完了しました。まもなくBright DataのSERP APIと連携し、最新の検索結果を取得できるようになります。

ステップ #2: エージェントのカスタマイズ

エージェント管理ページでは、エージェントの声、AIモデル、開始プロンプト、挨拶メッセージなど、複数のオプションをカスタマイズできます

モデルを変更するには、「AIモデル」セクション右側のドロップダウンを開きます:
Selecting the available LLM
IBM watsonxトライアル版では、以下の2つのモデルを利用できます:

  1. llama-3-2-90b-vision-instruct: 視覚認識、画像推論、キャプション生成、画像に関する質問への回答に最適化。デフォルトモデルです。
  2. llama-3-405b-instruct: チャットボット、コーディング、特定ドメインタスク向けの合成データ生成、知識蒸留、推論に対応した高度なLLM。Meta社開発

エージェントの目的に最も適したモデルを選択してください。

次に、エージェントの機能に合わせてウェルカムメッセージを更新することを検討してください。例えば、「どのようなコンテンツ推薦のヒントをお求めですか?」といった内容に書き換えてください。

また、クイックスタートプロンプトを更新し、ユーザー向けの対話例を提供してください:

  • 「最近絶対に見るべき映画をいくつかおすすめしてください」
  • 「IBM watsonxに関する最新のニュース記事を教えてください」
  • 「2025年のAIに関するトレンドブログトピックを探し、私が書ける5つのコンテンツアイデアを提案してください」

このエージェントは主にツール(具体的にはBright Data SERP API)に依存するため、ReActエージェントとして定義することも合理的です。このアーキテクチャに不慣れな方のために説明すると、ReActエージェントは以下の流れに従います:

  • 思考: LLMが次のステップを計画
  • アクション:ツールを使用してアクションを実行。
  • 観察:結果を観察し、アプローチを洗練させる。

この継続的なループにより、エージェントは複雑なクエリの処理、情報の相互参照、最終回答提供前の中間結果の検証が可能になります。
Customizing the AI agent
すべての設定が完了したら、右側の「プレビュー」セクションに移動し、「チャットをリセット」ボタンを押してエージェントのプレビューを再読み込みします:
Pressing the “Reset chat” update button

これで、すべてのカスタマイズが適用された更新版のエージェントが表示されます:
The updated AI agent

ステップ #3: Bright Data の SERP API を開始する

AIエージェント定義を続行する前に、Bright Dataアカウントの準備とSERP APIサービスの設定が必要です。これには、公式Bright Dataドキュメントまたは以下の手順に従ってください

アカウントをお持ちでない場合は、Bright Dataアカウントを作成してください。お持ちの場合はログインしてください。ログイン後、「プロキシ&スクレイピング」ページに移動します。「マイゾーン」セクションのテーブルで「SERP API」とラベル付けされた行を探します:
Note the “serp_api” row in the table

「SERP API」と表示された行がない場合、ゾーンがまだ設定されていません。「SERP API」セクションまでスクロールし、「ゾーンを作成」をクリックして追加します:
Configuring the SERP API zone
SERP APIゾーンを作成し、名前を割り当てます(例:serp_api、または任意の名前)。このゾーン名は、IBM watsonxでサービスにアクセスする際に必要となるため、必ず記録しておいてください。

SERP API製品ページで、「有効化」トグルを切り替えてゾーンを有効化してください:
Activating the SERP API zone
最後に、公式チュートリアルに従ってBright Data APIキーを生成してください。すぐに必要になるため、安全な場所に保管してください。

APIの呼び出し方法、利用可能なオプション、その他の詳細については、Bright Data SERP APIのドキュメントを確認することをお勧めします。

これで準備完了です。IBM watsonx AIエージェントでBright DataのSERP APIを使用する環境が整いました。

ステップ #4: SERP API ツールの追加

カスタマイズオプションの一環として、エージェントにツールを追加する機能も備わっています。これがAIエージェントをBright DataのSERP APIに接続する方法です。このカスタムツールの定義と統合手順(次の3ステップで完了)を順を追って説明します。

エージェントに新しいツールを追加するには、「ツール」セクションに移動し、「ツールを追加」ボタンをクリックします:
Pressing the “Add Tool” button
通常は「エージェントワークフローを作成」オプションを選択し、Pythonコードを記述してBright Data SERP APIに接続することを検討するかもしれません。しかし、執筆時点では、カスタムPythonコードノードでインポート・使用可能なPythonモジュールは固定されており、拡張できません。Python HTTPクライアントが含まれていないため、カスタムコードによるアプローチは機能しません。代わりに、OpenAPI仕様を介してツールにSERP APIを統合できます。

具体的には、OpenAPI定義を用いてBright Data APIツールを追加します。そのためには、ローカルマシンにbright-data-serp-api.ymlというファイルを作成し、以下の仕様を記述します:

openapi: 3.0.3
info:
  title: Bright Data SERP API
  version: 1.0.0
  description: >
    Bright Data SERP APIは主要検索エンジン全てにおいて、大量のリアルユーザー検索結果を提供します。
    生データおよびMarkdown出力形式をサポートします。
servers:
  - url: https://api.brightdata.com
paths:
  /request:
    post:
      summary: SERPリクエストを送信
      description: >
        Bright Data SERP APIゾーンを使用してSERPスクレイピングリクエストを送信します。
      tags:
        - SERP
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - zone
                - url
              properties:
                zone:
                  type: string
                  description: あなたのSERP APIゾーン名。
                  default: <YOUR_BRIGHT_DATA_SERP_API_ZONE_NAME>
                url:
                  type: string
                  description: クエリ対象の検索エンジンURL(例: https://www.google.com/search?q=<search_query>)
                  example: https://www.google.com/search?q=pizza&hl=en&gl=us
                format:
                  type: string
                  description: レスポンス形式
                  default: raw
                data_format:
                  type: string
                  description: 出力データ形式
                  default: markdown
      responses:
        "200":
          description: 検索結果を含む正常なレスポンス
          content:
            text/plain:
              schema:
                type: string
        "400":
          description: 無効なリクエスト
        "401":
          description: Unauthorized - APIキーが無効です
        "500":
          description: 内部サーバーエラー
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API_KEY

重要:<YOUR_BRIGHT_DATA_SERP_API_ZONE_NAME>を、事前に作成した SERP API ゾーンの実際の名前(例:serp_api)に置き換えてください。

上記のYAMLコードは、Bright Data SERP APIを統合するためのOpenAPI v3.0.3仕様を定義しています。主なポイントは次の通りです:

  • APIボディは次のパラメータを定義します:
    • zone: SERP API ゾーンの名前。
    • url: クエリ対象の検索エンジンページURL。
    • format: APIが出力データを生成する方法を指定します。「``raw''」は、APIが取得したデータを構造化されたオブジェクトにネストせずに、レスポンス本文に直接返すことを意味します。
    • data_format: HTML、パース済みJSON、Markdownなど、レスポンス形式を決定します。AI処理に最適なデータ形式であるため、デフォルトでは「markdown」に設定されています。
  • securitySchemes内の bearerAuthセクションは、API接続がBearerメカニズムを介した Authorizationヘッダー内のユーザー提供APIキーで認証されることを示しています(これはBright Data APIキーを使用してSERP APIへのリクエストを認証する方法です)。

ここで重要なのは、上記のOpenAPI仕様がMarkdown形式でデータを返すBright Data SERP API呼び出しを定義している点です。各パラメータやオプションの意味を含む詳細については、公式ドキュメントを参照してください

そのYAMLファイルをIBM Watsonxに渡すには、「Add a new tool」モーダルで「Add from file or MCP server」を選択します:
Selecting the “Add from file or MCP server” option

次に「ファイルからインポート」を選択します:
Selecting the “Import from file” option

ヒント:AI対応Bright Data製品へのアクセスを簡素化するには、「MCPサーバーからインポート」オプションを選択し、Bright DataのWeb MCPをリモートインスタンス経由で設定することも可能です。

「ツールのインポート」モーダルで、bright-data-SERP API.ymlファイルをドラッグ&ドロップするか、クリックしてアップロードします:
Uploading your OpenAPI specification file

検証が完了すると、以下の確認メッセージが表示されます:
Note the validation message
成功!Bright Data SERP API統合用のOpenAPI仕様が受理されました。「次へ」を押してエージェントでのツール統合を続行してください。

ステップ #5: SERP API ツール認証の完了

「次へ」ボタンを押すと、「操作」テーブルに「SERPリクエストを送信」行が表示されます:
Note the “Send a SERP request” row in the “Operations” table

チェックを入れ、「次へ」ボタンを押してください。その後「接続」セクションに移動します。ここでは、Bright Data APIキーを使用してSERP APIリクエストを認証するために必要な接続を定義する必要があります。「新規アイテムを追加」ボタンを押して開始してください:
Pressing the “Add new item” button

「新規接続を追加」セクションで、接続にIDを付与します(例:bright-data-api-key)。
Giving your connection an ID
「保存して続行」を押した後、以下の設定を行います:

  • 認証タイプ: 「Bearer Token」
  • 認証情報タイプ:「チーム認証情報」

Configuring the connection
「チーム認証情報」オプション選択後に表示される「ベアラートークン」入力欄に、Bright Data APIキーを貼り付けます。その後、「接続」を押します:
Pressing the “Connect” button

接続が確認されると、以下のような確認メッセージが表示されます:
Note the “Connected” message

次に「完了」を押して、「接続」テーブルでbright-data-api-keyを選択します
Selecting the “bright-data-api-key” connection
最後に「完了」を押して認証設定を完了してください。

おめでとうございます! Bright Data SERP API 統合用の「SERPリクエスト送信」カスタムツールの認証が正常に完了しました。

ステップ #6: SERP API ツール設定の最終化

エージェント管理ページで、「ツールセット」セクションに「SERPリクエスト送信」ツールが表示されるようになります:
Note the “Send a SERP request” tool in the “Toolset” section

ツールをさらにカスタマイズするには、「⋮」ボタンを押し、「詳細を編集」オプションを選択します。設定ページで、すべての設定が正しく必要に応じて構成されていることを確認してください:
Reviewing the “Send a SERP request” info
APIの説明とリクエスト本文パラメータ、およびそれらのデフォルト値が、先にアップロードしたYAML仕様で定義された通り表示されます。

これで完了です!OpenAPI仕様で定義されたカスタムツールを使用し、Bright DataのSERP APIをIBM watsonxエージェントに統合しました。

ステップ #7: エージェントのテスト

IBM watsonx AIエージェントは、SERP取得ツールへのアクセス設定が完了しました。ライブ検索エンジンデータが必要なプロンプトでテストしてください。例:

AIヒューマノイドロボットに関する最新ニュースを探し、このトピックを探求するために書ける5つのコンテンツアイデアを提案してください。

:これは単なる例です。ウェブ検索結果を必要とする任意のプロンプトでテストできます)

このプロンプトは理想的です。なぜなら「AIヒューマノイドロボット」は常に更新されるトレンドトピックであり、基盤モデルだけでは把握できない最新情報を要求するからです。

エージェントの「プレビュー」セクションでこのプロンプトを実行すると、以下のような出力が得られるはずです:
Running the prompt on the Content Recommendation Agent
ReActベースのエージェントは「SERPリクエスト送信」ツールを呼び出し、結果を取得し、SERP情報を処理して一貫性のある応答を生成します。

Google検索結果のスクレイピングを試したことがある方なら、ボット検知、IP禁止、JavaScriptレンダリング(SERPデータ危機を引き起こした要因)、その他の問題により、これがどれほど困難かご存知でしょう。Bright Data SERP APIはこれら全てを処理し、AI最適化Markdown(またはHTML、JSONなど)形式でスクレイピングされたSERPを返します。

エージェントがSERP APIを確実に呼び出したことを確認するには、レスポンスの「推論」セクションを展開してください。「ステップ1」に注目します:
Note the Markdown SERP
最初のステップが、クエリ「latest news AI humanoid robots」(プロンプトから推測されたもの)に対するBright Data SERP APIツールの呼び出しに対応している点に注目してください。その後、ツールの応答として、その検索クエリに対するSERPページのMarkdown版が返されます。

このケースでは、AIエージェントが生成した応答は以下の通りです:

検索結果に基づき、AIヒューマノイドロボットのトピックを探る5つのコンテンツアイデアを以下に示します:
1. 「仕事の未来:AIヒューマノイドロボットが産業に革命をもたらす方法」 - 本記事では、製造、医療、カスタマーサービスなど、様々な産業でAIヒューマノイドロボットが活用されている多様な方法を探求できます。
2. 「AIヒューマノイドロボットの倫理:人権を付与すべきか?」 - 本記事では、人間にますます似たロボットを創造することの倫理的含意、および彼らに人権を認めるべきかどうかについて掘り下げます。
3. 「AIヒューマノイドロボットの最新進歩:知っておくべきこと」 - 本記事では、より高度なロボットを創造するために使用されている新技術や革新を含む、AIヒューマノイドロボットの最新動向の概要を提供します。
4. 「家庭におけるAIヒューマノイドロボットの潜在的なリスクと利点」 - 本記事では、家事支援や伴侶としての役割など、家庭にAIヒューマノイドロボットを導入することの潜在的なリスクと利点を探求する。
5. 「AIヒューマノイドロボットが社会に与える影響:未来を展望する」 - 本記事では、AIヒューマノイドロボットが社会に与える潜在的な影響を検証します。生活や仕事の在り方を変える可能性や、人間にますます似たロボットを生み出すことの潜在的な帰結を含みます。

これはコンテンツ生成に役立つ貴重な洞察に満ちた素晴らしい回答です!

次はエージェントをさらに進化させましょう。ファクトチェック、ブランド監視、市場トレンド分析など様々なシナリオに関連するプロンプトをテストし、異なるRAGやエージェント用途での性能を評価してみてください。

さあ、完成です!IBM WatsonxにBright DataのSERP APIを統合したAIエージェントを構築しました。このエージェントは、インテリジェントなコンテンツ推薦を実現するため、最新の信頼性の高い文脈に沿ったウェブ検索データをオンデマンドで取得できます。

まとめ

本ブログ記事では、ローコードワークフローを用いてBright DataのSERP APIをIBM watsonx AIエージェントに統合する方法を解説しました。

このアプローチは、IBM上で文脈認識型AIエージェントを構築しつつ、Bright DataのSERP APIが提供するスケーラブルでエンタープライズ対応の機能を活用したいビジネスユーザーに最適です。AIワークフローをさらに進化させるには、Bright DataのAI向けインフラストラクチャをご検討ください。

今すぐBright Dataに登録し、AI対応のWebデータソリューションを無料でテスト開始しましょう!