AI アシスタントを作成する

ガイドライン

• アシスタント全体で同じ言語を使用します。例: トレーニング ドキュメントとプロンプト。

• アシスタント全体で一貫性を持たせます。例: ブランド名、目的、ドキュメントの内容、プロンプト。そうしないと、アシスタントが正しい応答を提供しない可能性があります。

  例: Answers 製品のドキュメントをアップロードし、プロンプト You should be a helpful チャットボット for the Conversations product を書くと、アシスタントはAnswers用とConversations用と言うことがあります。

アシスタントを作成する

1. Infobip Web インターフェイス (opens in a new tab) で、AI ハブ > AI アシスタント に移動します。

2. アシスタントの作成 を選択します。

   

3. アシスタントを一意に識別できるように名前を付けます。この名前はエンド ユーザーと共有されません。

4. 設定を設定します。

5. トレーニングドキュメントを追加します。

6. **Save (保存)**を選択します。

設定を構成する

アシスタントを設定するには、アシスタントの設定セクションで次の操作を行います。

1. 次のいずれかの方法でアシスタントを設定します。

   • 基本設定: このオプションは簡単に設定できます。ただし、設定は固定されており、すべてのエンド ユーザー操作に使用されます。カスタマイズは限られており、適応性もありません。このオプションは、アシスタントのテストに使用します。
   • プロンプトの書き込み(推奨): このオプションを使用すると、アシスタントの応答をガイドできます。カスタマイズ性と適応性が向上します。このオプションを使用すると、より良い結果が得られ、精度が向上します。

2. (オプション)AIの詳細設定を設定します。

プロンプトの書き込み (推奨)

AI アシスタントがエンド ユーザーの質問に対するカスタマイズされた応答を生成するために使用する指示を指定します。

設定方法

設定方法 フィールドで、プロンプトの書き込み を選択します。

プロンプト テンプレート

このパラメータは、基本設定に存在する名前、ブランド、および目的に代わるものです。

プロンプトテンプレートに次の情報を含めます。

• 次の必須変数は変更されません。

  • {context_str}: アップロードするドキュメントの関連情報。
  • {query_str}: 最後のユーザーの質問。

• 次の変数は省略可能です

  • {prompt_var}: 実行時に設定できる変数で、プロンプトにコンテキストを追加します。
  備考

  テキスト {context_str}、{query_str}、および {prompt_var} は英語である必要があります。

• (オプション)また、アシスタントのペルソナに関する指示を含めて、エンド ユーザーの質問に応答する方法をアシスタントに伝えることもできます。例: フォーマル、親しみやすい、面白い、絵文字を含める。

単純なプロンプト テンプレートの例

This is your context:{context_str}, answer the question:{query_str} using context.

詳細なプロンプトテンプレートの例

- You are a helpful chatbot for Infobip's products and services.  
- Your name is Omnia.  
- This is your context:{context_str}.  
- Answer the question:{query_str} using context in a friendly style.  
- Include appropriate emojis in your response.  
- Address the user as {prompt_var}.

初期化設定(オプション)

応答を生成するための指示またはガイダンスを AI アシスタントに提供します。これらの指示は、会話中の AI モデルの動作、コンテキスト、および期待を決定します。

システム メッセージ: AI アシスタントが応答を生成するために従う必要のあるコンテキスト、指示、例、ガイダンスを提供します。この機能を使用して、エラー処理と適切な例を定義します。このフィールドの指示は、会話中のアシスタントの動作を定義します。アシスタントのパーソナリティを設定したり、アシスタントに従わせる指示を出したりできます。

例：

- You are a chatbot. Your name is Omnia.
- Omnia, you represent Infobip. You should be a helpful chatbot for Infobip's products and services.
- You should have a friendly conversation with users and help them with questions related to Infobip.
- You will receive paragraphs extracted from a long documentation as a context to answer questions from users.

基本設定

この機能は、アシスタントのテストに使用します。より良い結果と精度を得るには、プロンプトの書き込み オプションを使用します。

アシスタントの設定 セクションで以下を構成します。

設定方法

設定方法 フィールドで、基本設定 を選択します。

チャットボットの目的

AI アシスタントの目的を追加します。この目的は、AIアシスタントをブランドの目標に合わせるのに役立ちます。

