View a markdown version of this page

使用 CloudWatch 日志监控 Connect 人工智能代理 - Amazon Connect Customer
所需的 IAM 权限启用日志记录支持的日志类型检查 CloudWatch 日志配额使用交互式处理程序记录 CloudWatch 事件调试助理日志的常见查询示例

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 CloudWatch 日志监控 Connect 人工智能代理

要了解 Connect AI 代理向您的代理提供的实时建议，以及他们通过自然语言理解检测到的客户意图，您可以查询 CloudWatch 日志。 CloudWatch 日志可以让你了解整个联系历程：对话、触发因素、意图、推荐。您也可以使用此信息进行调试，或者在联系他们寻求帮助 支持 时将其提供给他们。

本主题介绍如何为 Connect AI 代理启用日志记录。

所需的 IAM 权限

在启用 Connect 助手的日志记录之前，请检查您是否具有以下 AWS Identity and Access Management 权限。它们是登录到 Connect 客户控制台的用户帐户所必需的：

  • wisdom:AllowVendedLogDeliveryForResource：要求允许为助理资源传送日志。

要查看具有特定日志记录目标所需全部权限的 IAM 角色示例，请参阅需要额外权限的日志记录 [V2]。该主题包含不同日志记录目标的示例，例如发送到日志的 CloudWatch 日志和发送到 Amazon S3 的日志。这些示例展示了如何允许更新您的特定日志目标资源。

为 Connect AI 代理启用日志记录

要启用 Connect AI 代理的日志记录，请使用 CloudWatch API。完成以下步骤。

  1. 获取助手的 ARN（也称为其域名）。创建助手后，您可以从 Connect 客户控制台或通过调用 API 获取它的 ARN。GetAssistantARN 遵循以下格式：

    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 日志、Amazon S3 或 Amazon Data Firehose 作为存储日志的目标。您必须为日志的存储位置指定其中一个目标选项的 ARN。您可以选择日志的 outputFormat 作为以下选项之一：json、plain、w3c、raw、parquet。

    以下示例说明如何将日志配置为以 JSON 格式存储在 Amazon CloudWatch 日志组中。

    {
    "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"
    }
}

支持的日志类型

Connect AI 代理支持以下日志类型：

  • EVENT_LOGS：用于跟踪 Connect 助手在通话、聊天、任务和发送电子邮件期间的事件的日志。

检查 CloudWatch 日志配额

我们建议您查看 Amazon CloudWatch Logs 终端节点和配额，以查看是否存在与 CloudWatch 日志传输相关的 API 调用的配额。配额设置了您可以调用 API 或创建资源的最大次数。超过限制会导致 ServiceQuotaExceededException 错误。

使用交互式处理程序记录 CloudWatch 事件

事件类型定义

下表描述了每个事件类型。请注意，不同的事件类型包含不同的字段。有关每个字段的详细信息，请参阅字段定义部分。

