View a markdown version of this page

Connect AI エージェントのログ記録とトレース - Amazon Connect

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Connect AI エージェントのログ記録とトレース

Connect AI エージェントの問題を効果的にトラブルシューティングするには、次のログ記録とトレースオプションを使用します。

  • ListSpans API (オーケストレーター AI エージェントに推奨): ListSpans API を使用してセッションの AI エージェント実行トレースを取得します。これは、オーケストレーター AI エージェントインタラクションのデバッグに推奨される出発点です。エージェントオーケストレーションフロー、LLM インタラクション、ツール呼び出しをきめ細かく可視化できるため、AI エージェントがリクエストを通じてどのように推論したか、どのツールを選択して実行したかを追跡できます。

  • CloudWatch Logs: 「」の手順に従って、Connect AI エージェントの CloudWatch ログ記録を有効にしますConnect AI エージェントをモニタリングする。

    従来のセルフサービスインタラクションでは、イベントタイプのログエントリが次の形式で生成TRANSCRIPT_SELF_SERVICE_MESSAGEされます。

    {
    "assistant_id": "{UUID}",
    "event_timestamp": 1751414298692,
    "event_type": "TRANSCRIPT_SELF_SERVICE_MESSAGE",
    "session_id": "{UUID}",
    "utterance": "[CUSTOMER]...",
    "prompt": "{prompt used}",
    "prompt_type": "SELF_SERVICE_PRE_PROCESS|SELF_SERVICE_ANSWER_GENERATION",
    "completion": "{Response from model}",
    "model_id": "{model id e.g.: us.amazon.nova-pro-v1:0}",
    "session_message_id": "{UUID}",
    "parsed_response": "{model response}"
}

    エージェントセルフサービスインタラクションは、イベントタイプ のログエントリを生成しますTRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION。これらのエントリには、ツール設定を含むプロンプト、ツール呼び出しと結果を含む会話履歴、モデルの完了、AI エージェント設定などの完全なオーケストレーションコンテキストが含まれます。次の例は、キーフィールドを示しています。

    {
    "assistant_id": "{UUID}",
    "event_timestamp": 1772748470993,
    "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "session_id": "{UUID}",
    "prompt": "{full prompt including system instructions, tool configs, and conversation history}",
    "prompt_type": "ORCHESTRATION",
    "completion": "{model response with message and tool use}",
    "model_id": "{model id e.g.: us.anthropic.claude-haiku-4-5-20251001-v1:0}",
    "parsed_response": "{parsed customer-facing message}",
    "generation_id": "{UUID}",
    "ai_agent_id": "{UUID}"
}

  • Amazon Lex ログ記録 (セルフサービスのみ): Amazon Lex V2 のエラーログによるエラーのログ記録の手順に従ってAmazon Lexログ記録を有効にします。

  • Amazon Connect ログ記録: Amazon Connect フローに ログ記録動作の設定 フローブロックを追加して Amazon Connect ログ記録を有効にします。