# 初めて使用する（On-boardingガイド）

ここではAlliでAIチャットボットを構築し、公開するまでの手順と実施方法をお伝えします。

## 構築の手順 <a href="#how-to-build" id="how-to-build"></a>

1. **アカウントの作成 / ログイン**
2. **Q\&Aデータを作成、アップロードする**
3. **キャンペーンを作成する**
4. **SDKを実装する**

それぞれの手順について、以下より説明します。

## アカウントの作成 ／ ログイン <a href="#sign-up-sign-in" id="sign-up-sign-in"></a>

1. Alliアカウント情報を使って[**ログイン**](https://www.alli.ai/signin)します。\
   アカウントを追加する場合は、プロジェクト設定＞エージェント管理でアカウントへ招待をします。詳細は[**こちら**](https://docs.allganize.ai/alli-userguide/settings/agent-settings)からご確認ください。
2. 初回ログイン時に限り、単純なtutorialが実行されます。\
   ２回目以降はダッシュボードのキャンペーン一覧ページが開きます。

## Q\&Aデータを作成、アップロードする <a href="#upload-qa" id="upload-qa"></a>

### **＜Q\&Aを作成する＞**

Q\&Aを作成する上でのポイントなどは以下の資料にまとめています。作成を開始する前に一度ご確認ください。\
[**Q＆Aデータ作成のポイント**](https://drive.google.com/file/d/1RB62JGMDyQcIu6oPgLK8t1wVXjHOOIRM/view)**(Googleドライブにアクセスいただけないお客様は**[**こちら**](https://go.allganize.ai/l/1049071/2024-10-22/mcdv/1049071/1729593126lz7dz0QF/Alli_Q_A____________________________________.pdf)**)**

### **＜Q\&Aを登録・アップロードする＞**

左のメニューバーから、\[ナレッジベース]メニューを選択し、画面右上の\[Q\&A追加]をクリックしてください。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/image-14.png?resize=800%2C359&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

Q\&Aは、「1.Q\&Aアップロード」または「2.Q\&A直接入力」の2通りの方法で登録が可能です。詳細は以下を参照してください。

**1.Q\&Aアップロード**\
（1）\[Q\&A追加]メニューから\[Q\&Aアップロード]を選択してください。\
（2）作成したQ\&Aファイルを指定し、\[アップロード]ボタンをクリックしてください。　\
　※ サポートしているファイルタイプ：csv、tsv、xlsx、zip\
　※ ダウンロードサンプル（フォーマット）の活用をおすすめします。

<figure><img src="https://i0.wp.com/blog-ja.allganize.ai/content/images/2021/03/-----3.png?w=800&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

**2.Q\&A直接入力**\
&#x20;（1）\[Q\&A追加]メニューから\[Q\&A直接入力]を選択してください。\
&#x20;（2）入力画面を参考に、必要項目を入力してください。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/11/image.png?resize=364%2C486&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

上記で、Q\&Aの作成は完了です。作成後はすぐにチャット画面などでの検索結果へ反映されます。(ステータスがONになっている場合)

**※オプション：画像の挿入や文字の装飾**\
Q\&Aに画像やファイルの添付、文字に対して色を変更したりサイズを変更することが可能です。詳細は以下を確認してください。\
・[**画像を含むQ\&Aのアップロード**](https://docs.allganize.ai/alli-userguide/knowledge-base/faq/uploading-qa)\
・[**リンクやテキストスタイルを含むQ\&Aのアップロード**](https://docs.allganize.ai/alli-userguide/knowledge-base/faq/uploading-qa)

**※オプション：辞書登録**\
1つの単語に対して複数の言い回しや入力が考えられる場合は、辞書登録機能を利用することができます。辞書機能については、以下のガイドを確認ください。\
[**類語・対義語登録**](https://docs.allganize.ai/alli-userguide/knowledge-base/synonym-antonym-dictionary)

### **＜ドキュメント検索を利用する場合＞**

Q\&A検索の他に、ドキュメント検索を利用する場合は、以下のガイドを参考にドキュメントをアップロードください。\
[**ドキュメント検索**](https://guide.allganize.ai/alli/documents/?lang=ja)

## キャンペーンを作成する <a href="#create-a-campaign" id="create-a-campaign"></a>

キャンペーンでは、主にチャットフローを作成します。\
1\. **キャンペーン（スキル）の作成**\
&#x20;   キャンペーンを作成するには、\[**+**]ボタンをクリックします。\
&#x20;   プロジェクトのドメインに基づいて、テンプレート選択画面が表示されることがあります。ここでは        「テンプレートなし」を選択します。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/Onboarding-1.png?resize=800%2C465&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

**2.キャンペーン（スキル）の生成・タイトル名の変更**\
&#x20;   生成されたキャンペーンが左キャンペーンリストに「New Skill」という名前で\
&#x20;   表示されます。上部のタイトル名をクリックして名前を変更することができます。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/Onboarding-2.png?resize=800%2C464&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

**3. \[プレイスメント]の設定（オプション）**\
&#x20;   プレイスメントを設定することで、Webサイトやアプリの特定の場所でチャットウインドウを\
　起動することができるようになります。\
&#x20;   プレイスメントを指定しない場合、キャンペーン（スキル）はSDKを実装したすべてのサイトや\
　アプリ上で起動します。\
　設定方法は、[こちらのユーザーガイド](https://docs.allganize.ai/alli-userguide/skills/skill-dashboard)の「6. プレイスメント」よりご確認ください。

**4.チャットフローの編集**\
&#x20;   \[チャット編集]タブをクリックし、このキャンペーン（スキル）のチャットフ\
&#x20;   ローを作成します。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/Onboarding-6-.png?resize=670%2C319&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

キャンペーン（スキル）のチャット編集については、以下を参照ください。

### **＜チャットフローの編集＞**

1.チャットフローはメッセージで始まることが基本となります。\
&#x20;   上部のノードバーで「**会話・質問応答**」アイコンをクリックして会話・質問応答ノードを作成します。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/Onboarding-7.png?resize=800%2C182&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

2.会話・質問応答ノードが編集モードでチャットフローに表示されます。\
&#x20;   ユーザーに表示するメッセージとして、たとえば「どのようなご用でしょうか？」のような\
&#x20;   メッセージを入力します。メッセージ入力枠の上部にある各アイコンを利用して、\
&#x20;   書式の変更や画像・リンク等の挿入が可能です。\
&#x20;   完了したら、\[適用]をクリックします。\
&#x20;   チャットフローの開始となるメッセージで作成する内容は工夫が必要です。**何について答えられる**\
&#x20;   **チャットボットで、どのように使ってほしいか、などを記載することを推奨します**。\
&#x20;   メッセージの作成のポイントを以下の資料にまとめております。\
&#x20;   [**チャットメッセージ作成のポイント**](https://drive.google.com/file/d/11QdjUMYiIpcUsGA3gTfSVZiN4_1Ps7sv/view) **(Googleドライブにアクセスできないお客様は**[**こちら**](https://go.allganize.ai/l/1049071/2024-10-22/mcf2/1049071/17295931820Q4IcAPk/______________________________________________________.pdf)**)**<br>

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/Onboarding-8-.png?resize=653%2C348&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

3.次に、Startから会話応答ノード（メッセージを送信するノード）にドラッグし、接続します。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/Onboarding-9-.png?resize=446%2C327&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

4.会話・質問応答ノードでは、テキストメッセージや画像（イメージ）\
&#x20;   メッセージをユーザーに送ることができます。いずれの場合も「応答追加」を選択すると、\
&#x20;   ボタンオプションで回答を選択したり、テキストを入力することができます。

5.例として、「新規ファンドのご案内を受けますか？」という質問にボタン\
&#x20;   オプションで「はい」または「いいえ」で回答選択するチャットフローを作成します。\
&#x20;   さらに、回答に応じて、それぞれ別のノードにチャットフローを遷移させることができます。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/Onboarding-9-1-1.png?resize=653%2C477&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

6.他にも様々な機能を持ったノードをチャットフローで使用することができます。詳細については、\
&#x20;   以下のユーザガイド一覧の「スキル」のセクションを参照してください。\
&#x20;   [**Alliユーザガイド一覧**](https://docs.allganize.ai/alli-userguide/)

7\. 編集は自動保存されます。\[プレビュー]をクリックして編集したチャットフローをテストします。\
&#x20;   キャンペーン（スキル）ダッシュボードに戻る場合は戻るボタン\[＜]をクリックします。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/Onboarding-10.png?resize=800%2C67&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

### **＜チャットフロー作成のヒント＞**

どのようなチャットフローを作成すべきかについては、テンプレートを利用するか、\
以下の資料を参考ください。\
[**チャットフロー作成のポイント**](https://drive.google.com/file/d/1OBF4HZLLigta5BYv3TxHhJybrFsmnyC9/view) **(Googleドライブにアクセスできないお客様は**[**こちら**](https://go.allganize.ai/l/1049071/2024-10-22/mcdy/1049071/1729593158ZFKjilEl/_____________________________________________.pdf)**)**

## SDKの実装 <a href="#sdk-integration" id="sdk-integration"></a>

1.ウェブサイトやアプリにAlliを表示するには、SDKを実装する必要があります。\
&#x20;  下記のガイドを参考に実装ください。\
　**1.**　[**Web用のJavaScript SDK**](https://docs.allganize.ai/alli-userguide/settings/javascript-sdk-integration)\
　**2.**　[**iOS SDK**](https://docs.allganize.ai/alli-userguide/settings/ios-sdk-integration)\
　**3.**　[**Android SDK**](https://docs.allganize.ai/alli-userguide/settings/android-sdk-integration)

2.SDKの実装後、ダッシュボードに戻り、キャンペーンをオンにします。\
&#x20;   指定されたプレイスメント条件に合ったウェブサイトにアクセスすると、\
&#x20;   チャットウィンドウが表示されます。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/Onboarding-11-1.png?resize=800%2C211&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

以上、基本的な操作に関しての説明となります。\
なお、Alliには上記以外にも有用な機能が複数実装されています。\
他のユーザーガイドは[**こちらから**](https://docs.allganize.ai/alli-userguide/)ご参照してください。\
\
Alliご利用について、不明点がありましたら、お気軽に担当までご連絡ください。