mirascope.core.azure.call_response | Mirascope
MirascopeLilypad

mirascope.core.azure.call_response

This module contains the AzureCallResponse class.

Usage

Class AzureCallResponse

A convenience wrapper around the Azure ChatCompletion response.

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

Example:

from mirascope.core import prompt_template
from mirascope.core.azure import azure_call


@azure_call("gpt-4o")
def recommend_book(genre: str) -> str:
    return f"Recommend a {genre} book"


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

Bases:

BaseCallResponse[ChatCompletions, AzureTool, ChatCompletionsToolDefinition, AsyncAzureDynamicConfig | AzureDynamicConfig, ChatRequestMessage, AzureCallParams, UserMessage, AzureMessageParamConverter]

Attributes

NameTypeDescription
responseSkipValidation[ChatCompletions]-
contentstrReturns the content of the chat completion for the 0th choice.
finish_reasonslist[str]Returns the finish reasons of the response.
modelstrReturns the name of the response model.
idstrReturns the id of the response.
usageCompletionsUsage | NoneReturns the usage of the chat completion.
input_tokensint | NoneReturns the number of input tokens.
cached_tokensint | NoneReturns the number of cached tokens.
output_tokensint | NoneReturns the number of output tokens.
message_paramSerializeAsAny[AssistantMessage]Returns the assistants's response as a message parameter.
toolslist[AzureTool] | NoneReturns any available tool calls as their `AzureTool` definition.
toolAzureTool | NoneReturns the 0th tool for the 0th choice message.
common_finish_reasonslist[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[AzureTool, str]]The sequence of tools and their outputs from which the tool message parameters should be constructed.

Returns

TypeDescription
list[ToolMessage]The list of constructed `ChatCompletionToolMessageParam` parameters.