봇의 일반 설정 수정 방법:.

1. 상단에서 빌드 탭을 선택합니다.
2. 설정 -> 일반 설정을 클릭합니다.

일반 봇 설정

다음 표에 설명된 설정 중 하나 이상을 수정합니다.

필드	설명
봇 이름	봇의 이름입니다. 봇이 게시되면 이름을 변경할 수 없습니다. 이 필드는 필수입니다.
설명	봇의 설명입니다. 이 필드는 필수입니다.
아이콘	이전 그림과 같이 봇 빌더, 봇 마켓플레이스, 최종 사용자 인터페이스에 표시된 봇의 아이콘 이미지입니다. 이미지 형식은 .png여야 하며 200 x 200 픽셀 이미지를 사용하여 최상의 결과를 얻을 수 있습니다. 이 필드는 필수입니다.
이용 대상	봇이 도메인의 관리된 사용자와 관리 해제된 사용자 모두에 대해 일반적으로 사용되는 경우 일반 대중을 선택합니다. 봇 할당은 필요하지 않으며, 봇 관리자가 봇을 배포하는 경우 모든 도메인 사용자가 봇을 사용할 수 있습니다. 이 옵션을 사용하면 모든 사용자 유형이 봇을 광범위하게 사용할 수 있습니다. 봇이 도메인의 관리된 사용자(예: 직원 또는 유료 고객) 전용인 경우 엔터프라이즈 사용자를 선택합니다. 봇 관리자가 이 봇을 승인 및 배포한 후에는 봇 관리자가 명시적으로 할당하지 않는 한 관리된 사용자가 봇을 사용할 수 없습니다. 도메인에서 관리된 사용자가 자신의 장치에서 이 봇에 액세스하고 이를 설정할 수 있도록 제어하려는 경우 이 옵션을 사용합니다. 이용 대상이 정의되고 저장되면 변경할 수 없습니다.
기본 봇 언어	기본 봇 언어는 편집할 수 없으며 봇 생성 시 설정됩니다.
봇 ID	편집할 수 없으며 플랫폼에서 할당합니다. API 호출 등에 사용하기 위해 복사할 수 있습니다.
하위 도메인(테넌시)	예를 클릭하여 테넌시를 사용하도록 설정합니다. 테넌시가 정의되면 최종 사용자에게 봇 URL의 일부로 테넌트 이름을 입력하라는 메시지가 표시됩니다.(예: www.kore.someWebService.com과 같은 테넌트별 URL인 경우 kore) 활성화된 경우 다음 속성을 정의합니다. 도움말 힌트 – 최종 사용자에게 봇에 대한 테넌트별 URL을 입력하라는 메시지를 표시하는 텍스트입니다. 기본 URL – 최종 사용자가 다음 구문을 사용하여 테넌트별 URL을 완성하기 위해 회사를 지정해야 하는 봇의 기본 URL입니다. https://{tenant}.someWebService.com 여기서 {tenant}는 중괄호를 포함하여 테넌트 이름을 나타냅니다.
작업 설정/실행 링크 표시	예를 선택하면 사용자가 사용자 인터페이스 양식에서 작업을 실행하는 데 사용되는 정보를 입력하거나 메시지 입력 필드에 데이터를 직접 입력할 수 있는 링크를 표시합니다.(예: 새 Asana 작업 제목 입력) 편집하려면 여기를 클릭합니다. 여기에서 필드가 있는 양식에 대한 링크를 찾을 수 있습니다. 아니요를 선택하면 메시지 입력 필드에 작업에 대한 정보만 입력할 수 있습니다. 예:새 Asana 작업 제목 입력
오류 메시지	봇에 대한 사용자 정의 HTTP 상태 코드 및 오류 메시지를 편집 또는 추가합니다. 자세한 내용은 사용자 정의 오류 메시지를 참조하세요.

봇 설정을 저장하려면 저장을 클릭합니다 <봇 이름> 성공적으로 업데이트됨 메시지가 표시됩니다.

사용자 정의 오류 메시지

봇 빌더에서 각 봇과 작업에는 HTTP 요청 메소드에 대해 반환된 표준 HTTP 상태 코드를 위한 조치와 함께 사전 정의된 일련의 오류 메시지가 포함되어 있습니다. 대부분의 경우 최종 사용자 응답에 기본 응답 및 조치로 충분하지만 기본적으로 정의되지 않은 다른 HTTP 상태 코드를 처리하거나 오류 메시지 자체를 사용자 정의하거나 오류가 발생할 경우 Kore.ai의 기본 응답을 변경해야 할 수 있습니다. 이 항목은 Kore.ai 봇 및 작업에 대한 오류 메시지를 사용자 정의하고 생성하는 방법을 설명합니다. 봇 또는 작업을 생성할 때 봇 또는 작업 설정의 오류 메시지 섹션에서 HTTP 상태 코드에 대한 오류 메시지를 추가하거나 사용자 정의할 수 있습니다.

