はじめに
対話型AIプラットフォーム
チャットボットの概要
自然言語処理(NLP)
ボットの概念と用語
クイックスタートガイド
プラットフォームへのアクセス
ボットビルダーの操作
リリースノート
最新バージョン(英語)
以前のバージョン(英語)
廃止機能(英語)
コンセプト
設計
ストーリーボード
ダイアログタスク
ダイアログタスクとは
ダイアログビルダー
ノードタイプ
インテントノード
ダイアログノード
エンティティノード
フォームノード
確認ノード
ロジックノード
ボットアクションノード
サービスノード
Webhookノード
スクリプトノード
グループノード
エージェント転送ノード
ユーザープロンプト
音声通話プロパティ
イベント ハンドラー
ナレッジグラフ
ナレッジグラフの抽出
ナレッジグラフの構築
ボットにナレッジグラフを追加
グラフの作成
ナレッジグラフの構築
既存のソースからFAQを構築
通知タスク
スモールトーク
デジタルスキル
デジタルフォーム
デジタルビュー
デジタルビューとは
パネル
ウィジェット
トレーニング
トレーニングとは
機械学習
機械学習とは
モデル検証
ファンダメンタルミーニング
ナレッジグラフ
示唆
ランキングおよび解決
NLPの詳細設定
NLPのガイドライン
インテリジェンス
インテリジェンスとは
コンテキスト
コンテキストインテント
割り込み
複数インテントの検出
エンティティの変更
デフォルトの会話
センチメント管理
トーン分析
テストとデバッグ
ボットと会話
発話テスト
バッチテスト
会話テスト
デプロイ
チャネル
公開
分析
ボットの分析
NLPメトリクス
会話フロー
Usage Metrics
封じ込め測定
カスタムダッシュボード
カスタムダッシュボードとは
メタタグ
カスタムダッシュボードとウィジェット
LLM and Generative AI
Introduction
LLM Integration
Kore.ai XO GPT Module
Prompts & Requests Library
Co-Pilot Features
Dynamic Conversations Features
ユニバーサルボット
ユニバーサルボットとは
ユニバーサルボットの定義
ユニバーサルボットの作成
ユニバーサルボットのトレーニング
ユニバーサルボットのカスタマイズ
他言語の有効化
ストア
プラントと使用
Overview
Usage Plans
Support Plans
Invoices
管理
ボット認証
複数言語対応ボット
個人を特定できる情報の編集
ボット変数の使用
IVRのシステム連携
一般設定
ボット管理
ハウツー
会話スキルの設計
バンキングボットを作成
バンキングボット – 資金の振り替え
バンキングボット – 残高を更新
ナレッジグラフを構築
スマートアラートの予約方法
Integrations
Actions
Actions Overview
Asana
Configure
Templates
Azure OpenAI
Configure
Templates
BambooHR
Configure
Templates
Bitly
Configure
Templates
Confluence
Configure
Templates
DHL
Configure
Templates
Freshdesk
Configure
Templates
Freshservice
Configure
Templates
Google Maps
Configure
Templates
Here
Configure
Templates
HubSpot
Configure
Templates
JIRA
Configure
Templates
Microsoft Graph
Configure
Templates
Open AI
Configure
Templates
Salesforce
Configure
Templates
ServiceNow
Configure
Templates
Stripe
Configure
Templates
Shopify
Configure
Templates
Twilio
Configure
Templates
Zendesk
Configure
Templates
Agents
Agent Transfer Overview
Custom (BotKit)
Drift
Genesys
Intercom
NiceInContact
NiceInContact(User Hub)
Salesforce
ServiceNow
Configure Tokyo and Lower versions
Configure Utah and Higher versions
Unblu
External NLU Adapters
Overview
Dialogflow Engine
Test and Debug
デジタルスキルの設計
デジタルフォームの設定方法
デジタルビューの設定方法
データテーブルのデータの追加方法
データテーブルのデータの更新方法
Add Data from Digital Forms
ボットのトレーニング
示唆の使用方法
インテントとエンティティのパターンの使用方法
コンテキスト切り替えの管理方法
ボットのデプロイ
エージェント転送の設定方法
ボット関数の使用方法
コンテンツ変数の使用方法
グローバル変数の使用方法
ボットの分析
カスタムダッシュボードの作成方法
カスタムタグを使ってフィルタリング
Data
Overview
Data Table
Table Views
App Definitions
Data as Service
Build a Travel Planning Assistant
Travel Assistant Overview
Create a Travel Virtual Assistant
Design Conversation Skills
Create an ‘Update Booking’ Task
Create a Change Flight Task
Build a Knowledge Graph
Schedule a Smart Alert
Design Digital Skills
Configure Digital Forms
Configure Digital Views
Train the Assistant
Use Traits
Use Patterns
Manage Context Switching
Deploy the Assistant
Use Bot Functions
Use Content Variables
Use Global Variables
Use Web SDK
Build a Banking Assistant
Migrate External Bots
Google Dialogflow Bot
APIs & SDKs
API Reference
API Introduction
Rate Limits
API List
koreUtil Libraries
SDK Reference
SDK Introduction
Web SDK
How the Web SDK Works
SDK Security
SDK Registration
Web Socket Connect and RTM
Tutorials
Widget SDK Tutorial
Web SDK Tutorial
BotKit SDK
BotKit SDK Deployment Guide
Installing the BotKit SDK
Using the BotKit SDK
SDK Events
SDK Functions
Tutorials
BotKit - Blue Prism
BotKit - Flight Search Sample VA
BotKit - Agent Transfer
  1. ホーム
  2. Docs
  3. Virtual Assistants
  4. Bot Settings
  5. Bot Management
  6. ボット管理