EventType 定义
TRANSCRIPT_CREATE_SESSION 在创建新的 Connect AI 代理会话时记录。这标志着开始对话。
TRANSCRIPT_INTENT_TRIGGERING_REFERENCE 在对话中检测到特定的客户意图时记录，这可能会触发自动回复或工作流程。
TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION 当调用大语言模型（LLM）来生成回复或处理对话内容时记录。记录到 LLM 的输入和来自 LLM 的输出。
TRANSCRIPT_QUERY_ASSISTANT 在调用以下 Connect AI 代理之一时记录： AnswerRecommendation CaseSummarization、 EmailGenerativeAnswer、 EmailOverview、 EmailResponse、、 ManualSearch、 NoteTaking。
TRANSCRIPT_RECOMMENDATION 当系统向座席或客户提供建议（可能包括知识文章、生成的回复或推荐的操作）时记录。
TRANSCRIPT_RESULT_FEEDBACK 在提供有关搜索或查询结果的有用性或相关性的反馈时记录。
TRANSCRIPT_SELF_SERVICE_MESSAGE 当客户与 C SelfService onnect 人工智能代理互动时已登录
TRANSCRIPT_SESSION_POLLED 当系统检测到代理已连接到会话时记录（调用 GetRecommendations API 后会对会话进行轮询）
TRANSCRIPT_TRIGGER_DETECTION_MODEL_INVOCATION 当调用触发器检测模型以确定对话是否有意图时记录
TRANSCRIPT_UTTERANCE 当对话中的任何参与者发送消息时记录，此时记录实际的对话内容。
转录_编排_消息 记录编排循环中的每个步骤，包括最初的客户消息、机器人文本回复、推理、工具使用请求和工具结果。捕获 Orchestration Connect 人工智能代理执行的多回合代理推理的全部细节。
转录编排错误 在编排过程中出现错误（例如超过最大编排迭代次数、系统容量限制或常规编排失败）时记录。
转录_AI_AGENT_TRACE 在 AI 代理编排期间记录每个执行跨度，捕获详细的跟踪，包括 LLM 配置、令牌使用情况、消息和护栏评估结果。

字段定义

下表描述了每个元素。

字段 定义
ai_agent_id Connect AI 代理资源的唯一标识符。
assistant_id Connect 助手资源的唯一标识符。
completion 由 LLM 返回的或为消息生成的原始完成文本。
connect_user_arn 访问会话的 Connect 用户的 Amazon 资源名称（ARN）。
event_timestamp 事件发生时的 Unix 时间戳（以毫秒为单位）。
event_type 事件的类型，表示系统中发生了什么操作或进程。
generation_id 特定 AI-generated响应的唯一标识符。
intent 意图文本或描述。
intent_clicked 表示建议是否由点击的意图触发的布尔值。
意图_id 检测到的意图的唯一标识符。
issue_probability 在对话中检测到问题的数值概率（0.0–1.0）（概率大于 0.5 将调用意图生成）
is_recommendation_useful 表示用户认为结果是否有用的布尔值。
is_valid_trigger 一个布尔值，表示检测模型分析是否产生了有效的触发器。
model_id 用于调用 LLM 的人工智能模型的标识符。
parsed_response 语言模型响应的 processed/parsed 版本，通常采用结构化格式。
提示 用于调用 LLM 的输入提示。
prompt_type 用于处理消息或查询的 AI 提示类型。
建议 提供给用户的实际建议文字内容
recommendation_id 建议的唯一标识符。
响应 处理后为用户生成的最终回复文本。
session_event_id 会话中特定事件的唯一标识符。
session_event_ids 会话事件标识符的列表。
session_id Connect AI 代理会话的唯一标识符。
session_message_id 会话中自助服务消息的唯一标识符。
session_name 会话的名称。
言语 对话中交流的实际消息文本。
编排_id 编排运行的唯一标识符。对应于触发编排的初始客户消息 ID。
编排_迭代 编排循环中的迭代次数。
ai_agent_orchestration_use_case 协调器用例，例如或。CONNECT_AGENT_ASSISTANCE CONNECT_SELF_SERVICE
参与者 消息的参与者角色，例如CUSTOMER或BOT。
值 JSON-serialized 消息值列表。每个条目都有一种类型：text（带有文本值）、tool_use（包含工具UseId、toolID、名称和参数）、tool_result（包含工具UseId、toolID、名称、值和错误）或reasoning（带有文本值）。
护栏被挡住了 表示响应是否被 AI 护栏屏蔽的布尔值。
编排错误 JSON-serialized 错误详情包含errorMessage和一个可选errorDetails对象（带estimatedInputTokens和estimatedOutputTokens）。
跨度 JSON-serialized 全跨度对象的地图。每把钥匙都是 snake_case。值得注意的关键包括input_messages（发送给模型的对话历史记录）、output_messages（模型响应消息）、guardrail_assessments（带有、、guardrailId、guardrailName和的护栏评估结果列表policies）和input_messages_truncated（"true"当输入消息被截断以符合 256KB 的记录限制时）。source action仅在存在时event_type出现TRANSCRIPT_AI_AGENT_TRACE。

