Skip to content

mirascope.core.mistral.call_response

This module contains the MistralCallResponse class.

Usage Documentation

Calls

MistralCallResponse

Bases: BaseCallResponse[ChatCompletionResponse, MistralTool, dict[str, Any], AsyncMistralDynamicConfig | MistralDynamicConfig, ChatMessage, MistralCallParams, ChatMessage]

A convenience wrapper around the Mistral ChatCompletion response.

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

Example:

from mirascope.core import prompt_template
from mirascope.core.mistral import mistral_call


@mistral_call("mistral-largel-latest")
def recommend_book(genre: str) -> str:
    return f"Recommend a {genre} book"

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

content property 

content: str

The content of the chat completion for the 0th choice.

finish_reasons property 

finish_reasons: list[str]

Returns the finish reasons of the response.

model property 

model: str

Returns the name of the response model.

id property 

id: str

Returns the id of the response.

usage property 

usage: UsageInfo

Returns the usage of the chat completion.

input_tokens property 

input_tokens: int

Returns the number of input tokens.

output_tokens property 

output_tokens: int | None

Returns the number of output tokens.

cost property 

cost: float | None

Returns the cost of the call.

message_param property 

message_param: ChatMessage

Returns the assistants's response as a message parameter.

tools property 

tools: list[MistralTool] | None

Returns the tools for the 0th choice message.

Raises:

Type Description
ValidationError

if the tool call doesn't match the tool's schema.

tool property 

tool: MistralTool | None

Returns the 0th tool for the 0th choice message.

Raises:

Type Description
ValidationError

if the tool call doesn't match the tool's schema.

tool_message_params classmethod 

tool_message_params(
    tools_and_outputs: list[tuple[MistralTool, str]]
) -> list[ChatMessage]

Returns the tool message parameters for tool call results.

Parameters:

Name Type Description Default
tools_and_outputs list[tuple[MistralTool, str]]

The list of tools and their outputs from which the tool message parameters should be constructed.

 required

Returns:

Type Description
list[ChatMessage]

The list of constructed ChatMessage parameters.
Source code in mirascope/core/mistral/call_response.py 
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
@classmethod
def tool_message_params(
    cls, tools_and_outputs: list[tuple[MistralTool, str]]
) -> list[ChatMessage]:
    """Returns the tool message parameters for tool call results.

    Args:
        tools_and_outputs: The list of tools and their outputs from which the tool
            message parameters should be constructed.

    Returns:
        The list of constructed `ChatMessage` parameters.
    """
    return [
        ChatMessage(
            role="tool",
            content=output,
            tool_call_id=tool.tool_call.id,
            name=tool._name(),
        )
        for tool, output in tools_and_outputs
    ]