Packages

v4.68でアップデート

パッケージは、フローやレキシコンなどのエージェントのリソースをエクスポートおよびインポートして、他のチームと共有するための便利なツールです。 パッケージを使用すると、あるエージェントから別のエージェントにリソースを転送できます。 パッケージを作成すると、その直接の依存関係が自動的に組み込まれます。 ダウンロードしたら、ポータブルな zip アーカイブとして共有できます。

エージェント全体をエクスポートするスナップショットと比較して、パッケージを使用するとより柔軟に作業できます。 パッケージを使用すると、どのリソースをパッケージに含めるか、パッケージから除外するかを決定できます。

次のエージェント リソースをパッケージに含めることができます。

リソースをパッケージとしてエクスポート

単一のリソースをパッケージとしてエクスポートすることも、多くのリソースを一度にエクスポートすることもできます。

リソースをエクスポートする

次のいずれかのオプションを使用して、1 つのリソースをパッケージとしてエクスポートします。

  • リソースページ経由
  • パッケージページ経由
  1. Cognigy.AI インターフェイスに移動します。
  2. 左側のメニューで、エクスポートするリソースのセクションを選択します。 たとえば、フローをエクスポートする場合は、「フロー」セクションを選択します。
  3. 「リソース」ページで、リストから特定のリソースを選択します。
  4. リソースの右側で、[縦省略記号] > [パッケージとしてエクスポート] をクリックします。 このアクションにより、タスク マネージャーでパッケージの作成タスクがトリガーされます。
  5. 右上隅のタスクメニューをクリックして、パッケージの作成タスクのステータスを確認します。
  6. 作成が完了したら、タスク内のファイル名のリンクをクリックします。 パッケージは自動的にコンピュータにダウンロードされます。
  1. Cognigy.AI インターフェイスに移動します。
  2. 左側のメニューで、[設定] > [パッケージ化] に移動します。
  3. [パッケージ] ページで、リソースに対応するセクションに移動します。 たとえば、フローをエクスポートする場合は、「フロー」セクションに移動します。 簡単に検索するには、検索バーを使用できます。
  4. 選択したリソースの横にあるチェックボックスをオンにして、リストからリソースを選択します。
  5. 「次へ」をクリックします。
  6. 必要に応じて、「パッケージ構成」ページの「パッケージ名」フィールドで既存の名前を編集します。
  7. 「エクスポート」をクリックします。
  8. パッケージの作成が完了するまで待ちます。 プロセスが完了すると、パッケージ名を含む [エクスポートのダウンロード] リンクがページに表示されます。
  9. パッケージ名のリンクをクリックして、パッケージをダウンロードします。 パッケージは自動的にコンピュータにダウンロードされます。
  10. 「やり直す」をクリックして、エクスポートするリソースを選択したページに戻ります。

複数のリソースをエクスポートする

複数のリソースをパッケージとしてエクスポートするには、次の手順に従います。

  1. Cognigy.AI インターフェイスに移動します。
  2. 左側のメニューで、[設定] > [パッケージ化] に移動します。
  3. [パッケージ] ページで、特定のリソースまたはリソース タイプの横にあるチェックボックスをオンにして、リストからリソースを選択します。 たとえば、エージェント内のすべての既存のフローをエクスポートする場合は、フロー リソース タイプを選択します。 あるいは、より大きなリソースのセットをエクスポートする場合は、「エクスポートするリソースを選択」オプションの横にあるチェックボックスをオンにします。 次に、エクスポートしたくないリソースの横にあるチェックボックスをオフにします。
  4. 「次へ」をクリックします。
  5. 必要に応じて、「パッケージ構成」ページの「パッケージ名」フィールドで既存の名前を編集します。
  6. 「エクスポート」をクリックします。
  7. パッケージの作成が完了するまで待ちます。 プロセスが完了すると、パッケージ名を含む [エクスポートのダウンロード] リンクがページに表示されます。
  8. パッケージ名のリンクをクリックして、パッケージをダウンロードします。 パッケージは自動的にコンピュータにダウンロードされます。
  9. 「やり直す」をクリックして、エクスポートするリソースを選択したページに戻ります。

利用可能なすべてのリソースをエクスポートする

利用可能なすべてのリソースをエージェント内のパッケージとしてエクスポートするには、次の手順に従います。

  1. Cognigy.AI インターフェイスに移動します。
  2. 左側のメニューで、[設定] > [パッケージ化] に移動します。
  3. [パッケージ] ページで、[エクスポートするリソースの選択] オプションの横にあるチェックボックスをオンにします。
  4. 「次へ」をクリックします。
  5. 必要に応じて、「パッケージ構成」ページの「パッケージ名」フィールドで既存の名前を編集します。
  6. 「エクスポート」をクリックします。
  7. パッケージの作成が完了するまで待ちます。 プロセスが完了すると、パッケージ名を含む [エクスポートのダウンロード] リンクがページに表示されます。
  8. パッケージ名のリンクをクリックして、パッケージをダウンロードします。 パッケージは自動的にコンピュータにダウンロードされます。
  9. 「やり直す」をクリックして、エクスポートするリソースを選択したページに戻ります。

リソースをパッケージとしてインポートする

インポートする前に、パッケージの互換性を必ず確認してください。 エクスポート プロセスと同様に、インポートするリソースの数を指定できます。 インポート中に、パッケージのリソースが既存のリソースと重複する場合は、競合を解決する必要がある場合があります。