ボット管理

このセクションでは、ボットのインポートとエクスポート、ボットの削除、ボットの変更履歴の確認などについて説明します。

ボット変数とその管理方法を参照するのが良いと思われます。詳細はこちらを参照してください

ボットのインポートとエクスポート

Kore.aiでは、ボットのタスクおよび関連する設定を別のボットにエクスポートおよびインポートすることができます。この機能は、ボット定義の移行、ボットの複製、またはボット定義の定期的なバックアップを維持するのに役立ちます。特に、エンドユーザー向けにボットをリリースする前に、開発プロセスのさまざまな段階で、多様なバージョンのボットをテストすることに役立ちます。このセクションの記事は、“エクスポート”と“インポート”機能の仕組みと実行方法を理解するために役立ちます。メモ:v8.0リリース以降は、“enableNegativePatterns”フラグは、エクスポートとインポートされるボット定義における「NLPデータ」の下にある「NLP設定」に含まれるようになります。このフラグは、ボットにおいてネガティブパターンが有効/無効になっているかどうかをチェックするために使用されます。このパッチを適用する前は、このフラグは、インポートされたボット定義における「NLPデータ」の下の「NLP設定」の一部であり、また、エクスポートされたボット定義における「設定」の下の「ボット設定」の一部でありました。この変更は、機能の効率化を目的としたもので、v8.0以前に作成されたエクスポートファイルからのボットの増分インポートに失敗することもあります。

ボットのエクスポート

エクスポートオプションを用いて、ボットの定義および設定をエクスポートすることができます。ボットをエクスポートすると、以下のようなZIPファイルがダウンロードされます。

  • botDefinition.json:ボットメタデータ、タスク、ボットとタスクレベルの同義語、発話、パターン、ナレッジグラフ、標準応答、フローおよびIDPを含みます。ボットエクスポート時に、ボットタスク、NLPデータ(NLP設定、発話、標準応答)、設定(ボット設定、変数、IVR設定)の中より、エクスポート対象の特定アイテムを選択することができます。
  • config.json:ボット設定、ボット変数、およびIVR設定が含まれます。
  • icon.png:ボットアイコンが含まれます。
  • <カスタムスクリプトファイル名.js>(利用可能な場合):JavaScript機能を持つスクリプトファイルが含まれます。このファイルをボットにアップロードした場合、ボット内のいずれからでもファイル内の機能にアクセスできるようになります。
メモ:ボットとそのコンポーネントには、エクスポート時に固有のレファレンスIDが付与されます。これらのIDは、プラットフォームが対象となるボットの中で一致するタスクを特定し、更新するのに役立ちます。

エクスポートのモード

ボットのエクスポートには、以下の2つのモードがあります。公開済みおよび最新バージョン。選択されたモードに応じて、対応するバージョンのボットタスクがエクスポートされます。どちらのモードでも、ボットのタスク、NLPデータ、ボットの設定から、エクスポートする特定のボットコンポーネントを選択することができます。さらに、個々のボットタスクを選択することもできます。

公開済みモード

公開済みモードでボットをエクスポートすると、既存のバージョンにかかわらず、ボットタスクの公開済みバージョンのみがエクスポートされます。例として、ボットがタスクの公開済みバージョンと進行中のアップグレードバージョンで構成されている場合、公開済みバージョンのみがエクスポートされます。以下の表を参照して、どのバージョンのタスクが公開モードでエクスポートされるかをご確認ください。

タスク ステータス
進行中 タスクが開発進行中で、公開済みモードでエクスポートされない場合、エクスポートされません。
設定済み タスクの設定は完了しているが使用のために未公開で、公開済みモードでエクスポートされない場合、エクスポートされません。
公開済み エクスポートされた公開済みボットタスクは、すべてエクスポートされます。
アップグレード中 エクスポートされていない進行中のタスクアップグレード設定は、エクスポートされません。公開済み設定のみがエクスポートされます。
却下 管理者によって却下されたエクスポートされていないタスク設定は、エクスポートされません。
一時停止 一時停止中のエクスポートされていないタスクは、エクスポートされません。
メモ:ダイアログタスクでは、公開済みステータスのノードのみがエクスポートされます。
最新バージョン