사용자 정의 상태 코드

봇 또는 작업에 대해 기본적으로 약 25개의 HTTP 상태 코드가 정의되어 있습니다. HTTP 상태 코드 사용자 정의 방법

1. 봇 빌더에서 봇 또는 작업을 엽니다
2. 상단 메뉴에서 빌드 탭을 선택합니다
3. 왼쪽 메뉴에서 설정 -> 일반 설정을 클릭합니다.
4. 아래로 스크롤하여 오류 메시지 섹션을 찾습니다.
5. 사용자 정의할 코드의 편집 아이콘을 클릭하여 오류 메시지 설정 대화 상자를 엽니다.
6. 메시지 유형 필드에서 다음 중 하나를 선택합니다.
   • 사용자 정의 – 최종 사용자에 대한 오류별 메시지를 정의하는 사용자 정의 메시지를 표시합니다.
   • 소스 – 2XX 범위(성공 메시지) 이외의 HTTP 상태 코드에 대한 JSON 응답 페이로드에서 JSON 경로를 정의할 수 있는 오류 경로 필드를 표시합니다.
7. 조치 필드에서 오류 반복 필드에 정의된 연속 오류 수에 도달하는 경우 수행할 동작을 지정합니다. 다음 중 하나를 선택합니다.
   • 사용 안 함 – 오류가 발생할 때 작업이 비활성으로 설정됩니다. 필요한 경우 최종 사용자가 작업을 활성화할 수 있습니다.
   • 일정 변경 – 오류가 발생할 때 작업을 다시 시도할 경과 시간(분)을 정의하는 데 사용되는 재시도 간격 필드를 표시합니다.
   • 권한 부여 사용 안 함 – 오류가 발생하면 작업에 대해 정의된 권한 부여 메커니즘이 비활성화됩니다. 동일한 권한 부여 메커니즘을 사용하는 다른 작업도 비활성화됩니다.
   • 알림 – 최종 사용자 인터페이스에 오류 메시지를 표시합니다.

   

8. 메세지 필드(기본 메시지에만 사용 가능)에서 최종 사용자에게 표시되는 텍스트 메시지를 입력합니다.
9. 오류 반복 필드에서 작업을 실행하기 전에 반환해야 하는 연속 오류 코드 수를 지정합니다. 기본적으로 오류 반복 필드는 "1"로 설정되어 있습니다.
10. 추가를 클릭하여 사용자 정의 오류 메시지의 설치 오류 메시지 대화 상자를 저장하고 닫습니다.

새 HTTP 상태 코드를 생성하려면 오류 메시지 추가를 클릭하고 이전 섹션에서 설명한 대로 새 코드의 필드를 정의한 다음 추가를 클릭합니다.

ボットの一般的な設定を変更するには、

1. トップメニューから 構築タブを選択します。
2. 設定->一般設定をクリックします。

一般的なボットの設定

次の表に記載されている1つ以上の設定を変更します。

