AI

Bright DataのSERP APIをMicrosoft Copilot StudioのAIエージェントに統合する。

Bright DataのSERP APIをMicrosoft Copilot Studio AIエージェントにシームレスに統合して、最新のWeb検索インサイトを強化する方法をご覧ください。
3 分読
Microsoft Copilot Studio with SERP API blog image

この記事では、次のことを学びます:

  • Microsoft Copilot Studioとは何か、何が特別なのか。
  • Bright DataのSERP APIを、その中に構築されたAIエージェントに統合することを検討すべき理由。
  • SERP APIに接続したAIエージェントをCopilot Studioに実装する方法。

さっそく見ていきましょう!

Microsoft Copilot Studioとは?

Copilot Studioは、Microsoftが開発したローコードプラットフォームで、カスタムAIエージェントを構築、テスト、公開できます。また、生産性を高めるために設計された生成AIチャットボットであるMicrosoft 365 Copilotのカスタマイズにも使用できます。

Copilot StudioはMicrosoft Power Platformの一部であり、さまざまな技術レベルのユーザーが利用できるように構築されている。特に、タスクを自動化し、情報を提供し、他のビジネスシステムやコミュニケーションチャネルに接続するAIエージェントを視覚的に作成するためのツールが用意されています。

:AzureでAIエージェントを構築する場合は、Azure AI Foundry内のBright Data SERP APIの統合に関する専用ガイドをご覧ください。

Bright DataのSERP APIをMicrosoft Copilot Studio AIエージェントに統合する理由

Copilot Studioは、AIエージェントのエンジン/ブレインとして機能する複数の大規模言語モデルをサポートしています。しかし、最終的にどのLLMを選んでも、その知識は固定されたままです。例えば、LLMは、今日のヘッドラインや昨夜のスポーツの結果など、最近の出来事については認識できません。そのため、時代遅れの、あるいは「幻覚」のような回答になってしまうのです。

この限界に対処するためには、ウェブからのリアルタイム・データをLLMの根拠とする必要がある。この手法は、RAG(Retrieval-Augmented Generation)ワークフローで広く使用されています。このワークフローでは、LLMが回答を生成する前に外部情報を取得してLLMに提供し、回答が正確で最新のものになるようにします。

Copilot Studioでは、Bright DataのSERP APIなどライブWeb検索用のサードパーティのデータソースと統合できるため、このようなことが可能になります。

SERP APIを使用すると、検索エンジンの検索クエリをプログラムで実行し、完全なSERP(検索エンジンの結果ページ)を取得できます。これにより、AIエージェントは、検索エンジンからの最新で検証可能な、コンテキストに富んだデータの安定したフローを得ることができます。

SERP APIツールにアクセスできるMicrosoft Copilot StudioでAIエージェントを構築する方法

このステップバイステップのセクションでは、Bright Data SERP APIツールをCopilot StudioのAIエージェントに統合する方法について説明します。

多くの使用例が考えられますが、この章ではコンテンツ関連分析エージェントの作成について説明します。このようなエージェントは、上位のページが特定のキーワードに関連する意味的な関連や文脈上のトピックを発見するために考案されました。

エージェントによって生成される情報は、トピックをより深く理解し、SEOのためにコンテンツを最適化し、全体的なコンテンツ戦略を改善するために非常に貴重です。

: これは単なる例であり、SERP API統合によって他の多くのユースケースを実現することができます。

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

前提条件

このチュートリアルに従うには、以下が必要です:

Microsoft Copilot Studioアカウントを作成するには、いくつかの前提条件を満たす必要があります。
サインアップ時に「Microsoft Copilot Studioは現在、職場または学校のアカウントでは利用できません」というエラーが表示された場合は、Microsoft 365 Business Standardの無料トライアルを有効にしてみてください。これにより、<ユーザー名>@<会社名>.onmicrosoft.comという形式のアカウントが作成され、Copilot Studioのサブスクライブに使用できるようになります。