最新モードでボットをエクスポートすると、公開ステータスにかかわらず、ボットタスクの最新バージョンがエクスポートされます。例として、ボットがタスクの公開済みバージョンとアップグレード中のバージョンで構成されている場合、アップグレード中のバージョンがエクスポートされますが、設定済みバージョンだけしかない場合は、設定済みバージョンがエクスポートされます。以下のテーブルを参照して、どのバージョンのタスクが最新モードでエクスポートされるかを理解します。

タスク ステータス
進行中 利用可能な唯一のバージョンである場合は、エクスポートされます 以降のバージョンが存在する場合はエクスポートされません
設定済み 利用可能な唯一のバージョンである場合はエクスポートされます 以降のバージョンが存在する場合はエクスポートされません
公開済み 利用可能な唯一のバージョンである場合はエクスポートされます 以降のバージョンが存在する場合はエクスポートされません
アップグレード中 ボット内の他のタスクのバージョンにかかわらず、エクスポートされます。
却下 管理者によって却下されたエクスポートされていないタスク設定は、エクスポートされません
一時停止 一時停止中のエクスポートされていないタスクは、エクスポートされません

ボットをエクスポートする手順

  1. エクスポートしたいボットを開きます。
  2. トップメニューから デプロイタブを選択します
  3. 左側メニューから、ボット管理->インポート&エクスポートを選択します
  4. インポート&エクスポートページで、エクスポート タブを選択します。
  5. エクスポートタブにおいて、公開済みまたは最新バージョンのいずれかのエクスポートモードを選択します。
  6. デフォルトでは、すべてのボットアイテムがエクスポート向けに選択されています。エクスポートしたくないアイテムの選択を解除します。
  7. タスクについては、さらに選択したタスクのみをエクスポートすることもできます。デフォルトでは、「すべてのタスク」が選択されています。すべてのタスクのリンクをクリックすると、タスクの選択ダイアログが開きますので、エクスポートしたいタスクを選択します。
  8. また、依存タスクを含めるを選択するか、またはエクスポート向けを含めないも、選択できます。これらの存在はインポート前にチェックされ、依存するタスクがない場合はインポートが失敗します。これらの依存タスクには、以下のようなものが含まれます。
    • リンクされたダイアログ(例:別のダイアログの定義に存在するダイアログノード)。
    • ダイアログのいずれかのノードのIVRプロパティの「再試行回数超過時の動作」を定義するときにリンクされたダイアログです。
    • サブインテント/一時停止設定の一部としてリンクされたダイアログ。
    • 依存タスクが含まれていない場合にダイアログの実行が失敗する可能性があるその他のシナリオ。

  9. エクスポートをクリックします。エクスポートはバックグラウンドで行われ、完了後にダウンロードボタンが有効になります。ダウンロードをクリックすると、ファイルがローカルコンピュータにダウンロードされます。

エクスポートされたボットコンポーネント

ボットエクスポート時に、最新モードあるいは公開モードの選択に合わせて、以下のボットコンポーネントがエクスポートされます。

ボットタスク
タスクのみ
  • タスクの定義(アクション、通知、情報、ダイアログ)
  • 同義語(タスク、フィールド、エンティティ)
  • パターン(タスク、フィールド、エンティティ)
ナレッジグラフ ナレッジグラフの定義と、それに関連する同義語およびクラス。
NLPデータ
NLP設定

NLPの詳細設定と除外ワードとフィールドメモリ。NLPの詳細設定(自然言語>詳細設定)には、以下のアイテムがあります。

  • ML発話の自動学習設定
  • 複数のインテント検出設定
  • ~のしきい値と環境設定
  • ファンダメンタルミーニング
  • ナレッジグラフ
  • 機械学習
発話 すべての有効な言語のボットによるすべての発話
標準レスポンス すべての有効な言語でのボットによるすべての標準応答
設定
ボットの設定

ボットの設定画面から以下の情報を確認することができます。

  • 一般設定
  • 有効な言語ごとのボット名、説明、ボットの同義語
  • 言語選択期限(ボットの設定 > 言語管理)
  • ウェルカムメッセージ
  • 一時停止と再開の設定(ボットレベル)
  • カスタムスクリプトファイル
  • テナントURL
  • エラーメッセージ
  • タスクの設定と実行の設定(UIフォームを使用してタスクを実行する場合)。
