# AI SEARCH マニュアル > 検索結果ページに AI の回答を表示する AI SEARCH の、導入から運用までのマニュアルです。 - 読者は、導入を決める方、タグを設置するエンジニア・制作会社、運用する方、情報システム・セキュリティの担当の方です。 - 管理画面の操作は、別の[管理画面マニュアル](https://docs.geniee-search.net/popadmin/)で扱います。 - 用語: サービスを導入した顧客は「ユーザー」と呼びます。 ## このマニュアル - [Home](): 担当者別の案内、目的から探す。参照ページへのリンクの表 ## はじめに - [AI SEARCH の機能](): 表示される場所と内容、回答ができるまでの 3 段階、管理画面とタグで調整可能な項目、GENIEE に依頼が必要な項目、組み合わせる検索サービス(GENIEE SEARCH、probo、ページを読み込み直すその他の検索) - [導入の流れと担当](): 契約から本番公開までの 8 つの作業の順番と、それぞれをユーザー・制作会社・GENIEE のどれが担当するか、設定タグとタグマネージャーの役割 - [仕様と制限](): 上限値(月のリクエスト数、プロンプトの数と公開数、プロンプトの文字数)、設定が反映されるタイミング、設定上の制限と回避方法 - [セキュリティと送信する情報](): 送信する情報(タグを読み込んだときと検索したときに送る値)、学習への利用(検索キーワード、オプトアウトの相談先)、通信先のドメイン(ais-app.geniee-search.net、ais.g-cdn.net) ## 設置する - [設置前の準備](): GENIEE から受け取る値(uid、promptId)とタグマネージャー(起動タグ)、検索結果ページの条件、サイトで決めておくこと、CSP を設定しているサイトで許可するドメイン - [タグの設置](): 設定タグとタグマネージャー(起動タグ)、必須の 4 項目(uid、promptId、insertSelector、inputSelector)だけのタグ、タグを設置した後に確かめること、書き間違えたときに出るメッセージ(Unknown parameter、Invalid value for)、メッセージが出ずに表示されないとき - [表示の確認](): 公開前のチェックリスト(検索キーワードがないとき、回答を作っている間、回答、参照リンク、コンソールのメッセージ)、表示の状態を class 名で確かめる方法、うまくいかないとき - [デザインの選択](): 3 つのテーマ(default、theme1、theme2)の違い、theme の書き方とテーマ名を書き間違えたときに出る TypeError、theme2 で長い回答を折りたたむ extraThemeConf(contentMaxHeight、showMoreButtonText、showLessButtonText)、extraThemeConf を書き間違えたときに出るメッセージ - [固定メッセージの変更](): 変えられる固定メッセージ(headerText、footerText、noInputBodyText、loadingBodyText、exceptionBodyText、serviceUnavailableBodyText)、固定メッセージに書ける HTML、サービスを利用できないときに固定メッセージを出す showServiceUnavailable、回答を少しずつ表示する useStream と streamRate - [サイトの CSS による調整](): テーマの CSS より優先させる書き方、よく使う class 名(gn-ais、gn-ais-header、gn-ais-body、gn-ais-footer など)、見出しのラベル・背景・リンクの色や文字の大きさを変える設定例 - [検索キーワードの URL パラメータが q 以外の場合](): 検索キーワードの URL パラメータの名前を指定する queryParamName(初期値 q)、URL の # の後ろにキーワードがある場合に読む形と読まない形、書き間違えたときに出るメッセージ(Invalid value for queryParamName)、URL のパスや POST の検索でキーワードを読めないこと - [回答表示後の処理の実行](): 回答の表示後に関数を動かす completedHook、呼ばれるときと呼ばれないとき、関数が受け取る値(searchResult.references の url)、関数の中のエラーで exceptionBodyText が表示されること、Google タグマネージャーにイベントを送る設定例、関数の中で検索キーワードを取る例 ## 運用する - [回答の内容の変更](): ユースケース、システムプロンプト、ユーザープロンプト、公開プロンプトの説明、置き換えられる文字列(##Query##、##Today##)、回答が変わるタイミング、作成から公開までの手順、公開中のプロンプトやプロンプトの数の上限などの設定上の制限と回避方法 - [回答に使用するページの除外](): 除外URL設定での指定の仕方(match_type の exact と wildcard)、CSV ファイルの列(match_type、url、remarks)と形式、インデクシング(自動・手動)の後に反映されること、アップロードが上書きになること、外す手順、外したページを戻す方法、更新履歴での確かめ方、除外 URL が 1000 件を超えたときに画面に出る案内と CSV ファイルでの編集 - [利用量を確認する](): AI SEARCH サービスの画面の今月のリクエスト数・過去3ヶ月間のリクエスト数・今月のリクエスト上限、上限の表示 1500 (+500) の読み方、1 回の検索で 1 リクエストという数え方、今月の残りの計算、上限に達したときの表示と毎月 1 日のリセットと上限の追加、ステータス履歴での過去の月別の推移の見方 ## 困ったとき - [表示されない場合・表示に異常がある場合](): 症状から節を選ぶ図、症状ごとに確かめる順番と直し方(表示領域が出ずコンソールにメッセージが出る、メッセージも出ない、回答を作っている間に表示領域が消える、キーワードがないときの固定メッセージのまま、エラーの固定メッセージが出る、回答が出るまでに時間がかかる、固定メッセージや見た目が設定と違う) - [よくある質問](): よくある質問(AI の回答の正確さ、回答を変える・確かめる・ページを外す、サイトやプロンプトの更新が反映されるタイミング、注意書きのリンク、デザイン、q 以外の URL パラメータ、ページを開き直さないサイト、CSP、上限に達したとき、今月の残り、学習への利用、Cookie) - [お問合せの前に](): お問合せの前に読むページと、問い合わせに書く情報のテンプレート(会社名、サイト名、URL、日時、症状、コンソールのメッセージ、試したこと、社外のネットワークでの症状、ブラウザと OS、検索したキーワードと表示領域が写ったスクリーンショット) ## リファレンス - [パラメータ一覧](): 設定タグに書ける項目の一覧(名前、必須、型、初期値、説明)、項目ごとの書ける値(uid、promptId、insertSelector、inputSelector、queryParamName、theme、extraThemeConf、固定メッセージの項目、showServiceUnavailable、useStream、streamRate、completedHook)、書き間違えたときにコンソールに出るメッセージ - [表示領域の HTML と class 名](): 表示領域の HTML の形、表示の状態ごとの class 名(gn-ais-no-input、gn-ais-loading、gn-ais-rendering、gn-ais-completed、gn-ais-exception、gn-ais-service-unavailable)、class 名の一覧、テーマごとの HTML の違い、回答と参照リンクの HTML ## リリースノート - [リリースノート](): 日付ごとのマニュアルの変更。最初の項目はマニュアルの公開