または、Microsoftの公式フォーラムの指示に従ってセットアップを行うこともできます。

Bright Dataアカウントの設定については、この記事の後半で説明しますので、まだ心配しないでください。

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

Copilot StudioでAIエージェントを作成するには、まずログインします。メインダッシュボードに到達します:

The Copilot Studio dashboard

左側のメニューで「Create」ボタンをクリックし、「New Agent」ボタンを選択します:

Pressing the “New Agent” button

AIエージェントの作成フォームが表示されます。コンテンツ関連分析のためのエージェントを作成することが目的ですので、以下のようにフォームに記入してください:

  • 名前“コンテンツ関連解析エージェント”
  • 説明“このエージェントは、ターゲットキーワード/キーフレーズと密接に関連するトピックとコンセプトを発見します。選択したキーワードで上位に表示されているページを分析することで、文脈上のテーマ、エンティティ、関連するサブトピックを特定します。その目的は、ユーザーがウェブページをセマンティックに関連した情報で充実させ、より強力なトピックのオーソリティを構築できるようにすることです。”
  • 指示“エージェントは、Bright DataのSERP APIを使用して、指定されたキーワードの検索結果の上位を取得します。ページのタイトル、メタディスクリプション、その他の利用可能なデータを分析し、ターゲットキーワードと同一ではないが、繰り返し現れるコンセプトや関連するトピックを検出します。そして、これらの関連性を「関連するトピックX、Y、Zをカバーすることを検討する」のような実用的な洞察にまとめなければならない。

この情報は、エージェントの背後にいるLLMが意図した目標を達成するのに十分な詳細さでなければなりません。

フォームが完成したら、右上の “Create “ボタンをクリックする:

Creating the new AI agent

AIエージェントのセットアップには数分かかります。AIエージェントのセットアップには数分かかります。エージェントが作成されると、サブスクリプションに使用されているアドレスにEメール通知が届きます。

AIエージェントの準備が完了すると、左メニューの “エージェント “ページに表示されます:

Note the newly created “Content Association Analyzer Agent” agent

完了です!これでCopilot StudioにAIエージェントが設定されました。

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

エージェント” ページで、エージェントの行をクリックして専用ページにアクセスします:

The AI agent management platform in Copilot Studio

このインターフェイスでは、エージェントの動作をカスタマイズして改良し、実装を完了することができます。このインターフェイスでは、エージェントの動作をカスタマイズして調整し、実装を完了できます。

デフォルトでは、Copilot Studioは、ほとんどのシナリオに最適化されたAIモデルをエージェントに割り当てます。この場合、選択されたモデルはGPT-4oです。AIモデルを変更するには、「エージェントのモデル」行の「…」メニューをクリックし、「編集」オプションを選択します:

Select the “Edit” option

また、右上の “設定 “ボタンをクリックし、カスタマイズページにアクセスします:

Pressing the “Settings” button

設定 “ページでは、エージェントのトーン、応答フォーマット、およびその他の高度な側面を微調整するためのオプションにアクセスできます。

これは単なる例ですので、デフォルト設定のままにしておいてください。本番環境では、AIエージェントの動作や設定をカスタマイズしてください。

ステップ #3: Bright Data アカウントの設定

Copilot StudioでBright DataのSERP API統合のためのAIエージェントのツールを定義する前に、まずBright Dataアカウントを設定し、SERP APIサービスを設定する必要があります。Bright Dataの公式ドキュメントに従うか、以下の手順に従うかを覚えておいてください。

まだ登録していない場合は、Bright Dataにサインアップします。そうでなければ、既存のアカウントにログインしてください。ログインしたら、”プロキシ&スクレイピング “ページの “マイゾーン “セクションに到達し、テーブル内の “SERP API “行を探します:

Note the “serp_api” row in the table

この場合、Bright DataアカウントにはすでにSERP APIゾーンがあります(serp_apiと呼ばれます)。

