Actionモデル

ConvoKraft Botは、ユーザーとの会話中にActionsを実行するように設定できます。BotのActionは、Sample Sentences、param、およびBot Logicによって特徴付けられます。Direct answerで応答するように設定されたActionsは、関連するSample Sentencesで定義されます。一方、Bot Logicを実行するActionsは、特定の操作を実行するためにユーザー入力が必要な場合があり、Sample Sentencesとともにparamを設定する必要があります。

Sample Sentences

Sample Sentencesは、エンドユーザーが特定のActionを会話形式で呼び出す際に使用する例文です。これらのSample Sentencesは、ユーザー入力をより適切に理解するためのConvoKraftのインテリジェンスの強化に役立ちます。

以下は、イベントを作成するために設定できる一般的なSample Sentencesの例です：

• 「イベントを作成して」
• 「会議をスケジュールして」

実際には、ユーザーは呼び出し指示の一部としてデータを話すため、Sample Sentencesには特定のparam値が含まれる場合もあります。以下の例のように、ユーザーはイベントをスケジュールしようとする際に、最初の呼び出し文の一部としてイベントタイトル、開始時間、終了時間を言及する場合があります。

• 「午後5時から午後6時まで、Zylkerの案件について話し合うイベントを作成して」
• 「午後5時にJohnとの会議をスケジュールして」

呼び出し文に必要なすべてのparamが含まれていない場合、Botはユーザーにそれらの必須param値の入力を求めます。

Sample Sentencesは特定のActionの意図を定義し、paramはそのActionを実行するために必要なエンティティを定義します。したがって、ConvoKraft Actionのデータモデルは、Sample Sentencesとparamの組み合わせによって実現されます。

Sample Sentencesの詳細とAction設定における重要性については、こちらのページを参照してください。

Params

Paramは、Actionを実行するために必要な入力データです。たとえば、カレンダーにイベントを作成するように設定されたActionのparamは、通常、イベントタイトル、開始時間、終了時間、イベント会場などになります。

paramとその種類の詳細については、こちらを参照してください。

Bot Logic

Actionの会話フローと実行は、そのために定義されたBusiness Logic（またはBot Logic）に依存します。ConvoKraftは、ActionのBot Logicを定義するために以下の開発プラットフォームをサポートしています：

• Catalyst Functions
• Deluge Functions
• Webhooks

Actionのすべての宣言されたparamは、Actionを実行するためにBusiness Logicに渡されます。宣言されたparamに加えて、Business Logicの実行に必要なその他の環境データ（ユーザーやクライアントアプリケーションに関する詳細など）も、これらの関数への入力引数として渡されます。

1. Catalyst Functions

Catalyst Functionsは、Catalystアプリケーションの高度なBusiness Logicを含むカスタムビルドのコーディング構造です。Catalyst Integration Functionsを使用すると、Catalyst関数をコーディングして、他のCatalystまたはZohoサービスのバックエンドとして使用し、それらとの統合を確立できます。ConvoKraftでActionを呼び出すと、HTTP呼び出しを通じて設定されたIntegration Functionが自動的に呼び出されます。

Catalyst Functionsを使用する場合、Business Logicは以下のプログラミング環境で定義できます：

• Java
• Node.js
• Python

コンソールのServerlessサービスに移動してCatalyst Functionを作成するか、Catalyst CLIを使用してローカル環境から関数を作成・コーディングすることもできます。

Catalyst Functionsは高いスケーラビリティと効率性を備えています。関数がホストされるサーバーインフラストラクチャはCatalystによって完全に管理されるため、バックエンドを管理する必要がなく、Business Logicの開発にのみ集中できます。アプリケーションに強力なバックエンドを提供することに加えて、Catalyst Functionsは堅牢で信頼性が高く、ConvoKraftとのシームレスな統合を提供します。

Catalyst Functionsを使用してConvoKraft ActionsのBusiness Logicを定義する方法の詳細については、こちらを参照してください。

2. Deluge Functions

Delugeは、Zohoクラウド環境のネイティブオンラインスクリプト言語です。ユーザーフレンドリーな構文を持ち、2つのZohoサービス間、またはサードパーティサービスとのシームレスな統合を可能にします。

ConvoKraft ActionsのBusiness Logicは、以下の定義済み関数テンプレートを通じてDelugeで記述する必要があります：

• Execution（必須）：ConvoKraft Botのすべてのactionsの実行に関わるコア関数です。

• Context Handler（任意）：Action中のすべてのユーザー入力に対して呼び出される関数です。会話フローにおけるparamの順序変更、必要に応じたスキップ、カスタムバリデーションの実行に使用できます。

• Button Click（任意）：ボタンカードのBusiness Logicを定義する際に使用できる関数です。カスタムボタンの実装に焦点を当てたExecution関数タイプの一部です。

これらの関数はZohoクラウドでホストされ、Action実行中のそれぞれの呼び出しポイントで実行されます。Catalyst Functionsと同様に、Deluge Functionsも高い効率性を備え、ホスティングとメンテナンスはZohoによって完全に管理されます。Deluge Functionsを使用してConvoKraft ActionsのBusiness Logicを定義する方法の詳細については、こちらをご覧ください。

3. Webhooks

Webhooksの場合、外部プラットフォームでバックエンドロジックをコーディングし、ConvoKraft内で設定されたWebhooksを通じて呼び出すことができます。ActionsのBusiness Logicは、ConvoKraftからアクセス可能な公開ホストサーバーで外部的にビルド、管理、ホストする必要があります。構築するBotsからロジックにアクセスするためにREST APIを使用する必要があります。設定されたWebhook URLは、Action実行中の適切な呼び出しポイントでConvoKraftによって呼び出されます。

Webhooksを使用する場合、Business Logicは任意の便利なプログラミング言語で定義できます。ただし、DelugeおよびCatalyst Functionsとは異なり、Webhooksを使用する場合は、インフラストラクチャのセットアップと設定を完全に自分で管理する必要があります。Webhooksを使用してConvoKraft ActionsのBusiness Logicを定義する方法の詳細については、こちらのページをご覧ください。