AWS cli documentation change
Summary
Updated AWS CLI version reference from 2.28.8 to 2.28.11 and restructured agentVersion documentation with field reordering, renamed parameters, added new fields (recommendedActions), and modified parameter descriptions
Security assessment
Changes primarily involve documentation restructuring and parameter reorganization without explicit security vulnerability fixes. Security-related fields like customerEncryptionKeyArn (KMS encryption) and guardrailConfiguration remain but were moved rather than modified. No evidence of addressing specific security vulnerabilities in the diff.
Diff
diff --git a/cli/latest/reference/bedrock-agent/get-agent-version.md b/cli/latest/reference/bedrock-agent/get-agent-version.md index ee36d7973..f8c9b727a 100644 --- a//cli/latest/reference/bedrock-agent/get-agent-version.md +++ b//cli/latest/reference/bedrock-agent/get-agent-version.md @@ -15 +15 @@ - * [AWS CLI 2.28.8 Command Reference](../../index.html) » + * [AWS CLI 2.28.11 Command Reference](../../index.html) » @@ -206,8 +205,0 @@ agentVersion -> (structure) -> agentArn -> (string) -> ->> The Amazon Resource Name (ARN) of the agent that the version belongs to. -> -> agentCollaboration -> (string) -> ->> The agent’s collaboration settings. -> @@ -222 +214 @@ agentVersion -> (structure) -> agentResourceRoleArn -> (string) +> agentArn -> (string) @@ -224 +216 @@ agentVersion -> (structure) ->> The Amazon Resource Name (ARN) of the IAM role with permissions to invoke API operations on the agent. +>> The Amazon Resource Name (ARN) of the agent that the version belongs to. @@ -226 +218 @@ agentVersion -> (structure) -> agentStatus -> (string) +> version -> (string) @@ -228 +220 @@ agentVersion -> (structure) ->> The status of the agent that the version belongs to. +>> The version number. @@ -230 +222 @@ agentVersion -> (structure) -> createdAt -> (timestamp) +> instruction -> (string) @@ -232 +224 @@ agentVersion -> (structure) ->> The time at which the version was created. +>> The instructions provided to the agent. @@ -234 +226 @@ agentVersion -> (structure) -> customerEncryptionKeyArn -> (string) +> agentStatus -> (string) @@ -236 +228,5 @@ agentVersion -> (structure) ->> The Amazon Resource Name (ARN) of the KMS key that encrypts the agent. +>> The status of the agent that the version belongs to. +> +> foundationModel -> (string) +> +>> The foundation model that the version invokes. @@ -242 +238 @@ agentVersion -> (structure) -> failureReasons -> (list) +> idleSessionTTLInSeconds -> (integer) @@ -244 +240 @@ agentVersion -> (structure) ->> A list of reasons that the API operation on the version failed. +>> The number of seconds for which Amazon Bedrock keeps information about a user’s conversation with the agent. @@ -246 +242 @@ agentVersion -> (structure) ->> (string) +>> A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout. @@ -248 +244 @@ agentVersion -> (structure) -> foundationModel -> (string) +> agentResourceRoleArn -> (string) @@ -250 +246 @@ agentVersion -> (structure) ->> The foundation model that the version invokes. +>> The Amazon Resource Name (ARN) of the IAM role with permissions to invoke API operations on the agent. @@ -252 +248 @@ agentVersion -> (structure) -> guardrailConfiguration -> (structure) +> customerEncryptionKeyArn -> (string) @@ -254,9 +250 @@ agentVersion -> (structure) ->> Details about the guardrail associated with the agent. ->> ->> guardrailIdentifier -> (string) ->> ->>> The unique identifier of the guardrail. ->> ->> guardrailVersion -> (string) ->> ->>> The version of the guardrail. +>> The Amazon Resource Name (ARN) of the KMS key that encrypts the agent. @@ -264 +252 @@ agentVersion -> (structure) -> idleSessionTTLInSeconds -> (integer) +> createdAt -> (timestamp) @@ -266,3 +254 @@ agentVersion -> (structure) ->> The number of seconds for which Amazon Bedrock keeps information about a user’s conversation with the agent. ->> ->> A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout. +>> The time at which the version was created. @@ -270 +256 @@ agentVersion -> (structure) -> instruction -> (string) +> updatedAt -> (timestamp) @@ -272 +258 @@ agentVersion -> (structure) ->> The instructions provided to the agent. +>> The time at which the version was last updated. @@ -274 +260 @@ agentVersion -> (structure) -> memoryConfiguration -> (structure) +> failureReasons -> (list) @@ -276,15 +262 @@ agentVersion -> (structure) ->> Contains details of the memory configuration on the version of the agent. ->> ->> enabledMemoryTypes -> (list) ->> ->>> The type of memory that is stored. ->>> ->>> (string) ->> ->> sessionSummaryConfiguration -> (structure) ->> ->>> Contains the configuration for SESSION_SUMMARY memory type enabled for the agent. ->>> ->>> maxRecentSessions -> (integer) ->>> ->>>> Maximum number of recent session summaries to include in the agent’s prompt context. +>> A list of reasons that the API operation on the version failed. @@ -292 +264,5 @@ agentVersion -> (structure) ->> storageDays -> (integer) +>> (string) +> +> recommendedActions -> (list) +> +>> A list of recommended actions to take for the failed API operation on the version to succeed. @@ -294 +270 @@ agentVersion -> (structure) ->>> The number of days the agent is configured to retain the conversational context. +>> (string) @@ -300,4 +275,0 @@ agentVersion -> (structure) ->> overrideLambda -> (string) ->> ->>> The ARN of the Lambda function to use when parsing the raw foundation model output in parts of the agent sequence. If you specify this field, at least one of the `promptConfigurations` must contain a `parserMode` value that is set to `OVERRIDDEN` . For more information, see [Parser Lambda function in Amazon Bedrock Agents](https://docs.aws.amazon.com/bedrock/latest/userguide/lambda-parser.html) . ->> @@ -312 +284 @@ agentVersion -> (structure) ->>>> additionalModelRequestFields -> (document) +>>>> promptType -> (string) @@ -314 +286,9 @@ agentVersion -> (structure) ->>>>> If the Converse or ConverseStream operations support the model, `additionalModelRequestFields` contains additional inference parameters, beyond the base set of inference parameters in the `inferenceConfiguration` field. +>>>>> The step in the agent sequence that this prompt configuration applies to. +>>>> +>>>> promptCreationMode -> (string) +>>>> +>>>>> Specifies whether to override the default prompt template for this `promptType` . Set this value to `OVERRIDDEN` to use the prompt that you provide in the `basePromptTemplate` . If you leave it as `DEFAULT` , the agent uses a default prompt template. +>>>> +>>>> promptState -> (string) +>>>> +>>>>> Specifies whether to allow the agent to carry out the step specified in the `promptType` . If you set this value to `DISABLED` , the agent skips that step. The default state for each `promptType` is as follows. @@ -316 +296,6 @@ agentVersion -> (structure) ->>>>> For more information, see _Inference request parameters and response fields for foundation models_ in the Amazon Bedrock user guide. +>>>>> * `PRE_PROCESSING` – `DISABLED` +>>>>> * `ORCHESTRATION` – `ENABLED` +>>>>> * `KNOWLEDGE_BASE_RESPONSE_GENERATION` – `ENABLED` +>>>>> * `POST_PROCESSING` – `DISABLED` +>>>>> + @@ -322,4 +306,0 @@ agentVersion -> (structure) ->>>> foundationModel -> (string) ->>>> ->>>>> The agent’s foundation model. ->>>> @@ -330,10 +310,0 @@ agentVersion -> (structure) ->>>>> maximumLength -> (integer) ->>>>> ->>>>>> The maximum number of tokens to allow in the generated response. ->>>>> ->>>>> stopSequences -> (list) ->>>>> ->>>>>> A list of stop sequences. A stop sequence is a sequence of characters that causes the model to stop generating the response. ->>>>>> ->>>>>> (string) ->>>>> @@ -343,0 +315,4 @@ agentVersion -> (structure) +>>>>> topP -> (float) +>>>>> +>>>>>> While generating a response, the model determines the probability of the following token at each point of generation. The value that you set for `Top P` determines the number of most-likely candidates from which the model chooses the next token in the sequence. For example, if you set `topP` to 0.8, the model only selects the next token from the top 80% of the probability distribution of next tokens. +>>>>> @@ -348 +323 @@ agentVersion -> (structure) ->>>>> topP -> (float) +>>>>> maximumLength -> (integer) @@ -350 +325,7 @@ agentVersion -> (structure) ->>>>>> While generating a response, the model determines the probability of the following token at each point of generation. The value that you set for `Top P` determines the number of most-likely candidates from which the model chooses the next token in the sequence. For example, if you set `topP` to 0.8, the model only selects the next token from the top 80% of the probability distribution of next tokens. +>>>>>> The maximum number of tokens to allow in the generated response. +>>>>> +>>>>> stopSequences -> (list) +>>>>> +>>>>>> A list of stop sequences. A stop sequence is a sequence of characters that causes the model to stop generating the response. +>>>>>> +>>>>>> (string) @@ -356 +337 @@ agentVersion -> (structure) ->>>> promptCreationMode -> (string) +>>>> foundationModel -> (string) @@ -358 +339 @@ agentVersion -> (structure) ->>>>> Specifies whether to override the default prompt template for this `promptType` . Set this value to `OVERRIDDEN` to use the prompt that you provide in the `basePromptTemplate` . If you leave it as `DEFAULT` , the agent uses a default prompt template. +>>>>> The agent’s foundation model. @@ -360 +341 @@ agentVersion -> (structure) ->>>> promptState -> (string) +>>>> additionalModelRequestFields -> (document) @@ -362,6 +343 @@ agentVersion -> (structure) ->>>>> Specifies whether to allow the agent to carry out the step specified in the `promptType` . If you set this value to `DISABLED` , the agent skips that step. The default state for each `promptType` is as follows. ->>>>> ->>>>> * `PRE_PROCESSING` – `DISABLED` ->>>>> * `ORCHESTRATION` – `ENABLED` ->>>>> * `KNOWLEDGE_BASE_RESPONSE_GENERATION` – `ENABLED` ->>>>> * `POST_PROCESSING` – `DISABLED` +>>>>> If the Converse or ConverseStream operations support the model, `additionalModelRequestFields` contains additional inference parameters, beyond the base set of inference parameters in the `inferenceConfiguration` field. @@ -369,5 +345,5 @@ agentVersion -> (structure) - ->>>> ->>>> promptType -> (string) ->>>> ->>>>> The step in the agent sequence that this prompt configuration applies to.