ボット変数 ボットに存在するすべてのグローバル変数とコンテンツ変数、およびその値。
IVR設定 ボットのすべてのIVR設定(ボットの設定 > IVR設定)。

ボットのインポート

以下のインポートタイプのいずれかを使用して、ボットのタスクや設定を新規または既存のボットにインポートすることができます。

  • 全体インポート:既存のボットを、インポートされたボット構成に置き換えます。インポート定義に存在しない対象ボットの追加構成はすべて削除されます。ただし、Webhookチャネルは例外で、インポートボットの定義に存在しなくても保持されます。
    メモ:このオプションを使用してボットをインポートする前に、対象ボットのバックアップを取ることに十分に留意することを強くお勧めします。
  • 増分インポート:現在のボットを、インポートファイルで利用できる構成でアップグレードします。対象ボットもしくはインポートボットで利用できる追加構成はすべて保持されます。ボットタスク、NLPデータ、およびボット設定からインポートする特定のボットコンポーネントを、選択することができます。増分インポートにおいて、インポートされたボットアイテムが対象ボットアイテムをどのように置き換えるかについては、記事の最後にある増分インポートテーブルのボットアイテムをご参照ください。

開始する前に “config.json”ファイルは、対象ボットに必要な値を持つボット変数で構成されています。ボット定義を新しいボットにインポートする前に、ファイルを関連する開発者と共有するか、あるいは自分で変数に適切な値を入力します。

既存のボットへのインポートの手順

ボットをインポートするには、以下の手順に従います。

  1. エクスポートしたいボットを開きます。
  2. トップメニューから デプロイタブを選択します
  3. 左側メニューから、ボット管理->インポート&エクスポートを選択します
  4. インポート&エクスポートページでインポートタブを選択します。
  5. ボット定義ファイルボット設定ファイルの横にあるファイルの選択ボタンをクリックし、それぞれ“botDefinition.json”と“config.json”のファイルをアップロードします。
  6. インポートされたボットのカスタムスクリプトファイルがあれば、任意でそれをアップロードします。
  7. 次のいずれかのインポートオプションを選択します。全体インポート または増分インポート
  8. 完全インポートを選択した場合、開発中のコピーにあるボットの定義は、インポートファイルにある定義で上書きされます。
    • ボットに1つ以上の追加のタスクや言語がある場合、かつそれらがインポート定義に存在していない場合、これらのタスクは削除済みとしてマークされ、かつボットの公開時に除去されます。
    • インポート後にボットを自動公開するかどうかを選択することができます。

  9. 増分インポートを選択した場合、インポートするボットアイテムを選択することもできます。

    • MLの発話は、追加したり置き換えたりすることができます。
      • “追加”オプションは、ファイルに含まれる発話をボットにインポートする際に使用され、ボット内に存在する追加の発話は保持されます(これはデフォルトの動作です)。
      • “置換”オプションは、ファイルに含まれる発話をボットにインポートする際に使用します。ボット内に存在する追加の発話は削除されます。
        • タスクをインポート中の場合でも、インポート中のタスク関連の追加発話は削除されます。

    • 表示された確認ダイアログで、バックアップをクリックして既存のボットの設定をダウンロードします。
      メモ:バックアップはオプションですが、特に全体インポートを選択した場合は、インポートされたボットがボットの構成を置き換えた後では、ボットの構成を回復することができないため、バックアップを行うことを強くお勧めします。
    • 続行をクリックしてインポートを開始します。
    • インポートが完了すると、次のような成功メッセージが表示されます。完了をクリックします。

メモ:ボットが復元されているにもかかわらず、復元後に公開されていない場合、ボットのインポートに失敗してしまいます。

インポートオプションによる新規ボットの作成

ボットの作成中にボットをインポートするには、以下の手順に従います。

  1. ボットビルダーのホームページの右上にある新規ボット > ボットをインポートをクリックします。
  2. ボットの名前、対象ユーザー、色を入力します。詳細は「新しいボットの作成」をご参照ください。
  3. ボット定義ファイルボット設定ファイルの横にあるファイルの選択ボタンをクリックし、それぞれ botDefinition.json と config.json のファイルをアップロードします。
  4. ソースボットのカスタムスクリプトファイルがあれば、任意でそれをアップロードし、インポートをクリックします。
  5. インポート終了後の完了メッセージで、完了をクリックしてボットタスクのページに進みます。

増分インポートのボットアイテム

コンポーネント 説明
同じ参照IDを持つタスク インポートされたタスクは、ターゲットボットのタスクを置き換え、現在のステータス(一時停止および拒否されたタスクなど)に関わらず、ステータスが「設定済み」に変更されます。
異なる参照IDを持つソースボットのタスク これらのタスクは、同じ参照IDを持つターゲットボットで作成されます。
異なる参照IDを持つターゲットボットのタスク これらのタスクはそのままです。
発話、パターン、タスクレベルの同義語 インポートされた発話、パターン、タスクレベルの同義語は、対象ボットの同義語を置き換え、インポートされたタスクに適用されます。対象ボットの公開済みモデルはそのまま維持されます。
ナレッジグラフ、ボットの同義語、標準応答 対象ボットの既存のナレッジグラフ、ボットの同義語、標準応答は、インポート済みのものに置き換えられます。

