<div></div>
Google検索とDiscourse AI
Discourse AIプラグインでGoogle検索ボットを設定するには、Googleカスタム検索エンジンとカスタム検索APIキーを設定する必要があります。使用するAIモデルは、Google検索結果を返すためにこの検索ツールを使用する必要があります。DiscourseプラグインのAIサービスを設定する場合、例えばOpenAI API GPTやAnthropic Claudeを使用しており、Google検索を実行するヘルパーボットを使用したい場合は、Googleを検索するためのプログラマブル検索エンジンと、検索エンジンにアクセスして結果を返すためのリサーチャーボットのAPIキーを設定する必要があります。
はじめに：Google Cloud、プログラマブル検索エンジン、カスタム検索API
プログラマブル検索エンジン（またはカスタム検索エンジン）は、誰でも自分のウェブサイトに設定できる無料の検索エンジンサービスで、検索エンジンID（CX番号）で識別されます。カスタム検索APIキーは、検索エンジンへのAPIリクエストを行うために使用され、APIキーはGoogle Cloudコンソールで管理されます。したがって、Google Cloudアカウントを設定する必要があります。アカウント登録にはクレジットカードが必要ですが、カスタム検索APIは、有料になる前に1日あたり100回の検索クエリを無料で提供します（追加のリクエストは1,000クエリあたり5ドル、1日あたり最大10,000クエリですが、さらに多くの使用量を購入する必要があります）。請求の管理方法を参照してください。
また、キーはGoogle Cloudプロジェクトの下で設定することをお勧めします。できれば、検索キー専用の新しいプロジェクト（追跡を容易にするため）を作成してください。Google Cloudには、プロジェクト数と請求先アカウントに関連付けられたプロジェクト数にクォータがあることに注意してください。プロジェクトは、APIキーが作成された後に請求先アカウントに追加できます。
チェックリスト
- Google Cloudアカウントを設定する
- カスタム検索APIキー用のプロジェクトを作成する
- プロジェクトを請求先アカウントに接続する
- APIキーを作成する
- カスタム検索用にAPIキーを設定する
- Googleプログラマブル検索エンジンを設定する
- カスタム検索APIキーとカスタム検索IDをDiscourse AI設定に保存する
ステップ1：Google Cloudでプロジェクトを設定する
カスタム検索エンジンとAPIキーを設定する前に、Google Cloudでプロジェクトを設定します。
あなた（またはあなたの組織）のGoogle Cloud管理画面（APIの認証情報）にアクセスし、親組織にいることを確認してください（Google Cloudロゴの隣のフィールドで確認できます）。
使用したいプロジェクトがない場合は、検索エンジンのプロジェクトを作成する必要があります。新しいプロジェクトを選択または作成するためのリンクは、ページの上部近くにあります。
新しいプロジェクト作成ページを完了します（適切なドロップダウンフィールドで組織が選択されていることを確認してください）。
プロジェクトの請求を管理するために、Google Cloud請求先アカウントでプロジェクトの請求先アカウントを設定する必要があります。これは、組織の請求が設定されていることを前提としています。あなた（または請求先アカウントマネージャー）は、キーが作成された後にこれを行うことができます。組織のGoogle Cloudアカウントによっては、プロジェクトと請求プロジェクトにクォータがあることに注意してください。
プロジェクトで請求を有効にするには、Google Cloudナビゲーションメニューの請求タブに移動して請求先アカウントをリンクするか、請求プロジェクトページからプロジェクトの請求を有効にします。
ステップ2：APIキーを作成する
Google CloudコンソールからAPIキーを作成するには、Google Cloudコンソールの[APIとサービス]タブに移動し、新しいプロジェクトの認証情報設定にアクセスします。（「同意画面の設定」メッセージは無視してください）。ページ上部の「+認証情報を作成」リンクをクリックし、ドロップダウンオプションから「APIキー」を選択します。
新しいAPIキーが作成されます。コピーして、パスワード管理アプリケーションなどの安全な場所に保管してください。キーを共有しないでください。
これは、Discourse AI設定のai_google_custom_search_api_keyに入力する必要があるGoogleカスタム検索APIキーです。
これで、新しいキーがAPIキーリストに表示されます。一番右のアクション列にある3つのドットをクリックし、「APIキーを編集」を選択します。
APIキー認証情報の設定ページが表示されます。ここで、APIキーの名前をより適切なものに変更できます。（APIキーを表示/コピーしたり、必要に応じて再生成したりすることもできます）。次に、下部にある「APIの制限」セクションに移動し、「キーを制限」を選択して「カスタム検索API」を選択します。OKをクリックしてからAPIキーを保存します。
制限がリストに表示されない場合は、APIライブラリでAPIサービスを有効にする必要があるかもしれません。「Google Custom Search API」を検索して選択します。ここで、カスタム検索APIの詳細（価格やその他のドキュメントへのリンクを含む）が表示されます。APIを有効にするリンクをクリックします。
新しいAPIキーは、新しい名前とカスタム検索API JSONリクエストに制限されていることを示す緑色のチェックマークとともにリストに表示されます。
ステップ3：プログラマブル検索エンジンを作成する
APIキーが使用する検索エンジンを作成するには、Google Programmable Search Engineページにアクセスし、「開始する」をクリックします（まだログインしていない場合）。ログインまたはアカウントを作成します。ログインしたら、検索エンジンコンソールページにアクセスします。既存のすべてのプログラマブル検索エンジンがここにリストされます。
「追加」ボタン（または「最初の検索エンジンを作成！」リンク）をクリックして、新しい検索エンジンページを開きます。適切な名前を付け、該当するフィールドに入力します。
「作成」ボタンをクリックすると、新しい検索エンジンが作成されます。ページには、検索ボックスをウェブインターフェイスのどこかで使用したい場合にコピーできる検索スクリプトのオプションが表示されますが、APIキー認証情報へのアクセスに使用するだけなので、ここでは必要ありません。
カスタマイズボタンを選択して、検索エンジンの概要ページに移動します。ここで、Discourse AI Google検索設定で必要となる検索エンジンID（CX番号）と、設定可能なその他のオプションを確認できます。（下部までスクロールすると、APIキーを作成するためのリンクがありますが、ステップ2で作成したので、ここでは必要ありません。）
ステップ4：Discourse AIプラグインでGoogleカスタム検索を設定する
検索エンジンID番号をコピーし、ステップ2で作成したAPIキーと一緒に保存します。管理 - サイト設定に移動し、すべてのサイト設定フィルターに「Googleカスタム検索」と入力して、必要な2つの設定を表示します。APIキーをai_google_custom_search_api_keyに、検索エンジンID（CX番号）をDiscourseインスタンスのai_google_custom_search_cxに貼り付け、新しい設定を保存します。必要に応じて他のAI設定を構成します。
ステップ5：API検索キーの追跡
Google CloudコンソールAPIとサービスの詳細でカスタム検索APIキーのアクティビティを確認したり、クォータとシステム制限タブでクォータを設定したりできます。コストレポートはコストタブで表示できます。
Discourse AI検索の例
OpenAI GPT-4 TurboがGoogleカスタム検索を使用してその機能と設定方法を説明する例を以下に示します。
Anthropic Claude OpusがGoogleカスタム検索を使用して"リバースケンタウロス"の意味を説明する例を以下に示します。
関連リンク
- Discourse AI
- Google Developer Custom Search Engine Documentation
- Google Custom Search API
- Google Cloud Billing
- Google Programmable Search Engine
