# インスタンス作成

## インスタンスを作成

{% columns %}
{% column %}

<figure><img src="/files/wF0xNxlm13ZnJicyFaKu" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/4f6DtzjLARzDo9zC1BSZ" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### インスタンス作成と管理

genser を開始するために検索設定を含む「インスタンス」を作成します。1つのインスタンスがキーワード検索と自然言語検索の両方を統合して管理します。

1. **インスタンス作成：** \[新しいインスタンスを作成] ボタンをクリックします。（タイプ選択のステップはありません）
2. **デフォルト設定：** インスタンス名を入力し、基本検索オプションを設定します。
3. **統合設定：** キーワード検索設定と AI 応答のトーン＆マナー設定を1画面で統合管理します。
4. **インスタンス一覧：** 作成されたインスタンスはタイプの区別なく一覧に表示され、状態（準備中／完了）を確認できます。

### 検索設定

#### 検索結果 <a href="#tab01" id="tab01"></a>

<figure><img src="/files/WeQKGNqzAcQ02fnilDKa" alt=""><figcaption></figcaption></figure>

**呼び出しデータ単位**

データ呼び出し単位は検索された商品データをサーバーから分割して取得する基準数量で、実際に画面に表示される結果の件数とは異なります。

{% hint style="info" %}
**データ呼び出し単位を 50 に設定した場合**

* 検索時、サーバーは1回のリクエストにつき最大50件の item データを返します
* 画面ではその中の一部のみを表示したり、追加リクエストで続けてデータを表示することが可能です
  {% endhint %}

<figure><img src="/files/J9O9VwnszDoYbHAdhdOX" alt=""><figcaption></figcaption></figure>

**検索結果の説明**

ユーザーが入力した検索語に対して、なぜその結果が出たのかを示す機能です。この機能を有効にすると、ユーザーは単に商品が並んでいるだけで「なぜこれが出たのか？」と疑問に思うことがありますが、説明があれば結果の文脈を理解し信頼できます。

**トーン＆スタイル**

顧客に提供する検索応答の口調、雰囲気、専門性を制御する設定です。これにより顧客体験に合った自然な検索結果を提供できます。

**関連キーワード**

顧客が入力した検索語に関連する別の検索語を併せて表示する機能です。検索結果とともに表示され、顧客がより多くの商品を簡単に探索できるように支援します。

{% hint style="info" %}
検索語が `クリーム`の場合 → 「肌バリア強化クリーム」、「保湿鎮静クリーム」、「ヴィーガンクリーム」などの関連キーワードが一緒に表示されます。
{% endhint %}

**提案質問**

ユーザーの質問の文脈を分析し、顧客が追加で検索すると良いと思われる質問を AI が逆に提案する機能です。単にキーワードを列挙するのではなく、顧客が「次に何を疑問に思うか」を予測した質問文を提供することで自然な検索体験を助けます。

* 最大提案質問数：AI が生成する質問の「最大数」を設定します。（最大8件、推奨3〜5件）ただし、必ず設定した数だけ生成されるわけではありません。AI が自動的に最適化して検索文脈に適した質問がない場合は、設定数より少なく生成されるか生成されないことがあります。
* 質問タイプ選択：当サイトの特性に合わせて、AI がどの戦略で質問を生成するかを選択できます。各タイプは以下の優先順位に従って生成されます。
  * 購入意図の確認：「引越し祝い用」「ギフト用」「キャンプ用」など、顧客が検索した質問の背後にある顧客の「本当の意図」を予測します。具体的な状況や重要なキーワードを AI が先に提案することで、顧客が自然に追加の探索を続けるよう誘導します。
  * ブランド絞り込み：検索結果内に主要ブランドがある場合、「ナイキ製品で表示して」など特定ブランドによる商品結果のフィルタリングを促します。
  * 属性絞り込み：「10万円以下の価格帯で表示して」「青色だけ集めて見せて」など商品の詳細スペック（価格、色、サイズ等）で絞り込みます。
  * レビュー／ランキングベースの推薦：「評価が高い登山靴を見せて」「最も売れているキャンプ用品を見せて」など、顧客の嗜好と信頼性データに基づいて提案します。

{% hint style="info" %}
**ご注意！**

