양식 노드를 사용하면 디지털 양식을 대화 작업과 연동할 수 있습니다. 따라서 양식 표시가 용이하며 특정 사용 사례에 대한 사용자 입력을 캡처할 수 있습니다. 양식 노드의 주요 목적은 대화 작업에서 UI 양식을 표현하고, 최종 사용자가 해당 채널에서 양식을 사용할 수 있도록 하는 것입니다. 예: 새 계정을 개설하기 위해 고객 세부 정보를 캡처하는 양식이 있는 뱅킹 봇을 고려해 봅시다. 각 엔티티 값을 요청하는 대신 양식을 사용해야 합니다.

설정

대화 작업에서 양식 노드를 설정하려면 다음 단계를 수행합니다.

노드 추가

양식 노드를 대화 작업에 추가하려면 다음 단계를 수행하세요.

1. 양식 노드를 추가하려는 대화 작업을 엽니다.
2. 지정된 위치에 양식 노드를 추가합니다. 노드를 추가하는 단계의 경우, 여기를 참조하세요.
3. 양식 노드 창은 기본적으로 구성 요소 속성 탭이 선택되어 표시됩니다.

노드 설정

구성 요소 속성

양식 구성 요소 속성을 사용하면 일반 설정, 사용자 프롬프트 및 오류 프롬프트를 설정할 수 있습니다.

1. 구성 요소 속성 탭의 일반 설정 섹션에서 양식 노드의 이름 및 표시 이름 이름을 입력합니다. 노드 이름에는 공백을 사용할 수 없습니다. UI 양식 속성은 선택한 UI 양식으로 설정되며 변경할 수 없습니다.
2. 프롬프트 메시지 텍스트 상자에서 이 양식에 대해 사용자에게 표시하려는 프롬프트 메시지를 입력합니다. 사용자에게 링크를 클릭하여 양식을 작성하도록 지침을 제공합니다. 코드화된 양식{{context.form_node.formLink}})의 컨텍스트 변수 참조를 변경하는 것은 권장하지 않습니다. 사용자 프롬프트에 대한 채널별 메시지를 입력할 수 있습니다. 자세한 내용은 프롬프트 편집기 사용을 참조하세요.
3. 오류 메시지 텍스트 상자에서 기본 오류 메시지를 검토하고 필요한 경우 수정합니다. 자세한 내용은 프롬프트 편집기 사용을 참조하세요.
4. 제출 메시지 텍스트 상자에서 양식을 성공적으로 제출한 후 표시되는 기본 메시지를 검토하고 필요한 경우 수정합니다. 이 메시지는 URI 양식이 브라우저 탭에서 열린 경우에만 적용되며 웹/모바일 SDK는 적용되지 않습니다. 자세한 내용은 프롬프트 편집기 사용을 참조하세요.
5. 웹/모바일 SDK 양식 동작 섹션에서 양식이 표시되는 방식을 설정할 수 있습니다. 다음을 선택할 수 있습니다.
   • 전체 페이지 팝업 양식 열기 – 이것은 SDK 대화 인터페이스에서 양식이 전체 페이지 형태로 열리는 기본 설정입니다.
   • 인라인 양식 열기 – 양식이 대화 창 내에서 인라인 양식의 형태로 열립니다.
6. 변수 네임스페이스 섹션에서 이 노드와 전환을 실행할 변수 네임스페이스를 연결합니다. 이 옵션은 봇에 변수 네임스페이스를 사용하도록 설정한 경우에만 표시됩니다. 작업 수준 설정을 사용하거나 이 노드에 사용자 정의할 수 있습니다. 자세한 내용은 네임스페이스 관리를 참조하세요.

인스턴스 속성

인스턴스 속성을 사용하여 설정하려는 사용자 태그를 정의합니다.

1. 양식 창에서 인스턴스 속성 탭을 클릭합니다.
2. 맞춤형 태그 섹션에서 태그를 추가하여 봇 대화의 맞춤형 프로필을 작성하세요. 자세히 확인하려면 여기를 클릭하세요

연결 속성

노드의 연결 탭에서 대화 작업에서 어떤 노드를 다음에 실행할지 결정할 수 있습니다. 대화 작업에서 엔티티 또는 컨텍스트 개체의 값을 기반으로 조건문을 작성하거나 전환을 위해 의도를 사용할 수 있습니다. 구성 요소 전환을 설정하려면 다음 단계를 수행하세요.

