AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
The CLI doesn't support streaming operations in Amazon Bedrock, including InvokeAgent
.
Sends a prompt for the agent to process and respond to. Note the following fields for the request:
To continue the same conversation with an agent, use the same sessionId
value
in the request.
To activate trace enablement, turn enableTrace
to true
. Trace enablement
helps you follow the agent's reasoning process that led it to the information it processed,
the actions it took, and the final result it yielded. For more information, see Trace
enablement.
End a conversation by setting endSession
to true
.
In the sessionState
object, you can include attributes for the session or prompt
or, if you configured an action group to return control, results from invocation of
the action group.
The response is returned in the bytes
field of the chunk
object.
The attribution
object contains citations for parts of the response.
If you set enableTrace
to true
in the request, you can trace the agent's
steps and reasoning process that led it to the response.
If the action predicted was configured to return control, the response returns parameters
for the action, elicited from the user, in the returnControl
field.
Errors are also surfaced in the response.
For .NET Core this operation is only available in asynchronous form. Please refer to InvokeAgentAsync.
Namespace: Amazon.BedrockAgentRuntime
Assembly: AWSSDK.BedrockAgentRuntime.dll
Version: 3.x.y.z
public virtual InvokeAgentResponse InvokeAgent( InvokeAgentRequest request )
Container for the necessary parameters to execute the InvokeAgent service method.
Exception | Condition |
---|---|
AccessDeniedException | The request is denied because of missing access permissions. Check your permissions and retry your request. |
BadGatewayException | There was an issue with a dependency due to a server issue. Retry your request. |
ConflictException | There was a conflict performing an operation. Resolve the conflict and retry your request. |
DependencyFailedException | There was an issue with a dependency. Check the resource configurations and retry the request. |
InternalServerException | An internal server error occurred. Retry your request. |
ResourceNotFoundException | The specified resource Amazon Resource Name (ARN) was not found. Check the Amazon Resource Name (ARN) and try your request again. |
ServiceQuotaExceededException | The number of requests exceeds the service quota. Resubmit your request later. |
ThrottlingException | The number of requests exceeds the limit. Resubmit your request later. |
ValidationException | Input validation failed. Check your request parameters and retry the request. |
.NET Framework:
Supported in: 4.5 and newer, 3.5