フィールド	説明
ボット名	ボットの名前。ボットが公開されると、名前は変更できません。このフィールドは必要です。
説明	ボットの説明。このフィールドは必要です。
アイコン	前図に見られるように、ボットビルダー、ボットマーケットプレイス、エンドユーザーインターフェースに表示されるボットアイコン画像です。画像形式は.pngであり、200×200ピクセルの画像を使用すると最適な結果が得られます。このフィールドは必要です。
対象ユーザー	一般公開の選択は、ドメイン内の管理対象ユーザーおよび管理非対象のユーザーの両方に対してボットを公開する場合に、実施します。ボット割り当ては必須ではなく、ボット管理者がボットをデプロイした場合、すべてのドメインユーザーはボット使用が可能になります。このオプションの使用は、あらゆるユーザータイプに対してボットが広く利用できるようにするためのものです。 エンタープライズユーザーの選択は、従業員や有料顧客など、ドメイン内の管理対象ユーザーのみを相手とするボットの場合に、実施します。ボット管理者がこのボットを承認およびデプロイした後は、ボット管理者が明示的に割り当てない場合、管理対象ユーザーはこのボットを使用することができません。このオプションは、ドメイン内のどの管理対象ユーザーが自分のデバイスでこのボットにアクセスして設定できるようにするかを制御する場合に、使用します。 一度定義して保存した対象ユーザーは、変更することができません。
デフォルトのボット言語	これは編集不可能であり、ボット作成時に設定されます。
ボットID	編集不可であり、プラットフォームによって割り当てられます。APIコールなどで使用するためにコピーすることができます。
サブドメイン（テナンシー）	はい をクリックすると、テナンシーの使用が有効になります。テナンシーが定義されると、エンドユーザーはボットのURLの一部としてテナント名を入力するよう指示されます。たとえば、koreは、www.kore.someWebService.com tenant-specific URL.の一部として。有効にすると、以下のプロパティを定義します。 ヘルプヒント – ユーザーにボットのテナント固有のURLの入力を指示するためにエンドユーザーに表示されるテキストです。 ベースURL – エンドユーザーが自社を指定して、以下の構文でテナント固有のURLを完成させなければならないボットのベースURL。 https://{tenant}.someWebService.comにおいて {tenant}は中括弧を含めてテナント名を表す。
タスクのセットアップ/実行のためのリンクを表示	はいを選択すると、ユーザーがタスクの実行に使用する情報をユーザーインターフェイスフォームに入力するか、あるいは、メッセージ入力フィールドに直接データを入力するか、などの選択を可能にするリンクが表示されます 。例として、新しいAsanaタスクのタイトルを入力します。編集する場合は こちらクリックします。ここの場合 は、フィールドを持つフォームへのリンクです。 いいえを選択すると、ユーザーはメッセージ入力フィールドにタスクの情報のみを入力することができます。例として、 新しいAsanaタスクのタイトルを入力します.
エラーメッセージ	Myボット用に、カスタムHTTPステータスコードおよびエラーメッセージを編集または追加します。詳細情報については、エラーメッセージのカスタマイズをご覧ください。

ボットの設定を保存するには、保存をクリックします。“<ボット名>は正常に更新されました”というメッセージが表示されます。

エラーメッセージのカスタマイズ

ボットビルダーにおいて、それぞれのボットとタスクには、HTTPリクエストメソッドに返される標準的なHTTPステータスコードに対するアクションに加えて、事前定義済みのエラーメッセージのセットが含まれています。ほとんどの場合、エンドユーザーへの応答はデフォルトの応答とアクションで十分なのですが、デフォルトでは定義されていない他のHTTPステータスコードを扱ったり、エラーメッセージ自体をカスタマイズしたり、エラー発生時のKore.aiによるデフォルトの応答を変更したりする必要があることもあります。このトピックでは、Kore.aiボットとタスクのエラーメッセージをカスタマイズして作成する方法について説明します。ボットまたはタスクを作成する際、ボットまたはタスク設定のエラーメッセージセクションで、HTTPステータスコードのエラーメッセージを追加またはカスタマイズすることができます。

カスタムステータスコード

ボットまたはタスクには、デフォルトで約25種類のHTTPステータスコードが定義されています。HTTPステータスコードをカスタマイズするには、

1. ボットビルダーでボットまたはタスクを開きます。
2. トップメニューから 構築タブを選択します
3. 左側メニューから 設定->一般設定をクリックします。
4. 下にスクロールしてエラーメッセージセクションを探します。
5. カスタマイズするコードの編集アイコンをクリックして、エラーメッセージの設定ダイアログを開きます。
6. メッセージタイプフィールドで、以下のいずれかを選択します。
   • カスタム – エンドユーザー向けのエラー固有のメッセージを定義するためのカスタムメッセージフィールドを表示します。
   • ソース – 2XX範囲のHTTPステータスコード（成功メッセージ）以外のHTTPステータスコードに対するJSON応答のペイロードからのJSONパスを定義することができる、エラーパスフィールドを表示します。
7. アクションフィールドでは、エラーの繰り返しフィールドで定義済みの連続エラー回数に達したときに取るべきアクションを指定します。以下のうちいずれかを選択します。
   • 無効 – タスクは、エラー発生時に 非アクティブに設定されています。エンドユーザーは、必要に応じてタスクをアクティブにすることができます。
   • 再スケジュール – エラーが発生したときにタスクを再試行するまでの経過時間を分単位で定義するための再試行の間隔フィールドを表示します。
   • 認証の無効化 – エラーが発生すると、タスクに定義された認証メカニズムが無効化されます。同じ認証メカニズムを使用している他のタスクも無効化されます。
   • 通知 – エラーメッセージをエンドユーザーインターフェイスに表示します。

   

8. メッセージフィールド（デフォルトのメッセージに対してのみ利用可能）に、エンドユーザー用に表示するテキストメッセージを入力します。
9. エラーの繰り返し フィールドにおいえ、アクションが実行されるまでに返さなければならないエラーコードの連続回数を指定します。デフォルトでは、エラーの繰り返しフィールドは「1」に設定されています。
10. 追加をクリックし、カスタムエラーメッセージを保存してエラーメッセージを設定ダイアログを閉じます。

