VoiceAgentResponseCreateParams interface

Balíček:

@azure/ai-projects

Parametry přijímací hlasová událost.response.create

Vlastnosti

audio	Nastavení zvuku specifické pro reakci.
conversation	Ovládá, do kterého rozhovoru se odpověď přidá. V současnosti podporuje auto a none, s auto výchozí hodnotou. Hodnota auto znamená, že obsah odpovědi bude přidán do výchozí konverzace. Nastavte to tak, none aby vytvořil odpověď mimo pásmo, která nepřidává položky do výchozí konverzace.
input	Konverzační položky používané jako vstup pro odpovědi přímo do textu.
instructions	Výchozí systémové instrukce (tj. systémová zpráva) připojené k vyžádání modelu. Toto pole umožňuje klientovi řídit model na požadovaných odpovědích. Model lze instruovat o obsahu a formátu odpovědi (např. "buďte velmi stručné", "jednat přátelsky", "tady jsou příklady dobrých odpovědí") a o chování zvuku (např. "rychle mluvit", "vkládat do hlasu emoce", "smět se často"). Není zaručeno, že model bude pokyny dodržovat, ale poskytují modelu vedení ohledně požadovaného chování. Všimněte si, že server nastaví výchozí pokyny, které se použijí, pokud toto pole není nastaveno a jsou viditelné v session.created události na začátku relace.
interim_response	Nastavení pro tuto odpověď jako přechodná reakce.
max_output_tokens	Maximální počet výstupních tokenů pro jednu odpověď asistenta, včetně volání nástrojů. Zadejte celé číslo mezi 1 a 4096, abyste omezili výstupní tokeny nebo inf maximální dostupné tokeny pro daný model. Výchozí hodnota je inf.
metadata	Vlastní páry klíč-hodnota řetězce pro přiřazení k odpovědi.
output_modalities	Modality, které mohou vrátit odpověd.
parallel_tool_calls	Zda model může volat více nástrojů paralelně. Podporují pouze modely gpt-realtime-2reálného času jako .
pre_generated_assistant_message	Předem vytvořená asistentská zpráva použitá k zahájení odpovědi.
reasoning	Nastavení uvažování pro odpověď při použití modelu schopného uvažování v reálném čase.
tools	Nástroje dostupné pro model
tool_choice	Jak model vybírá nástroje. Zadejte jeden z režimů řetězců nebo vynutěte konkrétní funkci/MCP nástroj.

Podrobnosti vlastnosti

audio

Nastavení zvuku specifické pro reakci.

audio?: PickPropertiesVoiceAgentAudioConfig

Hodnota vlastnosti

PickPropertiesVoiceAgentAudioConfig

conversation

Ovládá, do kterého rozhovoru se odpověď přidá. V současnosti podporuje auto a none, s auto výchozí hodnotou. Hodnota auto znamená, že obsah odpovědi bude přidán do výchozí konverzace. Nastavte to tak, none aby vytvořil odpověď mimo pásmo, která nepřidává položky do výchozí konverzace.

conversation?: "auto" | "none"

Hodnota vlastnosti

"auto" | "none"

input

Konverzační položky používané jako vstup pro odpovědi přímo do textu.

input?: RealtimeConversationItemUnion[]

Hodnota vlastnosti

RealtimeConversationItemUnion[]

instructions

Výchozí systémové instrukce (tj. systémová zpráva) připojené k vyžádání modelu. Toto pole umožňuje klientovi řídit model na požadovaných odpovědích. Model lze instruovat o obsahu a formátu odpovědi (např. "buďte velmi stručné", "jednat přátelsky", "tady jsou příklady dobrých odpovědí") a o chování zvuku (např. "rychle mluvit", "vkládat do hlasu emoce", "smět se často"). Není zaručeno, že model bude pokyny dodržovat, ale poskytují modelu vedení ohledně požadovaného chování. Všimněte si, že server nastaví výchozí pokyny, které se použijí, pokud toto pole není nastaveno a jsou viditelné v session.created události na začátku relace.

instructions?: string

Hodnota vlastnosti

string

interim_response

Nastavení pro tuto odpověď jako přechodná reakce.

interim_response?: VoiceAgentInterimResponseConfigUnion

Hodnota vlastnosti

VoiceAgentInterimResponseConfigUnion

max_output_tokens

Maximální počet výstupních tokenů pro jednu odpověď asistenta, včetně volání nástrojů. Zadejte celé číslo mezi 1 a 4096, abyste omezili výstupní tokeny nebo inf maximální dostupné tokeny pro daný model. Výchozí hodnota je inf.

max_output_tokens?: number | "inf"

Hodnota vlastnosti

number | "inf"

metadata

Vlastní páry klíč-hodnota řetězce pro přiřazení k odpovědi.

metadata?: Metadata

Hodnota vlastnosti

Metadata

output_modalities

Modality, které mohou vrátit odpověd.

output_modalities?: VoiceOutputModality[]

Hodnota vlastnosti

VoiceOutputModality[]

parallel_tool_calls

Zda model může volat více nástrojů paralelně. Podporují pouze modely gpt-realtime-2reálného času jako .

parallel_tool_calls?: boolean

Hodnota vlastnosti

boolean

pre_generated_assistant_message

Předem vytvořená asistentská zpráva použitá k zahájení odpovědi.

pre_generated_assistant_message?: RealtimeConversationItemUnion

Hodnota vlastnosti

RealtimeConversationItemUnion

reasoning

Nastavení uvažování pro odpověď při použití modelu schopného uvažování v reálném čase.

reasoning?: RealtimeReasoning

Hodnota vlastnosti

RealtimeReasoning

tools

Nástroje dostupné pro model

tools?: (MCPTool | RealtimeFunctionTool)[]

Hodnota vlastnosti

(MCPTool | RealtimeFunctionTool)[]

tool_choice

Jak model vybírá nástroje. Zadejte jeden z režimů řetězců nebo vynutěte konkrétní funkci/MCP nástroj.

tool_choice?: ToolChoiceFunction | ToolChoiceMCP | ToolChoiceOptions

Hodnota vlastnosti

ToolChoiceFunction | ToolChoiceMCP | ToolChoiceOptions