ボットの削除

ボットのタスクがいずれも公開済みの場合、ボットの削除はできません。タスクの公開後、ボット管理者はそれを承認してユーザーに割り当てる必要があります。開発者は割り当てられたタスクを削除することはできません。公開されたタスクを削除するには、ボット管理者がタスクを一時停止する必要があります。また、ボットが公開されているフローの一部である場合、ボットを削除することはできません。フローを削除するか、もしくはフローからボットを削除してから削除する必要があります。

ボットを削除する手順

  • 削除したいボットを開きます
  • トップメニューから デプロイタブを選択します
  • 左側のナビゲーションからボット管理メニューの下で、ボットの削除をクリックします。

ボットの変更履歴の確認

ボットの作成後、設定の変更、タスクの追加、チャネルの有効化、フローの追加など、様々な理由で編集が必要になることがあります。ボットに加えられたすべての変更を追跡するために、変更ログを見ることができます。変更ログは、Myボットに対する変更の時系列的なリストを表示します。これは、Myボットを最初に保存してから最後の更新にいたるまでのあらゆる変更内容から構成されています。ボットの変更履歴を表示するには、以下の手順に従います。

  1. トップメニューから、デプロイタブを選択します
  2. 左側メニューから、ボット管理-> 変更ログをクリックします。
    • 逆の時系列順で並べられた変更内容リストで構成されています。
    • 各ページには、直近10件の変更内容と、変更を行ったユーザー名が表示され、続いて変更の概要、および適用された変更のタイムスタンプが表示されます。
    • 公開イベントのログは、選択したすべてのタスク用に統合され、すべてのタスクが公開コメントとともに公開するように選択されていない場合に備えて、タスクがリストアップされます。

ログに対して、以下のアクションを実行することができます。

  • 検索テキストボックスを使用して、任意のテキストを入力することができます。プラットフォームは変更内容の説明でそのテキストを検索し、検索条件を満たすログが表示されます。
  • フィルターオプションを使用して、以下の項目に基づいてフィルタリングすることができます。
    • ボットを共同開発している開発者名。
    • 日付の範囲は、過去24時間、過去7日間、または開始日と終了日を指定したカスタム日付のいずれかです。デフォルトでは、過去24時間のすべての開発者の変更内容が表示されます。
  • エクスポートアイコンでは、変更履歴をCSV形式でエクスポートすることができます。検索条件やフィルター条件を適用して表示されたログがダウンロードされます。

ボット管理

このセクションでは、ボットのインポートとエクスポート、ボットの削除、ボットの変更履歴の確認などについて説明します。

ボット変数とその管理方法を参照するのが良いと思われます。詳細はこちらを参照してください

ボットのインポートとエクスポート

Kore.aiでは、ボットのタスクおよび関連する設定を別のボットにエクスポートおよびインポートすることができます。この機能は、ボット定義の移行、ボットの複製、またはボット定義の定期的なバックアップを維持するのに役立ちます。特に、エンドユーザー向けにボットをリリースする前に、開発プロセスのさまざまな段階で、多様なバージョンのボットをテストすることに役立ちます。このセクションの記事は、“エクスポート”と“インポート”機能の仕組みと実行方法を理解するために役立ちます。メモ:v8.0リリース以降は、“enableNegativePatterns”フラグは、エクスポートとインポートされるボット定義における「NLPデータ」の下にある「NLP設定」に含まれるようになります。このフラグは、ボットにおいてネガティブパターンが有効/無効になっているかどうかをチェックするために使用されます。このパッチを適用する前は、このフラグは、インポートされたボット定義における「NLPデータ」の下の「NLP設定」の一部であり、また、エクスポートされたボット定義における「設定」の下の「ボット設定」の一部でありました。この変更は、機能の効率化を目的としたもので、v8.0以前に作成されたエクスポートファイルからのボットの増分インポートに失敗することもあります。

ボットのエクスポート

