VoiceAgentResponseCreateParams interface
Parametry akceptowane przez zdarzenie agenta response.create głosowego.
Właściwości
| audio | Ustawienia dźwięku specyficzne dla odpowiedzi. |
| conversation | Kontroluje, do której rozmowy dodana jest odpowiedź. Obecnie obsługuje |
| input | Elementy wejściowe do uwzględnienia w wierszu polecenia dla modelu. Użycie tego pola tworzy nowy kontekst dla tej Odpowiedzi zamiast używać domyślnej rozmowy. Pusta tablica |
| instructions | Domyślne instrukcje systemowe (tj. komunikat systemowy) są poprzedzane wywołaniami modelu. To pole umożliwia klientowi kierowanie odpowiedziami modelu w pożądany sposób. Model może być poinstruowany na temat zawartości i formatu odpowiedzi (np. "być bardzo zwięzły", "działać przyjazny", "oto przykłady dobrych odpowiedzi") i zachowania audio (np. "szybko rozmawiać", "wstrzykiwanie emocji do głosu", "śmiać się często"). Instrukcje nie gwarantują, że będą przestrzegane przez model, ale zapewniają przewodnictwo dotyczące pożądanego zachowania modelu.
Należy pamiętać, że serwer ustawia domyślne instrukcje, które będą używane, jeśli to pole nie jest ustawione i są widoczne w |
| interim_response | Ustawienia pośredniej reakcji dla tej odpowiedzi. |
| max_output_tokens | Maksymalna liczba tokenów wyjściowych dla jednej odpowiedzi asystenta, wliczając wywołania narzędzi. Podaj liczbę całkowitą z zakresu od 1 do 4096, aby ograniczyć liczbę tokenów wyjściowych, lub użyj |
| metadata | Niestandardowe pary klucz-wartość łańcuch-łańcuch do powiązania z odpowiedzią. |
| output_modalities | Sposoby, w których odpowiedź może wrócić. |
| parallel_tool_calls | Czy model może wywoływać wiele narzędzi równolegle. Wspierane tylko przez modele rozumowania w czasie rzeczywistym, takie jak |
| pre_generated_assistant_message | Gotową wiadomość asystenta używaną do rozpoczęcia odpowiedzi. |
| reasoning | Ustawienia rozumowania dla odpowiedzi przy użyciu modelu realtime umożliwiającego rozumowanie. |
| tools | Narzędzia dostępne dla modelu. |
| tool_choice | W jaki sposób model wybiera narzędzia. Zapewnij jeden z trybów stringów lub wymusz konkretną funkcję/narzędzie MCP. |
Szczegóły właściwości
audio
Ustawienia dźwięku specyficzne dla odpowiedzi.
audio?: PickPropertiesVoiceAgentAudioConfigWartość właściwości
conversation
Kontroluje, do której rozmowy dodana jest odpowiedź. Obecnie obsługuje auto i none, z auto wartością domyślną. Wartość oznacza auto , że treść odpowiedzi zostanie dodana do domyślnej rozmowy. Ustaw to tak, none aby stworzyć odpowiedź poza pasmem, która nie doda elementów do domyślnej rozmowy.
conversation?: "auto" | "none"Wartość właściwości
"auto" | "none"
input
Elementy wejściowe do uwzględnienia w wierszu polecenia dla modelu. Użycie tego pola tworzy nowy kontekst dla tej Odpowiedzi zamiast używać domyślnej rozmowy. Pusta tablica [] wyczyści kontekst dla tej odpowiedzi.
Należy zauważyć, że może to obejmować odniesienia do przedmiotów, które wcześniej pojawiły się w sesji pod ich identyfikatorem.
input?: RealtimeConversationItemUnion[]Wartość właściwości
instructions
Domyślne instrukcje systemowe (tj. komunikat systemowy) są poprzedzane wywołaniami modelu. To pole umożliwia klientowi kierowanie odpowiedziami modelu w pożądany sposób. Model może być poinstruowany na temat zawartości i formatu odpowiedzi (np. "być bardzo zwięzły", "działać przyjazny", "oto przykłady dobrych odpowiedzi") i zachowania audio (np. "szybko rozmawiać", "wstrzykiwanie emocji do głosu", "śmiać się często"). Instrukcje nie gwarantują, że będą przestrzegane przez model, ale zapewniają przewodnictwo dotyczące pożądanego zachowania modelu.
Należy pamiętać, że serwer ustawia domyślne instrukcje, które będą używane, jeśli to pole nie jest ustawione i są widoczne w session.created zdarzeniu na początku sesji.
instructions?: stringWartość właściwości
string
interim_response
Ustawienia pośredniej reakcji dla tej odpowiedzi.
interim_response?: VoiceAgentInterimResponseConfigUnionWartość właściwości
max_output_tokens
Maksymalna liczba tokenów wyjściowych dla jednej odpowiedzi asystenta, wliczając wywołania narzędzi. Podaj liczbę całkowitą z zakresu od 1 do 4096, aby ograniczyć liczbę tokenów wyjściowych, lub użyj inf dla maksymalnej liczby dostępnych tokenów dla danego modelu. Wartość domyślna to inf.
max_output_tokens?: number | "inf"Wartość właściwości
number | "inf"
metadata
Niestandardowe pary klucz-wartość łańcuch-łańcuch do powiązania z odpowiedzią.
metadata?: MetadataWartość właściwości
output_modalities
Sposoby, w których odpowiedź może wrócić.
output_modalities?: VoiceOutputModality[]Wartość właściwości
parallel_tool_calls
Czy model może wywoływać wiele narzędzi równolegle. Wspierane tylko przez modele rozumowania w czasie rzeczywistym, takie jak gpt-realtime-2.
parallel_tool_calls?: booleanWartość właściwości
boolean
pre_generated_assistant_message
Gotową wiadomość asystenta używaną do rozpoczęcia odpowiedzi.
pre_generated_assistant_message?: RealtimeConversationItemUnionWartość właściwości
reasoning
Ustawienia rozumowania dla odpowiedzi przy użyciu modelu realtime umożliwiającego rozumowanie.
reasoning?: RealtimeReasoningWartość właściwości
tools
Narzędzia dostępne dla modelu.
tools?: (MCPTool | RealtimeFunctionTool)[]Wartość właściwości
(MCPTool | RealtimeFunctionTool)[]
tool_choice
W jaki sposób model wybiera narzędzia. Zapewnij jeden z trybów stringów lub wymusz konkretną funkcję/narzędzie MCP.
tool_choice?: ToolChoiceFunction | ToolChoiceMCP | ToolChoiceOptions