SERP API の行がない場合は、その製品をまだ設定していないことを意味します。この場合、新しいSERP APIゾーンを手動で作成する必要があります。これを行うには、下にスクロールし、”SERP API “セクションの下にある “Create zone “をクリックします:

Configuring the SERP API zone

SERP APIゾーンを作成し、serp_api(または任意の名前)のような名前を付けます。ゾーン名は、Bright Data統合のためのCopilot Studio AIエージェントツールを定義するときに必要になるので、記録しておきます。

製品ページで、ゾーンを有効にするために「Activate」スイッチを切り替えることを忘れないでください:

Activating the SERP API zone

最後に、公式ガイドに従ってBright Data APIキーを生成します。すぐに必要になるので、安全な場所に保管してください。

これで完璧です!これで、Copilot StudioでBright DataのSERP APIを使用するために必要なものがすべて揃いました。

ステップ #4: SERP APIツールの作成を開始する

Copilot StudioのAIエージェントは、Bright DataのSERP APIにアクセスする必要があります。つまり、SERP APIゾーンを認証し、APIコールを行うことができなければなりません。これを実現するには、カスタムAIエージェントツールを作成して設定する必要があります。

新しいツールを定義するには、まず「ツール」タブに移動します。次に、”ツールを追加 “ボタンをクリックします:

Pressing the “Add a tool” button

モーダルが開きますので、”New Tool “ボタンをクリックします:

Clicking the “New tool” button on the top right corner of the modal

ウィザードの次のステップで、”カスタムコネクタ “カードを選択します:

Selecting the “Custom connector” card

カスタムコネクタは、Bright DataのAPIのような特殊な認証ロジックを必要とするサードパーティサービスとの統合に最適です。AIのためのBright Dataへのアクセスを簡素化したい場合は、”Model Context Protocol “カードを選択し、リモートインスタンス経由でBright DataのWeb MCPを設定することを検討してください。

Custom Connector” カードをクリックすると、Microsoft Power Apps サービスの“Custom connectors” ページにリダイレクトされます:

The custom connectors page

ここで、エージェントがツールとして使用する Bright Data の SERP API への接続を定義します。SERP API ツールの定義プロセスの最初の部分は完了です!

ステップ #5: SERP API 接続の定義

Microsoft Power Apps サービスの “カスタムコネクタ” ページで、”新規カスタムコネクタ” ドロップダウンをクリックし、”空白から作成” を選択します:

Selecting the “Create from blank” option

表示されたモーダルで、コネクタに名前(例:”Bright Data SERP API”)を付けて、”Continue “ボタンをクリックします。

コネクタ エディタ ウィザードに到達します。定義を簡単にするために、Swagger 仕様を使用します。したがって、”Swagger editor “オプションを切り替えます:

Toggling the “Swagger editor” option

Swaggerエディタのテキストエリアに、以下のOpenAPI 2.0定義を貼り付けます:

swagger: '2.0'
info:
  タイトルブライトデータSERP API
  説明:
    Bright Data SERP API は全ての主要な検索エンジンの実際のユーザー結果を大量に提供します。
    提供する。
  バージョン: '1.0
host: api.brightdata.com
basePath:/
スキーム:
  - https
消費する
  - application/json