エクスポートオプションを用いて、ボットの定義および設定をエクスポートすることができます。ボットをエクスポートすると、以下のようなZIPファイルがダウンロードされます。

  • botDefinition.json:ボットメタデータ、タスク、ボットとタスクレベルの同義語、発話、パターン、ナレッジグラフ、標準応答、フローおよびIDPを含みます。ボットエクスポート時に、ボットタスク、NLPデータ(NLP設定、発話、標準応答)、設定(ボット設定、変数、IVR設定)の中より、エクスポート対象の特定アイテムを選択することができます。
  • config.json:ボット設定、ボット変数、およびIVR設定が含まれます。
  • icon.png:ボットアイコンが含まれます。
  • <カスタムスクリプトファイル名.js>(利用可能な場合):JavaScript機能を持つスクリプトファイルが含まれます。このファイルをボットにアップロードした場合、ボット内のいずれからでもファイル内の機能にアクセスできるようになります。
メモ:ボットとそのコンポーネントには、エクスポート時に固有のレファレンスIDが付与されます。これらのIDは、プラットフォームが対象となるボットの中で一致するタスクを特定し、更新するのに役立ちます。

エクスポートのモード

ボットのエクスポートには、以下の2つのモードがあります。公開済みおよび最新バージョン。選択されたモードに応じて、対応するバージョンのボットタスクがエクスポートされます。どちらのモードでも、ボットのタスク、NLPデータ、ボットの設定から、エクスポートする特定のボットコンポーネントを選択することができます。さらに、個々のボットタスクを選択することもできます。

公開済みモード

公開済みモードでボットをエクスポートすると、既存のバージョンにかかわらず、ボットタスクの公開済みバージョンのみがエクスポートされます。例として、ボットがタスクの公開済みバージョンと進行中のアップグレードバージョンで構成されている場合、公開済みバージョンのみがエクスポートされます。以下の表を参照して、どのバージョンのタスクが公開モードでエクスポートされるかをご確認ください。

タスク ステータス
進行中 タスクが開発進行中で、公開済みモードでエクスポートされない場合、エクスポートされません。
設定済み タスクの設定は完了しているが使用のために未公開で、公開済みモードでエクスポートされない場合、エクスポートされません。
公開済み エクスポートされた公開済みボットタスクは、すべてエクスポートされます。
アップグレード中 エクスポートされていない進行中のタスクアップグレード設定は、エクスポートされません。公開済み設定のみがエクスポートされます。
却下 管理者によって却下されたエクスポートされていないタスク設定は、エクスポートされません。
一時停止 一時停止中のエクスポートされていないタスクは、エクスポートされません。
メモ:ダイアログタスクでは、公開済みステータスのノードのみがエクスポートされます。
最新バージョン

最新モードでボットをエクスポートすると、公開ステータスにかかわらず、ボットタスクの最新バージョンがエクスポートされます。例として、ボットがタスクの公開済みバージョンとアップグレード中のバージョンで構成されている場合、アップグレード中のバージョンがエクスポートされますが、設定済みバージョンだけしかない場合は、設定済みバージョンがエクスポートされます。以下のテーブルを参照して、どのバージョンのタスクが最新モードでエクスポートされるかを理解します。

タスク ステータス
進行中 利用可能な唯一のバージョンである場合は、エクスポートされます 以降のバージョンが存在する場合はエクスポートされません
設定済み 利用可能な唯一のバージョンである場合はエクスポートされます 以降のバージョンが存在する場合はエクスポートされません
公開済み 利用可能な唯一のバージョンである場合はエクスポートされます 以降のバージョンが存在する場合はエクスポートされません
アップグレード中 ボット内の他のタスクのバージョンにかかわらず、エクスポートされます。
却下 管理者によって却下されたエクスポートされていないタスク設定は、エクスポートされません
一時停止 一時停止中のエクスポートされていないタスクは、エクスポートされません

ボットをエクスポートする手順

  1. エクスポートしたいボットを開きます。
  2. トップメニューから デプロイタブを選択します
  3. 左側メニューから、ボット管理->インポート&エクスポートを選択します
  4. インポート&エクスポートページで、エクスポート タブを選択します。
  5. エクスポートタブにおいて、公開済みまたは最新バージョンのいずれかのエクスポートモードを選択します。
  6. デフォルトでは、すべてのボットアイテムがエクスポート向けに選択されています。エクスポートしたくないアイテムの選択を解除します。
  7. タスクについては、さらに選択したタスクのみをエクスポートすることもできます。デフォルトでは、「すべてのタスク」が選択されています。すべてのタスクのリンクをクリックすると、タスクの選択ダイアログが開きますので、エクスポートしたいタスクを選択します。
  8. また、依存タスクを含めるを選択するか、またはエクスポート向けを含めないも、選択できます。これらの存在はインポート前にチェックされ、依存するタスクがない場合はインポートが失敗します。これらの依存タスクには、以下のようなものが含まれます。
    • リンクされたダイアログ(例:別のダイアログの定義に存在するダイアログノード)。
    • ダイアログのいずれかのノードのIVRプロパティの「再試行回数超過時の動作」を定義するときにリンクされたダイアログです。
    • サブインテント/一時停止設定の一部としてリンクされたダイアログ。
    • 依存タスクが含まれていない場合にダイアログの実行が失敗する可能性があるその他のシナリオ。

  9. エクスポートをクリックします。エクスポートはバックグラウンドで行われ、完了後にダウンロードボタンが有効になります。ダウンロードをクリックすると、ファイルがローカルコンピュータにダウンロードされます。