1. 양식 창에서 연결 탭을 클릭합니다.
2. 연결 규칙 섹션의 기본값 드롭다운 목록에서 노드를 선택할 수 있습니다.
3. 조건부 흐름을 설정하려면 IF 추가를 클릭합니다.
4. 다음 조건 중 하나를 기준으로 조건식을 설정합니다.
   • 엔티티: 다음 연산자 중 하나를 사용하여 대화의 엔티티 노드와 지정된 값을 비교합니다. Exists, equals to, greater than equals to, less than equals to, not equal to, greater than, less than. 엔티티, 각 드롭다운 목록을 사용한 연산자를 선택하고 값 상자에 숫자를 입력합니다. 예: PassengerCount (엔티티) greater than (연산자) 5 (지정된 값):
   • 컨텍스트: 다음 연산자 중 하나를 사용하여 대화의 컨텍스트 개체와 지정된 값을 비교합니다. Exists, equals to, greater than equals to, less than equals to, not equal to, greater than, less than. 예: Context. entity.PassengerCount (컨텍스트 개체) greater than (연산자) 5 (지정된 값).
   • 의도: 다음 사용자 발화와 일치하는 의도를 선택합니다.
5. Then go to 드롭다운 목록에서 조건식이 성공할 경우 대화 흐름에서 실행할 다음 노드를 선택합니다. 예: PassengerCount (엔티티) greater than (연산자) 5 (지정된 값), Then go to Offers (하위 대화).
6. Else 드롭다운 목록 조건이 실패할 경우 실행할 노드를 선택합니다.
7. 저장을 클릭합니다.

フォームノードでは、 デジタルフォーム とダイアログタスクを連携することができます。これにより、特定のユースケースのためにユーザー入力をキャプチャするフォームの提示が容易になります。フォームノードの主要なパーパスは、ダイアログタスクでUIフォームを表現し、そのフォームをエンドユーザーのチャネルで利用できるようにすることです。例として、新規口座開設のために詳細な顧客情報をキャプチャするフォームのある銀行ボットを考えてみましょう。エンティティの値をひとつひとつ指示していくのではなく、フォームを使いたいのです。

セットアップ

ダイアログタスクにおけるダイアログノードのセットアップは、以下の手順で行います。

ノードの追加

ダイアログタスクにフォームノードを追加するためには、以下の手順で行います。

1. ダイアログタスクを開き、フォームノードを追加します。
2. フォームノードを指定された場所に追加します。ノードの追加手順についてはこちらをご参照ください。
3. フォームノードウィンドウは、デフォルトではコンポーネントプロパティタブが選択された状態で表示されます。

ノードの設定

コンポーネントプロパティ

フォームコンポーネントのプロパティでは、一般設定、ユーザー、エラープロンプトを設定できます。

1. コンポーネントプロパティタブの一般設定セクションで、フォームノードの名前と表示名を入力します。ノード名では、スペースを含めることはできません。UIフォームプロパティは、選択したUIフォームに設定され、変更することはできません。
2. プロンプトメッセージテキストボックスに、このフォームでユーザーに表示させたいプロンプトメッセージを入力します。ユーザーがリンクをクリックしてフォームを開始するように説明されています。その中でコーディングされているコンテキスト変数の（フォーム{{context.form_node.formLink}}の）参照を変更することは推奨されません。ユーザープロンプトにチャネル固有のメッセージを入力することができます。詳細情報については、プロンプトエディターの使用をご参照ください。
3. エラーメッセージテキストボックスで、デフォルトのエラーメッセージを見直して、必要に応じて修正します。詳細情報については、プロンプトエディターの使用をご参照ください。
4. メッセージの送信テキストボックスで、フォームを正常に送信した後に表示されるデフォルトのメッセージを見直して、必要に応じて修正します。このメッセージは、UIフォームがブラウザのタブで開かれている場合に限って適用されるもので、Web/モバイルSDKには適用されません。詳細情報については、プロンプトエディターの使用をご参照ください。
5. Web/モバイルSDKフォームの動作セクションにおいては、フォームの表示方法を設定できます。以下のいずれかを選択できます。
   • フルページポップアップフォームを開く – これはデフォルトの設定であり、SDKチャットインターフェイスにおいてフォームがフルページで開きます。
   • インラインフォームを開く – フォームがチャットウィンドウ内のインラインフォームで開きます。
6. 可変ネームスペースセクションにおいて、このノードとその遷移の実行に使用される可変ネームスペースを関連付けます。このオプションは、可変ネームスペースがボットに対して有効になっている場合にのみ表示されます。タスクレベルの設定を使用するか、またはこのノード用にカスタマイズできます。詳細情報は、ネームスペースの管理をご参照ください。

インスタンスプロパティ

インスタンスプロパティを使用して、設定したいユーザータグを定義します。

1. 「フォーム」ウィンドウで、インスタンスプロパティタブをクリックします。
2. カスタム タグセクションにおいて、タグを追加して、ボット会話のカスタムプロファイルを作成します。詳しくはこちらをクリックしてください

接続プロパティ

ノードの接続タブから、次に実行するダイアログタスクのノードを決定できます。条件文は、ダイアログタスク内の任意のエンティティやコンテキストオブジェクトの値に基づいて記述することも、遷移にインテントを使用することもできます。コンポーネント遷移のセットアップは、以下の手順に従います。