リソースのインポートの詳細は異なる場合があることに注意してください。 たとえば、フローの場合、ロケールをマップする必要があります。

パッケージの互換性を確認する

Cognigy.AI の古いバージョンで作成されたパッケージは、新しいバージョンのプラットフォームに問題なくインポートでき、完全にサポートされています。

ただし、新しいバージョンで作成されたパッケージは古いバージョンと互換性がない可能性があり、サポートされません。

新しいバージョンから古いバージョンの Cognigy.AI にパッケージをインポートすることは、予期しないエラーが発生する可能性があるため推奨されません。

パッケージのインポート

本番環境で使用するためにナレッジ ストアをインポートしないでください

ナレッジを運用プロジェクトにデプロイするためにパッケージを使用しないでください。 これは、インポート プロセスでのナレッジ ストアの置き換え中に、仮想エージェントのナレッジが一時的に利用できなくなる可能性があるためです。

本番パッケージをテンプレートとして使用する: ノード ID

フローとノード間のハードコードされたリンクが壊れないように、インポート時にノード ID は変更されません。 フローを同じプロジェクトに複数回インポートする必要がある場合は、ノードを削除して再作成し、ID の競合を防ぐことができます。

リソースをパッケージとしてインポートするには、次の手順に従います。

  1. Cognigy.AI インターフェイスに移動します。
  2. 左側のメニューで、[設定] > [パッケージ化] に移動します。
  3. [パッケージ] ページで、[ここにパッケージをドロップしてファイルをインポートまたは参照] セクションに移動します。
  4. コンピューター上のフォルダーから、前にエクスポートしたパッケージを選択し、灰色のセクションにドラッグします。 あるいは、「ファイルの参照」ボタンをクリックして、コンピュータ上のフォルダーからパッケージを選択します。
  5. パッケージがロードされるまで待ちます。
  6. [インポートするリソース] セクションで、インポートするリソースを選択します。 新しいパッケージをインポートするエージェント内のリソースの名前と一致するリソースがパッケージに含まれている場合、このステップで競合を解決する必要がある場合があります。 フローを含むパッケージをインポートする場合は、ロケールをマップする必要もあります。
  7. 「エクスポート」をクリックします。
  8. パッケージのインポートが完了したら、「やり直す」をクリックします。

競合を解決する

パッケージのインポート中に発生する競合を解決するには、次の競合戦略を使用します。

  1. 「競合管理」セクションに移動します。
  2. [すべてのリソースの重複処理] から、次のいずれかの戦略を選択します。
    ・コピーとしてインポート — アップロードされたリソースは複製としてインポートされます。 エージェント内の元のリソースは影響を受けず、インポートされたコピーは個別に追加されます。 この方法は、元のバージョンとインポートされたバージョンの両方を保持したい場合に便利です。 ナレッジ ストアをインポートする場合、コピーとしてインポートすることはできないことに注意してください。 インポートされたストアは現在のバージョンを置き換えます。
    ・既存のリソースを置き換える — アップロードされたリソースは既存のリソースを上書きします。 この方法は、既存のリソースを新しいバージョンで更新する場合に便利です。
  3. 「適用」をクリックします。 選択した戦略は、「インポートするリソース」セクション内のすべての既存のリソースに適用されます。
  4. (オプション) 特定のリソースの戦略を変更する場合は、リソースの横にあるリストからこの戦略を選択します。
  5. (オプション) リストからリソースを除外する場合は、リソースの横にあるチェックボックスをオフにします。
  6. 「インポート」をクリックします。 この戦略は、インポート用に選択したリソースにのみ適用されます。

フローのインポート中にロケールをマップする

別個のリソースとしてのロケールは、フローと一緒にインポートされません。 ただし、ノード構成、デフォルトの応答、インテント文などのローカライズされたコンテンツはインポート プロセスに含まれます。

パッケージのロケールは、インポートが行われるエージェントのロケールにマッピングできます。 これは、インポート先のエージェントのロケールがパッケージのロケールを上書きすることを意味します。 この場合、次の戦略をお勧めします。インポートが行われるエージェントで、パッケージ内のロケールと同様のロケールを事前に手動で作成し、パッケージのロケールにマッピングします。

プライマリ ロケールをマップする必要があります。 残りのロケールをインポートしないことも選択できます。

バージョン 4.67 以降では、パッケージの任意のロケールを、パッケージがインポートされるエージェントのプライマリ ロケールにマップできます。

パッケージの非プライマリ ロケールを既存のエージェントのプライマリ ロケールにリンクし、非プライマリ ロケールに完全な構成がない場合、システムは欠落している設定をパッケージのプライマリ ロケールからコピーします。

よくある質問

Q1: ナレッジ ストアのインポート中にエラーが発生した場合はどうすればよいですか?

A1: パッケージを再度アップロードしてみてください。 再アップロード中に、完全にインポートされていないナレッジ ストアのみを選択します。

Q2: ナレッジ ストア パッケージのアップロード中のブラウザ要求のタイムアウトを回避するにはどうすればよいですか?

A2: ブラウザーのリクエストのタイムアウトを回避するには、パッケージのサイズを小さくしてください。 リソースを小さなパッケージに分割します。

詳しくは