パス:
  /リクエスト
    post:
      要約: SERP リクエストを送信する
      説明:
        Bright Data SERP API ゾーンを使用して SERP スクレイピングリクエストを送信します。
        Authorization` ヘッダによる API キーが必要です。
      タグが必要です:
        - SERP
      パラメータが必要です:
        - in: 本文
          名前: ボディ
          説明SERP API のリクエストペイロード。
          必須: true
          スキーマ
            タイプ: オブジェクト
            必須
              - ゾーン
              - url
            プロパティ
              ゾーン
                タイプ: 文字列
              url:
                タイプ: 文字列         
              フォーマット
                型: 文字列
                デフォルト: raw
              data_format:
                型: 文字列
                デフォルト: markdown
      レスポンス:
        '200':
          説明成功したレスポンス
        '400':
          説明: 無効なリクエストです:無効なリクエスト
        '401':
          説明Unauthorized - 無効な API キー
        '500':
          説明: 内部サーバーエラー内部サーバーエラー
      operationId: SERP API-call
securityDefinitions:
  api_key:
    タイプ: apiKey
    ヘッダ
    名前: 認証
ヘッダ名は
  - api_key: []です。

YAMLの上記のコードはBright Data SERP APIコネクタを定義するOpenAPI 2.0の仕様です。ここで重要なのは、これら2つの側面です:

  1. ゾーン(SERP APIゾーンの名前を表す)、url(検索エンジンページのURLを表す)、format(APIがどのように出力データを生成するかを定義する)、data_format(ページのHTML、パースされたJSONバージョン、Markdownバージョンなど、APIがどのように応答するかを決定する)パラメータの定義です。
  2. securityDefinitionsの api_keyセクションは、API接続がAuthorizationヘッダに追加されたユーザ提供のキーによって認証されることを指定します(これは、Bright Data APIキーを使用してSERP APIを認証する方法です)。

各パラメータや引数の意味を含む上記の詳細については、公式ドキュメントを参照してください。知っておくべきことは、上記のSwagger設定は、Markdownフォーマット(AIのための取り込みに最適化されたフォーマット)でデータを返すBright Data SERP APIコールを指定するということです。

コネクタ定義ページでは、次のようになります:

Defining the connector via a Swagger specification

Create connector “を押して接続を保存します:

Clicking the “Create connector” button

次に、ウィザードの「5.テスト」ステップに進みます。Test operation “セクションで、”Connections “カードの “Create Connection “ボタンをクリックします:

Pressing the “New connection” button

Bright Data APIキーの入力を求められます。以下の形式で入力してください:

ベアラ <YOUR_BRIGHT_DATA_API_KEY> を入力してください。
Setting the authentication details for the Bright Data SERP API

次に、”Create “ボタンを押してください。

重要: “Bearer “プレフィックスは、Authorizationヘッダーを正しく入力するために必要です。

5.テスト “ページで、”serp-api-call “セクションにゾーン名(例:serp_api)とテスト URL(例:https://www.google.com/search?q=pizza)を入力します。Test Operation “をクリックして、SERP APIの統合をテストします。すべてが期待通りに進んでいれば、200 OKHTTP レスポンスが返ってくるはずです:

Note the 200 response on the test input

200レスポンスは、コネクタが SERP API を正常に呼び出せることを確認します。レスポンスボディには、”pizza” 検索クエリ (「serp-api-call」フォームの “url” フィールドで指定したもの) の Google SERP の Markdown バージョンが表示されます。

すごい!これでBright Data SERP APIコネクタができあがり、Copilot Studio内のAIエージェントのツールとして使用できるようになりました。

ステップ#6: SERP APIツールをAIエージェントに統合する

SERP APIコネクタの準備ができたので、Copilot Studio AIエージェントのダッシュボードに戻ります。ステップ#4で説明したように、「ツールの追加」セクションに移動します。

Connector」ラベルを選択し、”SERP API “を検索して結果をフィルタリングします。先に作成した “Send a SERP request – Bright Data SERP API “コネクタが表示されるはずです:

Select the “Send a SERP request” connector

コネクタカードをクリックし、”Add and configure “を押します:

Pressing the “Add and configure” button

ツールの追加には少し時間がかかる場合がありますので、しばらくお待ちください。準備ができたら、コネクタの設定ページで、以下のように入力を設定します:

  • ゾーンステップ#3で定義した Bright Data SERP API ゾーン名(この例ではserp_api)をカスタム値で指定します。
  • url:クエリする検索エンジンの結果ページの URL (例: https://www.google.com/search?q=)” のような説明を追加します。これは、AIにこのフィールドへの入力方法を指示するために重要である(その後、新鮮な検索結果を取得するためにSERP APIに渡される)。
Configuring the inputs of the AI agent

右上の “Save “を押すと、エージェントの “Send a SERP request “コネクタが有効になります:

Note the enabled connection

これで、エージェントを先ほど定義した “Bright Data SERP API” コネクタに接続しました。この統合を確定するには、”概要 “タブの “設定 “ボタンをクリックし、”接続設定 “ページに到達します。Bright Data SERP API” の行で、”Connect” リンクを押します:

Pressing the “Connect” button

Submit “を押して確認すると、Bright Data SERP APIが接続済みと表示されます:

Note that “Bright Data SERP API” is now connected

これで完了です!これで、SERP APIがCopilot Studio AIエージェントに統合され、ツールとして利用できるようになりました。

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

AIエージェントが正しく動作することを確認するには、以下のような適切なプロンプトでテストする必要があります:

機械学習」という検索クエリを分析し、主要な検索結果に表示される上位の関連トピックと概念を特定してください。トピックのオーソリティを強化するために私がカバーできる関連テーマを提案してください。

これだけで、SERP API ツールが起動し、エージェントが結果を処理して分析し、コンテンツ関連分析タスクを実行することができます。

ダッシュボードの “Test your agent “セクションで起動すると、このような動作が表示されるはずです:

Executing the prompt in Copilot Studio

これがエージェントの動作です:

  1. プロンプトに記述されたタスクを実行するためのプランを定義します。
  2. 機械学習」検索クエリの SERP API リクエストを実行します。
  3. SERPデータをMarkdown形式で受け取り、深い推論を用いて処理する。
  4. コンテンツ最適化のための実用的な推奨事項を返します。

実行が終わると、Copilot StudioのAIエージェントのダッシュボードはこのようになります:

The dashboard after AI agent execution

お分かりのように、左側のパネルは、エージェントが最終的なゴールに到達するまでに行った各ステップを表す視覚的なフローを示しています。

SERP APIリクエストが正常に実行されたことを確認するには、「Send a SERP request」ノードをクリックします。リクエストが正しく実行され、API が “machine learning” の Google SERP の Markdown バージョンを返したことがわかります:

Note the Markdown version of the “machine learning” Google SERP

具体的には、以下がエージェントによって生成された最終結果である:

The content association analysis report produced by the report

この出力には、SEO最適化のための貴重なコンテンツインサイトが含まれています。これらの洞察を得ることは、Bright DataのSERP APIを通して取得された検索データなしでは不可能である。

Googleの検索結果をスクレイピングしようとしたことがあれば、JavaScriptのレンダリング(SEOデータの危機につながったこともある)や高度なボット対策により、それがいかに困難であるかをご存知でしょう。スクレイピングに成功しても、AIに取り込ませるためにコンテンツをクリーンにして最適化する必要がある。Bright DataのSERP APIは、無限のスケーラビリティを提供しながら、これらすべてを自動的に処理する。

エージェントによるRAGワークフロー、ファクトチェック、ニュースの要約、または新鮮なウェブ検索データを必要とするユースケースなど、他のシナリオを探求するためにエージェントの説明やプロンプトを変えて試してみてください。

出来上がりです!Microsoft Copilot StudioでBright DataのSERP APIをAIエージェントに統合する方法がわかりました。

まとめ

このブログ記事では、コンテンツ関連分析ワークフローにBright DataのSERP APIを使用する方法をご覧いただきました。

そのおかげで、GoogleからSERPデータをフェッチし、それを分析して入力キーワードに関連する意味的に正確なトピックを発見できるAIのためのエージェントをCopilot Studioで構築できました。これは、SEO最適化やその他多くのユースケースで非常に役立ちます!

さらにリッチで複雑なAIのエージェントやワークフローを構築するには、Bright DataのAIのためのインフラストラクチャが提供するあらゆるサービスをご利用ください。

ブライトデータのアカウントを無料で作成し、AIのためのウェブデータソリューションにアクセスしてください!