助理日志示例

以下是每种事件类型的不同事件日志的示例。有关每种事件类型的详细说明，请参阅事件类型定义部分。

CreateSession


{
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530173612,
    "event_type": "TRANSCRIPT_CREATE_SESSION",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa",
    "session_name": "nabbccdd-9999-4b23-aaee-112233445566"
}

IntentTriggeringReference


{
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530173623,
    "event_type": "TRANSCRIPT_INTENT_TRIGGERING_REFERENCE",
    "intent": "To learn about how to autoscale DynamoDB.",
    "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa"
}

LargeLanguageModelInvocation

查询重构


{
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "completion": "<query>The customer is asking for information on how to autoscale DynamoDB.</query>",
    "event_timestamp": 1729530173645,
    "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef",
    "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5"
    "model_id": "us.amazon.nova-lite-v1:0",
    "parsed_response": "The customer is asking for information on how to autoscale DynamoDB.",
    "prompt": "{\"anthropic_version\":\"bedrock-2023-05-31\",\"max_tokens\":1024,\"system\":\"You are a...\"}",
    "prompt_type": "BEDROCK_KB_QUERY_REFORMULATION",
    "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa"
}

意图检测


{
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "completion": "no</malice>\n  - Step 2. <specific>yes</specific>\n  - Step 3. <intent>To learn how to autoscale DynamoDB.</intent>",
    "event_timestamp": 1729530173645,
    "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef",
    "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5"
    "model_id": "us.amazon.nova-lite-v1:0",
    "parsed_response": "To learn how to autoscale DynamoDB.",
    "prompt": "{\"anthropic_version\":\"bedrock-2023-05-31\",\"max_tokens\":1024,\"system\":\"You are a...\"}",
    "prompt_type": "GENERATIVE_INTENT_DETECTION",
    "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa"
}

意图答案生成


{
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "completion": "{\"citations\":[{\"citation\":{\"generatedResponsePart\":{\"textResponsePart\":{\"span\":{\"end\":1065,\"start\":0},\"text\":\"\\nDynamoDB auto s\"}}}}]}",
    "event_timestamp": 1729530173645,
    "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef",
    "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5",
    "model_id": "us.anthropic.claude-3-7-sonnet-20250219-v1:0",
    "parsed_response": "DynamoDB auto scaling works by creating CloudWatch alarms that monitor your table's activity. When the...",
    "prompt": "{\"input\":{\"text\":\"The customer is seeking information on how to autoscale DynamoDB. Key utterance: \\\"How can \"}}",
    "prompt_type": "BEDROCK_KB_GENERATIVE_ANSWER",
    "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa"
}

手动搜索生成


{
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "completion": "no</malice>\n  - Step 2. <specific>yes</specific>\n  - Step 3. <intent>To learn how to autoscale DynamoDB.</intent>",
    "event_timestamp": 1729530173645,
    "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef",
    "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5",
    "model_id": "us.anthropic.claude-3-7-sonnet-20250219-v1:0",
    "parsed_response": "DynamoDB auto scaling works by creating CloudWatch alarms that monitor...",
    "prompt": "{\"anthropic_version\":\"bedrock-2023-05-31\",\"max_tokens\":1024,\"system\":\"You are a...\"}",
    "prompt_type": "BEDROCK_KB_GENERATIVE_ANSWER",
    "session_id": "******************-*****************"
}

QueryAssistant


{
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530173667,
    "event_type": "TRANSCRIPT_QUERY_ASSISTANT",
    "recommendation_id": "r0001112-3f4e-4fa5-9111-aabbccddeeff",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa"
}

建议


{
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530173656,
    "event_type": "TRANSCRIPT_RECOMMENDATION",
    "intent_clicked": 1,
    "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5",
    "recommendation_id": "r0001112-3f4e-4fa5-9111-aabbccddeeff",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa"
}