文を完成させますあなたは役立つチャットボットになるはずです。

例: *Infobip 製品とサービス。

アシスタント名 (オプション)

アシスタントがエンド ユーザーに自己紹介するために使用する名前を追加します。名前がブランドと一致していることを確認してください。

この名前は、エンドユーザーがブランドを認識するのに役立ちます。また、名前のあるアシスタントと話すことで、コミュニケーションがより自然になります。

名前を追加しない場合、AI アシスタントは AI アシスタント として自己紹介します。

ブランド名(オプション)

会社名またはブランド名を追加します。例: Infobip。

ブランド名を追加すると、アシスタントはそれがブランドを表していることをエンドユーザーに伝えます。したがって、ブランド名はブランドのアイデンティティを確立するのに役立ちます。ブランド名を追加することで、サポートチャネル全体でのブランドの一貫性にもつながります。

ブランド名を追加しない場合、アシスタントはブランドに言及しません。

高度な AI 設定 (オプション)

トークン

トークンは、AI アシスタントが応答を分析、理解、生成できるようにするテキストの基本単位です。

例：

元のテキスト: チャットボットを作成する方法は次のとおりです。 36 文字以内です。

トークンに分割されたテキスト: Here's|どのように|あなた|缶|作成||チャットボット|. トークンが8個入っています。

パラメーター

アシスタント設定 タブで、詳細設定の編集 を選択します。

以下を設定します。

出力トークン (オプション)

アシスタントが応答で使用できるトークンの最大数を設定します。トークンの数は、アシスタントの応答の長さに影響します。

このフィールドに低い値を入力すると、応答は切り捨てられます。そのため、最低 300 個のトークンを構成します。

段落サイズの制限 (オプション)

アシスタントは、読みやすくするために応答を段落に分割します。

アシスタントの応答の段落内のトークンの最大数を設定します。これにより、段落のサイズが決まります。

小さいドキュメントには 300 の値を設定し、大きなドキュメントには 800 の値を設定します。

仕様:最小100トークン、最大900トークン。デフォルト値は 450 です。

重複トークン (オプション)

アシスタントの応答が段落に分割されている場合、エンド ユーザーが必要とする情報が 1 つの段落の最後と次の段落の先頭に存在する可能性があります。この問題を回避するには、1 つの段落の末尾と次の段落の先頭が重なるようにアシスタントを構成します。

また、コンテンツを重ね合わせることで、繰り返しが制御され、アシスタントの応答に多様性を持たせることができます。

重複するトークンの数を設定します。小さい文書には 20、大きな文書には 40 の値を設定します。

仕様:最小10トークン、最大900トークン。デフォルト値は 40 です。

類似の段落(オプション)

エンド ユーザーが質問をすると、アシスタントはアップロードされたドキュメントを検索し、回答が含まれている可能性が最も高い段落を特定します。アシスタントはこれらの段落を処理し、これらの段落の情報に基づいて応答を生成します。

応答を生成するためにアシスタントが処理する必要がある段落の数を構成します。

小さいドキュメントの場合は、値を 1 に設定します。ドキュメント内の複数の場所で同じトピックが言及されている大きなドキュメントの場合は、値 3 を設定します。

仕様:最小1段落、最大3段落。デフォルト値は 3 です。

温度(オプション)

生成される応答のランダム性のレベルを設定します。

低い温度で生成される応答は、焦点が絞られ、従来型で、予測可能であるのに対し、より高い温度で生成される応答は、創造的で、ランダムで、変化に富んでいます。

値を 0 に設定すると、提供されたソース資料に近い回答が生成されます。

仕様: 最小値は 0、最大値は 2 です。デフォルト値は 0 です。

会話の記憶とコンテキストの想起

チャット履歴を保存し、この履歴に基づいて応答を生成する場合は、このパラメーターを有効にします。チャット履歴を使用すると、会話の継続性が維持されます。

チャット履歴ではなく、エンドユーザーの質問に基づいて正確な回答を生成するには、このオプションを無効にします。

セッション・ウィンドウ

セッション ウィンドウ のサイズを定義して、アシスタントが記憶する以前のメッセージの数を指定します。

このパラメーターの各数値は、ユーザーの質問とアシスタントからの対応する回答を表します。