エクスポートされたボットコンポーネント

ボットエクスポート時に、最新モードあるいは公開モードの選択に合わせて、以下のボットコンポーネントがエクスポートされます。

ボットタスク
タスクのみ
  • タスクの定義(アクション、通知、情報、ダイアログ)
  • 同義語(タスク、フィールド、エンティティ)
  • パターン(タスク、フィールド、エンティティ)
ナレッジグラフ ナレッジグラフの定義と、それに関連する同義語およびクラス。
NLPデータ
NLP設定

NLPの詳細設定と除外ワードとフィールドメモリ。NLPの詳細設定(自然言語>詳細設定)には、以下のアイテムがあります。

  • ML発話の自動学習設定
  • 複数のインテント検出設定
  • ~のしきい値と環境設定
  • ファンダメンタルミーニング
  • ナレッジグラフ
  • 機械学習
発話 すべての有効な言語のボットによるすべての発話
標準レスポンス すべての有効な言語でのボットによるすべての標準応答
設定
ボットの設定

ボットの設定画面から以下の情報を確認することができます。

  • 一般設定
  • 有効な言語ごとのボット名、説明、ボットの同義語
  • 言語選択期限(ボットの設定 > 言語管理)
  • ウェルカムメッセージ
  • 一時停止と再開の設定(ボットレベル)
  • カスタムスクリプトファイル
  • テナントURL
  • エラーメッセージ
  • タスクの設定と実行の設定(UIフォームを使用してタスクを実行する場合)。
ボット変数 ボットに存在するすべてのグローバル変数とコンテンツ変数、およびその値。
IVR設定 ボットのすべてのIVR設定(ボットの設定 > IVR設定)。

ボットのインポート

以下のインポートタイプのいずれかを使用して、ボットのタスクや設定を新規または既存のボットにインポートすることができます。

  • 全体インポート:既存のボットを、インポートされたボット構成に置き換えます。インポート定義に存在しない対象ボットの追加構成はすべて削除されます。ただし、Webhookチャネルは例外で、インポートボットの定義に存在しなくても保持されます。
    メモ:このオプションを使用してボットをインポートする前に、対象ボットのバックアップを取ることに十分に留意することを強くお勧めします。
  • 増分インポート:現在のボットを、インポートファイルで利用できる構成でアップグレードします。対象ボットもしくはインポートボットで利用できる追加構成はすべて保持されます。ボットタスク、NLPデータ、およびボット設定からインポートする特定のボットコンポーネントを、選択することができます。増分インポートにおいて、インポートされたボットアイテムが対象ボットアイテムをどのように置き換えるかについては、記事の最後にある増分インポートテーブルのボットアイテムをご参照ください。

開始する前に “config.json”ファイルは、対象ボットに必要な値を持つボット変数で構成されています。ボット定義を新しいボットにインポートする前に、ファイルを関連する開発者と共有するか、あるいは自分で変数に適切な値を入力します。

既存のボットへのインポートの手順

ボットをインポートするには、以下の手順に従います。

  1. エクスポートしたいボットを開きます。
  2. トップメニューから デプロイタブを選択します
  3. 左側メニューから、ボット管理->インポート&エクスポートを選択します
  4. インポート&エクスポートページでインポートタブを選択します。
  5. ボット定義ファイルボット設定ファイルの横にあるファイルの選択ボタンをクリックし、それぞれ“botDefinition.json”と“config.json”のファイルをアップロードします。
  6. インポートされたボットのカスタムスクリプトファイルがあれば、任意でそれをアップロードします。
  7. 次のいずれかのインポートオプションを選択します。全体インポート または増分インポート
  8. 完全インポートを選択した場合、開発中のコピーにあるボットの定義は、インポートファイルにある定義で上書きされます。
    • ボットに1つ以上の追加のタスクや言語がある場合、かつそれらがインポート定義に存在していない場合、これらのタスクは削除済みとしてマークされ、かつボットの公開時に除去されます。
    • インポート後にボットを自動公開するかどうかを選択することができます。

  9. 増分インポートを選択した場合、インポートするボットアイテムを選択することもできます。

    • MLの発話は、追加したり置き換えたりすることができます。
      • “追加”オプションは、ファイルに含まれる発話をボットにインポートする際に使用され、ボット内に存在する追加の発話は保持されます(これはデフォルトの動作です)。
      • “置換”オプションは、ファイルに含まれる発話をボットにインポートする際に使用します。ボット内に存在する追加の発話は削除されます。
        • タスクをインポート中の場合でも、インポート中のタスク関連の追加発話は削除されます。

    • 表示された確認ダイアログで、バックアップをクリックして既存のボットの設定をダウンロードします。
      メモ:バックアップはオプションですが、特に全体インポートを選択した場合は、インポートされたボットがボットの構成を置き換えた後では、ボットの構成を回復することができないため、バックアップを行うことを強くお勧めします。
    • 続行をクリックしてインポートを開始します。
    • インポートが完了すると、次のような成功メッセージが表示されます。完了をクリックします。

