AWS cli documentation change
Summary
Updated AWS CLI version reference, restructured action group parameters, added computer use capability documentation, and reorganized field descriptions
Security assessment
Changes include documentation restructuring, version updates, and new feature descriptions for computer use capabilities. No specific security vulnerabilities or mitigations are mentioned. The computer use warning is a beta feature notice rather than a security advisory.
Diff
diff --git a/cli/latest/reference/bedrock-agent/get-agent-action-group.md b/cli/latest/reference/bedrock-agent/get-agent-action-group.md index 5dcb5e9c8..779d54d8d 100644 --- a//cli/latest/reference/bedrock-agent/get-agent-action-group.md +++ b//cli/latest/reference/bedrock-agent/get-agent-action-group.md @@ -15 +15 @@ - * [AWS CLI 2.28.8 Command Reference](../../index.html) » + * [AWS CLI 2.28.11 Command Reference](../../index.html) » @@ -67 +66,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc - --action-group-id <value> @@ -69,0 +69 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc + --action-group-id <value> @@ -94,4 +93,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -`--action-group-id` (string) - -> The unique identifier of the action group for which to get information. - @@ -105,0 +102,4 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc +`--action-group-id` (string) + +> The unique identifier of the action group for which to get information. + @@ -209 +209 @@ agentActionGroup -> (structure) -> actionGroupExecutor -> (tagged union structure) +> agentId -> (string) @@ -211,13 +211,5 @@ agentActionGroup -> (structure) ->> The Amazon Resource Name (ARN) of the Lambda function containing the business logic that is carried out upon invoking the action or the custom control method for handling the information elicited from the user. ->> ->> ### Note ->> ->> This is a Tagged Union structure. Only one of the following top level keys can be set: `customControl`, `lambda`. ->> ->> customControl -> (string) ->> ->>> To return the action group invocation results directly in the `InvokeAgent` response, specify `RETURN_CONTROL` . ->> ->> lambda -> (string) ->> ->>> The Amazon Resource Name (ARN) of the Lambda function containing the business logic that is carried out upon invoking the action. +>> The unique identifier of the agent to which the action group belongs. +> +> agentVersion -> (string) +> +>> The version of the agent to which the action group belongs. @@ -233 +225 @@ agentActionGroup -> (structure) -> actionGroupState -> (string) +> clientToken -> (string) @@ -235 +227 @@ agentActionGroup -> (structure) ->> Specifies whether the action group is available for the agent to invoke or not when sending an [InvokeAgent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) request. +>> 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) . @@ -237 +229 @@ agentActionGroup -> (structure) -> agentId -> (string) +> description -> (string) @@ -239 +231 @@ agentActionGroup -> (structure) ->> The unique identifier of the agent to which the action group belongs. +>> The description of the action group. @@ -241 +233 @@ agentActionGroup -> (structure) -> agentVersion -> (string) +> createdAt -> (timestamp) @@ -243 +235 @@ agentActionGroup -> (structure) ->> The version of the agent to which the action group belongs. +>> The time at which the action group was created. @@ -245 +237 @@ agentActionGroup -> (structure) -> apiSchema -> (tagged union structure) +> updatedAt -> (timestamp) @@ -247 +239,23 @@ agentActionGroup -> (structure) ->> Contains either details about the S3 object containing the OpenAPI schema for the action group or the JSON or YAML-formatted payload defining the schema. For more information, see [Action group OpenAPI schemas](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html) . +>> The time at which the action group was last updated. +> +> parentActionSignature -> (string) +> +>> If this field is set as `AMAZON.UserInput` , the agent can request the user for additional information when trying to complete a task. The `description` , `apiSchema` , and `actionGroupExecutor` fields must be blank for this action group. +>> +>> During orchestration, if the agent determines that it needs to invoke an API in an action group, but doesn’t have enough information to complete the API request, it will invoke this action group instead and return an [Observation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html) reprompting the user for more information. +> +> parentActionGroupSignatureParams -> (map) +> +>> The configuration settings for a computer use action. +>> +>> ### Warning +>> +>> Computer use is a new Anthropic Claude model capability (in beta) available with Claude 3.7 Sonnet and Claude 3.5 Sonnet v2 only. For more information, see [Configure an Amazon Bedrock Agent to complete tasks with computer use tools](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-computer-use.html) . +>> +>> key -> (string) +>> +>> value -> (string) +> +> actionGroupExecutor -> (tagged union structure) +> +>> The Amazon Resource Name (ARN) of the Lambda function containing the business logic that is carried out upon invoking the action or the custom control method for handling the information elicited from the user. @@ -251 +265 @@ agentActionGroup -> (structure) ->> This is a Tagged Union structure. Only one of the following top level keys can be set: `payload`, `s3`. +>> This is a Tagged Union structure. Only one of the following top level keys can be set: `lambda`, `customControl`. @@ -253 +267 @@ agentActionGroup -> (structure) ->> payload -> (string) +>> lambda -> (string) @@ -255 +269,13 @@ agentActionGroup -> (structure) ->>> The JSON or YAML-formatted payload defining the OpenAPI schema for the action group. For more information, see [Action group OpenAPI schemas](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html) . +>>> The Amazon Resource Name (ARN) of the Lambda function containing the business logic that is carried out upon invoking the action. +>> +>> customControl -> (string) +>> +>>> To return the action group invocation results directly in the `InvokeAgent` response, specify `RETURN_CONTROL` . +> +> apiSchema -> (tagged union structure) +> +>> Contains either details about the S3 object containing the OpenAPI schema for the action group or the JSON or YAML-formatted payload defining the schema. For more information, see [Action group OpenAPI schemas](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html) . +>> +>> ### Note +>> +>> This is a Tagged Union structure. Only one of the following top level keys can be set: `s3`, `payload`. @@ -268,12 +294,4 @@ agentActionGroup -> (structure) -> -> clientToken -> (string) -> ->> 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) . -> -> createdAt -> (timestamp) -> ->> The time at which the action group was created. -> -> description -> (string) -> ->> The description of the action group. +>> +>> payload -> (string) +>> +>>> The JSON or YAML-formatted payload defining the OpenAPI schema for the action group. For more information, see [Action group OpenAPI schemas](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-api-schema.html) . @@ -306,4 +323,0 @@ agentActionGroup -> (structure) ->>>> ->>>> description -> (string) ->>>> ->>>>> A description of the function and its purpose. @@ -314,0 +329,4 @@ agentActionGroup -> (structure) +>>>> description -> (string) +>>>> +>>>>> A description of the function and its purpose. +>>>> @@ -339,4 +356,0 @@ agentActionGroup -> (structure) ->>>>>> required -> (boolean) ->>>>>> ->>>>>>> Whether the parameter is required for the agent to complete the function for action group invocation. ->>>>>> @@ -345,0 +360,4 @@ agentActionGroup -> (structure) +>>>>>> +>>>>>> required -> (boolean) +>>>>>> +>>>>>>> Whether the parameter is required for the agent to complete the function for action group invocation. @@ -351,19 +369 @@ agentActionGroup -> (structure) -> parentActionGroupSignatureParams -> (map) -> ->> The configuration settings for a computer use action. ->> ->> ### Warning ->> ->> Computer use is a new Anthropic Claude model capability (in beta) available with Claude 3.7 Sonnet and Claude 3.5 Sonnet v2 only. For more information, see [Configure an Amazon Bedrock Agent to complete tasks with computer use tools](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-computer-use.html) . ->> ->> key -> (string) ->> ->> value -> (string) -> -> parentActionSignature -> (string) -> ->> If this field is set as `AMAZON.UserInput` , the agent can request the user for additional information when trying to complete a task. The `description` , `apiSchema` , and `actionGroupExecutor` fields must be blank for this action group. ->> ->> During orchestration, if the agent determines that it needs to invoke an API in an action group, but doesn’t have enough information to complete the API request, it will invoke this action group instead and return an [Observation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html) reprompting the user for more information. -> -> updatedAt -> (timestamp) +> actionGroupState -> (string) @@ -371 +371 @@ agentActionGroup -> (structure) ->> The time at which the action group was last updated. +>> Specifies whether the action group is available for the agent to invoke or not when sending an [InvokeAgent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) request. @@ -383 +383 @@ agentActionGroup -> (structure) - * [AWS CLI 2.28.8 Command Reference](../../index.html) » + * [AWS CLI 2.28.11 Command Reference](../../index.html) »