ResultFeedback


{
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530173667,
    "event_type": "TRANSCRIPT_RESULT_FEEDBACK",
    "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef",
    "is_recommendation_useful": 1,
    "recommendation_id": "r0001112-3f4e-4fa5-9111-aabbccddeeff"
}

SelfServiceMessage


{
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "completion": "{\"citations\":[{\"generatedResponsePart\":{\"textResponsePart\":{\"span\":{\"end\":276,\"start\":0},\"text\":\"To autoscale Amazon DynamoDB...\"}}]}",
    "event_timestamp": 1729530173678,
    "event_type": "TRANSCRIPT_SELF_SERVICE_MESSAGE",
    "model_id": "us.amazon.nova-pro-v1:0",
    "parsed_response": "To autoscale Amazon DynamoDB, follow these steps:...",
    "prompt": "{\"input\":{\"text\":\"how to autoscale dynamodb\"},\"retrieveAndGenerateConfiguration\":...}",
    "prompt_type": "SELF_SERVICE_ANSWER_GENERATION",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa",
    "session_message_id": "mdee1234-5678-4eab-9333-ffeebb998877",
    "utterance": "[Customer] How can I autoscale DyanmoDB?"
}

TranscriptSessionPolled


{
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "connect_user_arn": "arn:aws:connect:us-east-1:204585150770:instance/seaa9988-2233-4f44-8899-abcabcabcabc/agent/agbbccdd-9999-4b23-aaee-112233445566",
    "event_timestamp": 1729530173623,
    "event_type": "TRANSCRIPT_SESSION_POLLED",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa",
    "session_name": "nabbccdd-9999-4b23-aaee-112233445566"
}

TriggerDetectionModelInvocation


{
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530173634,
    "event_type": "TRANSCRIPT_TRIGGER_DETECTION_MODEL_INVOCATION",
    "is_valid_trigger": 1,
    "issue_probability": "0.87",
    "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc",
    "session_event_ids": ["seaa9988-2233-4f44-8899-abcabcabcabc"],
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa"
}

表达


{
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530173623,
    "event_type": "TRANSCRIPT_UTTERANCE",
    "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa",
    "utterance": "[Customer] My laptop won't connect to WiFi after the recent update"
}

OrchestrationMessage

客户留言


{
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "ai_agent_orchestration_use_case": "CONNECT_AGENT_ASSISTANCE",
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530173612,
    "event_type": "TRANSCRIPT_ORCHESTRATION_MESSAGE",
    "model_id": "us.anthropic.claude-4-5-sonnet-20250929-v1:0",
    "orchestration_id": "m1234567-abcd-4ef0-9876-aabbccddeeff",
    "participant": "CUSTOMER",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa",
    "session_message_id": "m1234567-abcd-4ef0-9876-aabbccddeeff",
    "values": "[{\"type\":\"text\",\"value\":\"How do I reset my password?\"}]"
}

机器人短信回复


{
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "ai_agent_orchestration_use_case": "CONNECT_AGENT_ASSISTANCE",
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530174234,
    "event_type": "TRANSCRIPT_ORCHESTRATION_MESSAGE",
    "guardrail_blocked": false,
    "model_id": "us.anthropic.claude-4-5-sonnet-20250929-v1:0",
    "orchestration_id": "m1234567-abcd-4ef0-9876-aabbccddeeff",
    "orchestration_iteration": 1,
    "participant": "BOT",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa",
    "session_message_id": "mfff1234-5678-4eab-9333-112233445566",
    "values": "[{\"type\":\"text\",\"value\":\"I can help you reset your password. Let me look up your account.\"}]"
}

工具使用


