Skip to content

mirascope.core.bedrock.call

A decorator for calling the Bedrock API with a typed function.

Usage Documentation

Calls

This decorator is used to wrap a typed function that calls the Bedrock API. It parses the prompt template of the wrapped function as the messages array and templates the input arguments for the function into each message's template.

Example:

from mirascope.core import prompt_template
from mirascope.core.bedrock import bedrock_call


@bedrock_call("anthropic.claude-3-haiku-20240307-v1:0")
@prompt_template("Recommend a {genre} book")
def recommend_book(genre: str):
    ...

response = recommend_book("fantasy")
print(response.content)

Parameters:

Name Type Description Default
model str

The Bedrock model to use in the API call.

required
stream bool

Whether to stream the response from the API call.

required
tools list[BaseTool | Callable]

The tools to use in the Bedrock API call.

required
response_model BaseModel | BaseType

The response model into which the response should be structured.

required
output_parser Callable[[BedrockCallResponse | ResponseModelT], Any]

A function for parsing the call response whose value will be returned in place of the original call response.

required
json_mode bool

Whether to use JSON Mode.

required
client object

An optional custom client to use in place of the default client.

required
call_params BedrockCallParams

The BedrockCallParams call parameters to use in the API call.

required

Returns:

Name Type Description
decorator Callable

The decorator for turning a typed function into an Bedrock API call.