AWS cli documentation change
Summary
Updated AWS CLI version reference from 2.28.8 to 2.28.11, reordered parameters, restructured prompt variant configurations, and modified field descriptions/output structures
Security assessment
Changes primarily involve documentation structure reorganization, parameter ordering, and configuration details for prompt variants. The client-token parameter (related to idempotency) was moved but not fundamentally changed. No concrete evidence of security vulnerability fixes or new security features added.
Diff
diff --git a/cli/latest/reference/bedrock-agent/create-prompt-version.md b/cli/latest/reference/bedrock-agent/create-prompt-version.md index fa00f30ff..3e68401ab 100644 --- a//cli/latest/reference/bedrock-agent/create-prompt-version.md +++ b//cli/latest/reference/bedrock-agent/create-prompt-version.md @@ -15 +15 @@ - * [AWS CLI 2.28.8 Command Reference](../../index.html) » + * [AWS CLI 2.28.11 Command Reference](../../index.html) » @@ -69,2 +68,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc - [--client-token <value>] - [--description <value>] @@ -71,0 +70,2 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc + [--description <value>] + [--client-token <value>] @@ -97 +97 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -`--client-token` (string) +`--prompt-identifier` (string) @@ -99 +99 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -> A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see [Ensuring idempotency](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html) . +> The unique identifier of the prompt that you want to create a version of. @@ -105 +105 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -`--prompt-identifier` (string) +`--client-token` (string) @@ -107 +107 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -> The unique identifier of the prompt that you want to create a version of. +> A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see [Ensuring idempotency](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html) . @@ -229 +229 @@ Disable automatically prompt for CLI input parameters. -arn -> (string) +name -> (string) @@ -231 +231 @@ arn -> (string) -> The Amazon Resource Name (ARN) of the version of the prompt. +> The name of the prompt. @@ -233 +233 @@ arn -> (string) -createdAt -> (timestamp) +description -> (string) @@ -235 +235 @@ createdAt -> (timestamp) -> The time at which the prompt was created. +> A description for the version. @@ -245,16 +244,0 @@ defaultVariant -> (string) -description -> (string) - -> A description for the version. - -id -> (string) - -> The unique identifier of the prompt. - -name -> (string) - -> The name of the prompt. - -updatedAt -> (timestamp) - -> The time at which the prompt was last updated. - @@ -269 +253 @@ variants -> (list) ->> additionalModelRequestFields -> (document) +>> name -> (string) @@ -271 +255 @@ variants -> (list) ->>> Contains model-specific inference configurations that aren’t in the `inferenceConfiguration` field. To see model-specific inference parameters, see [Inference request parameters and response fields for foundation models](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html) . +>>> The name of the prompt variant. @@ -273 +257 @@ variants -> (list) ->> genAiResource -> (tagged union structure) +>> templateType -> (string) @@ -275,13 +259 @@ variants -> (list) ->>> Specifies a generative AI resource with which to use the prompt. ->>> ->>> ### Note ->>> ->>> This is a Tagged Union structure. Only one of the following top level keys can be set: `agent`. ->>> ->>> agent -> (structure) ->>> ->>>> Specifies an Amazon Bedrock agent with which to use the prompt. ->>>> ->>>> agentIdentifier -> (string) ->>>> ->>>>> The ARN of the agent with which to use the prompt. +>>> The type of prompt template to use. @@ -289 +261 @@ variants -> (list) ->> inferenceConfiguration -> (tagged union structure) +>> templateConfiguration -> (tagged union structure) @@ -291 +263 @@ variants -> (list) ->>> Contains inference configurations for the prompt variant. +>>> Contains configurations for the prompt template. @@ -295 +267 @@ variants -> (list) ->>> This is a Tagged Union structure. Only one of the following top level keys can be set: `text`. +>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `text`, `chat`. @@ -299 +271 @@ variants -> (list) ->>>> Contains inference configurations for a text prompt. +>>>> Contains configurations for the text in a message for a prompt. @@ -301 +273 @@ variants -> (list) ->>>> maxTokens -> (integer) +>>>> text -> (string) @@ -303 +275 @@ variants -> (list) ->>>>> The maximum number of tokens to return in the response. +>>>>> The message for the prompt. @@ -305 +277 @@ variants -> (list) ->>>> stopSequences -> (list) +>>>> cachePoint -> (structure) @@ -307 +279 @@ variants -> (list) ->>>>> A list of strings that define sequences after which the model will stop generating. +>>>>> A cache checkpoint within a template configuration. @@ -309,45 +281,3 @@ variants -> (list) ->>>>> (string) ->>>> ->>>> temperature -> (float) ->>>> ->>>>> Controls the randomness of the response. Choose a lower value for more predictable outputs and a higher value for more surprising outputs. ->>>> ->>>> topP -> (float) ->>>> ->>>>> The percentage of most-likely candidates that the model considers for the next token. ->> ->> metadata -> (list) ->> ->>> An array of objects, each containing a key-value pair that defines a metadata tag and value to attach to a prompt variant. ->>> ->>> (structure) ->>> ->>>> Contains a key-value pair that defines a metadata tag and value to attach to a prompt variant. For more information, see [Create a prompt using Prompt management](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-management-create.html) . ->>>> ->>>> key -> (string) ->>>> ->>>>> The key of a metadata tag for a prompt variant. ->>>> ->>>> value -> (string) ->>>> ->>>>> The value of a metadata tag for a prompt variant. ->> ->> modelId -> (string) ->> ->>> The unique identifier of the model or [inference profile](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html) with which to run inference on the prompt. ->> ->> name -> (string) ->> ->>> The name of the prompt variant. ->> ->> templateConfiguration -> (tagged union structure) ->> ->>> Contains configurations for the prompt template. ->>> ->>> ### Note ->>> ->>> This is a Tagged Union structure. Only one of the following top level keys can be set: `chat`, `text`. ->>> ->>> chat -> (structure) ->>> ->>>> Contains configurations to use the prompt in a conversational format. +>>>>> type -> (string) +>>>>> +>>>>>> Indicates that the CachePointBlock is of the default type @@ -365,0 +296,4 @@ variants -> (list) +>>> +>>> chat -> (structure) +>>> +>>>> Contains configurations to use the prompt in a conversational format. @@ -374,0 +309,4 @@ variants -> (list) +>>>>>> role -> (string) +>>>>>> +>>>>>>> The role that the message belongs to. +>>>>>> @@ -385 +323,5 @@ variants -> (list) ->>>>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `cachePoint`, `text`. +>>>>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `text`, `cachePoint`. +>>>>>>>> +>>>>>>>> text -> (string) +>>>>>>>> +>>>>>>>>> The text in the message. @@ -394,8 +335,0 @@ variants -> (list) ->>>>>>>> ->>>>>>>> text -> (string) ->>>>>>>> ->>>>>>>>> The text in the message. ->>>>>> ->>>>>> role -> (string) ->>>>>> ->>>>>>> The role that the message belongs to. @@ -413 +347,5 @@ variants -> (list) ->>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `cachePoint`, `text`. +>>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `text`, `cachePoint`. +>>>>>> +>>>>>> text -> (string) +>>>>>> +>>>>>>> The text in the system prompt. @@ -422,4 +359,0 @@ variants -> (list) ->>>>>> ->>>>>> text -> (string) ->>>>>> ->>>>>>> The text in the system prompt. @@ -427 +361 @@ variants -> (list) ->>>> toolConfiguration -> (structure) +>>>> inputVariables -> (list) @@ -429 +363 @@ variants -> (list) ->>>>> Configuration information for the tools that the model can use when generating a response. +>>>>> An array of the variables in the prompt template. @@ -431 +365 @@ variants -> (list) ->>>>> toolChoice -> (tagged union structure) +>>>>> (structure) @@ -433,13 +367 @@ variants -> (list) ->>>>>> Defines which tools the model should request when invoked.