{
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "ai_agent_orchestration_use_case": "CONNECT_AGENT_ASSISTANCE",
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530174500,
    "event_type": "TRANSCRIPT_ORCHESTRATION_MESSAGE",
    "model_id": "us.anthropic.claude-4-5-sonnet-20250929-v1:0",
    "orchestration_id": "m1234567-abcd-4ef0-9876-aabbccddeeff",
    "orchestration_iteration": 1,
    "participant": "BOT",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa",
    "session_message_id": "maaa2222-3333-4bbb-cccc-ddddeeeeffff",
    "values": "[{\"type\":\"tool_use\",\"toolUseId\":\"toolu_01ABC\",\"toolId\":\"ResetPassword\",\"name\":\"ResetPassword\",\"arguments\":{\"email\":\"customer@example.com\"}}]"
}

工具结果


{
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "ai_agent_orchestration_use_case": "CONNECT_AGENT_ASSISTANCE",
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530175100,
    "event_type": "TRANSCRIPT_ORCHESTRATION_MESSAGE",
    "model_id": "us.anthropic.claude-4-5-sonnet-20250929-v1:0",
    "orchestration_id": "m1234567-abcd-4ef0-9876-aabbccddeeff",
    "orchestration_iteration": 1,
    "participant": "BOT",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa",
    "session_message_id": "mbbb3333-4444-5ccc-dddd-eeeeffff0000",
    "values": "[{\"type\":\"tool_result\",\"toolUseId\":\"toolu_01ABC\",\"toolId\":\"ResetPassword\",\"name\":\"ResetPassword\",\"values\":[{\"type\":\"text\",\"value\":\"Password reset email sent successfully.\"}],\"error\":null}]"
}

推理


{
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "ai_agent_orchestration_use_case": "CONNECT_AGENT_ASSISTANCE",
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530175200,
    "event_type": "TRANSCRIPT_ORCHESTRATION_MESSAGE",
    "model_id": "us.anthropic.claude-4-5-sonnet-20250929-v1:0",
    "orchestration_id": "m1234567-abcd-4ef0-9876-aabbccddeeff",
    "orchestration_iteration": 1,
    "participant": "BOT",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa",
    "session_message_id": "mccc4444-5555-6ddd-eeee-ffff00001111",
    "values": "[{\"type\":\"reasoning\",\"value\":\"The password reset was successful. I should inform the customer and ask if they need further help.\"}]"
}

OrchestrationError

已超过最大编排迭代次数


{
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "ai_agent_orchestration_use_case": "CONNECT_AGENT_ASSISTANCE",
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530180000,
    "event_type": "TRANSCRIPT_ORCHESTRATION_ERROR",
    "model_id": "us.anthropic.claude-4-5-sonnet-20250929-v1:0",
    "orchestration_error": "{\"errorMessage\":\"The orchestration exceeded the maximum number of iterations\"}",
    "orchestration_id": "m1234567-abcd-4ef0-9876-aabbccddeeff",
    "orchestration_iteration": 9,
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa"
}

系统容量限制


{
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "ai_agent_orchestration_use_case": "CONNECT_AGENT_ASSISTANCE",
    "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530180000,
    "event_type": "TRANSCRIPT_ORCHESTRATION_ERROR",
    "model_id": "us.anthropic.claude-4-5-sonnet-20250929-v1:0",
    "orchestration_error": "{\"errorMessage\":\"System capacity is constrained. We are actively working on scaling system to prevent such failures.\",\"errorDetails\":{\"estimatedInputTokens\":50000,\"estimatedOutputTokens\":2048}}",
    "orchestration_id": "m1234567-abcd-4ef0-9876-aabbccddeeff",
    "orchestration_iteration": 3,
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa"
}

AIAgentTrace

成功的编排跨度（无需护栏干预）


