RICOH Chatbot Service 使い方ガイド

カスタムシナリオを編集する

カスタムシナリオは様々なカードや、アクションオブジェクトなどのアイテムを組み合わせることで作成できます。

カードを追加する
カードを削除する
シナリオカードのメッセージを編集する
アイテムを追加する
アイテムを編集する
アイテムの順序を入れ替える
アイテムを削除する
アイテムとカードを接続線で紐づける
システムカードと任意のカードを接続線で紐づける
接続線を折り曲げる
接続線のポイントを削除する
接続線を削除する
カスタムシナリオが成立しているかをチェックする
カスタムシナリオを保存する
シナリオ編集画面を閉じる

カードを追加する

シナリオ編集画面の右側下部の［カードを追加する］ボタンをクリックします。
リストに表示されたカードから、追加したいカードを選択します。
カードをドラッグしながら移動することで、カードの位置を動かすことができます。

カードの説明

カード名	説明
シナリオカード	チャットボットに表示されるカードです。シナリオ編集画面では、白いカードで表示されます。表示するメッセージの編集ができます。アイテムの追加と削除ができます。入力ポート(カードの左上にある丸い部分)を保持します。
システムカード	チャットボットに表示されないカードです。シナリオ編集画面では、黒いカードで表示されます。アイテムの追加と削除ができます。入力ポート(カードの左上にある丸い部分)と出力ポート(カードの右中にある丸い部分)を保持します。
条件分岐カード	チャットボットに表示されないカードです。シナリオ編集画面では、黒いカードで表示されます。条件アイテムの追加と削除ができます。 (デフォルト条件アイテムを常に1つ保持します）入力ポート(カードの左上にある丸い部分)を保持します。

[Note]

スタートのシナリオカードは、あらかじめ作成されています。
スタートのシナリオカードは、位置を動かすことができません。
追加できるカードは、999枚までです。

カードを削除する

削除したいカードのゴミ箱アイコンをクリックします。
表示されたダイアログで［OK］ボタンをクリックします。

[Note]

削除するカードで作成したアイテムや接続線もすべて削除されます。

シナリオカードのメッセージを編集する

シナリオカード上部の吹き出しをクリックします。
シナリオ編集画面の右サイドパネルの［表示するメッセージ］欄で、メッセージを入力します。

[Note]

入力できるメッセージは、1000文字までです。

[Note]

自動翻訳が有効な場合、カードのメッセージに変数名を設定していると、自動翻訳の対象となります。
自動翻訳の対象外としたい場合は下記リンクをご参照ください。
メッセージの書式を変更する

[Note]

[<]ボタンをクリックすることで、編集パネルのサイズを変更することができます。

アイテムを追加する

編集したいカードの［アクションオブジェクトを追加する］もしくは［条件を追加する］ボタンをクリックします。
リストに表示された中から、追加したいアイテムを選択します。
カードにアイテムが追加されます。

[Note]

同じカード内で組み合わせ可能なアクションオブジェクト

アクションオブジェクト名	組み合わせ可能なアクションオブジェクト
テキスト	質問・回答、最初にもどる
質問・回答	テキスト、最初にもどる
最初にもどる	すべて
ヒアリング	最初にもどる
選択肢生成	最初にもどる

シナリオカードのアクションオブジェクトの説明

アクションオブジェクト名	説明
テキスト	チャットのシナリオを分岐するボタンです。選択されると次のシナリオカードに進みます。出力ポート(カードの右中にある丸い部分)を保持します。
質問・回答	チャットで質問・回答を表示するボタンです。選択されると回答を表示します。
最初にもどる	チャットを中断するボタンです。選択されると開始時のあいさつを表示します。
ヒアリング	自由入力を受け付けます。ユーザからの入力を取得し、他のカードやアイテムで使用することができます。チャットボットに表示されないアクションオブジェクトです。
選択肢生成	設定した情報をもとに複数のボタンを作成します。ユーザからの選択を取得し、他のカードやアイテムで使用することができます。

[Note]

シナリオカードには、１個以上のアクションオブジェクトを設定する必要があります。
追加できるアイテムは、カードあたり20個までです。

システムカードのアクションオブジェクトの説明

アクションオブジェクト名	説明
API連携	外部のAPIから情報を取得し、他のカードやアイテムで使用することができます。他のカードやアイテムで取得した情報を、外部のAPIへ送信することができます。
生成AI連携	生成AIを利用することができます。生成AIの最後の回答を取得し、他のカードやアイテムで使用することができます。

[Note]

同じカード内でアクションオブジェクトは１個のみ追加できます。

[Note]

チャットボットでチャット中、API連携アクションオブジェクト実行時に発生するエラー

チャットボットでチャット中、API連携アクションオブジェクト実行時に発生するエラーケースは以下になります。

APIの接続がタイムアウトした場合
APIのレスポンスボディの解析に失敗した場合
APIの戻り値が不正な場合(ステータスコードが400以上)

条件分岐カードのアイテムの説明

アイテム名	説明
条件	他のカードやアイテムで取得した情報をもとに次のカードを判断します。条件に当てはまると次のカードに分岐します。出力ポート(カードの右中にある丸い部分)を保持します。表示順が上の条件から判定します。
デフォルト条件	条件分岐カード内のどの条件にも当てはまらない場合に分岐します。出力ポート(カードの右中にある丸い部分)を保持します。

[Note]

追加できる条件アイテムは、カードあたり19個(デフォルト条件アイテムと合わせて20個)までです。

アイテムを編集する

編集したいアイテムをクリックします。
シナリオ編集画面の右サイドパネルで、アイテムに必要な項目を入力します。

[Note]

[<]ボタンをクリックすることで、編集パネルのサイズを変更することができます。

アイテムの入力項目

テキストアクションオブジェクト

ボタンタイトル
- ボタンに表示するテキスト
  ※入力できるテキストは、1000文字までです。

質問・回答アクションオブジェクト

ボタンタイトル
- ボタンに表示する質問の文章
- あらかじめ登録した質問・回答がリスト表示されます。

最初にもどるアクションオブジェクト

ボタンタイトル
- ボタンに表示するテキスト
  ※入力できるテキストは、1000文字までです。

ヒアリングアクションオブジェクト

変数名
- ユーザーから取得した値を保持する変数名
  ※入力できる変数名は、半角英数字で1000文字までです。
- 変数名は他のカードやアイテムで使用するための値です。
  カードのメッセージやアイテムのボタンタイトルに{{変数名}}を設定すると、保持している値に書き換えてチャットボットに表示されます。

[Note]

変数名は以下で使用できます。

カードのメッセージ
ボタンタイトル
API連携アクションオブジェクトの連携先URL
API連携アクションオブジェクトのリクエストボディ
条件アイテムの変数名
選択肢生成アクションオブジェクト
生成AI連携アクションオブジェクトの質問文

選択肢生成アクションオブジェクト

選択肢に使用する変数名
- API連携アクションオブジェクト、ヒアリングアクションオブジェクトなどの結果を保持する変数名
- {{変数名}}を設定すると、保持している値をボタンとしてチャットボットに表示します。
  ※変数名が保持している値に表示可能な値がない場合、エラーメッセージを表示し、開始時のあいさつを表示します。表示できない値に関しては、Noteをご確認ください。
  ※変数名が保持している値に重複がある場合、重複値は排除されて表示します。
変数名
- 選択された値を保持する変数名
  ※入力できる変数名は、半角英数字で1000文字までです。
- 変数名は他のカードやアイテムで使用するための値です。
  カードのメッセージやアイテムのボタンタイトルに{{変数名}}を設定すると、保持している値に書き換えてチャットボットに表示されます。

[Note]

選択肢生成アクションオブジェクトの変数名が保持している値が以下の場合、ボタンは表示されません。

null
文字列の場合
- 空文字
配列の場合
- 配列の要素数が0
- 配列の要素が、nullと空文字のみ

API連携アクションオブジェクト

連携先URL
- 使用するURL
  ※入力できる連携先URLは、URLフォーマットで2048文字までです。
メソッド種類
- 使用するHTTPメソッド(GET/POST)
  ※リクエストボディに値が入力されているときにメソッド種類をGETに変更する場合、確認ダイアログが表示されます。確認ダイアログの「OK」ボタンをクリックした場合、メソッド種類がGETに切り替わります。この時、リクエストボディに入力された値は削除されます。
リクエストヘッダー
- 連携先URLで使用するリクエストヘッダー
  リクエストヘッダーの「追加」ボタンをクリックしたら、名前と値入力欄が表示されます。
  ※入力できる名前と値は、リクエストヘッダーフォーマットです。
  - 名前
    - リクエストヘッダーのフィールド名
  - 値
    - リクエストヘッダーのフィールド値
リクエストボディ
- 連携先URLで使用するリクエストボディ
  ※空文字、またはJSON形式で10000文字までです。
- メソッド種類がGETの場合、リクエストボディは表示されません。
レスポンスボディ
- API実行結果のレスポンスボディをチャットボットで使用するための設定
  レスポンスボディの「追加」ボタンをクリックしたら、変数名と交換元キー名入力欄が表示されます。
- 変換元キー名
  - チャットボットに表示させたいJSONPath
    ※入力できるレスポンスボディ交換元キー名は、1000文字までです。
    ※JSON形式のみサポートしています。ただし、ルートが配列のJSON形式はサポート対象外です。
- 変数名
  - 他のカードやアイテムで使用する際の名前
    カードのメッセージやアイテムのボタンタイトルに{{変数名}}を設定すると、変換元キーに指定したJSONの値に書き換えてチャットボットに表示されます。
    ※入力できるレスポンスボディ変数名は、半角英数字で1000文字までです。

[Note]

JSONPathを使用することで階層やリスト形式で取得することが可能です。

JSONPathの表現式

path	説明
$	ルートの要素
. または []	子要素
..	子孫要素を再帰的に探す
*	ワイルドカード
[]	添え字演算子
[,]	ユニオン演算子
[start:end:step]	配列スライス演算子
?()	フィルター(スクリプト)式
@	フィルター結果の現在の要素

API連携で返却されるレスポンスボディの例

{
  "status": {
    "state": "active",
    "openingtime": "10:00",
    "closingtime": "23:00"
  },
  "message": "店舗を選んでください",
  "location": [
    {
      "id": "1",
      "name": "新宿店"
    },
    {
      "id": "2",
      "name": "渋谷店"
    },
    {
      "id": "3",
      "name": "池袋店"
    }
  ]
}

JSONPathの使用例

変換元キー名の例

取得できるもの

status

{
  "state": "active",
  "openingtime": "10:00",
  "closingtime": "23:00"
}

{
  "status": {
    "state": "active",
    "openingtime": "10:00",
    "closingtime": "23:00"
  },
  "message": "店舗を選んでください",
  "location": [
    {
      "id": "1",
      "name": "新宿店"
    },
    {
      "id": "2",
      "name": "渋谷店"
    },
    {
      "id": "3",
      "name": "池袋店"
    }
  ]
}

status.state

active

$.['status', 'message']

{
  "state": "active",
  "openingtime": "10:00",
  "closingtime": "23:00"
},店舗を選んでください

location[0:]

{
  "id": "1",
  "name": "新宿店"
},
{
  "id": "2",
  "name": "渋谷店"
},
{
  "id": "3",
  "name": "池袋店"
}

location[0]

{
  "id": "1",
  "name": "新宿店"
}

location[0:2]

{
  "id": "1",
  "name": "新宿店"
},
{
  "id": "2",
  "name": "渋谷店"
}

location[0,2]

{
  "id": "1",
  "name": "新宿店"
},
{
  "id": "3",
  "name": "池袋店"
}

location[0:].id

1,2,3

location[0].id

location[?(@.id =='1')]

{
  "id": "1",
  "name": "新宿店"
}

location[?(@.id > '1')]

{
  "id": "2",
  "name": "渋谷店"
},
{
  "id": "3",
  "name": "池袋店"
}

$..id

1,2,3

status.*

active,10:00,23:00

生成AI連携アクションオブジェクト

質問文
- 生成AIへの最初の質問文
  ※入力できるテキストは、1500文字までです。
変数名
- 生成AIの最後の回答を保持する変数名
  ※入力できる変数名は、半角英数字で1000文字までです。
- 変数名は他のカードやアイテムで使用するための値です。
  カードのメッセージやアイテムのボタンタイトルに{{変数名}}を設定すると、保持している値に書き換えてチャットボットに表示されます。
生成AIとの会話終了のボタンタイトル
- 生成AIとの会話を終了するためのボタンに表示するテキスト
  ※入力できるテキストは、1000文字までです。