新しいHTTPステータスコードを作成するには、エラーメッセージを追加をクリックして、前のセクションで説明したように新しいコードのフィールドを定義してから追加をクリックします。

To modify the general settings of a bot:

1. Select the Build tab from the top;
2. Click Configuration -> General Settings.

General Bot Settings

Modify one or more of the settings described in the following table.

Field	Description
Bot Name	The name of the Bot. When a Bot is published, the Name cannot be changed. This field is required.
Description	The description of the Bot. This field is required.
Icon	The icon image for the Bot displayed in Bot Builder, Bots Marketplace, and the end-user interface as shown in the previous illustration. The image format must be .png and best results are obtained using a 200 x 200-pixel image. This field is required.
Target Audience	Select General Public if the bot is for public use for both managed and unmanaged users in your domain. Bot assignments are not required and when the Bots Admin deploys the bot, it is available for use by all domain users. Use this option to make a bot widely available for all user types. Select Enterprise Users if the bot is for managed users only in a domain, for example, for your employees or paid customers. After the Bots Admin approves and deploys this bot, it is not available to any managed users unless explicitly assigned by the Bots Admin. Use this option when you want to control which managed users in your domain can access and set up this bot on their devices. Once Target Audience is defined and saved, you cannot change them.
Default Bot Language	This is uneditable and is set at the time of Bot creation.
Bot Id	Non-editable, assigned by the platform. Can be copied for use in API calls etc..
Subdomain (Tenancy)	Click Yes to enable the use of tenancy. When the tenancy is defined, the end-user is prompted to enter a tenant name as part of the URL for the Bot, for example, kore, for the www.kore.someWebService.com tenant-specific URL. When enabled define the following properties: Help Hint – The text displayed to the end-user to prompt the user to enter a tenant-specific URL for the Bot. Base URL – The base URL for the Bot that the end-user must specify their company to complete the tenant-specific URL using the following syntax: https://{tenant}.someWebService.com where {tenant}, including the braces, represents the tenant name.
Show link for task setup/execution	Select Yes to display a link to enable the choice for a user to input information used to execute a task in a user interface form or input the data directly into the message input field, for example, Enter the title for new Asana task. To make edits, click here. where here is a link to a form with fields. When No is selected, the user can only input information for the task in the message input field. For example, Enter the title for new Asana task.
Error Message(s)	Edit or add custom HTTP Status Codes and error messages for your Bot. For more information, see Customizing Error Messages.

To save the Bot settings, click Save. The < Bot Name > updated successfully message is displayed.

Customizing Error Messages

In Bot Builder, each Bot and task contains a set of predefined error messages along with actions for standard HTTP Status codes returned for an HTTP Request method.

In most cases, the default response and action are sufficient for an end-user response, however, you may need to handle other HTTP Status codes not defined by default, or customize the error message itself, or change the default response by Kore.ai in the event of an error.

This topic describes how to customize and create error messages for Kore.ai Bots and tasks.

When you create a Bot or a task, you can add or customize error messages for HTTP Status codes in the Error Messages section of the Bot or task settings.

Custom Status Codes

There are approximately 25 HTTP Status codes defined by default for a Bot or task.

To customize an HTTP Status code

1. Open the Bot or task in Bot Builder
2. Select Build tab from top menu
3. From the left menu click Configurations -> General Settings
4. Scroll down to locate the Error Messages section.
5. Click the Edit  icon for the code that you want to customize to open the Setup Error Message dialog.
   
6. In the Message Type field, select one of:
   • Custom – Displays a Custom Message field to define an error-specific message for the end-user.
   • Source – Displays the Error Paths field where you can define the JSON path from the JSON response payload for HTTP Status codes other than those in the 2XX range (success messages).
7. In the Action field, specify the action to take when the number of consecutive errors defined in the Error Recurrence field is reached. Select one of:
   • Disable – The task is set to Inactive when the error occurs. The end-user can activate the task when needed.
   • Reschedule – Displays the Retry Interval field used to define the elapsed time in minutes after which to retry the task when the error occurs.
   • Disable Auth – When the error occurs, the authorization mechanism defined for the task is disabled. Any other task that uses the same authorization mechanism is also disabled.
   • Notify – Displays the error message in the end-user interface.

   

8. In the Message field (available only for the default messages), enter the text message displayed to the end-user.
9. In the Error Recurrence field, specify the number of consecutive error codes must be returned before the action is executed. By default, the Error Recurrence field is set to ” 1 “.
10. Click Add to save and close the Setup Error Message dialog for your custom error message.

To create a new HTTP Status code, click Add Error Message, define the fields for your new code as described in the preceding section, and then click Add.