• セッションウィンドウが小さくなると、最近のメッセージに焦点が当てられ、応答が予測しやすくなります。ただし、アシスタントは会話の前の部分を見失う可能性があります。
• セッション ウィンドウが大きくなると、より多くの会話履歴が保持され、継続性が維持されます。ただし、無関係な詳細が含まれる場合もあり、応答品質に影響を与える可能性があります。

ドキュメントを追加する

応答を生成するために、AI アシスタントは受信した情報に依存します。そのため、AIアシスタントが関連するドキュメントを使用することが不可欠です。

例: AI アシスタントは、製品ドキュメントでトレーニングされています。AI アシスタントは、このドキュメントを使用して、エンド ユーザー クエリに対する応答を生成します。

ドキュメントは、次のいずれかの方法で追加できます。

• 独自のドキュメントを作成するを開き、ファイルをアップロードします。最良の結果を得るには、このオプションに従ってください。
• クローラを使う を使用して Web サイトのコンテンツをダウンロードし、コンテンツを確認してから、アシスタントにアップロードします。

独自のドキュメントを作成

自作のドキュメントを作成し、.zipファイルとしてアップロードします。

次のガイドラインに従って、ドキュメントを作成します。

ドキュメントの内容に関するガイドライン

• 構造化されたドキュメントを使用します。
• 同じドキュメントに複数のトピックに関する情報を追加しないでください。代わりに別のドキュメントを使用してください。
• zipファイルで複数のドキュメントを使用する場合は、データがクリーンであることを確認してください。そうすることで、アシスタントはより正確な応答を提供することができます。次のことは避けてください。
  • 同じコンテンツが複数の場所に存在する
  • 同じ概念の異なる定義
  • 不正確または古い情報
  • 同じドキュメント内の類似製品に関する情報
• コンテンツは、.pdf、.json、.txt、または.docx形式である必要があります。ドキュメントがサポートされている形式のいずれでもない場合は、サポートされている形式のドキュメントにコンテンツをコピーまたは保存します。
• ドキュメントから画像を削除します。

ドキュメントをアップロードする

ドキュメントを.zipファイルとしてアップロードします。AI アシスタントは、このセクションにアップロードしたドキュメントにのみアクセスできます。

ファイルのガイドラインと制限事項

• ドキュメントは.zipファイルとしてのみアップロードできます。
• zip ファイルの最大ファイルサイズは 7 MB です。
• アップロードできる zip ファイルは 1 つだけです。
• .zipファイルでは、複数のドキュメントを使用できます。
• zip ファイル内のドキュメントでサポートされているファイルの種類は、.pdf、.json、.docx、.txt です。
• サポートされている異なるファイルタイプのドキュメントを同じ zip ファイルで使用できます。
• すべてのドキュメントを zip ファイルの 1 つのフォルダーとしてアップロードします。サブフォルダは作成しないでください。
• ドキュメントを zip ファイルに追加する順序は重要ではありません。

zipファイルをアップロードする

1. [カスタム コンテンツ] タブで、[zip ファイルのアップロード] セクションに移動します。
2. [参照] を選択して zip ファイルを見つけてアップロードするか、ファイルをセクションにドラッグ アンド ドロップします。

コンテンツのフィルタ (オプション)

ドキュメント内の有害なコンテンツを特定します。カテゴリごとに、次の操作を実行できます。

• モードを設定します。
  • 注釈 - アシスタントがメッセージを処理して応答できるようにします。ただし、分析では、メッセージによってトリガーされたフィルターを確認できます。
  • 注釈とブロック - アシスタントがメッセージを処理して応答できないようにします。分析では、メッセージによってトリガーされたフィルターを確認できます。
• 重大度 レベルを設定します。

アシスタントを編集する

設定を編集する

AI アシスタントの設定は、チャットボットを有効にした後でも、いつでも更新できます。

1. Infobip Web インターフェイス (opens in a new tab) で、AI Hub > AI アシスタント に移動します。

2. **Edit (編集)**を選択します。

   

3. アシスタント設定、カスタムコンテンツ、コンテンツフィルタータブで、設定の更新をクリックします。

4. 更新アシスタント を選択します。

トレーニングドキュメントの編集

新しいドキュメントや更新されたドキュメントを追加するには、変更だけでなく、完全なドキュメントを アップロード します。