mirascope.core.anthropic.call_response | Mirascope
MirascopeLilypad

mirascope.core.anthropic.call_response

This module contains the AnthropicCallResponse class.

Usage

Class AnthropicCallResponse

A convenience wrapper around the Anthropic Message response.

When calling the Anthropic API using a function decorated with anthropic_call, the response will be an AnthropicCallResponse instance with properties that allow for more convenience access to commonly used attributes.

Example:

from mirascope.core import prompt_template
from mirascope.core.anthropic import anthropic_call


@anthropic_call("claude-3-5-sonnet-20240620")
def recommend_book(genre: str) -> str:
    return f"Recommend a {genre} book"


response = recommend_book("fantasy")  # response is an `AnthropicCallResponse` instance
print(response.content)

Bases:

BaseCallResponse[Message, AnthropicTool, ToolParam, AsyncAnthropicDynamicConfig | AnthropicDynamicConfig, MessageParam, AnthropicCallParams, MessageParam, AnthropicMessageParamConverter]

Attributes

NameTypeDescription
contentstrReturns the string text of the 0th text block.
finish_reasonslist[str]Returns the finish reasons of the response.
modelstrReturns the name of the response model.
idstrReturns the id of the response.
usageUsageReturns the usage of the message.
input_tokensintReturns the number of input tokens.
cached_tokensintReturns the number of cached tokens.
output_tokensintReturns the number of output tokens.
message_paramSerializeAsAny[MessageParam]Returns the assistants's response as a message parameter.
toolslist[AnthropicTool] | NoneReturns any available tool calls as their `AnthropicTool` definition.
toolAnthropicTool | NoneReturns the 0th tool for the 0th choice message.
common_finish_reasonslist[types.FinishReason] | NoneProvider-agnostic finish reasons.
common_message_paramBaseMessageParam-
common_user_message_paramBaseMessageParam | None-
cost_metadataCostMetadataGet metadata required for cost calculation.

Function tool_message_params

Returns the tool message parameters for tool call results.

Parameters

NameTypeDescription
clsAny-
tools_and_outputsSequence[tuple[AnthropicTool, str]]The sequence of tools and their outputs from which the tool message parameters should be constructed.

Returns

TypeDescription
list[MessageParam]The list of constructed `MessageParam` parameters.