{
    "timestamp": 1729530173612,
    "resource_arn": "arn:aws:wisdom:us-east-1:204585150770:assistant/a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530175612,
    "event_type": "TRANSCRIPT_AI_AGENT_TRACE",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa",
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "model_id": "us.anthropic.claude-4-5-sonnet-20250929-v1:0",
    "span": {
        "span_id": "7a3f2b1c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
        "parent_span_id": "eb06e7cf-c3ba-4e75-86ef-ba761fd0ee30",
        "span_name": "inference",
        "span_type": "CLIENT",
        "start_timestamp": "1729530173612",
        "end_timestamp": "1729530175612",
        "status": "OK",
        "operation_name": "inference",
        "provider_name": "aws.bedrock",
        "session_name": "nabbccdd-9999-4b23-aaee-112233445566",
        "ai_agent_arn": "arn:aws:wisdom:us-east-1:204585150770:ai-agent/ai112233-7a85-4b3c-8def-0123456789ab",
        "ai_agent_type": "ANSWER_RECOMMENDATION",
        "ai_agent_name": "MyAgent",
        "ai_agent_version": "3",
        "ai_agent_orchestrator_use_case": "Connect.AgentAssistance",
        "request_model": "us.anthropic.claude-4-5-sonnet-20250929-v1:0",
        "request_max_tokens": "4096",
        "temperature": "1.0",
        "response_finish_reasons": "[\"end_turn\"]",
        "usage_input_tokens": "5274",
        "usage_output_tokens": "266",
        "usage_total_tokens": "5540",
        "cache_read_input_tokens": "4800",
        "cache_write_input_tokens": "0",
        "prompt_arn": "arn:aws:wisdom:us-east-1:204585150770:ai-prompt/prompt-abc:2",
        "prompt_id": "prompt-abc",
        "prompt_type": "ORCHESTRATION",
        "prompt_name": "Agent Assistance Orchestration",
        "prompt_version": "2",
        "time_to_first_token_ms": "850",
        "input_messages": "[{\"messageId\":\"msg-1\",\"participant\":\"CUSTOMER\",\"timestamp\":1729530173000,\"values\":[{\"text\":{\"value\":\"How can I autoscale DynamoDB?\"}}]}]",
        "output_messages": "[{\"messageId\":\"msg-2\",\"participant\":\"BOT\",\"timestamp\":1729530175612,\"values\":[{\"text\":{\"value\":\"DynamoDB auto scaling works by creating CloudWatch alarms that monitor your table's activity.\"}}]}]",
        "system_instructions": "[{\"messageId\":\"sys-1\",\"participant\":\"USER\",\"timestamp\":0,\"values\":[{\"text\":{\"value\":\"You are an AI assistant for contact center agents.\"}}]}]"
    }
}

Guardrail 会屏蔽输出（违反主题政策）


{
    "timestamp": 1729530173612,
    "resource_arn": "arn:aws:wisdom:us-east-1:204585150770:assistant/a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530175612,
    "event_type": "TRANSCRIPT_AI_AGENT_TRACE",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa",
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "model_id": "us.anthropic.claude-4-5-sonnet-20250929-v1:0",
    "span": {
        "span_id": "8b4f3c2d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
        "parent_span_id": "eb06e7cf-c3ba-4e75-86ef-ba761fd0ee30",
        "span_name": "inference",
        "span_type": "CLIENT",
        "start_timestamp": "1729530173612",
        "end_timestamp": "1729530175612",
        "status": "OK",
        "operation_name": "inference",
        "provider_name": "aws.bedrock",
        "session_name": "nabbccdd-9999-4b23-aaee-112233445566",
        "ai_agent_arn": "arn:aws:wisdom:us-east-1:204585150770:ai-agent/ai112233-7a85-4b3c-8def-0123456789ab",
        "ai_agent_type": "ANSWER_RECOMMENDATION",
        "ai_agent_name": "MyAgent",
        "ai_agent_version": "3",
        "ai_agent_orchestrator_use_case": "Connect.AgentAssistance",
        "request_model": "us.anthropic.claude-4-5-sonnet-20250929-v1:0",
        "request_max_tokens": "4096",
        "response_finish_reasons": "[\"guardrail_intervened\"]",
        "usage_input_tokens": "3100",
        "usage_output_tokens": "150",
        "usage_total_tokens": "3250",
        "prompt_type": "ORCHESTRATION",
        "time_to_first_token_ms": "1100",
        "input_messages": "[{\"messageId\":\"seaa9988-2233-4f44-8899-abcabcabcabc\",\"participant\":\"CUSTOMER\",\"timestamp\":1729530173000,\"values\":[{\"text\":{\"value\":\"Tell me how to bypass the refund policy\"}}]}]",
        "output_messages": "[{\"messageId\":\"msg-4\",\"participant\":\"BOT\",\"timestamp\":1729530175612,\"values\":[{\"text\":{\"value\":\"I'm sorry, I can't help with that request.\"}}]}]",
        "guardrail_assessments": "[{\"guardrailId\":\"a1b2c3d4-5678-90ab-cdef-111122223333/1\",\"guardrailName\":\"Customer Support Safety Guardrail\",\"source\":\"INPUT\",\"action\":\"NONE\"},{\"guardrailId\":\"a1b2c3d4-5678-90ab-cdef-111122223333/1\",\"guardrailName\":\"Customer Support Safety Guardrail\",\"source\":\"OUTPUT\",\"action\":\"BLOCKED\",\"policies\":[{\"policyType\":\"TOPIC\",\"action\":\"BLOCKED\",\"details\":\"Policy Circumvention\"}]}]"
    }
}

