VoiceAgentResponseCreateParams interface
Parameters die worden geaccepteerd door een voice-agent-gebeurtenis response.create .
Eigenschappen
| audio | Respons-specifieke audio-instellingen. |
| conversation | Bepaalt aan welk gesprek het antwoord wordt toegevoegd. Momenteel ondersteunt |
| input | Invoeritems die moeten worden opgenomen in de prompt voor het model. Het gebruik van dit veld creëert een nieuwe context voor deze Response in plaats van het standaardgesprek te gebruiken. Een lege array |
| instructions | De standaardsysteeminstructies (bijvoorbeeld systeembericht) die voorafgaand aan modeloproepen worden toegevoegd. Met dit veld kan de client het model begeleiden bij de gewenste antwoorden. Het model kan worden geïnstrueerd over antwoordinhoud en -indeling (bijvoorbeeld 'extreem beknopt zijn', 'act friendly', 'hier zijn voorbeelden van goede reacties') en op audiogedrag (bijvoorbeeld 'snel praten', 'emotie in uw stem injecteren', 'lachen vaak'). De instructies worden niet gegarandeerd gevolgd door het model, maar bieden richtlijnen voor het model over het gewenste gedrag.
Houd er rekening mee dat de server standaardinstructies instelt die worden gebruikt als dit veld niet is ingesteld en zichtbaar is in de |
| interim_response | Tijdelijke responsinstellingen voor deze reactie. |
| max_output_tokens | Maximaal aantal outputtokens voor een enkele assistentrespons, inclusief tool-aanroepen. Geef een geheel getal op tussen 1 en 4096 om uitvoertokens te beperken of |
| metadata | Aangepaste string-sleutel-waarde paren om te koppelen aan de respons. |
| output_modalities | Modaliteiten waarbij de respons kan terugkeren. |
| parallel_tool_calls | Of het model meerdere tools parallel kan oproepen. Alleen ondersteund door redenering van Realtime-modellen zoals |
| pre_generated_assistant_message | Een vooraf gegenereerd assistentbericht om het antwoord te starten. |
| reasoning | Redeneerinstellingen voor het antwoord bij gebruik van een realtime model dat met redeneren kan werken. |
| tools | Hulpprogramma's die beschikbaar zijn voor het model. |
| tool_choice | Hoe het model hulpprogramma's kiest. Bied een van de stringmodi of dwing een specifieke functie/MCP-tool in. |
Eigenschapdetails
audio
Respons-specifieke audio-instellingen.
audio?: PickPropertiesVoiceAgentAudioConfigWaarde van eigenschap
conversation
Bepaalt aan welk gesprek het antwoord wordt toegevoegd. Momenteel ondersteunt auto en none, met auto als standaardwaarde. De auto waarde betekent dat de inhoud van het antwoord wordt toegevoegd aan het standaardgesprek. Stel dit in om none een out-of-band antwoord te maken dat geen items toevoegt aan het standaardgesprek.
conversation?: "auto" | "none"Waarde van eigenschap
"auto" | "none"
input
Invoeritems die moeten worden opgenomen in de prompt voor het model. Het gebruik van dit veld creëert een nieuwe context voor deze Response in plaats van het standaardgesprek te gebruiken. Een lege array [] zal de context voor deze Response opwissen.
Let op: dit kan ook verwijzingen omvatten naar items die eerder in de sessie verschenen met hun id.
input?: RealtimeConversationItemUnion[]Waarde van eigenschap
instructions
De standaardsysteeminstructies (bijvoorbeeld systeembericht) die voorafgaand aan modeloproepen worden toegevoegd. Met dit veld kan de client het model begeleiden bij de gewenste antwoorden. Het model kan worden geïnstrueerd over antwoordinhoud en -indeling (bijvoorbeeld 'extreem beknopt zijn', 'act friendly', 'hier zijn voorbeelden van goede reacties') en op audiogedrag (bijvoorbeeld 'snel praten', 'emotie in uw stem injecteren', 'lachen vaak'). De instructies worden niet gegarandeerd gevolgd door het model, maar bieden richtlijnen voor het model over het gewenste gedrag.
Houd er rekening mee dat de server standaardinstructies instelt die worden gebruikt als dit veld niet is ingesteld en zichtbaar is in de session.created gebeurtenis aan het begin van de sessie.
instructions?: stringWaarde van eigenschap
string
interim_response
Tijdelijke responsinstellingen voor deze reactie.
interim_response?: VoiceAgentInterimResponseConfigUnionWaarde van eigenschap
max_output_tokens
Maximaal aantal outputtokens voor een enkele assistentrespons, inclusief tool-aanroepen. Geef een geheel getal op tussen 1 en 4096 om uitvoertokens te beperken of inf voor de maximaal beschikbare tokens voor een bepaald model. Wordt standaard ingesteld op inf.
max_output_tokens?: number | "inf"Waarde van eigenschap
number | "inf"
metadata
Aangepaste string-sleutel-waarde paren om te koppelen aan de respons.
metadata?: MetadataWaarde van eigenschap
output_modalities
Modaliteiten waarbij de respons kan terugkeren.
output_modalities?: VoiceOutputModality[]Waarde van eigenschap
parallel_tool_calls
Of het model meerdere tools parallel kan oproepen. Alleen ondersteund door redenering van Realtime-modellen zoals gpt-realtime-2.
parallel_tool_calls?: booleanWaarde van eigenschap
boolean
pre_generated_assistant_message
Een vooraf gegenereerd assistentbericht om het antwoord te starten.
pre_generated_assistant_message?: RealtimeConversationItemUnionWaarde van eigenschap
reasoning
Redeneerinstellingen voor het antwoord bij gebruik van een realtime model dat met redeneren kan werken.
reasoning?: RealtimeReasoningWaarde van eigenschap
tools
Hulpprogramma's die beschikbaar zijn voor het model.
tools?: (MCPTool | RealtimeFunctionTool)[]Waarde van eigenschap
(MCPTool | RealtimeFunctionTool)[]
tool_choice
Hoe het model hulpprogramma's kiest. Bied een van de stringmodi of dwing een specifieke functie/MCP-tool in.
tool_choice?: ToolChoiceFunction | ToolChoiceMCP | ToolChoiceOptions