Expand description
Data structures used by operation inputs/outputs.
Modules§
Structs§
- AnyTool
Choice The model must request at least one tool (no text is generated). For example,
{"any" : {}}
.- Async
Invoke S3Output Data Config Asynchronous invocation output data settings.
- Async
Invoke Summary A summary of an asynchronous invocation.
- Auto
Tool Choice The Model automatically decides if a tool should be called or whether to generate text instead. For example,
{"auto" : {}}
.- Bidirectional
Input Payload Part Payload content for the bidirectional input. The input is an audio stream.
- Bidirectional
Output Payload Part Output from the bidirectional stream. The output is speech and a text transcription.
- Cache
Point Block Defines a section of content to be cached for reuse in subsequent API calls.
- Citation
Contains information about a citation that references a specific source document. Citations provide traceability between the model's generated response and the source documents that informed that response.
- Citation
Source Content Delta Contains incremental updates to the source content text during streaming responses, allowing clients to build up the cited content progressively.
- Citations
Config Configuration settings for enabling and controlling document citations in Converse API responses. When enabled, the model can include citation information that links generated content back to specific source documents.
- Citations
Content Block A content block that contains both generated text and associated citation information. This block type is returned when document citations are enabled, providing traceability between the generated content and the source documents that informed the response.
- Citations
Delta Contains incremental updates to citation information during streaming responses. This allows clients to build up citation data progressively as the response is generated.
- Content
Block Delta Event The content block delta event.
- Content
Block Start Event Content block start event.
- Content
Block Stop Event A content block stop event.
- Converse
Metrics Metrics for a call to Converse.
- Converse
Stream Metadata Event A conversation stream metadata event.
- Converse
Stream Metrics Metrics for the stream.
- Converse
Stream Trace The trace object in a response from ConverseStream. Currently, you can only trace guardrails.
- Converse
Trace The trace object in a response from Converse. Currently, you can only trace guardrails.
- Document
Block A document to include in a message.
- Document
Char Location Specifies a character-level location within a document, providing precise positioning information for cited content using start and end character indices.
- Document
Chunk Location Specifies a chunk-level location within a document, providing positioning information for cited content using logical document segments or chunks.
- Document
Page Location Specifies a page-level location within a document, providing positioning information for cited content using page numbers.
- Guardrail
Assessment A behavior assessment of the guardrail policies used in a call to the Converse API.
- Guardrail
Configuration Configuration information for a guardrail that you use with the Converse operation.
- Guardrail
Content Filter The content filter for a guardrail.
- Guardrail
Content Policy Assessment An assessment of a content policy for a guardrail.
- Guardrail
Contextual Grounding Filter The details for the guardrails contextual grounding filter.
- Guardrail
Contextual Grounding Policy Assessment The policy assessment details for the guardrails contextual grounding filter.
- Guardrail
Converse Image Block An image block that contains images that you want to assess with a guardrail.
- Guardrail
Converse Text Block A text block that contains text that you want to assess with a guardrail. For more information, see
GuardrailConverseContentBlock
.- Guardrail
Coverage The action of the guardrail coverage details.
- Guardrail
Custom Word A custom word configured in a guardrail.
- Guardrail
Image Block Contain an image which user wants guarded. This block is accepted by the guardrails independent API.
- Guardrail
Image Coverage The details of the guardrail image coverage.
- Guardrail
Invocation Metrics The invocation metrics for the guardrail.
- Guardrail
Managed Word A managed word configured in a guardrail.
- Guardrail
Output Content The output content produced by the guardrail.
- Guardrail
PiiEntity Filter A Personally Identifiable Information (PII) entity configured in a guardrail.
- Guardrail
Regex Filter A Regex filter configured in a guardrail.
- Guardrail
Sensitive Information Policy Assessment The assessment for aPersonally Identifiable Information (PII) policy.
- Guardrail
Stream Configuration Configuration information for a guardrail that you use with the
ConverseStream
action.- Guardrail
Text Block The text block to be evaluated by the guardrail.
- Guardrail
Text Characters Coverage The guardrail coverage for the text characters.
- Guardrail
Topic Information about a topic guardrail.
- Guardrail
Topic Policy Assessment A behavior assessment of a topic policy.
- Guardrail
Trace Assessment A Top level guardrail trace object. For more information, see
ConverseTrace
.- Guardrail
Usage The details on the use of the guardrail.
- Guardrail
Word Policy Assessment The word policy assessment.
- Image
Block Image content for a message.
- Inference
Configuration Base inference parameters to pass to a model in a call to Converse or ConverseStream. For more information, see Inference parameters for foundation models.
If you need to pass additional parameters that the model supports, use the
additionalModelRequestFields
request field in the call toConverse
orConverseStream
. For more information, see Model parameters.- Message
A message input, or returned from, a call to Converse or ConverseStream.
- Message
Start Event The start of a message.
- Message
Stop Event The stop event for a message.
- Payload
Part Payload content included in the response.
- Performance
Configuration Performance settings for a model.
- Prompt
Router Trace A prompt router trace.
- Reasoning
Text Block Contains the reasoning that the model used to return the output.
- S3Location
A storage location in an Amazon S3 bucket.
- Specific
Tool Choice The model must request a specific tool. For example,
{"tool" : {"name" : "Your tool name"}}
.This field is only supported by Anthropic Claude 3 models.
- Tag
A tag.
- Token
Usage The tokens used in a message API inference call.
- Tool
Configuration Configuration information for the tools that you pass to a model. For more information, see Tool use (function calling) in the Amazon Bedrock User Guide.
- Tool
Result Block A tool result block that contains the results for a tool request that the model previously made.
- Tool
Specification The specification for the tool.
- Tool
UseBlock A tool use content block. Contains information about a tool that the model is requesting be run., The model uses the result from the tool to generate a response.
- Tool
UseBlock Delta The delta for a tool use block.
- Tool
UseBlock Start The start of a tool use block.
- Video
Block A video block.
Enums§
- Async
Invoke Output Data Config Asynchronous invocation output data settings.
- Async
Invoke Status - When writing a match expression against
AsyncInvokeStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Cache
Point Type - When writing a match expression against
CachePointType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Citation
Generated Content Contains the generated text content that corresponds to or is supported by a citation from a source document.
- Citation
Location Specifies the precise location within a source document where cited content can be found. This can include character-level positions, page numbers, or document chunks depending on the document type and indexing method.
- Citation
Source Content Contains the actual text content from a source document that is being cited or referenced in the model's response.
- Content
Block A block of content for a message that you pass to, or receive from, a model with the Converse or ConverseStream API operations.
- Content
Block Delta A block of content in a streaming response.
- Content
Block Start Content block start information.
- Conversation
Role - When writing a match expression against
ConversationRole
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Converse
Output The output from a call to Converse.
- Converse
Stream Output The messages output stream
- Document
Content Block Contains the actual content of a document that can be processed by the model and potentially cited in the response.
- Document
Format - When writing a match expression against
DocumentFormat
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Document
Source Contains the content of a document.
- Guardrail
Action - When writing a match expression against
GuardrailAction
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Content Block The content block to be evaluated by the guardrail.
- Guardrail
Content Filter Confidence - When writing a match expression against
GuardrailContentFilterConfidence
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Content Filter Strength - When writing a match expression against
GuardrailContentFilterStrength
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Content Filter Type - When writing a match expression against
GuardrailContentFilterType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Content Policy Action - When writing a match expression against
GuardrailContentPolicyAction
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Content Qualifier - When writing a match expression against
GuardrailContentQualifier
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Content Source - When writing a match expression against
GuardrailContentSource
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Contextual Grounding Filter Type - When writing a match expression against
GuardrailContextualGroundingFilterType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Contextual Grounding Policy Action - When writing a match expression against
GuardrailContextualGroundingPolicyAction
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Converse Content Block -
A content block for selective guarding with the Converse or ConverseStream API operations.
- Guardrail
Converse Content Qualifier - When writing a match expression against
GuardrailConverseContentQualifier
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Converse Image Format - When writing a match expression against
GuardrailConverseImageFormat
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Converse Image Source The image source (image bytes) of the guardrail converse image source.
- Guardrail
Image Format - When writing a match expression against
GuardrailImageFormat
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Image Source The image source (image bytes) of the guardrail image source. Object used in independent api.
- Guardrail
Managed Word Type - When writing a match expression against
GuardrailManagedWordType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Output Scope - When writing a match expression against
GuardrailOutputScope
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
PiiEntity Type - When writing a match expression against
GuardrailPiiEntityType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Sensitive Information Policy Action - When writing a match expression against
GuardrailSensitiveInformationPolicyAction
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Stream Processing Mode - When writing a match expression against
GuardrailStreamProcessingMode
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Topic Policy Action - When writing a match expression against
GuardrailTopicPolicyAction
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Topic Type - When writing a match expression against
GuardrailTopicType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Trace - When writing a match expression against
GuardrailTrace
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Guardrail
Word Policy Action - When writing a match expression against
GuardrailWordPolicyAction
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Image
Format - When writing a match expression against
ImageFormat
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Image
Source The source for an image.
- Invoke
Model With Bidirectional Stream Input Payload content, the speech chunk, for the bidirectional input of the invocation step.
- Invoke
Model With Bidirectional Stream Output Output from the bidirectional stream that was used for model invocation.
- Performance
Config Latency - When writing a match expression against
PerformanceConfigLatency
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Prompt
Variable Values Contains a map of variables in a prompt from Prompt management to an object containing the values to fill in for them when running model invocation. For more information, see How Prompt management works.
- Reasoning
Content Block Contains content regarding the reasoning that is carried out by the model with respect to the content in the content block. Reasoning refers to a Chain of Thought (CoT) that the model generates to enhance the accuracy of its final response.
- Reasoning
Content Block Delta Contains content regarding the reasoning that is carried out by the model with respect to the content in the content block. Reasoning refers to a Chain of Thought (CoT) that the model generates to enhance the accuracy of its final response.
- Response
Stream Definition of content in the response stream.
- Sort
Async Invocation By - When writing a match expression against
SortAsyncInvocationBy
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Sort
Order - When writing a match expression against
SortOrder
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Stop
Reason - When writing a match expression against
StopReason
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - System
Content Block A system content block.
- Tool
Information about a tool that you can use with the Converse API. For more information, see Tool use (function calling) in the Amazon Bedrock User Guide.
- Tool
Choice Determines which tools the model should request in a call to
Converse
orConverseStream
.ToolChoice
is only supported by Anthropic Claude 3 models and by Mistral AI Mistral Large.- Tool
Input Schema The schema for the tool. The top level schema type must be
object
.- Tool
Result Content Block The tool result content block.
- Tool
Result Status - When writing a match expression against
ToolResultStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Trace
- When writing a match expression against
Trace
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Video
Format - When writing a match expression against
VideoFormat
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Video
Source A video source. You can upload a smaller video as a base64-encoded string as long as the encoded file is less than 25MB. You can also transfer videos up to 1GB in size from an S3 bucket.