SpanAttributes - Amazon Connect
ContentsSee Also

SpanAttributes

Contextual attributes capturing operation details, LLM configuration, usage metrics, and conversation data

Contents

agentId

Amazon Connect agent ID

Type: String

Pattern: [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

Required: No

aiAgentArn

AI agent ARN

Type: String

Pattern: arn:[a-z-]*?:wisdom:[a-z0-9-]*?:[0-9]{12}:[a-z-]*?/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?:/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}){0,2}(:[A-Z0-9_$]+){0,1}

Required: No

aiAgentId

AI agent identifier

Type: String

Pattern: [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

Required: No

aiAgentInvoker

Entity that invoked the AI agent

Type: String

Length Constraints: Minimum length of 1. Maximum length of 4096.

Required: No

aiAgentName

AI agent name

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: [a-zA-Z0-9\s_.,-]+.*

Required: No

aiAgentOrchestratorUseCase

AI agent orchestrator use case

Type: String

Length Constraints: Minimum length of 1. Maximum length of 4096.

Required: No

aiAgentType

AI agent type

Type: String

Valid Values: MANUAL_SEARCH | ANSWER_RECOMMENDATION | SELF_SERVICE | EMAIL_RESPONSE | EMAIL_OVERVIEW | EMAIL_GENERATIVE_ANSWER | ORCHESTRATION | NOTE_TAKING | CASE_SUMMARIZATION

Required: No

aiAgentVersion

AI agent version number

Type: Integer

Required: No

cacheReadInputTokens

Number of input tokens that were retrieved from cache

Type: Integer

Required: No

cacheWriteInputTokens

Number of input tokens that were written to cache in this request

Type: Integer

Required: No

contactId

Amazon Connect contact identifier

Type: String

Pattern: [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

Required: No

errorType

Error classification if span failed (e.g., throttle, timeout)

Type: String

Length Constraints: Minimum length of 1. Maximum length of 4096.

Required: No

initialContactId

Amazon Connect contact identifier

Type: String

Pattern: [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

Required: No

inputMessages

Input message collection sent to LLM

Type: Array of SpanMessage objects

Array Members: Minimum number of 0 items. Maximum number of 50 items.

Required: No

instanceArn

Amazon Connect instance ARN

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Pattern: arn:[a-z-]+?:[a-z-]+?:[a-z0-9-]*?:([0-9]{12})?:[a-zA-Z0-9-:/]+

Required: No

operationName

Action being performed

Type: String

Length Constraints: Minimum length of 1. Maximum length of 4096.

Required: No

outputMessages

Output message collection received from LLM

Type: Array of SpanMessage objects

Array Members: Minimum number of 0 items. Maximum number of 50 items.

Required: No

promptArn

AI prompt ARN

Type: String

Pattern: arn:[a-z-]*?:wisdom:[a-z0-9-]*?:[0-9]{12}:[a-z-]*?/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?:/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}){0,2}(:[A-Z0-9_$]+){0,1}

Required: No

promptId

AI prompt identifier

Type: String

Pattern: [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

Required: No

promptName

AI prompt name

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: [a-zA-Z0-9\s_.,-]+.*

Required: No

promptType

AI prompt type

Type: String

Valid Values: ANSWER_GENERATION | INTENT_LABELING_GENERATION | QUERY_REFORMULATION | SELF_SERVICE_PRE_PROCESSING | SELF_SERVICE_ANSWER_GENERATION | EMAIL_RESPONSE | EMAIL_OVERVIEW | EMAIL_GENERATIVE_ANSWER | EMAIL_QUERY_REFORMULATION | ORCHESTRATION | NOTE_TAKING | CASE_SUMMARIZATION

Required: No

promptVersion

AI prompt version number

Type: Integer

Required: No

providerName

Model provider identifier (e.g., aws.bedrock)

Type: String

Length Constraints: Minimum length of 1. Maximum length of 4096.

Required: No

requestMaxTokens

Maximum tokens configured for generation

Type: Integer

Required: No

requestModel

LLM model ID for request (e.g., anthropic.claude-3-sonnet)

Type: String

Length Constraints: Minimum length of 1. Maximum length of 4096.

Required: No

responseFinishReasons

Generation termination reasons (e.g., stop, max_tokens)

Type: Array of strings

Array Members: Minimum number of 0 items. Maximum number of 10 items.

Length Constraints: Minimum length of 1. Maximum length of 4096.

Required: No

responseModel

Actual model used for response (usually matches requestModel)

Type: String

Length Constraints: Minimum length of 1. Maximum length of 4096.

Required: No

sessionName

Session name

Type: String

Length Constraints: Minimum length of 1. Maximum length of 4096.

Required: No

systemInstructions

System prompt instructions

Type: Array of SpanMessageValue objects

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Required: No

temperature

Sampling temperature for generation

Type: Float

Valid Range: Minimum value of 0.0. Maximum value of 1.0.

Required: No

topP

Top-p sampling parameter for generation

Type: Float

Valid Range: Minimum value of 0.0. Maximum value of 1.0.

Required: No

usageInputTokens

Number of input tokens in prompt

Type: Integer

Required: No

usageOutputTokens

Number of output tokens in response

Type: Integer

Required: No

usageTotalTokens

Total tokens consumed (input + output)

Type: Integer

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: