CloudWatch Logs を使用して Amazon Q in Connect をモニタリングする

PDFRSS

Amazon Q in Connect がエージェントに提供するリアルタイムの推奨事項と、自然言語を理解して検出する顧客の意図を可視化するには、CloudWatch Logs をクエリできます。CloudWatch Logs を使用すると、会話、トリガー、インテント、推奨事項など、コンタクトジャーニー全体を確認できます。また、この情報をデバッグに使用したり、サポートを依頼 サポート するときに に提供したりすることもできます。

このトピックでは、Amazon Q in Connect のロギングを有効にする方法について説明します。

必要な IAM 許可

Amazon Q in Connect アシスタントのログ記録を有効にする前に、次の AWS Identity and Access Management アクセス許可があることを確認してください。Amazon Connect コンソールにサインインしているユーザーアカウントに必要です。

• wisdom:AllowVendedLogDeliveryForResource: アシスタントリソースのログの提供を許可するために必要です。

特定のロギング先に必要なすべてのアクセス許可を持つ IAM ロールの例を表示するには、「追加のアクセス許可が必要なロギング [V2]」を参照してください。そのトピックには、CloudWatch Logs に送信されたログや Amazon S3 に送信されたログなど、さまざまなロギング先の例が含まれています。この例は、特定のロギング先リソースの更新を許可する方法を示しています。

Amazon Q in Connect のロギングを有効にする

Amazon Q in Connect のロギングを有効化するには、CloudWatch API を使用します。以下の手順を実行します。

1. Amazon Q in Connect アシスタント (ドメイン とも呼ばれます) の ARN を取得します。アシスタントを作成したら、Amazon Connect コンソールから、または GetAssistant API を呼び出すことで、その ARN を取得できます。ARN はこの形式に従います。

   arn:aws:wisdom:your-region:your-account-id:assistant/assistant-id

2. PutDeliverySource を呼び出す: この CloudWatch API を使用して、アシスタントの配信ソースを作成します。アシスタントの ARN を resourceArn として渡します。logType 、アシスタントからログを収集するために EVENT_LOGS を指定します。

   {
       "logType": "EVENT_LOGS",
       "name": "your-assistant-delivery-source",
       "resourceArn": "arn:aws:wisdom:your-region:your-account-id:assistant/assistant_id
   }

3. PutDeliveryDestination を呼び出す: この CloudWatch API を使用して、ログの保存先を設定します。ログの保存先として、CloudWatch Logs、Amazon S3、または Amazon Data Firehose を選択できます。ログの保存先として、保存先オプション 1 つの ARN を指定する必要があります。ログの outputFormat は以下のいずれかを選択できます: json、plain、w3c、raw、parquet。

   次の例は、Amazon CloudWatch Logs グループに JSON 形式でログを保存するように設定する方法を示しています。

   {
       "deliveryDestinationConfiguration": {
           "destinationResourceArn": "arn:aws:logs:your-region:your-account-id:log-group:your-log-group-name:*"
       },
       "name": "string",
       "outputFormat": "json",
       "tags": {
           "key": "value"
       }
   }

4. CreateDelivery を呼び出す: この CloudWatch API を使用して、配信ソースを前のステップで作成した配信先にリンクします。この API オペレーションは、配信ソースを最終配信先と関連付けます。

   {
       "deliveryDestinationArn": "string",
       "deliverySourceName": "string",
       "tags": {
           "string": "string"
       }
   }

サポートされているログのタイプ

Amazon Q in Connect は、以下のログのタイプをサポートしています。

• EVENT_LOGS: 通話とチャット中に Amazon Q in Connect アシスタントのイベントを追跡するログ。

CloudWatch Logs のクォータを確認する

Amazon CloudWatch Logs のエンドポイントとクォータをチェックして、CloudWatch Logs の配信関連の API コールを行うためのクォータがあるかどうかを確認することをお勧めします。クォータは、API を呼び出したり、リソースを作成したりできる最大回数を設定します。制限を超えると ServiceQuotaExceededException エラーが発生します。

アシスタントログの例

以下はイベントログの例になります。イベントタイプによっては、さらに多くのフィールドが表示される場合があります。

{
    "assistant_id": "AssistantId",
    "event_timestamp": 1729530173612,
    "event_type": "TRANSCRIPT_CREATE_SESSION" | "TRANSCRIPT_INTENT_TRIGGERING_REFERENCE" | "TRANSCRIPT_RECOMMENDATION" | "TRANSCRIPT_UTTERANCE" | "TRANSCRIPT_TRIGGER_DETECTION_MODEL_INVOCATION" | "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "session_id": "SessionId",
    "session_name": "SessionName",
    "recommendation": "Recommendation",
    "intent": "Intent",
    "prompt": "Prompt",
    "utterance": "Utterance"
}

イベントタイプによっては、さらに多くのフィールドが表示される場合があります。例えば、チャットまたは音声イベントには発話に関する情報があります。推奨事項を生成したイベントには、インテント、トリガー、または推奨事項自体に関する情報が含まれます。

アシスタントログをデバッグするための一般的なクエリの例

クエリを使用してログを操作できます。例えば、SESSION_NAME を使用して、セッション内のすべてのイベントをクエリすることができます。

以下は、特定のセッション用に生成されたすべてのログを返すための 2 つの一般的なクエリです。

• filter session_name = "SessionName"

• filter session_id = "SessionId"