メモ:ボットが復元されているにもかかわらず、復元後に公開されていない場合、ボットのインポートに失敗してしまいます。

インポートオプションによる新規ボットの作成

ボットの作成中にボットをインポートするには、以下の手順に従います。

  1. ボットビルダーのホームページの右上にある新規ボット > ボットをインポートをクリックします。
  2. ボットの名前、対象ユーザー、色を入力します。詳細は「新しいボットの作成」をご参照ください。
  3. ボット定義ファイルボット設定ファイルの横にあるファイルの選択ボタンをクリックし、それぞれ botDefinition.json と config.json のファイルをアップロードします。
  4. ソースボットのカスタムスクリプトファイルがあれば、任意でそれをアップロードし、インポートをクリックします。
  5. インポート終了後の完了メッセージで、完了をクリックしてボットタスクのページに進みます。

増分インポートのボットアイテム

コンポーネント 説明
同じ参照IDを持つタスク インポートされたタスクは、ターゲットボットのタスクを置き換え、現在のステータス(一時停止および拒否されたタスクなど)に関わらず、ステータスが「設定済み」に変更されます。
異なる参照IDを持つソースボットのタスク これらのタスクは、同じ参照IDを持つターゲットボットで作成されます。
異なる参照IDを持つターゲットボットのタスク これらのタスクはそのままです。
発話、パターン、タスクレベルの同義語 インポートされた発話、パターン、タスクレベルの同義語は、対象ボットの同義語を置き換え、インポートされたタスクに適用されます。対象ボットの公開済みモデルはそのまま維持されます。
ナレッジグラフ、ボットの同義語、標準応答 対象ボットの既存のナレッジグラフ、ボットの同義語、標準応答は、インポート済みのものに置き換えられます。

ボットの削除

ボットのタスクがいずれも公開済みの場合、ボットの削除はできません。タスクの公開後、ボット管理者はそれを承認してユーザーに割り当てる必要があります。開発者は割り当てられたタスクを削除することはできません。公開されたタスクを削除するには、ボット管理者がタスクを一時停止する必要があります。また、ボットが公開されているフローの一部である場合、ボットを削除することはできません。フローを削除するか、もしくはフローからボットを削除してから削除する必要があります。

ボットを削除する手順

  • 削除したいボットを開きます
  • トップメニューから デプロイタブを選択します
  • 左側のナビゲーションからボット管理メニューの下で、ボットの削除をクリックします。

ボットの変更履歴の確認

ボットの作成後、設定の変更、タスクの追加、チャネルの有効化、フローの追加など、様々な理由で編集が必要になることがあります。ボットに加えられたすべての変更を追跡するために、変更ログを見ることができます。変更ログは、Myボットに対する変更の時系列的なリストを表示します。これは、Myボットを最初に保存してから最後の更新にいたるまでのあらゆる変更内容から構成されています。ボットの変更履歴を表示するには、以下の手順に従います。

  1. トップメニューから、デプロイタブを選択します
  2. 左側メニューから、ボット管理-> 変更ログをクリックします。
    • 逆の時系列順で並べられた変更内容リストで構成されています。
    • 各ページには、直近10件の変更内容と、変更を行ったユーザー名が表示され、続いて変更の概要、および適用された変更のタイムスタンプが表示されます。
    • 公開イベントのログは、選択したすべてのタスク用に統合され、すべてのタスクが公開コメントとともに公開するように選択されていない場合に備えて、タスクがリストアップされます。

ログに対して、以下のアクションを実行することができます。

  • 検索テキストボックスを使用して、任意のテキストを入力することができます。プラットフォームは変更内容の説明でそのテキストを検索し、検索条件を満たすログが表示されます。
  • フィルターオプションを使用して、以下の項目に基づいてフィルタリングすることができます。
    • ボットを共同開発している開発者名。
    • 日付の範囲は、過去24時間、過去7日間、または開始日と終了日を指定したカスタム日付のいずれかです。デフォルトでは、過去24時間のすべての開発者の変更内容が表示されます。
  • エクスポートアイコンでは、変更履歴をCSV形式でエクスポートすることができます。検索条件やフィルター条件を適用して表示されたログがダウンロードされます。
メニュー