# 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](API_amazon-q-connect_SpanMessage.md) 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](API_amazon-q-connect_SpanMessage.md) 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\$1tokens) 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](API_amazon-q-connect_SpanMessageValue.md) 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 \$1 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: + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qconnect-2020-10-19/SpanAttributes) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qconnect-2020-10-19/SpanAttributes) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qconnect-2020-10-19/SpanAttributes)