有料プランの機能

以下の機能は、Plusプラン以上のユーザーのみご利用いただけます。 プラス

• 電話統合機能
• プライベート・エンドポイント
• 検索
• watsonx Assistant v2 API
• ログ Webhook

v2 Logs API は、プラス・プランの無料試用版で使用できます。

以下の機能は、エンタープライズ・プランのユーザーのみが使用できます。 Enterprise

• アクティビティー・トラッキング
• 複数環境
• 応答モードのシステム・デフォルトのオーバーライド
• セグメントへのイベントの送信

現在使用しているサービス・インスタンスのプラン・タイプが、ページ・ヘッダーに表示されます。 あるプラン・タイプから別のプラン・タイプにアップグレードできます。 詳しくは、アップグレードを参照してください。

ユーザー・ベースのプランの説明

1 カ月の間に行われた API 呼び出しの数によって使用量を測定する API ベースのプランとは異なり、プラス・プランとエンタープライズ・プランは、月次アクティブ・ユーザーの数によって使用量を測定します。

月間アクティブユーザー（MAU）とは、該当月の暦上の期間に、貴社のアシスタントまたはカスタムアプリケーションと少なくとも1回はやりとりしたユニークユーザーを指します。

固有のユーザーを認識するために、アシスタントと対話する個人に関連付けられているユーザー ID が使用されます。 このプロパティーは、Web チャットや他の組み込み統合によって自動的に設定されます。

IBM Cloud と IBM Cloud Pak for Dataの両方について、自分で MAU を計算できます。 MAU を計算するには、 logs エンドポイントを使用して会話をエクスポートします。 特定の月について、結果で検出された固有のユーザー ID の数をカウントします。 1 カ月に 50 個を超えるメッセージ (API 呼び出し) を持つユーザー ID は、50 個のメッセージごとに複数回カウントされます。 各ユーザー ID がアシスタントと会話する顧客を表す一般的なユース・ケースでは、通常、ユーザー当たりの平均メッセージ数は 50 メッセージ未満であるため、1 つのユーザー ID を複数回カウントすることは一般的ではありません。

REST API を使用してユーザー ID を指定

watsonx Assistant API でカスタム・クライアントを使用する場合は、user_id プロパティーを、クライアントが message メソッドに送信するメッセージ・ペイロードにおいて設定する必要があります。 user_id プロパティーは、以下の例にあるように要求本体のルートで指定されます。

{
  "input": {
    "message_type": "text",
    "text": "I want to cancel my order"
  },
  "user_id": "my_user_id"
}

一部の古い SDK バージョンでは、user_id プロパティーは最上位のメソッド・パラメーターとしてはサポートされていません。 代わりに、user_id を、ネストされた context.global.system オブジェクト内で指定できます。

user_id プロパティーについて詳しくは、以下の API リファレンス資料を参照してください。

• v2 ステートレス /message
• v2 ステートフル /message

ユーザー ID が指定されていない場合

カスタム・クライアント・アプリケーションを使用していて、user_id 値を設定していない場合、サービスは自動的に以下のいずれかの値に設定します。

• session_id (v2 API のみ): ユーザーとアシスタントの間の単一の会話を識別する、v2 API で定義されるプロパティー。 セッション ID は、組み込み統合によって生成される /message API 呼び出しで提供されます。 セッションは、ユーザーがチャット・ウィンドウを閉じるか、または非アクティブの時間制限に到達した場合に終了します。

  ステートレスな v2 message APIを使用する場合は、進行中の会話のすべてのメッセージに session_id を (context.global.session_id で) 指定する必要があります。

• **conversation_id v1 ** のみ ): v1定義されたプロパティで、 /message API コールのコンテキストオブジェクトに格納されます。 このプロパティーを使用して、1 名のユーザーとの単一の会話型のやり取りに関連付けられている複数の /message API 呼び出しを識別できます。 ただし、同じ ID は、その ID を明示的に保持し、同じ会話の一部として作成された各要求とともに渡した場合にのみ使用されます。 それ以外の場合は、新しい /message API 呼び出しごとに新しい ID が生成されます。

同じ人物が同じ課金期間中に3回にわたってアシスタントとチャットした場合、そのユーザーをAPIコールでどのように表現するかによって、インタラクションの課金方法が異なります。 ユーザー対話を user_id で識別していた場合は、1 回の使用としてカウントされます。 session_id とのユーザーのやりとりを特定した場合、各やりとりごとに個別のセッションが作成されるため、3回の使用とカウントされます。

すべてのカスタム・アプリケーションを、固有の user_id または session_id をキャプチャーしてその情報を watsonx Assistant に渡すように設計してください。 顧客のライフサイクルを通して変化することがない、個人を特定できない ID を選択してください。 例えば、個人の E メール・アドレスをユーザー ID として使用したりしないでください。 実際、 user_id の構文は 、RFC 7230 で定義されているヘッダーフィールドの要件を満たさなければなりません。

組み込みの統合では、以下の方法でユーザー ID が取得されます。

• Facebook 統合では、user_id プロパティーは、Facebook がペイロードに入れて提供する送信者 ID に設定されます。
• Slack 統合では、user_id プロパティーは、T09LVDR7Y などのチーム ID と W4F8K9JNF などのユーザーのメンバー ID を連結したものです。 例えば、T09LVDR7YW4F8K9JNFです。
• Web チャットでは、user_id プロパティーの値を設定できます。

課金は、サービス・インスタンスごとに月別アクティブ・ユーザーの単位で管理されます。 単一のユーザーが、同じプランに属するさまざまなサービス・インスタンスでホストされているアシスタントと対話する場合は、各対話が別個の使用として扱われます。 そのユーザーのサービス・インスタンスとの対話は、サービス・インスタンスごとに別々に課金されます。

匿名ユーザーの扱い

カスタムのアプリケーションまたはアシスタントが匿名のユーザーと対話する場合は、ランダムな汎用一意識別子を生成して各匿名ユーザーを表すことができます。 UUIDの詳細については 、RFC 4122 を参照してください。

• Web チャットの場合、セッションの開始時にユーザーの ID を渡さなければ、Web チャットが自動的に ID を作成します。 Web チャットは、生成した匿名 ID が含まれたファースト・パーティー Cookie を作成します。 この Cookie のアクティブ期間は、45 日間です。 後で同じユーザーが同じ月にサイトに戻ってきて再びアシスタントとチャットした場合、Web チャット統合はそのユーザーを認識します。 同じ匿名ユーザーが 1 カ月の間にアシスタントと複数回対話しても、1 回としてのみ課金されます。

匿名ユーザーがログインし、後から、既知の ID で要求を送信したユーザーと同一人物であると特定された場合は、2 回課金されます。 固有のユーザー ID を持つ各メッセージが、独立したアクティブ・ユーザーとして課金されます。 この状態を回避するために、チャットを開始する前にユーザーにログインを求めるプロンプトを出すことができます。 あるいは、匿名ユーザー ID を使用して、一貫してユーザーを表すことができます。

データ・センター

IBM Cloud には、そのクラウド・サービスにパフォーマンス上のメリットをもたらすグローバル・データ・センターのネットワークがあります。 詳細は IBM Cloudのグローバルデータセンター をご覧ください。

以下のデータ・センターの場所でホストされる watsonx Assistant サービス・インスタンスを作成できます。