Failure Handler

# Failure Handler

# はじめに

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

Execution関数の{{%link href="/ja/convokraft/help/actions//bot-logic/deluge-functions/defining-deluge-functions/#system-defined-input-arguments" %}}システム定義の入力引数{{%/link%}}に加えて、Failure handler関数には、現在のチャットセッションにおけるユーザーからの最新の応答を格納するString型のuserInputというカスタム引数が含まれています。Failure handler関数は、Execution関数の{{%link href="/ja/convokraft/help/actions/bot-logic/deluge-functions/execution-function/#return-values" %}}returnマップ{{%/link%}}と同様の構造を持つマップを返します。

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

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 FailureHandler {
    Logger LOGGER = Logger.getLogger(FailureHandler.class.getName());
    public JSONObject handleFailureRequest(JSONObject reqBody) throws Exception{
        JSONObject jsonResponse = new JSONObject();
        LOGGER.info("Failure Handler : : TODO : " + reqBody.get("todo"));
        jsonResponse.put("message", "Failure 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 handleFailure() {
  logger.info('Handling failure request');
  return {
    "message": "Failure Response: Please define this question and try again"
  };
}{{%/code%}}

### Python

{{%code class="language-python"%}}import logging
def handle_failure_request():
    #  これは失敗レスポンスハンドラーです。 
    #    関数の実行中にボットが失敗した場合の失敗レスポンスを記述してください。 
    #    失敗メッセージを返す方法は次のとおりです： 
    #       {
    #           'message': '申し訳ありません、問題が発生しました'
    #       }
    #   以下に同じ設定のサンプルコードがあります。
    logging.info('Handling failure request')
    return {
        'message': 'Failure Response: Please define this question and try again'
    }{{%/code%}}

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

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

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

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

Java

copy

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

Node.js

copy

         import logger from "./logger.js";
// 失敗機能を処理する
export default function handleFailure() {
  logger.info('Handling failure request');
  return {
    "message": "Failure Response: Please define this question and try again"
  };
}
    

Python

copy

         import logging
def handle_failure_request():
    #  これは失敗レスポンスハンドラーです。 
    #    関数の実行中にボットが失敗した場合の失敗レスポンスを記述してください。 
    #    失敗メッセージを返す方法は次のとおりです： 
    #       {
    #           'message': '申し訳ありません、問題が発生しました'
    #       }
    #   以下に同じ設定のサンプルコードがあります。
    logging.info('Handling failure request')
    return {
        'message': 'Failure 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