1. 「フォーム」ウィンドウで接続タブをクリックします。
2. 接続ルールセクションでは、デフォルトドロップダウンリストからノードを選択できます。
3. 条件付きのフローを設定するには、IFの追加をクリックします。
4. 以下のいずれかの基準に基づいて、条件式を設定します。
   • エンティティ：これらの演算子のいずれかを使用して、ダイアログ内のエンティティノードを特定の値と比較します。存在する、等しい、等しいより大きい、等しいより小さい、等しくない、より大きい、より小さい。それぞれのドロップダウンリストを使用して、エンティティ、演算子を選択し、値ボックスに数値を入力します。例：PassengerCount (エンティティ) は5 (指定値)より大きい(演算子)。
   • コンテキスト：これらの演算子のいずれかを使用して、ダイアログ内のコンテキストオブジェクトを特定の値と比較します。存在する、等しい、等しいより大きい、等しいより小さい、等しくない、より大きい、より小さい。例： Context.entity.PassengerCount （コンテキストオブジェクト）が（演算子）5（指定値）より大きい。
   • インテント：次のユーザーの発話に一致するインテントを選択します。
5. 次へ進むドロップダウンリストから、条件式が成功した場合にダイアログフローで実行する次のノードを選択します。例として、PassengerCount（エンティティ）が5（指定値）より大きい（演算子） 場合、次へ進むオファー（サブダイアログ）になります。
6. その他ドロップダウンリストで、条件が失敗した場合に実行するノードを選択します。
7. 保存をクリックします。

Form node lets you integrate the Digital Forms with Dialog Task. This facilitates the presentation of form to capture user inputs for specific use cases.

The primary purpose of the Form node is to represent a UI Form in the dialog task and make the form available for end-users on their channel. For example, let us consider a banking bot that has a form to capture the customer details to open a new account. You want to use the form instead of prompting for each and every entity value.

Set-Up

Setting up a form node in a dialog task involves the following steps:

Add Node

To add a form node to the dialog task, follow the below steps:

1. Open the dialog task to add the Form node.
2. Add form node in the designated place. For steps in adding nodes, refer here.
3. The Form Node window is displayed with the Component Properties tab selected by default.

Configure Node

Component Properties

The Form Component Properties allow you to configure the General Settings, User, and Error Prompts.

1. On the Component Properties tab, under the General Settings section, enter a Name and Display Name for the form node. Node names cannot have spaces. The UI Form property is set to the UI Form you selected and it cannot be changed.
2. In the Prompt Message text box, enter the prompt message that you want the user to see for this form. It gives instructions to the user to click on the link to initiate the form. It is not recommended to change the context variable reference (of the form {{context.form_node.formLink}})coded therein. You can enter channel-specific messages for user prompts. For more information, refer to Using the Prompt Editor.
3. In the Error Message text box, review the default error message, and if required modify it. For more information, refer to Using the Prompt Editor.
4. In the Submit Message text box, review the default message that is displayed after successful submission of the form, and if required, modify it. This message is applicable only when the UI Form is opened in a browser tab and not for Web/Mobile SDK. For more information, refer to Using the Prompt Editor.
5. Under the Web/Mobile SDK Form Behavior section, you can set how the form is displayed. You can select:
   • Open full page popup form – This is the default setting where the form opens as a full page on the SDK chat interface.
   • Open inline form – The form opens as an inline form within the chat window.
6. In the Variable Namespaces section, associate the variable namespaces used to execute this node and its transitions. This option is visible only when the variable namespace is enabled for the bot. You can go with the task level settings or customize it for this node. For more information, refer to Managing Namespace.

Instance Properties

Use the Instance Properties to define any user tags that you want to set.

1. On the Form window, click the Instance Properties tab.
2. Under the Custom Tags section, add tags to build custom profiles of your bot conversations. Click here for more

Connections Properties

From the node’s Connections tab, you can determine the node in the dialog task to execute next. You can write the conditional statements based on the values of any Entity or Context Objects in the dialog task, or you can use intents for transitions.
To setup Component Transitions, follow the below steps:

1. On the Form window, click the Connections tab.
2. Under the Connection Rules section, you can select a node from the Default drop-down list.
3. To configure a conditional flow, click Add IF.
4. Configure the conditional expression based on one of the following criteria:
   • Entity: Compare an entity node in the dialog with a specific value using one of these operators: Exists, equals to, greater than equals to, less than equals to, not equal to, greater than, and less than. Select the entity, operator using the respective drop-down lists, and type the number in the Value box. For example, PassengerCount (entity) greater than (operator) 5 (specified value).
   • Context: Compare a context object in the dialog with a specific value using one of these operators: Exists, equals to, greater than equals to, less than equals to, not equal to, greater than, and less than. For example, Context. entity.PassengerCount (Context object) greater than (operator) 5 (specified value).
   • Intent: Select an intent that matches the next user utterance.
5. From the Then go to drop-down list, select the next node to execute in the dialog flow if the conditional expression succeeds. For example, if the PassengerCount (entity) greater than (operator) 5 (specified value), Then go to Offers (sub-dialog).
6. In the Else drop-down list, select the node to execute if the condition fails.
7. Click Save.