Action Followups

Action Followupsは、Actionの実行後にBotがユーザーに何を推奨すべきかを定義し、会話にユーザーをさらに引き付けるためのものです。Botは提案のリストを表示したり、特定のActionの完了後にユーザーにとってコンテキスト上有用な別のActionを呼び出すかどうかを尋ねたりできます。フォローアップとして設定されたActionsは、同じActionまたは異なるActionsにすることができますが、対応するConvoKraft Botにそれぞれのactionsが設定されている必要があります。

Action Followupsを設定することで、ユーザーがConvoKraft Botと対話するためのより多くの方法をBotが積極的に提案するようにできます。これにより、Action実行後にコンテキスト上有用な次のActionをユーザーが簡単にトリガーできるようになります。このようなコンテキスト上有用なActionsをフォローアップとして設定することで、現在のAction実行が完了すると、Botは定義済みの提案リストを即座に表示します。ユーザーが適切な提案を選択すると、その提案に設定されたActionが次のActionとして呼び出されます。

例：

タスク管理アプリケーション用に構築されたBotを考えてみましょう。新しいタスクを作成した後、ユーザーへの提案として以下を表示することがコンテキスト上適切です：「このタスクを開始する」、「未完了タスクを表示する」、**「このタスクを重要としてマークする」など。ユーザーが「このタスクを重要としてマークする」**をクリックすると、タスクステータスを更新するActionが呼び出されます。

Action Followupsは、Actionsのリストを直接提供するか、実行時にActionsを動的に取得することで設定できます。Action Followups機能は、Direct answerで応答するように設定されたActionsとBusiness Logicを実行するActionsの両方に同様に適用されます。

Static Followup Suggestions

コードを使用せずにAction Followupsを静的に設定する場合は、以下の手順に従ってください：

1. コンソールで既存のActionをクリックすると、Actionの詳細ページが表示されます。Actionの作成については、こちらのページを参照してください。

   Followup SuggestionsセクションのAdd Followup Suggestionsをクリックします。

   

2. Followup Suggestionsのポップアップウィンドウで、以下の操作を行います：

• Suggestionsセクションのテキストボックスに適切な提案テキストを入力します。

• Mapped Actionsセクションのドロップダウンをクリックし、指定した提案テキストにマッピングする適切なActionを選択します。これにより、ユーザーが提案をクリックした際にActionが実行されます。さらに提案を追加し、適切なActionsにマッピングすることもできます。

3. 必要な提案テキストとそのマッピングされたActionsの設定後、Updateボタンをクリックします。

設定されたフォローアップ提案は、Followup Suggestionsセクションにリスト表示されます。

4. 既存のフォローアップ提案リストを変更するには、Followup SuggestionsセクションのConfigureをクリックします。そこから、必要に応じてさらに更新できます。

フォローアップ提案は、以下のようにチャットウィンドウに表示されます：

Dynamic Followup Suggestions

ConvoKraft Botに実行時にフォローアップとして提案リストを動的に表示させるには、以下に示すように、Execution関数出力のfollowupキーにマップ値として渡す必要があります：

フォローアップActionのparam値を設定して、そのAction実行時にユーザーに再度プロンプトが表示されないようにすることもできます。

{
"followup":{
"suggestions":[
{
"message":"//ユーザーに表示するチャット候補",
"action":{
"name":"//呼び出すアクションの名前空間",
"params":[ 
{
"name":"//パラメーター名",
"value":"//パラメーター値"
} 
//必要に応じて他のパラメータを追加する  
]
}
}
//必要に応じて他の提案を追加する
] 
}
}

別のActionの呼び出しをプロンプトする

場合によっては、複数のActionsよりも1つのActionがAction後に実行する方が適切なことがあります。このActionを定義済みの提案とともにフォローアップとして設定することで、Botはその特定のActionを定義済みの提案リストとともに表示し、次のActionを呼び出すようプロンプトメッセージでユーザーに尋ねます。ユーザーは必要な提案を選択するか、適切なメッセージでプロンプトに返信し、会話をさらに進めることができます。

例：

タスク管理Botを考えてみましょう。ユーザーは次のタスクを表示したい場合があります。次のタスクを表示した後、「このタスクを開始しますか？」とともに、このプロンプトに適した提案として「はい、このタスクを開始済みにしてください」、「いいえ、結構です」、**「いいえ、このタスクは後で開始します」**を尋ねることがコンテキスト上適切です。ユーザーは適切な提案を選択するか、適切なメッセージでこのプロンプトに返信して、そのタスクを開始するActionを呼び出すことができます。

フォローアップActionに多くのparamがあり、Botが他のparamの中で最初に特定のparamの値をプロンプトするようにしたい場合は、フォローアップActionの設定でそのparam名を指定できます。フォローアップActionのparam値を設定して、そのAction実行時にユーザーに再度プロンプトが表示されないようにすることもできます。

ConvoKraft Botがフォローアップとして特定のActionを呼び出すようユーザーにプロンプトするには、以下の形式に示すように、Execution関数出力のfollowupキーにActionの詳細をマップ値として渡す必要があります：

{
"followup":{
"prompt":{
"message":"//ユーザーへのプロンプトメッセージ",
"suggestions":["//候補テキスト1", "//候補テキスト2", ... "//候補テキスト5"],
"reject_message":"//プロンプトをキャンセルするための否定的なフレーズをユーザーが返したときに表示するメッセージ",
"param":"//このアクション実行時に最初に値を促すパラメーター名",
"action":{
"name":"//呼び出すアクションの名前空間",
"params":[
{
"name":"//パラメーター名",
"value":"//パラメーター値"
}
//必要に応じて他のパラメータを追加する   
]
}
}
}
}