Fallback Handler

# Fallback Handler

# はじめに

botが理解できない入力メッセージを受信した場合、botはfallback handler関数で設定されたメッセージで応答します。デフォルトの応答メッセージをカスタマイズして独自の返信を行いたい場合は、botの特定のニーズに基づいてfallback handler関数を設定できます。
	
Execution関数の{{%link href="/ja/convokraft/help/actions/bot-logic/deluge-functions/defining-deluge-functions/#system-defined-input-arguments" %}}システム定義の入力引数{{%/link%}}に加えて、Fallback Handler関数には、現在のチャットセッションにおけるユーザーからの最新の応答を格納するString型の{{%badge%}}userInput{{%/badge%}}というカスタム引数が含まれています。Fallback handler関数は、Execution関数の{{%link href="/ja/convokraft/help/actions/bot-logic/deluge-functions/execution-function/#return-values" %}}returnマップ{{%/link%}}と同様の構造を持つマップを返します。

{{%note%}}{{%bold%}}注意:{{%/bold%}}

1. ConvoKraft botの開発プラットフォームとして{{%bold%}}Catalyst functions{{%/bold%}}または{{%bold%}}Webhooks{{%/bold%}}を選択している場合、コンソールからhandlerを有効にし、handler関数のロジックをIntegration functionまたは設定されたwebhook URLに関連付けられたコードベースでそれぞれ定義できます。

2. fallback handler関数の成功シナリオの応答ステータスは、{{%badge%}}handled{{%/badge%}}として設定する必要があります。設定しない場合、ステータスは失敗とみなされます。関数の返却応答は、fallback function handlerで設定されたロジックに依存します。これはCatalyst functionsとWebhooksの両方に適用されます。

Delugeでのhandler関数の定義の詳細については、{{%link href="/ja/convokraft/help/handlers/code-deluge-handlers" %}}こちらのページ{{%/link%}}を参照してください。

開発プラットフォームとしてFunctionsを選択した場合、Java、Node.js、Pythonスタックの以下のサンプルコードを使用できます：

### Java

{{%code class="language-java"%}}import org.json.JSONObject;
import java.io.*;
import java.util.logging.Logger;
public class FallbackHandler {
    Logger LOGGER = Logger.getLogger(FallbackHandler.class.getName());
    public JSONObject handleFallbackRequest(JSONObject reqBody) throws Exception{
        JSONObject jsonResponse = new JSONObject();
        LOGGER.info("Fallback Handler : : TODO : "+ reqBody.get("todo"));
        jsonResponse.put("message", "Fallback Response: Please define this question and try again");
        return jsonResponse;
    }
}{{%/code%}}

### Node.js

{{%code class="language-javascript"%}}import logger from "./logger.js";
// フォールバック機能を処理する
export default function handleFallback() {
  logger.info('Handling fallback request');
  return {
    "message": "Fallback Response: Please define this question and try again"
  };
}
{{%/code%}}

### Python

{{%code class="language-python"%}}import logging
def handle_fallback_request():
    #   これはフォールバックレスポンスハンドラーです。 
    #   ボットがユーザーへの応答方法を知らない場合のフォールバックレスポンスを記述してください。 
    #   フォールバックメッセージを返す方法は次のとおりです： 
    #       {
    #        'message': 'フォールバックレスポンス：この質問を定義してもう一度お試しください'
    #       }
    #   以下に同じ設定のサンプルコードがあります。
    logging.info('Handling fallback request')
    return {
        'message': 'Fallback Response: Please define this question and try again'
    }{{%/code%}}

botが理解できない入力メッセージを受信した場合、botはfallback handler関数で設定されたメッセージで応答します。デフォルトの応答メッセージをカスタマイズして独自の返信を行いたい場合は、botの特定のニーズに基づいてfallback handler関数を設定できます。

Execution関数のシステム定義の入力引数に加えて、Fallback Handler関数には、現在のチャットセッションにおけるユーザーからの最新の応答を格納するString型のuserInputというカスタム引数が含まれています。Fallback handler関数は、Execution関数のreturnマップと同様の構造を持つマップを返します。

注意:

ConvoKraft botの開発プラットフォームとしてCatalyst functionsまたはWebhooksを選択している場合、コンソールからhandlerを有効にし、handler関数のロジックをIntegration functionまたは設定されたwebhook URLに関連付けられたコードベースでそれぞれ定義できます。
fallback handler関数の成功シナリオの応答ステータスは、handledとして設定する必要があります。設定しない場合、ステータスは失敗とみなされます。関数の返却応答は、fallback function handlerで設定されたロジックに依存します。これはCatalyst functionsとWebhooksの両方に適用されます。

Delugeでのhandler関数の定義の詳細については、こちらのページを参照してください。

開発プラットフォームとしてFunctionsを選択した場合、Java、Node.js、Pythonスタックの以下のサンプルコードを使用できます：

Java

copy

         import org.json.JSONObject;
import java.io.*;
import java.util.logging.Logger;
public class FallbackHandler {
    Logger LOGGER = Logger.getLogger(FallbackHandler.class.getName());
    public JSONObject handleFallbackRequest(JSONObject reqBody) throws Exception{
        JSONObject jsonResponse = new JSONObject();
        LOGGER.info("Fallback Handler : : TODO : "+ reqBody.get("todo"));
        jsonResponse.put("message", "Fallback Response: Please define this question and try again");
        return jsonResponse;
    }
}
    

Node.js

copy

         import logger from "./logger.js";
// フォールバック機能を処理する
export default function handleFallback() {
  logger.info('Handling fallback request');
  return {
    "message": "Fallback Response: Please define this question and try again"
  };
}

    

Python

copy

         import logging
def handle_fallback_request():
    #   これはフォールバックレスポンスハンドラーです。 
    #   ボットがユーザーへの応答方法を知らない場合のフォールバックレスポンスを記述してください。 
    #   フォールバックメッセージを返す方法は次のとおりです： 
    #       {
    #        'message': 'フォールバックレスポンス：この質問を定義してもう一度お試しください'
    #       }
    #   以下に同じ設定のサンプルコードがあります。
    logging.info('Handling fallback request')
    return {
        'message': 'Fallback Response: Please define this question and try again'
    }
    

最終更新日 2026-03-30 13:40:30 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit