Management UI

はじめに

Cognigy Management UIは、元々Cognigy社内で自社のクラウドインストールを管理するツールとして開発された追加製品です。ご利用になるには、実際の製品に追加でインストールしていただく必要があります。

オンプレミスのCognigy.AIをインストールしている場合は、Management UIを自分でセットアップすることができます。そうでない場合、Management UIを変更したい場合は、テクニカルサポートにお問い合わせください。

多くのユーザーはCognigy.AIがマルチテナントシナリオを処理できることをご存じないかと思います。これらの個々のテナントはCognigy.AI内で組織と呼ばれます。

組織は完全に切り離されています：

• projects（プロジェクト）
• users（ユーザー）
• api- access and -keys（APIアクセスとAPIキー）
• contact profile schemas（コンタクトプロファイルスキーマ）
• quotas & limits（クォータと制限）

組織を使用することで、例えば複数のお客様に独自のCognigy.AIインストールを使用し、安全な方法でデータを分離することができます。新しい組織は特別な内部APIを使用して作成することができますが、当社はCognigy Management UIと呼ばれる追加ツールを作成しました。これはクラスタにデプロイできる追加製品です。このツールを使用してインストールに接続し、システム内のすべての組織などを検査できます。

下図はこの製品がどのように見えるかのイメージ画像です。

使用方法

Management UIの使い方は非常に簡単です。左側にグローバルナビゲーションがあり、次のように切り替えることができます： – ユーザー – 組織 – システムメッセージ

次に、個々のビューとそこでできることを見てみましょう。

ユーザー

ここでは、システムに新しいユーザーを追加することができます。ユーザーを組織に割り当てる必要がありますので、最初に新しい組織を作成する必要があります。新規ユーザーを作成するには、ビューの右下にある大きなピンクのボタンをクリックしてください。ダイアログが表示されますので、以下の項目を入力してください：

• 名前
• メールアドレス
• 組織の選択

v4.16.0で追加

複数の組織にユーザー（メールアドレスで識別）を追加することができます。ユーザーがどのように組織にログインできるかは、複数組織のユーザーのログインページで確認できます。

既存のユーザーのいずれかをクリックすると、詳細ページが開き、そのユーザーに関する特定の情報が表示されます。ここでできる最も重要なことは以下のとおりです：

• 一般的な情報を見る
• ユーザーの現在のロールを確認する
• status情報を確認する
• ユーザーをなりすます。これにより実際の製品に転送され、選択されたユーザーであるかのようにログインします。
• ユーザーの追加アクションは、右上の三点アイコンの中にあります。

組織

このビューには、システム内に存在するすべての組織が表示されます。インストールごとに、少なくとも1つの組織が自動的に作成されます。この初期組織はdefaultOrg-xxxと呼ばれます。以下の図をご覧ください。

新しい組織を作成したり、既存の組織を無効にすることもできます。

システムメッセージ

Cognigy.AIをインストールしている場合、一定の時点でメンテナンスをスケジュールしたくなる場合があります。このような場合、システムメッセージ機能をご利用ください。左側のナビゲーションでシステムメッセージを選択し、ピンクのボタンをクリックして新しいシステムメッセージを作成してください。

一度に存在できるシステムメッセージは1つだけです。このようなメッセージには実際のメッセージテキストと有効期限があります。メッセージが有効である限り、メッセージはすべてのUIクライアントに表示されます。有効期限が切れると、メッセージは自動的に消滅します。

システムメッセージは組織に関係なく、すべてのユーザーに表示されます。

クォータと制限

Cognigy.AIのバージョン3.4.0では、組織レベルでのクォータと制限を導入しました。複数の組織を持つ大規模なお客様は、これらのクォータを使用して特定の組織内で可能なことを制限できます。制限を設定するには、まず組織を選択し、その詳細を開いて右上の三点ボタンをクリックします。

メニューから[Change Organisation Quotas(組織クォータの変更)]を選択します。

現在、以下のクォータと制限を設定できます：

属性	説明
Max users（最大ユーザ-数）	組織内で作成できるユーザーの最大数。
Max projects（最大プロジェクト数）	この組織内で作成できるプロジェクトの最大数。
Max channels per project（1プロジェクトあたりの最大チャネル数）	1つのプロジェクト内にある、異なるタイプのチャネルの最大数。チャネルとは、例えばAlexa-Endpointのことです。これが例えば1に設定されている場合、Alexa Endpointを無限に作成できますが、Google Actions Endpointを追加で作成しようとするとエラーになります。制限されるのは、チャネルの種類の数です。
Max messages per day（1日あたりの最大メッセージ数）	現在のところ、これはソフトな制限であり、プロジェクトがこれを超えても何も行われません。今後、このクォータの変更を導入する予定です。

クォータを0に設定すると、クォータは無効になります。

パスワードポリシー

Management UI で組織のパスワードポリシーを設定することも可能です。パスワードポリシーを設定するには、まず組織を選択し、右上の三点ボタンをクリックします。

メニューで、[Change Password Policy(パスワードポリシーの変更)]を選択します。

現在、パスワードポリシーの以下の属性を設定できます：

属性	説明
Minimum Length（最小文字数）	パスワードに必要な最小文字数。
Maximum Length（最大文字数）	パスワードの最大文字数。
Minimum Amount of Lowercase（小文字の最小文字数）	小文字でなければならないパスワードの最小文字数。
Minimum Amount of Uppercase（大文字の最小文字数）	大文字でなければならないパスワードの最小文字数。
Minimum Amount of Special Characters（特殊文字の最小文字数）	パスワードに含まれる特殊文字の最小文字数。
Maximum Amount of Identical Characters（同一文字の最大文字数）	パスワードに使用できる同じ文字の最大文字数。
Amount of failed logins resulting in account disabling（ログインに失敗し、アカウントが無効になった回数）	アカウントが無効になるまでに何回ログインを試みることができるかを指定します。これを0に設定すると、アカウントが無効になることはありません。無効化されたユーザーは、Management UIで再度有効にすることができます。

Save & Enforce（ 保存して実行 ）ボタンをクリックすると、その組織のすべてのユーザーがログアウトします。再ログインすると、パスワードを変更する必要があります。

データプライバシー設定

v4.38.0で追加

Management UIで組織のデータプライバシー設定を行うことができます。データプライバシー設定を行うには、まず組織を選択し、右上の三点ボタンをクリックします。

メニューで[Change Data Privacy Settings(データプライバシー設定の変更)]を選択します。

・データプライバシー設定を有効にする

この組織のすべてのプロジェクトにデータプライバシー設定を適用します

・コンタクトプロファイル

個別のコンタクトプロファイルを作成し、セッションをまたいでユーザーデータを保存します。

・分析データの収集

すべてのエンドポイントの分析データを収集します。

・機密分析データのマスク

すべてのエンドポイントの機密分析データをマスクします。

・機密ロギングのマスク

すべてのエンドポイントのすべての機密ログをマスクします。

・トークの収集

すべてのエンドポイントのトーク履歴を収集します。

・リストを無視

プロジェクトは組織のデータプライバシー設定を無視し、エンドポイントで定義されたものを使用します。

機密データの有効期限（TTL）

特定の機密データの有効期限を設定し、システムから削除することができます。これを変更するには、まず組織を選択し、右上隅の三点ボタンをクリックします。

メニューで[Change Expiration Values(有効期限値の変更)]を選択します。

すべての有効期限値は、データが作成されてから有効期限が切れるまで何分かかるかを定義します。有効期限値を0に設定すると、データが期限切れになることはありません。以下のデータの有効期限を設定できます

有効期限の値	説明
Contact Profiles Expiration（コンタクトプロファイルの有効期限）	コンタクトプロファイルがトークで最後にアクティブになってから削除されるまでの分数を決定します。
Session Expiration（セッションの有効期限）	セッションの最後のメッセージが送信されてからセッションが削除されるまでの分数を決定します。つまり、セッション内の新しいメッセージが送信されるたびに、有効期限タイマーはリセットされます。一部のエンドポイントでは、個々のエンドポイントでセッションの有効期限を設定することもできます。そこでも値が設定されている場合、最も小さい値が使用されます。
Conversation Expiration（トークの有効期限）	トークが作成されてからデータベースから削除されるまでの分数を決定します。
Analytics Expiration（分析データの有効期限）	分析データが作成されてからデータベースから削除されるまでの分数を決定します。
Insight’s Session Data Expiration（Insightのセッションデータの有効期限）	Insightのセッションのデータが作成されてから、データベースから削除されるまでの分数を決定します。
Steps Data Expiration（ステップデータの有効期限）	ステップデータが作成されてからデータベースから削除されるまでの分数を決定します。

Insightsのデータ有効期限に関する詳細は、Insightsドキュメントの[Data Expiration(データの有効期限)]をご覧ください。

また、上記のすべての機密データについて、サーバー全体の最大有効期限を設定することも可能です。これは、インストール時にお客様に提供される基本ドキュメントに記載されています。

インストール

Cognigy Management UIのインストールに関する詳細情報は、GitHubページでご覧いただくか、Cognigyの営業担当者にお問い合わせいただくか、info@cognigy.comまでお問い合わせください。