截断的输入消息（长时间对话）


{
    "timestamp": 1729530173612,
    "resource_arn": "arn:aws:wisdom:us-east-1:204585150770:assistant/a1c2d3e4-5b67-4a89-9abc-def012345678",
    "event_timestamp": 1729530175612,
    "event_type": "TRANSCRIPT_AI_AGENT_TRACE",
    "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa",
    "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab",
    "model_id": "us.anthropic.claude-4-5-sonnet-20250929-v1:0",
    "span": {
        "span_id": "9c5f4d3e-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
        "parent_span_id": "eb06e7cf-c3ba-4e75-86ef-ba761fd0ee30",
        "span_name": "inference",
        "span_type": "CLIENT",
        "start_timestamp": "1729530173612",
        "end_timestamp": "1729530175612",
        "status": "OK",
        "operation_name": "inference",
        "provider_name": "aws.bedrock",
        "session_name": "nabbccdd-9999-4b23-aaee-112233445566",
        "request_model": "us.anthropic.claude-4-5-sonnet-20250929-v1:0",
        "response_finish_reasons": "[\"end_turn\"]",
        "usage_input_tokens": "48000",
        "usage_output_tokens": "500",
        "usage_total_tokens": "48500",
        "input_messages": "[{\"messageId\":\"msg-98\",\"participant\":\"CUSTOMER\",\"timestamp\":1729530173000,\"values\":[{\"text\":{\"value\":\"What about the shipping timeline?\"}}]}]",
        "input_messages_truncated": "true",
        "output_messages": "[{\"messageId\":\"msg-99\",\"participant\":\"BOT\",\"timestamp\":1729530175612,\"values\":[{\"text\":{\"value\":\"Based on your location, delivery takes 3-5 business days after shipping.\"}}]}]",
        "guardrail_assessments": "[{\"guardrailId\":\"a1b2c3d4-5678-90ab-cdef-111122223333/1\",\"guardrailName\":\"Customer Support Safety Guardrail\",\"source\":\"INPUT\",\"action\":\"NONE\"},{\"guardrailId\":\"a1b2c3d4-5678-90ab-cdef-111122223333/1\",\"guardrailName\":\"Customer Support Safety Guardrail\",\"source\":\"OUTPUT\",\"action\":\"NONE\"}]"
    }
}

调试助理日志的常见查询示例

您可以使用查询与日志进行交互。例如，您可以使用 SESSION_NAME 查询会话中的所有活动。

以下是返回特定会话生成的所有日志的两个常用查询。

  • filter session_name = "SessionName"

  • filter session_id = "SessionId"