露出ロジックと優先順位の提案質問はシステムのバックエンドで把握された **実際の検索結果の豊富さ**に応じて3段階（最小型、標準型、拡張型）に分かれて異なる動作をします。検索結果が少ない場合は最も重要な質問タイプから、結果が多い場合は多様な質問タイプを表示します。
{% endhint %}

{% hint style="warning" %}
**設定時の注意事項**

質問タイプの優先順位が最も高い **「購入意図の確認」をオフにした場合、** 検索結果が少ない（最小型）商品検索時には **「提案質問」機能をオンにしていても提案質問が表示されないことがあります。**
{% endhint %}

**全体の検索結果数**

顧客が入力した検索語で検索したとき、条件に合う商品（または item）が合計でいくつ検索されたかを示す数字です。

#### 制限語 <a href="#tab02" id="tab02"></a>

<figure><img src="/files/jW4VTrMl8HA8NbFJUKr6" alt=""><figcaption></figcaption></figure>

**制限語**

検索時に特定の単語や条件を制限して結果に含めないように設定する機能です。例えば「中古」を制限語として登録すると検索結果から中古商品が自動的に除外されます。

#### オートコンプリート <a href="#autocomplete" id="autocomplete"></a>

<figure><img src="/files/fdiBrKOaFX9QZ8NFDUlj" alt=""><figcaption></figcaption></figure>

**オートコンプリート**

オートコンプリートはユーザーが検索語を入力した瞬間に、予想される検索語と推奨結果をリアルタイムで表示する機能です。

**オートコンプリート禁止語**

オートコンプリート禁止語は特定の単語がオートコンプリート提案に表示されないようにブロックする機能です。\
センシティブまたは不要なキーワードを登録して、顧客が入力したときにオートコンプリート提案欄に表示されないよう設定できます。

{% hint style="info" %}
例

* **ブランド／競合企業名の制御**\
  例：競合ブランド名をオートコンプリートの推奨から除外
* **内部管理用コード／商品名の除外**\
  例：運営者のみが知っている `SKU-1234` のような管理用商品名が顧客に見えないように設定
* **在庫切れ／生産終了商品を除外**\
  既に販売が終了した商品名が推奨として表示されないように管理
  {% endhint %}

#### ファセット（Facet） <a href="#tab03" id="tab03"></a>

<figure><img src="/files/bYCcT7hozF3ORUvanlsV" alt=""><figcaption></figcaption></figure>

**ファセット（Facet）**

**ファセット**は、顧客が検索した結果をさまざまな基準（カテゴリ、ブランド、価格、色など）で細分化してフィルタリングできるようにする機能です。簡単に言えば、検索後に表示された多くの商品から顧客が望む条件に合わせて結果を絞り込んでいける機能です。

#### 高度な設定 <a href="#tab04" id="tab04"></a>

<figure><img src="/files/cs1C3zA1vJ48MGXLO2Um" alt=""><figcaption></figcaption></figure>

高度な設定は基本の検索結果設定に加えて、検索品質の条件を適用できる領域です。運営者はここで検索結果の露出方式、並び順の制御、推薦ロジックなどを直接コントロールできます。

**画像ベースの後続検索**

{% hint style="warning" %}
画像ベースの後続検索は標準で提供されておらず、利用を希望される場合は別途お問い合わせが必要です。
{% endhint %}

ユーザーが選択した商品画像を基に類似商品を再検索する機能です。テキストで説明しにくい場合でも、画像検索を通じて直感的に欲しい結果を見つけられます。

**検索結果の順序制御**

検索結果の表示順を調整できる機能です。運営者が特定の商品情報を優先的に見せたり、ユーザー体験に合わせて並び替え基準を設定できます。

#### ご確認ください！ 🔍

検索語を入力して結果が表示されるまでの間は **検索が行われているかどうかをユーザーが認識しづらいです。** このとき何も画面やメッセージがなければサービスが停止したと誤解され、不要にリフレッシュを試みたり検索を諦める可能性があります。

したがって <mark style="background-color:orange;">**検索中であることを明確に示す専用ページ（読み込み状態ページ）**</mark>が必要です。このページには進行中であることを視覚的に示すスピナー、スケルトンUI、または「検索結果を準備しています」のような案内文を含めることで、ユーザーが検索結果ページが出るまで待てるようにします。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.genser.ai/ja/ai-search/genser-instance/create.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
