> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Agent erstellen POST https://api.elevenlabs.io/v1/convai/agents/create Content-Type: application/json Erstellen Sie einen Agenten aus einem Konfigurationsobjekt. Reference: https://elevenlabs.io/docs/api-reference/agents/create ## Servers - `https://api.elevenlabs.io` (Production, default) - `https://api.us.elevenlabs.io` (Production US) - `https://api.eu.residency.elevenlabs.io` (Production EU) - `https://api.in.residency.elevenlabs.io` (Production India) - `https://api.sg.residency.elevenlabs.io` (Production Singapore) ## Request ### Query parameters - `enable_versioning` (boolean, optional, default: true, deprecated) — Veraltet: Alle Agenten sind versioniert. Dieser Parameter wird ignoriert. ### Body (application/json) This endpoint expects a Body_Create_Agent_v1_convai_agents_create_post. - `conversation_config` (ConversationalConfigAPIModel-Input, required) — Gesprächskonfiguration für einen Agenten - `platform_settings` (AgentPlatformSettingsRequestModel, optional, nullable) — Plattformeinstellungen für den Agenten umfassen alle Einstellungen, die nicht die Orchestrierung und Inhalte der Unterhaltung betreffen. - `workflow` (AgentWorkflowRequestModel, optional) — Workflow für den Agenten. Definiert den Ablauf des Gesprächs und wie der Agent mit Tools interagiert. - `name` (string, optional, nullable) — Ein Name, um den Agenten leichter zu finden - `tags` (list of string, optional, nullable) — Tags zum Klassifizieren und Filtern des Agents ## Response ### 200 Erfolgreiche Antwort - `agent_id` (string, required) — ID des erstellten Agenten ## Errors ### 422 Unprocessable Entity Error Validierungsfehler - `detail` (list of ValidationError, optional) ## Types ### ConversationalConfigAPIModel-Input - `asr` (ASRConversationalConfig, optional) — Konfiguration für Transkription in Unterhaltungen - `turn` (TurnConfig, optional) — Konfiguration für Sprecherwechselerkennung - `tts` (TTSConversationalConfig-Input, optional) — Konfiguration für Text to Speech in Unterhaltungen - `conversation` (ConversationConfig-Input, optional) — Konfiguration für Unterhaltungsereignisse - `language_presets` (map from string to LanguagePreset-Input, optional) — Sprachvoreinstellungen für Gespräche - `vad` (VADConfig, optional) — Konfiguration für Sprachaktivitätserkennung - `agent` (AgentConfigAPIModel-Input, optional) — Agent-spezifische Konfiguration ### AgentPlatformSettingsRequestModel - `evaluation` (EvaluationSettings-Input, optional) — Einstellungen für die Auswertung - `widget` (WidgetConfig-Input, optional) — Konfiguration für das Widget - `data_collection` (map from string to AnalysisProperty, optional) — Datenerfassungseinstellungen - `data_collection_scopes` (map from string to enum, optional) — Geltungsbereich pro ID des Datenerfassungselements. Fehlende Schlüssel verwenden standardmäßig den Gesprächsbereich. - Allowed values: `conversation`, `agent` - `analysis_items` (AgentAnalysisItems-Input, optional, nullable) — Per Verweis angehängte Auswertungs- und Datenerfassungselemente. None bedeutet, dass der Agent noch nicht auf Analyseelemente migriert wurde (anders als eine leere, migrierte Menge); in diesem Fall greifen Lesevorgänge auf die bisherigen Felder evaluation/data_collection zurück. - `overrides` (ConversationInitiationClientDataConfig-Input, optional) — Zusätzliche Überschreibungen für den Agenten beim Start der Unterhaltung - `workspace_overrides` (AgentWorkspaceOverrides-Input, optional) — Workspace-Überschreibungen für den Agenten - `testing` (AgentTestingSettings, optional) — Testkonfiguration für den Agent - `archived` (boolean, optional, default: false) — Gibt an, ob der Agent archiviert ist. - `guardrails` (GuardrailsV1-Input, optional) — Guardrails-Konfiguration für den Agenten - `summary_language` (string, optional, nullable) — Sprache für alle Ausgaben der Gesprächsanalyse (Zusammenfassungen, Titel, Bewertungsbegründungen, Begründungen zur Datenerfassung). Falls nicht gesetzt, wird die Sprache aus dem Gespräch abgeleitet. Muss eine der unterstützten Gesprächssprachen sein. - `auto_translate_transcript_to_app_language` (boolean, optional, nullable) — Wenn aktiviert, wird ein Gesprächstranskript beim Öffnen der Transkriptseite automatisch in die Anwendungssprache des Betrachters übersetzt. Wenn nicht festgelegt oder false, werden Transkripte in ihrer Originalsprache angezeigt, sofern der Betrachter nicht manuell eine Übersetzung auswählt. - `auth` (AuthSettings, optional) — Einstellungen für die Authentifizierung - `call_limits` (AgentCallLimits, optional) — Anruflimits für den Agent - `queueing_config` (AgentQueueingConfig, optional) — Konfiguration der Wartewarteschlange für Gleichzeitigkeit des Agents - `privacy` (PrivacyConfig-Input, optional) — Datenschutzeinstellungen für den Agenten - `trust_context` (enum, optional, default: unknown) — Der Vertrauenskontext, in dem der Agent arbeitet. - Allowed values: `unknown`, `low`, `high` - `analysis_llm` (enum, optional) — Standard-LLM-Modell für die Nachbearbeitungsanalyse (Auswertung und Datenerfassung) - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b` - `topic_discovery` (TopicDiscoverySettings, optional) — Konfiguration der Themenerkennung pro Agent - `sentiment_analysis` (SentimentAnalysisSettings, optional) — Konfiguration der Sentimentanalyse nach Anrufen pro Agent - `alerting` (AlertingSettings, optional, nullable) — Warnkonfiguration auf Agent-Ebene, die Workspace-Einstellungen überschreibt. ### AgentWorkflowRequestModel - `edges` (map from string to WorkflowEdgeModel-Input, optional) - `nodes` (map from string to AgentWorkflowRequestModelNodes, optional) - `prevent_subagent_loops` (boolean, optional, default: false) — Ob Schleifen bei der Workflow-Ausführung verhindert werden sollen. ### ValidationError - `loc` (list of ValidationErrorLocItems, required) - `msg` (string, required) - `type` (string, required) ### ASRConversationalConfig - `quality` (enum, optional, default: high) — Die Qualität der Transkription - Allowed values: `high` - `provider` (enum, optional, default: scribe_realtime) — Der Anbieter des Transkriptionsdienstes - Allowed values: `elevenlabs`, `scribe_realtime`, `scribe_v2_turbo` - `user_input_audio_format` (enum, optional, default: pcm_16000) — Das Format des zu transkribierenden Audios - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000` - `keywords` (list of string, optional) — Schlüsselwörter, deren Vorhersagewahrscheinlichkeit erhöht werden soll ### TurnConfig - `turn_timeout` (double, optional, default: 7) — Maximale Wartezeit auf die Antwort des Nutzers, bevor der Nutzer erneut angesprochen wird - `initial_wait_time` (double, optional, nullable) — Wie lange der Agent wartet, bis der Benutzer die Unterhaltung beginnt, wenn die erste Nachricht leer ist. Wenn nicht festgelegt, wird der reguläre turn_timeout verwendet. - `silence_end_call_timeout` (double, optional, default: -1) — Maximale Zeit seit der letzten Äußerung des Nutzers, bevor der Anruf beendet wird - `turn_eagerness` (enum, optional, default: normal) — Steuert, wie schnell der Agent antwortet. Niedrig = weniger schnell (wartet länger), Standard = Standardgeschwindigkeit, Hoch = schneller (antwortet früher) - Allowed values: `patient`, `normal`, `eager` - `spelling_patience` (enum, optional, default: auto) — Steuert, ob der Agent geduldiger sein soll, wenn der Nutzer Zahlen und benannte Entitäten buchstabiert. Auto = modellbasiert, Off = nie zusätzlich warten - Allowed values: `auto`, `off` - `speculative_turn` (boolean, optional, default: false) — Wenn aktiviert, beginnt die Generierung von LLM-Antworten während Stille, bevor die volle Turn-Konfidenz erreicht ist. Dies reduziert die wahrgenommene Latenz, kann aber die LLM-Kosten erhöhen. - `retranscribe_on_turn_timeout` (boolean, optional, default: false) — Wenn aktiviert und VAD keine Sprache erkennt, wird beim Turn-Timeout versucht, das angesammelte Audio erneut zu transkribieren. Deaktiviert die Abrechnung mit Stille-Rabatt, solange die Funktion für den aktiven Agenten oder Workflow-Knoten aktiviert ist. - `turn_model` (enum, optional, default: turn_v3) — Zu verwendende Version des Turn-Detection-Modells. - Allowed values: `turn_v2`, `turn_v3` - `interruption_ignore_terms` (list of string, optional) — Liste von Begriffen, die keine Unterbrechung auslösen sollen, wenn der Nutzer sie sagt (z. B. 'gotcha', 'understood'). Verwendet exakte Groß-/Kleinschreibungsunabhängige Übereinstimmung. - `interruption_ignore_term_languages` (list of string, optional) — Sprachcodes, für die voreingestellte Kategorien ignorierter Begriffe aktiviert wurden. Sie werden explizit gespeichert, damit die Anzeige nicht aus Begriffsüberschneidungen abgeleitet wird. - `merge_with_default_ignore_terms` (boolean, optional, default: false) — Wenn aktiviert, werden zusätzlich zu interruption_ignore_terms die kuratierten Standardbegriffe für interruption_ignore_term_languages verwendet. - `transcribe_on_disabled_interruptions` (boolean, optional, default: false) — Wenn Unterbrechungen deaktiviert sind, wird das Gesagte des Benutzers dennoch transkribiert, damit es in den nächsten Turn übernommen werden kann. Wenn deaktiviert, wird Benutzersprache während eines nicht unterbrechbaren Turns ignoriert und löst keinen Turn aus. - `soft_timeout_config` (SoftTimeoutConfig, optional) — Konfiguration für die Soft-Timeout-Funktion. Liefert sofortiges Feedback bei längeren LLM-Antworten. ### TTSConversationalConfig-Input - `model_id` (enum, optional, default: eleven_v4_turbo) — Das für TTS zu verwendende Modell - Allowed values: `eleven_turbo_v2`, `eleven_turbo_v2_5`, `eleven_flash_v2`, `eleven_flash_v2_5`, `eleven_multilingual_v2`, `eleven_v3_conversational`, `eleven_v4`, `eleven_v4_turbo` - `voice_id` (string, optional, default: cjVigY5qzO86Huf0OWal) — Die für TTS zu verwendende Stimmen-ID - `supported_voices` (list of SupportedVoice, optional) — Zusätzlich unterstützte Stimmen für den Agenten - `expressive_mode` (boolean, optional, default: true) — Wenn aktiviert, wird der Prompt für ausdrucksstarke Audiotags angewendet. Für Nicht-v3-Modelle wird er automatisch deaktiviert. - `suggested_audio_tags` (list of SuggestedAudioTag, optional) — Vorgeschlagene Audio-Tags für ausdrucksstärkere Sprache (für die Modelle eleven_v3 und eleven_v3_conversational). Der Agent kann weiterhin andere, hier nicht aufgeführte Tags verwenden. - `agent_output_audio_format` (enum, optional, default: pcm_16000) — Das für TTS zu verwendende Audioformat - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000` - `stability` (double, optional, default: 0.5) — Die Stabilität der generierten Sprache - `speed` (double, optional, default: 1) — Die Geschwindigkeit der generierten Sprache - `similarity_boost` (double, optional, default: 0.8) — Der Ähnlichkeits-Boost für generierte Sprache - `text_normalisation_type` (enum, optional, default: system_prompt) — Methode zum Umwandeln von Zahlen in Wörter vor der Umwandlung von Text in Sprache. Bei SYSTEM_PROMPT wird der System-Prompt um Normalisierungsanweisungen ergänzt. Bei ELEVENLABS wird der Text nach der Generierung normalisiert, was eine leicht erhöhte Latenz verursacht. - Allowed values: `system_prompt`, `elevenlabs` - `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional) — Die Referenzen auf Aussprachewörterbücher - `enable_phoneme_tags` (boolean, optional, default: true) — Aktivierung der Verarbeitung von SSML-Phonem-Tags für V3-Modelle. Wenn aktiviert, werden Phonem-Tags (inline und aus Aussprachewörterbüchern) vor dem Senden an das Modell in inline-IPA geparst. - `audio_effects` (EffectsSpec-Input, optional, nullable) — Optionale TTS-Effektspezifikation: Filtervoreinstellung, Distanz (Proximity-EQ) und Umgebung (Convolution-Reverb). - `optimize_streaming_latency` (enum, optional, deprecated) — Veraltet: Dieses Feld hat keine Wirkung und wird ignoriert. - Allowed values: `0`, `1`, `2`, `3`, `4` ### ConversationConfig-Input - `text_only` (boolean, optional, default: false) — Wenn aktiviert, wird Audio nicht verarbeitet und nur Text verwendet. Verwenden Sie dies, um Audiokosten zu vermeiden. - `max_duration_seconds` (integer, optional, default: 600) — Die maximale Dauer einer Unterhaltung in Sekunden - `client_events` (list of enum, optional) — Die Ereignisse, die an den Client gesendet werden - Allowed values: `conversation_initiation_metadata`, `asr_initiation_metadata`, `ping`, `audio`, `interruption`, `user_transcript`, `tentative_user_transcript`, `agent_response`, `agent_response_correction`, `client_tool_call`, `mcp_tool_call`, `mcp_connection_status`, `agent_tool_request`, `agent_tool_response`, `agent_tool_response_full_payload`, `agent_response_metadata`, `vad_score`, `agent_chat_response_part`, `client_error`, `guardrail_triggered`, `dtmf_request`, `agent_response_complete`, `context_usage`, `internal_turn_probability`, `internal_tentative_agent_response` - `file_input` (FileInputConfig, optional) — Konfiguration für Dateieingaben (Bild-/PDF-Uploads) während Unterhaltungen. - `monitoring_enabled` (boolean, optional, default: false) — Aktiviert die Echtzeitüberwachung von Gesprächen über WebSocket - `monitoring_events` (list of enum, optional) — Die Ereignisse, die an Monitoring-Verbindungen gesendet werden. - Allowed values: `conversation_initiation_metadata`, `asr_initiation_metadata`, `ping`, `audio`, `interruption`, `user_transcript`, `tentative_user_transcript`, `agent_response`, `agent_response_correction`, `client_tool_call`, `mcp_tool_call`, `mcp_connection_status`, `agent_tool_request`, `agent_tool_response`, `agent_tool_response_full_payload`, `agent_response_metadata`, `vad_score`, `agent_chat_response_part`, `client_error`, `guardrail_triggered`, `dtmf_request`, `agent_response_complete`, `context_usage`, `internal_turn_probability`, `internal_tentative_agent_response` - `dtmf_input_settings` (DTMFInputConfig, optional, nullable) — Erfassung von DTMF-Eingaben (Tastenfeld) während Telefonanrufen konfigurieren - `background_sound` (BackgroundSoundConfig, optional) — Konfiguration für Hintergrundgeräusche während Unterhaltungen. - `source_attribution` (boolean, optional, default: false) — Wenn aktiviert und Inhalte der Wissensbasis vorhanden sind, wird das LLM angewiesen anzugeben, welche Quellen es verwendet hat. ### LanguagePreset-Input - `overrides` (ConversationConfigClientOverride-Input, required) — Die Überschreibungen für die Sprachvoreinstellung - `first_message_translation` (LanguagePresetTranslation, optional, nullable) — Die Übersetzung der ersten Nachricht - `soft_timeout_translation` (LanguagePresetTranslation, optional, nullable) — Die Übersetzung der Soft-Timeout-Nachricht ### VADConfig ### AgentConfigAPIModel-Input - `first_message` (string, optional, default: ) — Wenn nicht leer, die erste Nachricht, die der Agent sagt. Wenn leer, wartet der Agent, bis der Nutzer die Unterhaltung beginnt. - `language` (string, optional, default: en) — Sprache des Agenten – verwendet für ASR und TTS - `hinglish_mode` (boolean, optional, default: false) — Wenn aktiviert, mischt der Agent englische Wörter und Ausdrücke in Antworten auf Hindi, Malayalam, Telugu oder Kannada. - `dynamic_variables` (any, optional) — Konfiguration für dynamische Variablen - `disable_first_message_interruptions` (boolean, optional, default: false) — Wenn true, kann der Nutzer den Agenten nicht unterbrechen, während die erste Nachricht übermittelt wird. - `max_conversation_duration_message` (string, optional, default: ) — Wenn nicht leer, die Nachricht, die der Agent sendet, wenn die maximale Gesprächsdauer erreicht ist. - `text_behavior_overrides` (map from string to BehaviorOverride, optional, nullable) — Überschreibungen des Antwortverhaltens pro Kanal für Textunterhaltungen. Wenn nicht festgelegt, gelten die integrierten Kanalstandards. - `prompt` (PromptAgentAPIModel-Input, optional) — Der Prompt für den Agenten ### EvaluationSettings-Input Einstellungen zur Bewertung der Leistung eines Agenten. Agenten werden anhand einer Reihe von Kriterien bewertet. Erfolg ist definiert als das Erfüllen einer Kombination dieser Kriterien. - `criteria` (list of PromptEvaluationCriteria, optional) — Einzelne Kriterien, anhand derer der Agent bewertet werden soll ### WidgetConfig-Input - `variant` (enum, optional, default: full) — Die Variante des Widgets - Allowed values: `tiny`, `compact`, `full`, `expandable` - `placement` (enum, optional, default: bottom-right) — Die Position des Widgets auf dem Bildschirm - Allowed values: `top-left`, `top`, `top-right`, `bottom-left`, `bottom`, `bottom-right` - `expandable` (enum, optional, default: never) — Ob das Widget erweiterbar ist. - Allowed values: `never`, `mobile`, `desktop`, `always` - `avatar` (WidgetConfigInputAvatar, optional) — Der Avatar des Widgets - `feedback_mode` (enum, optional, default: none) — Der Feedback-Modus des Widgets - Allowed values: `none`, `during`, `end` - `end_feedback` (WidgetEndFeedbackConfig, optional, nullable) — Konfiguration für am Ende der Unterhaltung erfasstes Feedback - `bg_color` (string, optional, default: #ffffff) — Die Hintergrundfarbe des Widgets - `text_color` (string, optional, default: #000000) — Die Textfarbe des Widgets - `btn_color` (string, optional, default: #000000) — Die Schaltflächenfarbe des Widgets - `btn_text_color` (string, optional, default: #ffffff) — Die Textfarbe der Schaltfläche im Widget - `border_color` (string, optional, default: #e1e1e1) — Die Rahmenfarbe des Widgets - `focus_color` (string, optional, default: #000000) — Die Fokusfarbe des Widgets - `border_radius` (integer, optional, nullable) — Der Rahmenradius des Widgets - `btn_radius` (integer, optional, nullable) — Der Schaltflächenradius des Widgets - `action_text` (string, optional, nullable) — Der Aktionstext des Widgets - `start_call_text` (string, optional, nullable) — Der Text für den Gesprächsstart des Widgets - `end_call_text` (string, optional, nullable) — Der Text zum Beenden des Anrufs im Widget - `expand_text` (string, optional, nullable) — Der Erweiterungstext des Widgets - `listening_text` (string, optional, nullable) — Der anzuzeigende Text, wenn der Agent zuhört - `speaking_text` (string, optional, nullable) — Der anzuzeigende Text, wenn der Agent spricht - `shareable_page_text` (string, optional, nullable) — Der beim Teilen anzuzeigende Text - `shareable_page_show_terms` (boolean, optional, default: true) — Ob die Geschäftsbedingungen auf der teilbaren Seite angezeigt werden sollen - `terms_text` (string, optional, nullable) — Der für die Allgemeinen Geschäftsbedingungen anzuzeigende Text - `terms_html` (string, optional, nullable) — Das HTML zur Anzeige der Allgemeinen Geschäftsbedingungen - `terms_key` (string, optional, nullable) — Der anzuzeigende Schlüssel für die Allgemeinen Geschäftsbedingungen - `show_avatar_when_collapsed` (boolean, optional, nullable, default: false) — Ob der Avatar angezeigt werden soll, wenn das Widget eingeklappt ist - `disable_banner` (boolean, optional, default: false) — Ob das Banner deaktiviert werden soll. - `override_link` (string, optional, nullable) — Der Überschreibungslink für das Widget - `markdown_link_allowed_hosts` (list of AllowlistItem, optional) — Liste zulässiger Hostnamen für anklickbare Markdown-Links. Verwenden Sie \{ hostname: '\*' }, um jede Domain zuzulassen. Leer bedeutet, dass keine Links zulässig sind. - `markdown_link_include_www` (boolean, optional, default: true) — Ob www.-Varianten zulässiger Hosts automatisch einbezogen werden sollen. - `markdown_link_allow_http` (boolean, optional, default: true) — Ob zusätzlich zu https:// auch http:// für zulässige Hosts erlaubt werden soll. - `mic_muting_enabled` (boolean, optional, default: true) — Ob das Stummschalten des Mikrofons aktiviert werden soll. - `transcript_enabled` (boolean, optional, default: true) — Ob das Widget das Gesprächstranskript während des Gesprächs anzeigen soll. - `text_input_enabled` (boolean, optional, default: true) — Ob der Nutzer Textnachrichten senden können soll. - `conversation_mode_toggle_enabled` (boolean, optional, default: false) — Ob der Umschalter für den Gesprächsmodus im Widget aktiviert werden soll. - `default_expanded` (boolean, optional, default: false) — Ob das Widget standardmäßig erweitert sein soll. - `always_expanded` (boolean, optional, default: false) — Ob das Widget immer erweitert sein soll. - `dismissible` (boolean, optional, default: false) — Ob der Nutzer das Widget schließen kann. - `show_agent_status` (boolean, optional, default: false) — Ob der Status „in Bearbeitung“, „abgeschlossen“ oder „Fehler“ des Agenten während der Tool-Nutzung angezeigt werden soll - `show_conversation_id` (boolean, optional, default: true) — Ob die Gesprächs-ID nach dem Trennen angezeigt werden soll. - `strip_audio_tags` (boolean, optional, default: true) — Ob Audio-Markup aus Nachrichten entfernt werden soll. - `syntax_highlight_theme` (enum, optional, nullable) — Theme für die Syntaxhervorhebung in Codeblöcken. Wenn nicht festgelegt, verwendet das Widget automatisch die Erkennung. - Allowed values: `light`, `dark` - `text_contents` (WidgetTextContents, optional) — Textinhalte des Widgets - `styles` (WidgetStyles, optional) — Stile für das Widget - `show_resize_button` (boolean, optional, default: true) — Ob die Schaltfläche zum Ändern der Größe angezeigt werden soll - `end_confirmation_enabled` (boolean, optional, default: false) — Ob der Benutzer vor dem Beenden eines Chats oder Anrufs um Bestätigung gebeten werden soll - `language_selector` (boolean, optional, default: false) — Ob die Sprachauswahl angezeigt werden soll - `supports_text_only` (boolean, optional, default: true) — Ob das Widget in den Nur-Text-Modus wechseln kann. - `custom_avatar_path` (string, optional, nullable) — Der Pfad zum benutzerdefinierten Avatar - `language_presets` (map from string to WidgetLanguagePreset, optional) — Sprachvoreinstellungen für das Widget ### AnalysisProperty Datenerfassungseigenschaft mit optionaler LLM-Überschreibung pro Element für die Nachbearbeitungsanalyse. TODO: Statt Vererbung auf Komposition migrieren (value_schema: LiteralJsonSchemaProperty + llm), damit dies künftig sauber auf Objekt-/Array-Schemas verallgemeinert werden kann. - `type` (enum, required) - Allowed values: `boolean`, `string`, `integer`, `number` - `description` (string, optional, default: ) — Die Beschreibung der Eigenschaft. Wenn festgelegt, stellt das LLM den Wert anhand dieser Beschreibung bereit. Nicht gleichzeitig mit dynamic_variable, is_system_provided, constant_value und is_omitted verwendbar. - `enum` (list of string, optional, nullable) — List of allowed string values for string type parameters - `is_system_provided` (boolean, optional, default: false) — Wenn true, wird der Wert vom System zur Laufzeit ausgefüllt. Wird von API-Integration-Webhook-Tools für Vorlagen verwendet. Schließt sich gegenseitig mit description, dynamic_variable, constant_value und is_omitted aus. - `dynamic_variable` (string, optional, default: ) — Der Name der dynamischen Variable, die für den Wert dieser Eigenschaft verwendet werden soll. Kann nicht zusammen mit description, is_system_provided, constant_value und is_omitted verwendet werden. - `allowed_values` (AllowedValues, optional, nullable) — Serverseitige Ablehnungsprüfung für einen von der LLM bereitgestellten Wert: Die Laufzeit lehnt jeden Wert außerhalb der von diesem Objekt benannten zulässigen Menge ab. Die Menge wird der LLM nicht als Enum mitgeteilt. Wird nur unterstützt, wenn die Wertquelle `description` ist; eine Kombination mit dynamic_variable, is_system_provided, constant_value oder is_omitted wird abgelehnt. - `constant_value` (AnalysisPropertyConstantValue, optional, nullable, default: ) — Ein konstanter Wert für diese Eigenschaft. Schließt sich gegenseitig mit description, dynamic_variable, is_system_provided und is_omitted aus. - `is_omitted` (boolean, optional, default: false) — Wenn true, wird dieser Parameter vollständig aus der Anfrage weggelassen. Nur für optionale Parameter gültig. Schließt sich gegenseitig mit description, dynamic_variable, is_system_provided und constant_value aus. - `name` (string, optional, nullable) — Der Name dieses Datensammlungselements. - `llm` (enum, optional, nullable) — LLM-Modell für dieses Analyseelement. Wenn nicht festgelegt, wird der Standardwert analysis_llm des Agenten verwendet. - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b` - `allowed_values_dynamic_variable` (string, optional, default: , deprecated) — VERALTET: Verwenden Sie stattdessen `allowed_values`. Wenn festgelegt, liefert das LLM den Wert, aber die Laufzeitumgebung lehnt jeden Wert ab, der nicht in der Liste dieser dynamischen Variable enthalten ist (muss ein JSON-Array wie ["ws_alpha", "ws_beta"] sein). Verwenden Sie dies, damit das LLM aus einer serverseitig verifizierten Menge auswählen kann (z. B. den IDs, auf die der aktuelle Benutzer zugreifen darf). Erfordert description; schließt sich gegenseitig mit dynamic_variable, is_system_provided, constant_value und is_omitted aus. ### AgentAnalysisItems-Input - `evaluation_criteria` (list of AgentAnalysisItemsInputEvaluationCriteriaItems, optional) - `data_collection` (list of AgentAnalysisItemsInputDataCollectionItems, optional) ### ConversationInitiationClientDataConfig-Input - `conversation_config_override` (ConversationConfigClientOverrideConfig-Input, optional) — Überschreibungen für die Unterhaltungskonfiguration - `custom_llm_extra_body` (boolean, optional, default: false) — Ob ein benutzerdefinierter zusätzlicher LLM-Body einbezogen werden soll. - `enable_conversation_initiation_client_data_from_webhook` (boolean, optional, default: false) — Ob Client-Daten zur Gesprächsinitiierung aus Webhooks aktiviert werden sollen. - `enable_starting_workflow_node_id_from_client` (boolean, optional, default: false) — Gibt an, ob Clients starting_workflow_node_id in Initiierungs-Clientdaten übergeben dürfen. Bei false schlägt das Starten der Unterhaltung beim Übergeben fehl. - `enable_procedure_ids_from_client` (boolean, optional, default: false) — Gibt an, ob Clients procedure_ids in Initiierungs-Clientdaten übergeben dürfen, um auszuwählen, welche Prozeduren des Agenten für die Unterhaltung verfügbar sind. Bei false schlägt das Starten der Unterhaltung beim Übergeben fehl. ### AgentWorkspaceOverrides-Input - `conversation_initiation_client_data_webhook` (ConversationInitiationClientDataWebhook, optional, nullable) — Der Webhook, an den Client-Daten zur Gesprächsinitiierung gesendet werden - `webhooks` (ConvAIWebhooks, optional) ### AgentTestingSettings Einstellungen für die Agent-Testkonfiguration. - `attached_tests` (list of AttachedTestModel, optional) — Liste der Test-IDs, die für diesen Agenten ausgeführt werden sollen ### GuardrailsV1-Input - `version` ("1", optional, default: 1) - `focus` (FocusGuardrail, optional) - `prompt_injection` (PromptInjectionGuardrail, optional) - `content` (ContentGuardrail-Input, optional) - `custom` (CustomGuardrail-Input, optional) — Container für benutzerdefinierte Guardrails, entsprechend dem ModerationGuardrail-Muster ### AuthSettings - `enable_auth` (boolean, optional, default: false) — Wenn auf true gesetzt, ist zum Starten einer Unterhaltung mit einem Agenten ein signiertes Token erforderlich - `allowlist` (list of AllowlistItem, optional) — Eine Liste von Hosts, die Gespräche mit dem Agenten starten dürfen - `require_origin_header` (boolean, optional, default: false) — Wenn aktiviert, werden Verbindungen ohne Origin-Header abgelehnt. Wenn die Zulassungsliste leer ist, hat diese Option keine Wirkung. - `shareable_token` (string, optional, nullable) — Ein teilbarer Token, mit dem ein Gespräch mit dem Agenten gestartet werden kann ### AgentCallLimits - `agent_concurrency_limit` (integer, optional, default: -1) — Die maximale Anzahl gleichzeitiger Unterhaltungen. -1 bedeutet, dass kein Maximum besteht. - `daily_limit` (integer, optional, default: 100000) — Die maximale Anzahl von Unterhaltungen pro Tag - `bursting_enabled` (boolean, optional, default: true) — Ob Bursting aktiviert werden soll. Wenn true, darf das Parallelitätslimit des Workspaces bis zum Dreifachen des Limits überschritten werden. Bei Überschreitung des Limits werden Aufrufe zum doppelten Preis berechnet. ### AgentQueueingConfig - `enabled` (boolean, optional, default: false) — Hält Anrufer in einer Warteschlange, wenn der Agent sein Parallelitätslimit erreicht hat, statt sie sofort abzulehnen. Neue Agenten werden mit aktivierter Warteschlange erstellt, sofern dieses Feld nicht explizit gesetzt wird. - `wait_timeout_seconds` (integer, optional, default: 180) — Maximale Wartezeit eines Anrufers in der Warteschlange, bevor er abgewiesen wird - `hold_audio` (AgentHoldAudioConfig, optional, nullable) — Benutzerdefiniertes Wartesignal für Anrufer in der Warteschlange; wenn nicht festgelegt, hören Anrufer den Standard-Warteton. Schreibgeschützt: Legen Sie es durch Hochladen einer Datei über den Hold-Audio-Endpunkt des Agenten fest. ### PrivacyConfig-Input - `record_voice` (boolean, optional, default: true) — Ob das Gespräch aufgezeichnet werden soll - `retention_days` (integer, optional, default: -1) — Die Anzahl der Tage, für die das Gespräch gespeichert wird. -1 bedeutet, dass es keine Aufbewahrungsgrenze gibt. - `delete_transcript_and_pii` (boolean, optional, default: false) — Ob das Transkript und PII gelöscht werden sollen. - `delete_audio` (boolean, optional, default: false) — Ob das Audio gelöscht werden soll. - `apply_to_existing_conversations` (boolean, optional, default: false) — Ob die Datenschutzeinstellungen auf bestehende Gespräche angewendet werden sollen. - `zero_retention_mode` (boolean, optional, default: false) — Ob der Zero-Retention-Modus aktiviert werden soll – es werden keine PII-Daten gespeichert. - `conversation_history_redaction` (ConversationHistoryRedactionConfig, optional) — Konfiguration für die Schwärzung personenbezogener Daten in der Unterhaltungshistorie ### TopicDiscoverySettings Konfiguration der Themenerkennung pro Agent. Intervall und Analysefenster werden intern verwaltet; dies stellt nur den kundenorientierten Ein-/Aus-Schalter bereit. ### SentimentAnalysisSettings ### AlertingSettings Warnkonfiguration für Agenten- und Workspace-Ebene. Kaskadenreihenfolge für Schwellenwert und automatische Auflösung pro Monitor: Agent → Workspace → Systemstandard. - `monitor_configs` (map from string to AlertingMonitorConfig, optional) — Warnkonfiguration, nach Monitorname gegliedert. - `auto_resolve_after_inactive_minutes` (integer, optional, nullable) — Wie viele Minuten eine Warnung inaktiv bleiben kann, bevor sie automatisch aufgelöst wird. Nicht festgelegte Werte werden von der nächsten Ebene übernommen. - `notifiers` (list of AlertingSettingsNotifiersItems, optional) — Zustellkanäle für Benachrichtigungen zum Lebenszyklus von Warnmeldungen. Werden mit anderen Ebenen kombiniert und anhand von ``webhook_id``, PagerDuty ``connection_id`` oder Slack ``(connection_id, channel_id)`` dedupliziert. ### WorkflowEdgeModel-Input - `source` (string, required) — ID des Quellknotens. - `target` (string, required) — ID des Zielknotens. - `forward_condition` (WorkflowEdgeModelInputForwardCondition, optional, nullable) — Bedingung, die erfüllt sein muss, damit die Kante vorwärts durchlaufen wird (Quelle zu Ziel). - `backward_condition` (WorkflowEdgeModelInputBackwardCondition, optional, nullable) — Bedingung, die erfüllt sein muss, damit die Kante rückwärts durchlaufen wird (Ziel zu Quelle). ### AgentWorkflowRequestModelNodes - `type`: `end` (WorkflowEndNodeModel) - `edge_order` (list of string, optional) — Die IDs ausgehender Kanten in der Reihenfolge, in der sie ausgewertet werden sollen. - `outcome` (enum, optional, default: success) — Ob das Erreichen dieses Endknotens die Konversation erfolgreich beendet oder fehlschlagen lässt. - Allowed values: `success`, `failure` - `position` (Position-Input, optional) — Position des Knotens im Workflow. - `type`: `override_agent` (WorkflowOverrideAgentNodeModel) - `label` (string, required) — Menschenlesbare Bezeichnung für den Knoten, die in der gesamten Benutzeroberfläche verwendet wird. - `additional_knowledge_base` (list of KnowledgeBaseLocator, optional) — Zusätzliche Wissensdatenbankdokumente, auf die der Subagent zugreifen kann. Sie werden zusätzlich zu den Dokumenten des Hauptagenten verwendet. - `additional_prompt` (string, optional) — Spezifisches Ziel für diesen Subagenten. Es wird dem System-Prompt hinzugefügt und kann verwendet werden, um das Verhalten des Agenten in diesem Kontext weiter zu verfeinern. - `additional_tool_ids` (list of string, optional) — IDs zusätzlicher Tools, auf die der Subagent Zugriff hat. Diese werden zusätzlich zu den Tools des Hauptagenten verwendet. - `conversation_config` (ConversationalConfigAPIModelWorkflowOverride-Input, optional) — Konfigurationsüberschreibungen, die angewendet werden, während der Subagent die Unterhaltung führt. - `edge_order` (list of string, optional) — Die IDs ausgehender Kanten in der Reihenfolge, in der sie ausgewertet werden sollen. - `entry_behavior` (enum, optional, default: auto) — Legt fest, ob dieser Knoten beim Eintritt sofort eine Antwort generieren oder auf Nutzereingaben warten soll. Bei "auto" wird das Verhalten anhand des Typs des vorhergehenden Knotens bestimmt: "wait_for_user" nach den Knoten "say" und "start", andernfalls "generate_immediately". - Allowed values: `generate_immediately`, `wait_for_user`, `auto` - `position` (Position-Input, optional) — Position des Knotens im Workflow. - `type`: `phone_number` (WorkflowPhoneNumberNodeModel) - `transfer_destination` (WorkflowPhoneNumberNodeModelInputTransferDestination, required) - `custom_sip_headers` (list of WorkflowPhoneNumberNodeModelInputCustomSipHeadersItems, optional) — Benutzerdefinierte SIP-Header, die bei der Gesprächsweiterleitung eingeschlossen werden. Jeder Header kann entweder ein statischer Wert oder ein Verweis auf eine dynamische Variable sein. - `edge_order` (list of string, optional) — Die IDs ausgehender Kanten in der Reihenfolge, in der sie ausgewertet werden sollen. - `position` (Position-Input, optional) — Position des Knotens im Workflow. - `post_dial_digits` (WorkflowPhoneNumberNodeModelInputPostDialDigits, optional, nullable) — Nach dem Verbindungsaufbau zu sendende DTMF-Ziffern (z. B. 'ww1234' für eine Durchwahl). Kann ein statischer Wert oder ein Verweis auf eine dynamische Variable sein. Verwenden Sie 'w' für eine Pause von 0,5 Sekunden. Nur für Twilio-Weiterleitungen unterstützt. - `sip_refer_play_dialtone` (boolean, optional, default: true) — Wenn True, wird auf dem ursprünglichen Anrufzweig ein Klingelton wiedergegeben, während eine SIP-REFER-Weiterleitung abgeschlossen wird. Der Ton wird über RTP an den SIP-Peer übertragen, der den REFER ausführt. Deaktivieren Sie dies, wenn das empfangende System, z. B. ein SBC oder Contact Center, ihn nicht hören soll. Wenn deaktiviert, hört der Anrufer bis zum Abschluss der Weiterleitung Stille. Nur für SIP-REFER-Weiterleitungen. - `transfer_type` (enum, optional, default: conference) - Allowed values: `blind`, `conference`, `sip_refer` - `uui` (UUITransferConfig, optional, nullable) — User-to-User Information (RFC 7433), die SIP-REFER-Weiterleitungen beigefügt wird. Überträgt den Anrufkontext, etwa CRM-Identifikatoren oder den Eskalationsgrund, über die Weiterleitungsgrenze hinweg. - `type`: `standalone_agent` (WorkflowStandaloneAgentNodeModel) - `agent_id` (string, optional, nullable) — Die ID des Agenten, an den die Unterhaltung übergeben werden soll. None bedeutet eine Übergabe innerhalb des aktuellen Agenten. - `branch_id` (string, optional, nullable) — Optionale Branch-ID für den Zielagenten. Ohne Angabe folgt sie dem Traffic-Deployment des Zielagenten oder verwendet dessen Haupt-Branch, wenn node_id gesetzt ist. - `delay_ms` (integer, optional, default: 0) — Künstliche Verzögerung in Millisekunden vor der Weiterleitung der Unterhaltung. - `edge_order` (list of string, optional) — Die IDs ausgehender Kanten in der Reihenfolge, in der sie ausgewertet werden sollen. - `enable_transferred_agent_first_message` (boolean, optional, default: false) — Ob der übertragene Agent nach der Übergabe seine konfigurierte erste Nachricht senden soll. - `node_id` (string, optional, nullable) — Optionale Zielknoten-ID im Workflow des Ziel-Agenten. Wenn festgelegt, startet die Übergabe an diesem Knoten statt am Standard-Einstiegsknoten. - `position` (Position-Input, optional) — Position des Knotens im Workflow. - `preserve_client_tts_overrides` (boolean, optional, default: false) — Legt fest, ob TTS-Client-Überschreibungen auf den weitergeleiteten Agenten übertragen werden sollen. - `preserve_voice_settings` (boolean, optional, default: false) — Legt fest, ob die Basisstimme, das TTS-Modell und die Stimmeinstellungen auf den übertragenen Agenten übernommen werden sollen. - `transfer_message` (string, optional, nullable) — Optionale Nachricht, die vor dem Einleiten der Weiterleitung an den Benutzer gesendet wird. - `type`: `start` (WorkflowStartNodeModel) - `edge_order` (list of string, optional) — Die IDs ausgehender Kanten in der Reihenfolge, in der sie ausgewertet werden sollen. - `position` (Position-Input, optional) — Position des Knotens im Workflow. - `type`: `tool` (WorkflowToolNodeModel) - `edge_order` (list of string, optional) — Die IDs ausgehender Kanten in der Reihenfolge, in der sie ausgewertet werden sollen. - `position` (Position-Input, optional) — Position des Knotens im Workflow. - `tools` (list of WorkflowToolLocator, optional) — Liste der parallel auszuführenden Tools. Der gesamte Knoten gilt als erfolgreich, wenn alle Tools erfolgreich ausgeführt wurden. - `type`: `say` (WorkflowSayNodeModel) - `label` (string, required) — Menschenlesbare Bezeichnung für den Knoten, die in der gesamten Benutzeroberfläche verwendet wird. - `message` (WorkflowSayNodeModelInputMessage, required) — Nachricht, die dieser Knoten spricht. Verwenden Sie `literal` für genauen Text oder `prompt`, damit das LLM die Nachricht aus einer Beschreibung erzeugt. - `additional_knowledge_base` (list of KnowledgeBaseLocator, optional) — Wissensbasisdokumente, die dem LLM beim Erzeugen der Nachricht dieses Knotens zusätzlich zu den Dokumenten des Agenten zur Verfügung stehen. - `additional_prompt` (string, optional) — Wird zur Konsistenz mit Subagent-Knoten akzeptiert, aber nicht verwendet. Beschreiben Sie die Nachricht in `message.prompt` oder ersetzen Sie den System-Prompt durch `conversation_config.agent.prompt.prompt`. - `additional_tool_ids` (list of string, optional) — Wird zur Konsistenz mit Subagent-Knoten akzeptiert, aber nicht verwendet. Ein Say-Knoten kann keine Tools aufrufen. - `conversation_config` (ConversationalConfigAPIModelWorkflowOverride-Input, optional) — Konfigurationsüberschreibungen, die angewendet werden, während dieser Knoten spricht, etwa die Stimme oder bei Prompt-Nachrichten das LLM und der System-Prompt. - `edge_order` (list of string, optional) — Die IDs ausgehender Kanten in der Reihenfolge, in der sie ausgewertet werden sollen. - `position` (Position-Input, optional) — Position des Knotens im Workflow. - `wait_for_speech_completion` (boolean, optional, default: false) — Bei true wechselt der Workflow erst zum nächsten Knoten, nachdem die Nachricht vollständig gesprochen wurde. - `wait_for_user_response` (boolean, optional, default: false) — Bei true spricht der Knoten seine Nachricht und wartet dann auf die Antwort des Nutzers, bevor ausgehende Kanten ausgewertet werden. So können Kanten anhand der Antwort verzweigen. Bleibt der Nutzer still, wird der Workflow nach dem Turn-Timeout fortgesetzt. - `type`: `update_state` (WorkflowUpdateStateNodeModel) - `label` (string, required) — Menschenlesbare Bezeichnung für den Knoten, die in der gesamten Benutzeroberfläche verwendet wird. - `updates` (list of WorkflowStateUpdate-Input, required) — Statusaktualisierungen, die angewendet werden, wenn der Workflow diesen Knoten erreicht. Ein Knoten akzeptiert höchstens 50 Aktualisierungen. - `edge_order` (list of string, optional) — Die IDs ausgehender Kanten in der Reihenfolge, in der sie ausgewertet werden sollen. - `position` (Position-Input, optional) — Position des Knotens im Workflow. ### ValidationErrorLocItems ### SoftTimeoutConfig Konfiguration für die Soft-Timeout-Funktion während der Generierung von LLM-Antworten. - `timeout_seconds` (double, optional, default: -1) — Zeit in Sekunden, bevor die vordefinierte Nachricht während des Wartens auf die LLM-Antwort angezeigt wird. Zum Deaktivieren auf -1 setzen. - `message` (string, optional, default: Hhmmmm...yeah.) — Nachricht, die angezeigt wird, wenn beim Warten auf die LLM-Antwort der erste weiche Timeout erreicht wird. Unterstützt dynamische Variablen (z. B. \{\{system\_\_time}}, \{\{custom\_variable}}). - `additional_soft_timeout_messages` (list of string, optional) — Zusätzliche statische Füllnachrichten für nachfolgende Soft-Timeouts in derselben LLM-Generierung. Das erste Timeout verwendet `message`. Wenn weniger Nachrichten als `max_soft_timeouts_per_generation` konfiguriert sind, wird die zuletzt konfigurierte Nachricht wiederholt; andernfalls wird eine integrierte Füllnachricht verwendet. - `use_llm_generated_message` (boolean, optional, default: false) — Wenn aktiviert, wird die Nachricht bei einem Soft-Timeout dynamisch generiert, statt die statische Nachricht zu verwenden. - `randomize_fillers` (boolean, optional, default: false) — Wenn aktiviert, wird die Reihenfolge statischer Nachrichten bei einem Soft-Timeout einmal zu Beginn jedes Turns zufällig gemischt. Gilt nur, wenn use_llm_generated_message false ist. - `max_soft_timeouts_per_generation` (integer, optional, default: 1) — Maximale Anzahl von Füllnachrichten beim Warten auf eine einzelne LLM-Antwort. Wird alle timeout_seconds ausgelöst, bis das LLM Inhalte streamt oder dieses Limit erreicht ist. - `llm_generated_message_prompt_override` (string, optional, nullable) — Benutzerdefinierter Prompt zum Generieren der Überbrückungsnachricht bei Soft-Timeout, wenn use\_llm\_generated\_message aktiviert ist. Der aktuelle Gesprächskontext wird als separate Benutzernachricht bereitgestellt. Wenn nicht festgelegt, wird der Standard-Prompt verwendet. Unterstützt dynamische Variablen (z. B. \{\{system\_\_time}}, \{\{custom\_variable}}). - `disable_until_first_user_message` (boolean, optional, default: false) — Wenn true, werden weiche Timeout-Fülltexte unterdrückt, bis die Unterhaltung mindestens eine tatsächliche Benutzernachricht enthält. Verhindert Fülltexte während des Eröffnungsturns des Agenten, z. B. bei Workflow generate-immediately oder Tool-Aufrufen, bevor der Benutzer spricht. ### SupportedVoice - `label` (string, required) - `voice_id` (string, required) - `description` (string, optional, nullable) - `language` (string, optional, nullable) - `model_family` (enum, optional, nullable) - Allowed values: `turbo`, `flash`, `multilingual`, `v3_conversational`, `v4`, `v4_turbo` - `optimize_streaming_latency` (enum, optional, nullable) - Allowed values: `0`, `1`, `2`, `3`, `4` - `stability` (double, optional, nullable) - `speed` (double, optional, nullable) - `similarity_boost` (double, optional, nullable) ### SuggestedAudioTag - `tag` (string, required) — Zu verwendendes Audio-Tag (für beste Leistung 1–2 Wörter, z. B. „happy“, „excited“) - `description` (string, optional, nullable) — Optionale Beschreibung, wann dieses Tag verwendet werden soll ### PydanticPronunciationDictionaryVersionLocator Eine Referenz, damit andere Dokumente auf ein bestimmtes Wörterbuch und dessen Version verweisen können. Dies ist eine Pydantic-Version von PronunciationDictionaryVersionLocatorDBModel. Erforderlich, um die Kompatibilität mit den übrigen Agent-Datenmodellen sicherzustellen. - `pronunciation_dictionary_id` (string, required) — Die ID des Aussprachewörterbuchs - `version_id` (string, required, nullable) — Die ID der Version des Aussprachewörterbuchs ### EffectsSpec-Input Audioeffekte für generierte Sprache: ein Filter-Preset, wahrgenommene Distanz, eine Hallumgebung, ein Hintergrundgeräuschbett und Stereo-Panning. Lassen Sie alle Felder auf den Standardwerten, um unbearbeitetes Audio zu erhalten. - `filter_preset_id` (string, optional, nullable) — ID eines Filter-Presets, das den Klang der Stimme verändert, etwa `phone` oder `old_radio`. Gültige IDs erhalten Sie mit `GET /v1/audio-effects/catalog`. - `distance` (double, optional, default: 0) — Wie weit die sprechende Person vom Mikrofon entfernt klingt, von 0 (nah, unverändert) bis 1 (weit). Höhere Werte dämpfen tiefe und hohe Frequenzen und verschieben bei festgelegter Umgebung die Balance von der trockenen Stimme zum Hall. - `environment_id` (string, optional, nullable) — ID einer Hallumgebung, die die Stimme in einem Raum platziert, etwa `small_room` oder `hall`. Gültige IDs erhalten Sie mit `GET /v1/audio-effects/catalog`. Hall wird in Stereo gerendert und fügt nach Ende der Sprache einen Nachhall von bis zu mehreren Sekunden hinzu. - `background_noise_id` (string, optional, nullable) — ID eines unter die Stimme gelegten Hintergrundgeräuschbetts in Schleife, etwa `cafe` oder `keyboard`. Gültige IDs erhalten Sie mit `GET /v1/audio-effects/catalog`. - `send_level` (double, optional, default: 1) — Wie viel der Stimme in den Hall fließt, von 0 (nichts) bis 1 (vollständig). Gilt nur, wenn `environment_id` festgelegt ist; 0 deaktiviert den Hall. - `pan` (double, optional, default: 0) — Stereoposition der Stimme: von -1 (ganz links) über 0 (Mitte) bis 1 (ganz rechts). Nur die Stimme wird im Stereopanorama positioniert; Hall und Hintergrundgeräusche bleiben mittig. ### FileInputConfig - `enabled` (boolean, optional, default: true) — Wenn aktiviert, können Nutzer im Chat Bilder, PDFs oder Textdateien anhängen, sofern das LLM multimodale Eingaben unterstützt. - `max_files_in_memory` (integer, optional, default: 10) — Anzahl der zuletzt verwendeten Dateien, die während einer Unterhaltung im Speicher bleiben. Ältere Dateien werden zusammengefasst und ihr Speicher wird freigegeben. - `max_files_per_conversation` (integer, optional, default: 10) — Gesamtzahl der Dateien, die ein Nutzer in einer Unterhaltung hochladen kann. Uploads werden pro Datei abgerechnet. Verwenden Sie -1 für kein Limit oder einen Wert >= max_files_in_memory. ### DTMFInputConfig Konfiguration für die Erfassung von DTMF-Eingaben (Tastenfeld) während Telefonanrufen. - `dtmf_input_timeout` (double, optional, default: 2) — Timeout in Sekunden für das Warten auf weitere DTMF-Ziffern - `hash_terminator` (boolean, optional, default: true) — Wenn true, wird die DTMF-Eingabe durch Drücken von # sofort abgeschlossen. - `redact_input` (boolean, optional, default: false) — Wenn true, werden die DTMF-Eingaben des Anrufers im Transkript, Gesprächsprotokoll und in der Analyse durch eine Schwärzungsmarkierung ersetzt. Ziffern, die der Agent wiederholt oder an ein Tool übergibt, sind nicht betroffen. ### BackgroundSoundConfig - `source_type` (enum, optional, nullable) — Der Typ der Hintergrundgeräuschquelle. - Allowed values: `preset` - `source_id` (enum, optional, nullable) — Kennung der Klangquelle. - Allowed values: `office2`, `office1`, `restaurant`, `city`, `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `volume` (double, optional, default: 0.15) — Lautstärke des Hintergrundsounds (0,01 bis 1,0). - `crossfade_loop` (boolean, optional, default: true) — Wendet am Schleifenübergang eine Überblendung an, um hörbare Knackgeräusche bei der Wiederholung zu vermeiden. ### ConversationConfigClientOverride-Input - `asr` (ASRConversationalConfigOverride, optional, nullable) — Konfiguration für Transkription in Unterhaltungen - `turn` (TurnConfigOverride, optional, nullable) — Konfiguration für Sprecherwechselerkennung - `tts` (TTSConversationalConfigOverride, optional, nullable) — Konfiguration für Text to Speech in Unterhaltungen - `conversation` (ConversationConfigOverride, optional, nullable) — Konfiguration für Unterhaltungsereignisse - `agent` (AgentConfigOverride-Input, optional, nullable) — Agent-spezifische Konfiguration ### LanguagePresetTranslation - `source_hash` (string, required) - `text` (string, required) ### BehaviorOverride - `verbosity` (enum, optional, nullable) — Überschreibung der Ausführlichkeit. Wenn nicht festgelegt, gilt der zugrunde liegende Standardwert. - Allowed values: `auto`, `concise`, `thorough` - `output_format` (enum, optional, nullable) — Überschreibung des Ausgabeformats. Wenn nicht festgelegt, gilt der zugrunde liegende Standardwert. - Allowed values: `mp3_22050_32`, `mp3_44100_32`, `mp3_44100_64`, `mp3_44100_96`, `mp3_44100_128`, `mp3_44100_192`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `ulaw_8000` - `interaction_budget` (enum, optional, nullable) — Überschreibung des Interaktionsbudgets. Wenn nicht gesetzt, gilt der zugrunde liegende Standardwert. - Allowed values: `realtime`, `5_minutes`, `10_minutes`, `1_hour` ### PromptAgentAPIModel-Input - `prompt` (string, optional, default: ) — Der Prompt für den Agenten - `llm` (enum, optional) — Das LLM, das mit dem Prompt und dem Chatverlauf abgefragt wird. Bei Verwendung von Datenresidenz muss das LLM in der Datenresidenzumgebung unterstützt werden. - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b` - `reasoning_effort` (enum, optional, nullable) — Reasoning-Aufwand des Modells. Nur für einige Modelle verfügbar. - Allowed values: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max` - `thinking_budget` (integer, optional, nullable) — Maximale Anzahl der für das Denken verwendeten Token. Verwenden Sie 0 zum Deaktivieren, falls das Modell dies unterstützt. - `enable_reasoning_summary` (boolean, optional, default: false) — Aktiviert Zusammenfassungen der Modellüberlegungen. Wenn deaktiviert, fordern wir nach Möglichkeit keine Zusammenfassungen vom Anbieter an, um eine schnellere TTFB zu erreichen. Nicht ZRM-kompatibel. - `temperature` (double, optional, nullable, default: 0) — Die Temperatur für das LLM. Der Standardwert ist 0. Setzen Sie den Wert auf null, um den Parameter vollständig aus der LLM-Anfrage auszuschließen. Das ist für benutzerdefinierte LLMs nützlich, die das Feld temperature ablehnen. - `max_tokens` (integer, optional, default: -1) — Wenn größer als 0: maximale Anzahl an Tokens, die das LLM vorhersagen kann - `tool_ids` (list of string, optional) — Eine Liste der IDs von Tools, die der Agent verwendet - `tool_ids_strict` (boolean, optional, default: false) — Gilt nur als Überschreibung für eine Unterhaltung und ist zulässig, wenn tool_ids überschrieben werden dürfen. Wenn true, enthält die überschreibende tool_ids die vollständige Liste der in der Unterhaltung erlaubten Tools, einschließlich der Tools in Workflow-Knoten. Wird ignoriert, wenn es für den Agenten festgelegt ist. - `built_in_tools` (BuiltInTools-Input, optional) — Integrierte System-Tools, die vom Agent verwendet werden - `enable_parallel_tool_calls` (boolean, optional, default: true) — Aktiviert parallele Tool-Aufrufe. Wenn aktiviert, kann der Agent mehrere Tools innerhalb eines einzelnen Turns parallel ausführen. Nicht von allen Modellen unterstützt. - `mcp_server_ids` (list of string, optional) — Eine Liste der MCP-Server-IDs, die der Agent verwenden soll - `native_mcp_server_ids` (list of string, optional) — Eine Liste der nativen MCP-Server-IDs, die der Agent verwenden soll - `knowledge_base` (list of KnowledgeBaseLocator, optional) — Eine Liste der Wissensdatenbanken, die der Agent verwenden soll - `custom_llm` (CustomLLM, optional, nullable) — Definition für ein benutzerdefiniertes LLM, wenn das LLM-Feld auf 'CUSTOM_LLM' gesetzt ist - `ignore_default_personality` (boolean, optional, nullable, default: true) — Ob die standardmäßigen Persönlichkeitszeilen aus dem System-Prompt entfernt werden sollen - `rag` (RagConfig-Input, optional) — Konfiguration für RAG - `timezone` (string, optional, nullable) — Zeitzone zur Anzeige der aktuellen Zeit im System-Prompt. Wenn festgelegt, wird die aktuelle Zeit in dieser Zeitzone in den System-Prompt aufgenommen. Muss ein gültiger Zeitzonenname sein, z. B. 'America/New_York', 'Europe/London' oder 'UTC'. Für präzise zeitbezogene Antworten empfohlen. Andernfalls kennt der Agent das aktuelle Datum und die Uhrzeit nicht, sofern Sie diese nicht über dynamische Variablen oder Tools bereitstellen. Das kann zu falschen oder halluzinierten Zeitangaben führen. - `backup_llm_config` (PromptAgentApiModelInputBackupLlmConfig, optional) — Konfiguration für die Kaskadierung von Backup-LLMs. Kann deaktiviert sein, Systemstandards verwenden oder eine benutzerdefinierte Reihenfolge festlegen. - `cascade_timeout_seconds` (double, optional, default: 4) — Zeit in Sekunden, bevor auf das Backup-LLM gewechselt wird. Muss zwischen 2 und 15 Sekunden liegen. - `tools` (list of PromptAgentApiModelInputToolsItems, optional, deprecated) — Eine Liste von Tools, die der Agent während des Gesprächs verwenden kann. Verwenden Sie stattdessen tool_ids. ### PromptEvaluationCriteria Eine Auswertung mit dem Transkript und einem Prompt für eine Ja/Nein-Antwort zum Erfolg - `id` (string, required) — Die eindeutige Kennung für die Bewertungskriterien - `name` (string, required) - `conversation_goal_prompt` (string, required) — Der Prompt, den der Agent zur Bewertung des Gesprächs verwenden soll - `type` ("prompt", optional, default: prompt) — Der Typ der Bewertungskriterien - `use_knowledge_base` (boolean, optional, default: false) — Gibt an, ob beim Auswerten des Prompts die Wissensdatenbank des Agenten verwendet werden soll. - `scope` (enum, optional, default: conversation) — Der Umfang des Transkriptkontexts, der zur Bewertung dieses Kriteriums verwendet wird. 'conversation' verwendet das vollständige Transkript; 'agent' verwendet nur den Abschnitt, in dem der definierende Agent aktiv war. - Allowed values: `conversation`, `agent` - `llm` (enum, optional, nullable) — LLM-Modell für dieses Bewertungskriterium. Wenn nicht festgelegt, wird der Standardwert analysis_llm des Agenten verwendet. - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b` - `scoring_mode` (enum, optional, default: binary) — Wie dieses Kriterium bewertet wird. 'binary' ergibt Erfolg/Fehlschlag/unbekannt. 'numeric_uniform' gibt eine Zahl auf der Skala [0, max_score] zurück, die in den aggregierten Erfolgssatz der Unterhaltung normalisiert wird. - Allowed values: `binary`, `numeric_uniform` - `max_score` (integer, optional, default: 100) — Maximalwert der numerischen Bewertungsskala (der Mindestwert ist immer 0). Wird nur verwendet, wenn scoring_mode auf 'numeric_uniform' gesetzt ist. - `score_instructions` (string, optional, nullable) — Optionale Freitextanweisungen zur Zuordnung von Werten auf der numerischen Skala. Wird nur verwendet, wenn scoring_mode den Wert 'numeric_uniform' hat. ### WidgetConfigInputAvatar Der Avatar des Widgets ### WidgetEndFeedbackConfig - `type` (enum, optional, default: rating) — Der Typ des Feedbacks, das am Ende der Unterhaltung erfasst wird - Allowed values: `rating` ### AllowlistItem - `hostname` (string, required) — Der Hostname des zulässigen Ursprungs ### WidgetTextContents - `main_label` (string, optional, nullable) — Call-to-Action, der in der kompakten und der vollständigen Variante angezeigt wird. - `start_call` (string, optional, nullable) — Text und ARIA-Label für die Schaltfläche zum Starten eines Anrufs. - `start_chat` (string, optional, nullable) — Text und ARIA-Label für die Schaltfläche zum Starten eines Chats (nur Text) - `new_call` (string, optional, nullable) — Text und ARIA-Label für die Schaltfläche für einen neuen Anruf. Wird angezeigt, wenn der Anrufer bereits mindestens einen Anruf beendet hat, um den nächsten zu starten. - `end_call` (string, optional, nullable) — Text und ARIA-Label für die Schaltfläche zum Beenden des Anrufs. - `mute_microphone` (string, optional, nullable) — ARIA-Label für die Schaltfläche zum Stummschalten des Mikrofons. - `change_language` (string, optional, nullable) — ARIA-Label für das Dropdown-Menü zum Ändern der Sprache. - `collapse` (string, optional, nullable) — ARIA-Label für die Schaltfläche zum Einklappen. - `expand` (string, optional, nullable) — ARIA-Label für die Schaltfläche zum Ausklappen. - `copied` (string, optional, nullable) — Text, der angezeigt wird, wenn der Nutzer über die Kopierschaltfläche einen Wert kopiert. - `accept_terms` (string, optional, nullable) — Text und ARIA-Label für die Schaltfläche zum Akzeptieren der Bedingungen. - `dismiss_terms` (string, optional, nullable) — Text und ARIA-Label für die Schaltfläche zum Abbrechen der Bedingungen. - `listening_status` (string, optional, nullable) — Angezeigter Status, wenn der Agent zuhört. - `speaking_status` (string, optional, nullable) — Angezeigter Status, wenn der Agent spricht. - `connecting_status` (string, optional, nullable) — Angezeigter Status, wenn der Agent eine Verbindung herstellt. - `chatting_status` (string, optional, nullable) — Angezeigter Status, wenn der Agent chattet (nur Text) - `queue_waiting_status` (string, optional, nullable) — Status, der während des Wartens in der Warteschlange auf einen verfügbaren Agenten angezeigt wird. - `queue_waiting_status_short` (string, optional, nullable) — Kurzer Status, der während des Wartens auf einen verfügbaren Agenten angezeigt wird. - `input_label` (string, optional, nullable) — ARIA-Label für das Texteingabefeld. - `input_placeholder` (string, optional, nullable) — Platzhaltertext für die Texteingabe. - `input_placeholder_text_only` (string, optional, nullable) — Platzhaltertext für die Texteingabe (nur Text) - `input_placeholder_new_conversation` (string, optional, nullable) — Platzhaltertext für die Texteingabe beim Start einer neuen Unterhaltung (nur Text) - `user_ended_conversation` (string, optional, nullable) — Informationsnachricht, die angezeigt wird, wenn der Nutzer das Gespräch beendet. - `agent_ended_conversation` (string, optional, nullable) — Informationsnachricht, die angezeigt wird, wenn der Agent das Gespräch beendet. - `conversation_id` (string, optional, nullable) — Textlabel neben der Gesprächs-ID. - `error_occurred` (string, optional, nullable) — Textlabel, das bei einem Fehler verwendet wird. - `queue_timed_out` (string, optional, nullable) — Fehlermeldung, die bei Ablauf der Wartezeit in der Warteschlange angezeigt wird. - `copy_id` (string, optional, nullable) — Text und ARIA-Label für die Schaltfläche zum Kopieren der ID. - `initiate_feedback` (string, optional, nullable) — Text, der angezeigt wird, um den Nutzer um Feedback zu bitten. - `request_follow_up_feedback` (string, optional, nullable) — Text, der angezeigt wird, um zusätzliche Feedback-Details anzufordern. - `thanks_for_feedback` (string, optional, nullable) — Text, der angezeigt wird, um dem Nutzer für sein Feedback zu danken. - `thanks_for_feedback_details` (string, optional, nullable) — Zusätzlicher angezeigter Text, der den Nutzen von Nutzerfeedback erläutert. - `follow_up_feedback_placeholder` (string, optional, nullable) — Platzhaltertext für das Eingabefeld für anschließendes Feedback. - `submit` (string, optional, nullable) — Text und ARIA-Label für die Absenden-Schaltfläche. - `go_back` (string, optional, nullable) — Text und ARIA-Label für die Schaltfläche „Zurück“. - `send_message` (string, optional, nullable) — Text und ARIA-Label für die Schaltfläche zum Senden einer Nachricht. - `text_mode` (string, optional, nullable) — Text und ARIA-Label für die Schaltfläche zum Wechseln in den Textmodus. - `voice_mode` (string, optional, nullable) — Text und ARIA-Label für die Schaltfläche zum Wechseln in den Sprachmodus. - `switched_to_text_mode` (string, optional, nullable) — Beim Wechsel in den Textmodus angezeigte Toast-Benachrichtigung. - `switched_to_voice_mode` (string, optional, nullable) — Beim Wechsel in den Sprachmodus angezeigte Toast-Benachrichtigung. - `copy` (string, optional, nullable) — Text und ARIA-Label für die Kopierschaltfläche. - `download` (string, optional, nullable) — Text und ARIA-Label für die Download-Schaltfläche. - `wrap` (string, optional, nullable) — Text und ARIA-Label für die Schaltfläche zum Umschalten des Zeilenumbruchs. - `agent_working` (string, optional, nullable) — Statustext, der angezeigt wird, während der Agent einen Tool-Aufruf verarbeitet. - `agent_done` (string, optional, nullable) — Statustext, der angezeigt wird, wenn der Agent die Verarbeitung eines Tool-Aufrufs abschließt. - `agent_error` (string, optional, nullable) — Statustext, der angezeigt wird, wenn beim Tool-Aufruf des Agents ein Fehler auftritt. - `attach_file` (string, optional, nullable) — Text und ARIA-Label für die Schaltfläche zum Anhängen einer Datei. - `remove_file` (string, optional, nullable) — ARIA-Label für die Schaltfläche zum Entfernen der Datei. - `file_upload_error` (string, optional, nullable) — Fehlermeldung, die angezeigt wird, wenn das Hochladen einer Datei fehlschlägt. - `file_type_unsupported` (string, optional, nullable) — Fehlermeldung, die angezeigt wird, wenn ein nicht unterstützter Dateityp ausgewählt wurde. Anschließend folgt die Liste der akzeptierten Typen. - `file_too_large` (string, optional, nullable) — Fehlermeldung, die angezeigt wird, wenn eine Datei die maximale Größenbeschränkung überschreitet. - `file_limit_reached` (string, optional, nullable) — Fehlermeldung, die angezeigt wird, wenn die maximale Anzahl von Dateien für ein Gespräch erreicht ist. - `typing_indicator` (string, optional, nullable) — Statustext, der angezeigt wird, während der Agent schreibt. - `rich_content_unavailable` (string, optional, nullable) — Ersatzmeldung, die angezeigt wird, wenn Rich Content nicht gerendert werden kann. ### WidgetStyles - `base` (string, optional, nullable) — Die Basis-Hintergrundfarbe. - `base_hover` (string, optional, nullable) — Die Farbe des Basis-Hintergrunds beim Darüberfahren. - `base_active` (string, optional, nullable) — Die Farbe des Basis-Hintergrunds im aktiven Zustand (geklickt). - `base_border` (string, optional, nullable) — Die Farbe des Rahmens vor dem Basis-Hintergrund. - `base_subtle` (string, optional, nullable) — Die Farbe des dezenten Texts vor dem Basis-Hintergrund. - `base_primary` (string, optional, nullable) — Die Farbe des primären Texts vor dem Basis-Hintergrund. - `base_error` (string, optional, nullable) — Die Farbe von Fehlertext vor dem Basis-Hintergrund. - `accent` (string, optional, nullable) — Die Akzent-Hintergrundfarbe. - `accent_hover` (string, optional, nullable) — Die Farbe des Akzenthintergrunds beim Darüberfahren. - `accent_active` (string, optional, nullable) — Die Farbe des Akzenthintergrunds im aktiven Zustand (geklickt). - `accent_border` (string, optional, nullable) — Die Farbe des Rahmens vor dem Akzenthintergrund. - `accent_subtle` (string, optional, nullable) — Die Farbe des dezenten Texts vor dem Akzenthintergrund. - `accent_primary` (string, optional, nullable) — Die Farbe des primären Texts vor dem Akzenthintergrund. - `overlay_padding` (double, optional, nullable) — Der Innenabstand an den Rändern des Viewports. - `button_radius` (double, optional, nullable) — Der Radius der Schaltflächen. - `input_radius` (double, optional, nullable) — Der Radius der Eingabefelder. - `bubble_radius` (double, optional, nullable) — Der Radius der Chatblasen. - `sheet_radius` (double, optional, nullable) — Der Standardradius von Sheets. - `compact_sheet_radius` (double, optional, nullable) — Der Radius des Bereichs im kompakten Modus. - `dropdown_sheet_radius` (double, optional, nullable) — Der Radius des Dropdown-Bereichs. ### WidgetLanguagePreset - `text_contents` (WidgetTextContents, optional, nullable) — Der Textinhalt für die ausgewählte Sprache - `text_contents_translation` (WidgetTextContentsTranslation, optional, nullable) — Der Übersetzungscache für die Textinhalte - `terms_text` (string, optional, nullable) — Der in dieser Sprache für die Allgemeinen Geschäftsbedingungen anzuzeigende Text - `terms_html` (string, optional, nullable) — Das HTML zur Anzeige der Allgemeinen Geschäftsbedingungen in dieser Sprache - `terms_key` (string, optional, nullable) — Der anzuzeigende Schlüssel für die Allgemeinen Geschäftsbedingungen in dieser Sprache - `terms_translation` (WidgetTermsTranslation, optional, nullable) — Der Übersetzungscache für die Begriffe ### AllowedValues - `dynamic_variable` (string, required) — Name einer dynamischen Variablen, die zu einem JSON-Array zulässiger Werte aufgelöst werden muss, z. B. ["ws_alpha", "ws_beta"]. Systemvariablen funktionieren nur, wenn sie zu einer Liste aufgelöst werden. ### AnalysisPropertyConstantValue Ein konstanter Wert für diese Eigenschaft. Schließt sich gegenseitig mit description, dynamic_variable, is_system_provided und is_omitted aus. ### AgentAnalysisItemsInputEvaluationCriteriaItems - `source`: `system` (AttachedSystemEvaluationRef) - `analysis_item_id` (enum, required) — ID der referenzierten integrierten Systembewertung. - Allowed values: `__system_eval_criteria_sentiment`, `__system_eval_criteria_frustration` - `scope` (enum, optional, default: conversation) — Beim Ausführen dieses Elements verwendeter Transkriptkontext ('conversation' oder 'agent'). - Allowed values: `conversation`, `agent` - `weight` (double, optional, nullable) — Optionales relatives Gewicht für die Gesamtbewertung. - `source`: `user` (AttachedUserEvaluationRef) - `analysis_item_id` (string, required) — ID des referenzierten Nutzerbewertungselements. - `additional_version_ids` (list of string, optional) — Zusätzliche Elementversionen, die ebenfalls für einen Vergleich (A/B) ausgeführt werden. Sie werden ausgeführt und gespeichert, aber nicht bewertet; die primäre version_id wird bewertet. - `scope` (enum, optional, default: conversation) — Beim Ausführen dieses Elements verwendeter Transkriptkontext ('conversation' oder 'agent'). - Allowed values: `conversation`, `agent` - `version_id` (string, optional, nullable) — Primäre Elementversion, deren Ergebnis in die Bewertung einfließt. None verfolgt die zuletzt veröffentlichte Version des Elements. - `weight` (double, optional, nullable) — Optionales relatives Gewicht für die Gesamtbewertung. ### AgentAnalysisItemsInputDataCollectionItems - `source`: `system` (AttachedSystemDataCollectionRef) - `analysis_item_id` (enum, required) — ID des referenzierten integrierten Systemdatensammlungselements. - Allowed values: `__system_data_collection_topic` - `scope` (enum, optional, default: conversation) — Beim Ausführen dieses Elements verwendeter Transkriptkontext ('conversation' oder 'agent'). - Allowed values: `conversation`, `agent` - `source`: `user` (AttachedUserDataCollectionRef) - `analysis_item_id` (string, required) — ID des referenzierten Nutzerdatensammlungselements. - `scope` (enum, optional, default: conversation) — Beim Ausführen dieses Elements verwendeter Transkriptkontext ('conversation' oder 'agent'). - Allowed values: `conversation`, `agent` - `version_id` (string, optional, nullable) — Angeheftete Elementversion. None verfolgt die zuletzt veröffentlichte Version des Elements. ### ConversationConfigClientOverrideConfig-Input - `asr` (ASRConversationalConfigOverrideConfig, optional) — Konfiguriert Überschreibungen für verschachtelte Felder. - `turn` (TurnConfigOverrideConfig, optional) — Konfiguriert Überschreibungen für verschachtelte Felder. - `tts` (TTSConversationalConfigOverrideConfig, optional) — Konfiguriert Überschreibungen für verschachtelte Felder. - `conversation` (ConversationConfigOverrideConfig, optional) — Konfiguriert Überschreibungen für verschachtelte Felder. - `agent` (AgentConfigOverrideConfig, optional) — Konfiguriert Überschreibungen für verschachtelte Felder. ### ConversationInitiationClientDataWebhook - `url` (string, required) — Die URL, an die der Webhook gesendet wird - `request_headers` (map from string to ConversationInitiationClientDataWebhookRequestHeaders, required) — Die Header, die mit der Webhook-Anfrage gesendet werden sollen ### ConvAIWebhooks - `post_call_webhook_id` (string, optional, nullable) - `events` (list of enum, optional) — Liste der Event-Typen, die über Webhook gesendet werden sollen. Optionen: transcript, audio, call_initiation_failure, answering_machine_detection, unredacted_transcript, unredacted_audio. - Allowed values: `transcript`, `audio`, `call_initiation_failure`, `answering_machine_detection`, `unredacted_transcript`, `unredacted_audio` - `transcript_format` (enum, optional, default: json) — Format für Transkript-Webhooks. - Allowed values: `json`, `opentelemetry` - `exclude_transcript` (boolean, optional, default: false) — Wenn true, lassen JSON-Webhooks für Transkriptionen nach dem Anruf das zugweise Transkript weg. Analyse, Metadaten und andere Unterhaltungsfelder werden weiterhin gesendet. Wird für das OpenTelemetry-Transkriptformat ignoriert. - `send_audio` (boolean, optional, nullable, deprecated) — VERALTET: Verwenden Sie stattdessen das Feld 'events'. Legt fest, ob Audiodaten mit Post-Call-Webhooks für ConvAI-Gespräche gesendet werden. ### AttachedTestModel - `test_id` (string, required) - `workflow_node_id` (string, optional, nullable) ### FocusGuardrail - `is_enabled` (boolean, optional, default: false) ### PromptInjectionGuardrail - `is_enabled` (boolean, optional, default: false) ### ContentGuardrail-Input - `execution_mode` (enum, optional, default: streaming) - Allowed values: `streaming`, `blocking` - `config` (ContentConfig, optional) - `trigger_action` (ContentGuardrailInputTriggerAction, optional) ### CustomGuardrail-Input Container für benutzerdefinierte Guardrails, entsprechend dem ModerationGuardrail-Muster - `config` (CustomGuardrailsConfig-Input, optional) — Konfigurationscontainer für eine Liste benutzerdefinierter Guardrails ### AgentHoldAudioConfig Benutzerdefiniertes Wartesignal, das Anrufern in der Warteschlange des Agenten in Schleife vorgespielt wird. Wird durch Hochladen einer Datei über den Hold-Audio-Endpunkt des Agenten festgelegt. Werte aus Anfragen zum Erstellen oder Aktualisieren von Agenten werden ignoriert. - `audio_path` (string, required) — Speicherpfad des hochgeladenen Clips - `audio_url` (string, required) — Öffentliche CDN-URL des hochgeladenen Clips - `original_filename` (string, required) — Dateiname des hochgeladenen Clips, wie vom Nutzer angegeben - `duration_secs` (double, required) — Dauer des hochgeladenen Clips in Sekunden - `size_bytes` (integer, required) — Größe des hochgeladenen Clips in Byte ### ConversationHistoryRedactionConfig - `enabled` (boolean, optional, default: false) — Gibt an, ob die Schwärzung des Unterhaltungsverlaufs aktiviert ist. - `entities` (list of enum, optional) — Die Entitäten, die aus dem Gesprächstranskript, Audio und der Analyse geschwärzt werden sollen. Verwenden Sie Typen der obersten Ebene wie „name“, „email_address“ oder Punktnotation für bestimmte Untertypen wie „name.full_name“. - Allowed values: `name`, `name.name_given`, `name.name_family`, `name.name_other`, `email_address`, `contact_number`, `dob`, `age`, `religious_belief`, `political_opinion`, `sexual_orientation`, `ethnicity_race`, `marital_status`, `occupation`, `physical_attribute`, `language`, `username`, `password`, `url`, `organization`, `financial_id`, `financial_id.payment_card`, `financial_id.payment_card.payment_card_number`, `financial_id.payment_card.payment_card_expiration_date`, `financial_id.payment_card.payment_card_cvv`, `financial_id.bank_account`, `financial_id.bank_account.bank_account_number`, `financial_id.bank_account.bank_routing_number`, `financial_id.bank_account.swift_bic_code`, `financial_id.financial_id_other`, `location`, `location.location_address`, `location.location_city`, `location.location_postal_code`, `location.location_coordinate`, `location.location_state`, `location.location_country`, `location.location_other`, `date`, `date_interval`, `unique_id`, `unique_id.government_issued_id`, `unique_id.account_number`, `unique_id.vehicle_id`, `unique_id.healthcare_number`, `unique_id.healthcare_number.medical_record_number`, `unique_id.healthcare_number.health_plan_beneficiary_number`, `unique_id.device_id`, `unique_id.unique_id_other`, `medical`, `medical.medical_condition`, `medical.medication`, `medical.medical_procedure`, `medical.medical_measurement`, `medical.medical_other` - `excluded_data_collection_ids` (list of string, optional) — IDs von Datenerfassungselementen, deren extrahierte Werte nicht geschwärzt werden. Ihre Begründungen werden weiterhin geschwärzt. ### AlertingMonitorConfig - `enabled` (boolean, optional, nullable) — Ob dieser Monitor aktiviert ist und Benachrichtigungen senden kann. - `threshold` (double, optional, nullable) — Fehlerratenschwelle, ab der dieser Monitor benachrichtigen kann. - `relative_increase_threshold` (double, optional, nullable) — Relative Steigerung gegenüber der bisherigen Basislinie, ab der dieser Monitor benachrichtigen kann (0.2 = 20 % über der Basislinie, 0 = jeder Fehler). Bei conversation_volume_drop ist dies der Anteil des üblichen Volumens, der fehlen muss, zwischen 0.1 und 0.9 (0.5 = die Hälfte). - `min_failure_count` (integer, optional, nullable) — Minimale Anzahl von Fehlern im Zeitfenster, bevor dieser Monitor ausgelöst werden kann. - `min_history_bucket_count` (integer, optional, nullable) — Minimale Anzahl vorhergehender Buckets mit Traffic, bevor die Spike-Erkennung ausgelöst werden kann. - `min_sample_count` (integer, optional, nullable) — Minimale Anzahl von Samples im Zeitfenster, bevor dieser Monitor ausgelöst werden kann. - `suspect_trigger_threshold` (integer, optional, nullable) — Wie viele verdächtige Buckets innerhalb des Rückblickfensters erforderlich sind, um einen Verdachtsfall zu einer Warnung hochzustufen. - `auto_resolve_after_inactive_minutes` (integer, optional, nullable) — Wie viele Minuten eine Warnung inaktiv bleiben kann, bevor sie automatisch aufgelöst wird. ### AlertingSettingsNotifiersItems - `type`: `webhook` (AlertingWebhookNotifier) - `webhook_id` (string, required) — ID des Workspace-Webhooks, an den Benachrichtigungen zum Warnungslebenszyklus gesendet werden. - `type`: `integration` (AlertingIntegrationNotifier) - `connection_id` (string, required) — ID der Workspace-Integrationsverbindung, an die Benachrichtigungen zum Warnungslebenszyklus gesendet werden. Die Integration der Verbindung muss die Überwachungsfunktion unterstützen und mit ``integration_type`` übereinstimmen. - `channel_id` (string, optional) — ID des Slack-Kanals, in dem Warnbenachrichtigungen veröffentlicht werden, z. B. ``C0123456789``. Erforderlich, wenn ``integration_type`` den Wert ``slack`` hat. Die Slack-App muss Mitglied des Kanals sein und den Bereich ``chat:write`` haben, oder für öffentliche Kanäle, denen sie nicht beigetreten ist, ``chat:write.public``. - `integration_type` (enum, optional) — Integration, an die zugestellt werden soll. Der Server behandelt einen ausgelassenen Wert als ``pagerduty``. - Allowed values: `pagerduty`, `slack` ### WorkflowEdgeModelInputForwardCondition Bedingung, die erfüllt sein muss, damit die Kante vorwärts durchlaufen wird (Quelle zu Ziel). - `type`: `expression` (WorkflowExpressionConditionModel) - `expression` (ASTNode-Input, required) — Auszuwertender Ausdruck. - `label` (string, optional, nullable) — Optionale menschenlesbare Bezeichnung für die in der gesamten Benutzeroberfläche verwendete Bedingung. - `type`: `llm` (WorkflowLLMConditionModel) - `condition` (string, required) — Auszuwertende Bedingung - `label` (string, optional, nullable) — Optionale menschenlesbare Bezeichnung für die in der gesamten Benutzeroberfläche verwendete Bedingung. - `type`: `result` (WorkflowResultConditionModel) - `successful` (boolean, required) — Gibt an, ob alle Tools im zuvor ausgeführten Tool-Knoten erfolgreich ausgeführt wurden. - `label` (string, optional, nullable) — Optionale menschenlesbare Bezeichnung für die in der gesamten Benutzeroberfläche verwendete Bedingung. - `type`: `unconditional` (WorkflowUnconditionalModel) - `label` (string, optional, nullable) — Optionale menschenlesbare Bezeichnung für die in der gesamten Benutzeroberfläche verwendete Bedingung. ### WorkflowEdgeModelInputBackwardCondition Bedingung, die erfüllt sein muss, damit die Kante rückwärts durchlaufen wird (Ziel zu Quelle). - `type`: `expression` (WorkflowExpressionConditionModel) - `expression` (ASTNode-Input, required) — Auszuwertender Ausdruck. - `label` (string, optional, nullable) — Optionale menschenlesbare Bezeichnung für die in der gesamten Benutzeroberfläche verwendete Bedingung. - `type`: `llm` (WorkflowLLMConditionModel) - `condition` (string, required) — Auszuwertende Bedingung - `label` (string, optional, nullable) — Optionale menschenlesbare Bezeichnung für die in der gesamten Benutzeroberfläche verwendete Bedingung. - `type`: `result` (WorkflowResultConditionModel) - `successful` (boolean, required) — Gibt an, ob alle Tools im zuvor ausgeführten Tool-Knoten erfolgreich ausgeführt wurden. - `label` (string, optional, nullable) — Optionale menschenlesbare Bezeichnung für die in der gesamten Benutzeroberfläche verwendete Bedingung. - `type`: `unconditional` (WorkflowUnconditionalModel) - `label` (string, optional, nullable) — Optionale menschenlesbare Bezeichnung für die in der gesamten Benutzeroberfläche verwendete Bedingung. ### Position-Input - `x` (double, optional, default: 0) - `y` (double, optional, default: 0) ### KnowledgeBaseLocator - `type` (enum, required) — Der Typ der Wissensdatenbank - Allowed values: `file`, `url`, `text`, `folder` - `name` (string, required) — Der Name der Wissensdatenbank - `id` (string, required) — Die ID der Wissensdatenbank - `usage_mode` (enum, optional, default: auto) — Der Nutzungsmodus der Wissensdatenbank - Allowed values: `prompt`, `auto` ### ConversationalConfigAPIModelWorkflowOverride-Input - `asr` (ASRConversationalConfigWorkflowOverride, optional, nullable) — Konfiguration für Transkription in Unterhaltungen - `turn` (TurnConfigWorkflowOverride, optional, nullable) — Konfiguration für Sprecherwechselerkennung - `tts` (TTSConversationalConfigWorkflowOverride-Input, optional, nullable) — Konfiguration für Text to Speech in Unterhaltungen - `conversation` (ConversationConfigWorkflowOverride-Input, optional, nullable) — Konfiguration für Unterhaltungsereignisse - `language_presets` (map from string to LanguagePreset-Input, optional, nullable) — Sprachvoreinstellungen für Gespräche - `vad` (VADConfigWorkflowOverride, optional, nullable) — Konfiguration für Sprachaktivitätserkennung - `agent` (AgentConfigAPIModelWorkflowOverride-Input, optional, nullable) — Agent-spezifische Konfiguration ### WorkflowPhoneNumberNodeModelInputTransferDestination - `type`: `phone` (PhoneNumberTransferDestination) - `phone_number` (string, required) - `type`: `phone_dynamic_variable` (PhoneNumberDynamicVariableTransferDestination) - `phone_number` (string, required) - `type`: `sip_uri` (SIPUriTransferDestination) - `sip_uri` (string, required) - `type`: `sip_uri_dynamic_variable` (SIPUriDynamicVariableTransferDestination) - `sip_uri` (string, required) ### WorkflowPhoneNumberNodeModelInputCustomSipHeadersItems - `type`: `dynamic` (CustomSIPHeaderWithDynamicVariable) - `key` (string, required) — Der SIP-Headername (z. B. 'X-Customer-ID') - `value` (string, required) — Der aufzulösende Name der dynamischen Variable - `type`: `static` (CustomSIPHeader) - `key` (string, required) — Der SIP-Headername (z. B. 'X-Customer-ID') - `value` (string, required) — Der Header-Wert ### WorkflowPhoneNumberNodeModelInputPostDialDigits Nach dem Verbindungsaufbau zu sendende DTMF-Ziffern (z. B. 'ww1234' für eine Durchwahl). Kann ein statischer Wert oder ein Verweis auf eine dynamische Variable sein. Verwenden Sie 'w' für eine Pause von 0,5 Sekunden. Nur für Twilio-Weiterleitungen unterstützt. - `type`: `dynamic` (PostDialDigitsDynamicVariable) - `value` (string, required) — Der aufzulösende Name der dynamischen Variable - `type`: `static` (PostDialDigitsStatic) - `value` (string, required) — Nach dem Verbindungsaufbau zu sendende DTMF-Ziffern (z. B. 'ww1234' für eine Durchwahl) ### UUITransferConfig User-to-User-Information-Umschlag für SIP-REFER-Weiterleitungen (RFC 7433). Ausgehende Payloads sind hexadezimal codiert (die einzige in RFC 7433 definierte Codierung). Die Protokolldiskriminator-Achse ermöglicht, plattformspezifische Formate (Talkdesk, Genesys, ...) per Konfiguration auszudrücken, statt über verstreute Weiterleitungs-Flags. Weitere Achsen (ASCII-Codierung, Header-Name, Zweck-/Inhaltsparameter) können hier ergänzt werden, ohne das Weiterleitungsmodell anzupassen. - `data` (string, required) — UUI-Payload, die bei SIP-REFER-Weiterleitungen gesendet wird. Unterstützt eingebettete dynamische Variablen und wird bei der Weiterleitung hexadezimal codiert. - `protocol_discriminator` (string, optional, nullable) — Optionaler Ein-Oktett-Protokolldiskriminator (zwei Hexadezimalziffern, z. B. '00'). Erforderlich für Plattformen wie Genesys Cloud, die andernfalls das erste Oktett der Payload entfernen. Für Plattformen wie Talkdesk, die eine reine Hex-Payload erwarten, nicht festlegen. - `protocol_discriminator_mode` (enum, optional, default: prefix) — Wie protocol\_discriminator angehängt wird. 'prefix' stellt das Oktett der hexadezimalen Nutzlast voran (User-to-User=XX\;encoding=hex). 'pd\_parameter' sendet es als separaten Parameter (User-to-User=\;pd=XX;encoding=hex). Wird ignoriert, wenn protocol\_discriminator nicht festgelegt ist. - Allowed values: `prefix`, `pd_parameter` ### WorkflowToolLocator - `tool_id` (string, required) - `schema_overrides` (map from string to WorkflowToolLocatorSchemaOverrides, optional, nullable) — Parameterüberschreibungen pro Knoten, die zusätzlich zur Konfiguration des Tools angewendet werden. Schlüssel sind punktgetrennte Parameterpfade (Webhook-Tools stellen Schlüsseln path_params./query_params./request_body. voran). Sie haben Vorrang vor allen Überschreibungen, die bereits im Tool selbst definiert sind. ### WorkflowSayNodeModelInputMessage Nachricht, die dieser Knoten spricht. Verwenden Sie `literal` für genauen Text oder `prompt`, damit das LLM die Nachricht aus einer Beschreibung erzeugt. - `type`: `literal` (SayNodeLiteralMessage) - `text` (string, required) — Der genaue Text, den der Agent spricht. Unterstützt Platzhalter für dynamische Variablen wie `{{variable_name}}`. - `text_translations` (map from string to TranslatedString, optional) — Übersetzungen von `text`, nach Sprachcode geordnet. Wenn für die Gesprächssprache ein Eintrag vorhanden ist, wird dessen Wert statt `text` gesprochen. - `type`: `prompt` (SayNodePromptMessage) - `prompt` (string, required) — Beschreibung der Nachricht, die das LLM erzeugen soll. Sie wird zum System-Prompt des Agenten hinzugefügt, während dieser Knoten aktiv ist. ### WorkflowStateUpdate-Input - `variable_name` (string, required) — Name der dynamischen Variablen, der ein Wert zugewiesen wird. - `expression` (ASTNode-Input, required) — Ausdruck, dessen Ergebnis der Variablen zugewiesen wird. Er kann Konstanten, andere dynamische Variablen, vom LLM extrahierte Werte und Operatoren kombinieren. - `type` ("dynamic_variable", optional, default: dynamic_variable) - `required` (boolean, optional, default: true) — Bei false kann das LLM die Werte weglassen, auf denen diese Aktualisierung basiert. Die Aktualisierung wird dann übersprungen und die Variable behält ihren aktuellen Wert. ### ASRConversationalConfigOverride - `keywords` (list of string, optional, nullable) — Schlüsselwörter, deren Vorhersagewahrscheinlichkeit erhöht werden soll ### TurnConfigOverride - `soft_timeout_config` (SoftTimeoutConfigOverride, optional, nullable) — Konfiguration für die Soft-Timeout-Funktion. Liefert sofortiges Feedback bei längeren LLM-Antworten. ### TTSConversationalConfigOverride - `model_id` (enum, optional, nullable, default: eleven_v4_turbo) — Das für TTS zu verwendende Modell - Allowed values: `eleven_turbo_v2`, `eleven_turbo_v2_5`, `eleven_flash_v2`, `eleven_flash_v2_5`, `eleven_multilingual_v2`, `eleven_v3_conversational`, `eleven_v4`, `eleven_v4_turbo` - `voice_id` (string, optional, nullable) — Die für TTS zu verwendende Stimmen-ID - `supported_voices` (list of SupportedVoice, optional, nullable) — Zusätzlich unterstützte Stimmen für den Agenten - `stability` (double, optional, nullable) — Die Stabilität der generierten Sprache - `speed` (double, optional, nullable) — Die Geschwindigkeit der generierten Sprache - `similarity_boost` (double, optional, nullable) — Der Ähnlichkeits-Boost für generierte Sprache - `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional, nullable) — Die Referenzen auf Aussprachewörterbücher ### ConversationConfigOverride - `text_only` (boolean, optional, nullable) — Wenn aktiviert, wird Audio nicht verarbeitet und nur Text verwendet. Verwenden Sie dies, um Audiokosten zu vermeiden. - `max_duration_seconds` (integer, optional, nullable) — Die maximale Dauer einer Unterhaltung in Sekunden ### AgentConfigOverride-Input - `first_message` (string, optional, nullable) — Wenn nicht leer, die erste Nachricht, die der Agent sagt. Wenn leer, wartet der Agent, bis der Nutzer die Unterhaltung beginnt. - `language` (string, optional, nullable) — Sprache des Agenten – verwendet für ASR und TTS - `max_conversation_duration_message` (string, optional, nullable) — Wenn nicht leer, die Nachricht, die der Agent sendet, wenn die maximale Gesprächsdauer erreicht ist. - `prompt` (PromptAgentAPIModelOverride-Input, optional, nullable) — Der Prompt für den Agenten ### BuiltInTools-Input Systemtools, die einem Conversational Agent bereitgestellt werden können. Absichtlich nicht ConversationalBuiltInTools genannt: BuiltInToolsInput und BuiltInToolsOutput sind Teil der öffentlichen API-Spezifikation und der generierten SDKs. - `transfer_to_agent` (SystemToolConfig, optional, nullable) — Das Tool zum Weiterleiten an einen Agenten - `end_call` (SystemToolConfig, optional, nullable) — Das Tool zum Beenden des Anrufs - `language_detection` (SystemToolConfig, optional, nullable) — Das Tool zur Spracherkennung - `transfer_to_number` (SystemToolConfig, optional, nullable) — Das Tool zum Weiterleiten an eine Nummer - `skip_turn` (SystemToolConfig, optional, nullable) — Das Tool zum Überspringen eines Gesprächszugs - `play_keypad_touch_tone` (SystemToolConfig, optional, nullable) — Das DTMF-Wiedergabetool - `voicemail_detection` (SystemToolConfig, optional, nullable) — Das Tool zur Mailbox-Erkennung ### CustomLLM - `url` (string, required) — Die URL des mit Chat Completions kompatiblen Endpunkts - `model_id` (string, optional, nullable) — Die zu verwendende Modell-ID, wenn die URL mehrere Modelle bereitstellt - `api_key` (CustomLlmApiKey, optional, nullable) — Der API-Schlüssel zur Authentifizierung. Entweder eine Arbeitsbereichs-Secret-Referenz \{'secret\_id': '...'} oder eine Umgebungsvariablen-Referenz \{'env\_var\_label': '...'}. - `auth_connection` (CustomLlmAuthConnection, optional, nullable) — Optionale Workspace-Authentifizierungsverbindung. Es werden nur Authentifizierungsverbindungen unterstützt, die ein Authorization-Bearer-Token erzeugen. Basic Auth, mTLS, benutzerdefinierte Header und URL-Secret-Authentifizierungsverbindungen werden nicht unterstützt. - `request_headers` (map from string to CustomLlmRequestHeaders, optional) — Header, die in die Anfrage aufgenommen werden sollen - `api_version` (string, optional, nullable) — Die für die Anfrage zu verwendende API-Version - `api_type` (enum, optional, default: chat_completions) — Der zu verwendende API-Typ (chat_completions, responses oder websocket) - Allowed values: `chat_completions`, `responses`, `websocket` ### RagConfig-Input - `enabled` (boolean, optional, default: false) - `embedding_model` (enum, optional, default: e5_mistral_7b_instruct) - Allowed values: `e5_mistral_7b_instruct`, `multilingual_e5_large_instruct` - `max_vector_distance` (double, optional, default: 0.6) — Maximale Vektordistanz abgerufener Chunks. - `max_documents_length` (integer, optional, default: 50000) — Maximale Gesamtlänge der von RAG abgerufenen Dokument-Chunks. - `max_retrieved_rag_chunks_count` (integer, optional, default: 20) — Maximale Anzahl von RAG-Dokument-Chunks, die zunächst aus dem Vektorspeicher abgerufen werden. Diese werden anschließend nach Vektordistanz und Gesamtlänge weiter gefiltert. - `num_candidates` (integer, optional, nullable) — Anzahl der in der ANN-Vektorsuche bewerteten Kandidaten. Eine höhere Anzahl liefert bessere Ergebnisse, erhöht aber die Latenz. Der empfohlene Mindestwert beträgt 100. Wenn deaktiviert, wird der Standardwert verwendet. - `query_rewrite_prompt_override` (string, optional, nullable) — Benutzerdefinierter Prompt zum Umschreiben von Benutzeranfragen vor dem RAG-Abruf. Der Gesprächsverlauf wird automatisch am Ende angehängt. Wenn nicht festgelegt, wird der Standard-Prompt verwendet. - `knowledge_base_tool_info` (KnowledgeBaseToolInfo, optional, nullable) — Wenn festgelegt, verwendet der Agent das Tool knowledge_base statt des veralteten Tools knowledge_base_rag. None bedeutet, dass der Agent nicht aktiviert ist. ### PromptAgentApiModelInputBackupLlmConfig Konfiguration für die Kaskadierung von Backup-LLMs. Kann deaktiviert sein, Systemstandards verwenden oder eine benutzerdefinierte Reihenfolge festlegen. - `preference`: `default` (BackupLLMDefault) - `preference`: `disabled` (BackupLLMDisabled) - `preference`: `override` (BackupLLMOverride) - `order` (list of enum, required) - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b` ### PromptAgentApiModelInputToolsItems Der Tool-Typ - `type`: `api_integration_webhook` (ApiIntegrationWebhookToolConfig) - `api_integration_connection_id` (string, required) - `api_integration_id` (string, required) - `description` (string, required) — Beschreibung, wann das Tool verwendet werden soll und was es tut. - `name` (string, required) - `api_schema_overrides` (ApiIntegrationWebhookOverrides, optional, nullable) — Nutzerüberschreibungen, die zusätzlich zu api_schema angewendet werden - `assignments` (list of DynamicVariableAssignment, optional) — Konfiguration zum Extrahieren von Werten aus Tool-Antworten und Zuweisen zu dynamischen Variablen - `dynamic_variables` (DynamicVariablesConfig, optional) — Konfiguration für dynamische Variablen - `execution_mode` (enum, optional, default: immediate) — Legt fest, wann und wie das Tool ausgeführt wird: 'immediate' führt das Tool sofort aus, wenn das LLM es anfordert, 'post_tool_speech' wartet, bis der Agent zu Ende gesprochen hat, und 'async' führt das Tool im Hintergrund ohne Blockierung aus – ideal für lang laufende Vorgänge. - Allowed values: `immediate`, `post_tool_speech`, `async` - `interruption_mode` (enum, optional, default: allow) — Controls whether the user can interrupt the agent around this tool call. 'allow' (default) lets the user interrupt at any time, 'disable_during_tool' suppresses interruptions only while the tool is running, 'disable_during_tool_and_turn' suppresses interruptions while the tool runs and for the agent response that follows it. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Controls whether the agent speaks before this tool is called. 'auto' (default) decides based on recent tool latency, 'force' always asks the agent to speak, 'off' fully opts out regardless of latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — Die maximale Wartezeit in Sekunden für den Abschluss des Tool-Aufrufs. Muss zwischen 5 und 300 Sekunden liegen, einschließlich. - `tool_call_sound` (enum, optional, nullable) — Vordefinierter Tool-Aufruf-Soundtyp, der während der Tool-Ausführung abgespielt wird. Wenn nicht angegeben, wird kein Tool-Aufruf-Sound abgespielt. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Legt fest, wann der Ton für Tool-Aufrufe abgespielt werden soll. 'auto' spielt ihn nur ab, wenn vor dem Tool-Aufruf gesprochen wird; 'always' spielt ihn bei jedem Tool-Aufruf ab. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Controls how tool errors are processed before being shared with the agent. 'auto' determines handling based on tool type (summarized for native integrations, hide for others), 'summarized' sends an LLM-generated summary, 'passthrough' sends the raw error, 'hide' does not share the error with the agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `tool_version` (string, optional, default: 1.0.0) — Die Version des API-Integrationstools - `disable_interruptions` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `interruption_mode`. Bei true kann der Benutzer den Agenten nicht unterbrechen, während dieses Tool ausgeführt wird. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `pre_tool_speech`. Bei true spricht der Agent vor dem Tool-Aufruf. - `type`: `client` (ClientToolConfig) - `description` (string, required) — Beschreibung, wann das Tool verwendet werden soll und was es tut. - `name` (string, required) - `assignments` (list of DynamicVariableAssignment, optional) — Konfiguration zum Extrahieren von Werten aus Tool-Antworten und Zuweisen zu dynamischen Variablen - `dynamic_variables` (DynamicVariablesConfig, optional) — Konfiguration für dynamische Variablen - `execution_mode` (enum, optional, default: immediate) — Legt fest, wann und wie das Tool ausgeführt wird: 'immediate' führt das Tool sofort aus, wenn das LLM es anfordert, 'post_tool_speech' wartet, bis der Agent zu Ende gesprochen hat, und 'async' führt das Tool im Hintergrund ohne Blockierung aus – ideal für lang laufende Vorgänge. - Allowed values: `immediate`, `post_tool_speech`, `async` - `expects_response` (boolean, optional, default: false) — Wenn true, soll der Aufruf dieses Tools die Unterhaltung blockieren, bis der Client antwortet und die Antwort an das LLM übergeben wird. Wenn false, wird die Unterhaltung fortgesetzt, ohne auf die Antwort des Clients zu warten. Dies eignet sich, um Nutzern Inhalte anzuzeigen, ohne die Unterhaltung zu blockieren. - `interruption_mode` (enum, optional, default: allow) — Controls whether the user can interrupt the agent around this tool call. 'allow' (default) lets the user interrupt at any time, 'disable_during_tool' suppresses interruptions only while the tool is running, 'disable_during_tool_and_turn' suppresses interruptions while the tool runs and for the agent response that follows it. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `parameters` (ObjectJsonSchemaProperty-Input, optional, nullable) — Schema für alle an den Client zu übergebenden Parameter - `pre_tool_speech` (enum, optional, default: auto) — Controls whether the agent speaks before this tool is called. 'auto' (default) decides based on recent tool latency, 'force' always asks the agent to speak, 'off' fully opts out regardless of latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — Die maximale Wartezeit in Sekunden, bis der Tool-Aufruf abgeschlossen ist. Muss zwischen 1 und 120 Sekunden (einschließlich) liegen oder -1, um unbegrenzt auf die Antwort des Clients zu warten (erfordert expects_response). - `tool_call_sound` (enum, optional, nullable) — Vordefinierter Tool-Aufruf-Soundtyp, der während der Tool-Ausführung abgespielt wird. Wenn nicht angegeben, wird kein Tool-Aufruf-Sound abgespielt. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Legt fest, wann der Ton für Tool-Aufrufe abgespielt werden soll. 'auto' spielt ihn nur ab, wenn vor dem Tool-Aufruf gesprochen wird; 'always' spielt ihn bei jedem Tool-Aufruf ab. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Controls how tool errors are processed before being shared with the agent. 'auto' determines handling based on tool type (summarized for native integrations, hide for others), 'summarized' sends an LLM-generated summary, 'passthrough' sends the raw error, 'hide' does not share the error with the agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `interruption_mode`. Bei true kann der Benutzer den Agenten nicht unterbrechen, während dieses Tool ausgeführt wird. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `pre_tool_speech`. Bei true spricht der Agent vor dem Tool-Aufruf. - `type`: `mcp` (mcp) - `type`: `smb` (smb) - `type`: `system` (SystemToolConfig) - `name` (string, required) - `params` (ToolRequestModelToolConfigDiscriminatorMappingSystemParams, required) - `assignments` (list of DynamicVariableAssignment, optional) — Konfiguration zum Extrahieren von Werten aus Tool-Antworten und Zuweisen zu dynamischen Variablen - `description` (string, optional, default: ) — Beschreibung, wann das Tool verwendet werden soll und was es tut. Leer lassen, um die für den jeweiligen Tooltyp optimierte Standardbeschreibung zu verwenden. - `interruption_mode` (enum, optional, default: allow) — Controls whether the user can interrupt the agent around this tool call. 'allow' (default) lets the user interrupt at any time, 'disable_during_tool' suppresses interruptions only while the tool is running, 'disable_during_tool_and_turn' suppresses interruptions while the tool runs and for the agent response that follows it. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Controls whether the agent speaks before this tool is called. 'auto' (default) decides based on recent tool latency, 'force' always asks the agent to speak, 'off' fully opts out regardless of latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — Die maximale Wartezeit in Sekunden für den Abschluss des Tool-Aufrufs. - `tool_call_sound` (enum, optional, nullable) — Vordefinierter Tool-Aufruf-Soundtyp, der während der Tool-Ausführung abgespielt wird. Wenn nicht angegeben, wird kein Tool-Aufruf-Sound abgespielt. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Legt fest, wann der Ton für Tool-Aufrufe abgespielt werden soll. 'auto' spielt ihn nur ab, wenn vor dem Tool-Aufruf gesprochen wird; 'always' spielt ihn bei jedem Tool-Aufruf ab. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Controls how tool errors are processed before being shared with the agent. 'auto' determines handling based on tool type (summarized for native integrations, hide for others), 'summarized' sends an LLM-generated summary, 'passthrough' sends the raw error, 'hide' does not share the error with the agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `interruption_mode`. Bei true kann der Benutzer den Agenten nicht unterbrechen, während dieses Tool ausgeführt wird. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `pre_tool_speech`. Bei true spricht der Agent vor dem Tool-Aufruf. - `type`: `webhook` (WebhookToolConfig) - `api_schema` (WebhookToolApiSchemaConfig-Input, required) — Das Schema für den ausgehenden Webhook, einschließlich Parameter und URL-Spezifikation - `description` (string, required) — Beschreibung, wann das Tool verwendet werden soll und was es tut. - `name` (string, required) - `assignments` (list of DynamicVariableAssignment, optional) — Konfiguration zum Extrahieren von Werten aus Tool-Antworten und Zuweisen zu dynamischen Variablen - `dynamic_variables` (DynamicVariablesConfig, optional) — Konfiguration für dynamische Variablen - `execution_mode` (enum, optional, default: immediate) — Legt fest, wann und wie das Tool ausgeführt wird: 'immediate' führt das Tool sofort aus, wenn das LLM es anfordert, 'post_tool_speech' wartet, bis der Agent zu Ende gesprochen hat, und 'async' führt das Tool im Hintergrund ohne Blockierung aus – ideal für lang laufende Vorgänge. - Allowed values: `immediate`, `post_tool_speech`, `async` - `follow_redirects` (boolean, optional, default: false) — Ob einer Weiterleitung vom Endpunkt gefolgt und die endgültige Antwort zurückgegeben werden soll. Einer Weiterleitung wird als GET ohne Request-Body gefolgt. Keine für dieses Tool konfigurierte Einstellung (Header, Authentifizierung, Client-Zertifikat) wird an das Weiterleitungsziel gesendet. Sowohl der Endpunkt als auch das Weiterleitungsziel müssen HTTPS verwenden. Wird von API-Integrationstools nicht unterstützt. - `follow_redirects_allowed_domains` (list of string, optional) — Domains, auf die eine Weiterleitung verweisen darf, z. B. 'test.example.com'. Erforderlich beim Folgen von Weiterleitungen; Ziele außerhalb der Liste werden abgelehnt. - `interruption_mode` (enum, optional, default: allow) — Controls whether the user can interrupt the agent around this tool call. 'allow' (default) lets the user interrupt at any time, 'disable_during_tool' suppresses interruptions only while the tool is running, 'disable_during_tool_and_turn' suppresses interruptions while the tool runs and for the agent response that follows it. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Controls whether the agent speaks before this tool is called. 'auto' (default) decides based on recent tool latency, 'force' always asks the agent to speak, 'off' fully opts out regardless of latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — Die maximale Wartezeit in Sekunden für den Abschluss des Tool-Aufrufs. Muss zwischen 5 und 300 Sekunden liegen, einschließlich. - `tool_call_sound` (enum, optional, nullable) — Vordefinierter Tool-Aufruf-Soundtyp, der während der Tool-Ausführung abgespielt wird. Wenn nicht angegeben, wird kein Tool-Aufruf-Sound abgespielt. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Legt fest, wann der Ton für Tool-Aufrufe abgespielt werden soll. 'auto' spielt ihn nur ab, wenn vor dem Tool-Aufruf gesprochen wird; 'always' spielt ihn bei jedem Tool-Aufruf ab. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Controls how tool errors are processed before being shared with the agent. 'auto' determines handling based on tool type (summarized for native integrations, hide for others), 'summarized' sends an LLM-generated summary, 'passthrough' sends the raw error, 'hide' does not share the error with the agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `interruption_mode`. Bei true kann der Benutzer den Agenten nicht unterbrechen, während dieses Tool ausgeführt wird. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `pre_tool_speech`. Bei true spricht der Agent vor dem Tool-Aufruf. ### OrbAvatar - `type` ("orb", optional, default: orb) — Der Typ des Avatars - `color_1` (string, optional, default: #2792dc) — Die erste Farbe des Avatars - `color_2` (string, optional, default: #9ce6e6) — Die zweite Farbe des Avatars ### URLAvatar - `type` ("url", optional, default: url) — Der Typ des Avatars - `custom_url` (string, optional, default: ) — Die benutzerdefinierte URL des Avatars ### ImageAvatar - `type` ("image", optional, default: image) — Der Typ des Avatars - `url` (string, optional, default: ) — Die URL des Avatars ### WidgetTextContentsTranslation - `source` (map from string to string, optional) — Der Quelltext, aus dem jedes übersetzte Feld abgeleitet wurde - `text` (map from string to string, optional) — Die zuletzt automatisch übersetzte Ausgabe für jedes übersetzte Feld ### WidgetTermsTranslation - `source_hash` (string, required) - `text` (string, required) ### ASRConversationalConfigOverrideConfig - `keywords` (boolean, optional, default: false) — Ob das Überschreiben des Felds keywords erlaubt werden soll. ### TurnConfigOverrideConfig - `soft_timeout_config` (SoftTimeoutConfigOverrideConfig, optional) — Konfiguriert Überschreibungen für verschachtelte Felder. ### TTSConversationalConfigOverrideConfig - `model_id` (boolean, optional, default: false) — Ob das Überschreiben des Felds model_id erlaubt werden soll. - `voice_id` (boolean, optional, default: false) — Ob das Überschreiben des Felds voice_id erlaubt werden soll. - `supported_voices` (boolean, optional, default: false) — Ob das Überschreiben des Felds supported_voices erlaubt werden soll. - `stability` (boolean, optional, default: false) — Ob das Überschreiben des Felds stability erlaubt werden soll. - `speed` (boolean, optional, default: false) — Ob das Überschreiben des Felds speed erlaubt werden soll. - `similarity_boost` (boolean, optional, default: false) — Ob das Überschreiben des Felds similarity_boost erlaubt werden soll. - `pronunciation_dictionary_locators` (boolean, optional, default: false) — Ob das Überschreiben des Felds pronunciation_dictionary_locators erlaubt werden soll. ### ConversationConfigOverrideConfig - `text_only` (boolean, optional, default: false) — Ob das Überschreiben des Felds text_only erlaubt werden soll. - `max_duration_seconds` (boolean, optional, default: false) — Ob das Überschreiben des Felds max_duration_seconds erlaubt werden soll. ### AgentConfigOverrideConfig - `first_message` (boolean, optional, default: false) — Ob das Überschreiben des Felds first_message erlaubt werden soll. - `language` (boolean, optional, default: false) — Ob das Überschreiben des Felds language erlaubt werden soll. - `max_conversation_duration_message` (boolean, optional, default: false) — Ob das Überschreiben des Felds max_conversation_duration_message erlaubt werden soll. - `prompt` (PromptAgentAPIModelOverrideConfig, optional) — Konfiguriert Überschreibungen für verschachtelte Felder. ### ConversationInitiationClientDataWebhookRequestHeaders ### ContentConfig - `sexual` (ContentThresholdGuardrail, optional) - `violence` (ContentThresholdGuardrail, optional) - `harassment` (ContentThresholdGuardrail, optional) - `self_harm` (ContentThresholdGuardrail, optional) - `profanity` (ContentThresholdGuardrail, optional) - `religion_or_politics` (ContentThresholdGuardrail, optional) - `medical_and_legal_information` (ContentThresholdGuardrail, optional) ### ContentGuardrailInputTriggerAction - `type`: `end_call` (EndCallTriggerAction) - `type`: `retry` (RetryTriggerAction) - `feedback` (string, optional, default: Your response was blocked by a guardrail that blocks content that matches this condition/category: '{{trigger_reason}}' During your next turn you must tell the user "I'm sorry but I can't answer that question, would you like to know something else?".) — Benutzerdefiniertes Feedback, das dem Agenten bei einem erneuten Versuch nach Auslösung einer Guardrail übergeben wird. ### CustomGuardrailsConfig-Input Konfigurationscontainer für eine Liste benutzerdefinierter Guardrails - `configs` (list of CustomGuardrailConfig, optional) ### ASTNode-Input - `type`: `add_operator` (ASTAdditionOperatorNode) - `left` (ASTNode-Input, required) — Linker Operand des binären Operators. - `right` (ASTNode-Input, required) — Rechter Operand des binären Operators. - `type`: `and_operator` (ASTAndOperatorNode) - `children` (list of ASTNode-Input, required) — Untergeordnete Knoten des logischen Operators. - `type`: `boolean_literal` (ASTBooleanNode) - `value` (boolean, required) — Wert dieses Literals. - `type`: `conditional_operator` (ASTConditionalOperatorNode) - `condition` (ASTNode-Input, required) — Bedingung, die festlegt, welcher Ausdruck ausgewählt wird. - `falseExpression` (ASTNode-Input, required) — Ausdruck, der ausgewählt wird, wenn die Bedingung false ist. - `trueExpression` (ASTNode-Input, required) — Ausdruck, der ausgewählt wird, wenn die Bedingung true ist. - `type`: `div_operator` (ASTDivisionOperatorNode) - `left` (ASTNode-Input, required) — Linker Operand des binären Operators. - `right` (ASTNode-Input, required) — Rechter Operand des binären Operators. - `type`: `dynamic_variable` (ASTDynamicVariableNode) - `name` (string, required) — Der Name der dynamischen Variable. - `type`: `eq_operator` (ASTEqualsOperatorNode) - `left` (ASTNode-Input, required) — Linker Operand des binären Operators. - `right` (ASTNode-Input, required) — Rechter Operand des binären Operators. - `type`: `gt_operator` (ASTGreaterThanOperatorNode) - `left` (ASTNode-Input, required) — Linker Operand des binären Operators. - `right` (ASTNode-Input, required) — Rechter Operand des binären Operators. - `type`: `gte_operator` (ASTGreaterThanOrEqualsOperatorNode) - `left` (ASTNode-Input, required) — Linker Operand des binären Operators. - `right` (ASTNode-Input, required) — Rechter Operand des binären Operators. - `type`: `llm` (llm) - `type`: `lt_operator` (ASTLessThanOperatorNode) - `left` (ASTNode-Input, required) — Linker Operand des binären Operators. - `right` (ASTNode-Input, required) — Rechter Operand des binären Operators. - `type`: `lte_operator` (ASTLessThanOrEqualsOperatorNode) - `left` (ASTNode-Input, required) — Linker Operand des binären Operators. - `right` (ASTNode-Input, required) — Rechter Operand des binären Operators. - `type`: `mul_operator` (ASTMultiplicationOperatorNode) - `left` (ASTNode-Input, required) — Linker Operand des binären Operators. - `right` (ASTNode-Input, required) — Rechter Operand des binären Operators. - `type`: `neq_operator` (ASTNotEqualsOperatorNode) - `left` (ASTNode-Input, required) — Linker Operand des binären Operators. - `right` (ASTNode-Input, required) — Rechter Operand des binären Operators. - `type`: `null_literal` (ASTNullNode) - `type`: `number_literal` (ASTNumberNode) - `value` (AstNumberNodeInputValue, required) — Wert dieses Literals. - `type`: `or_operator` (ASTOrOperatorNode) - `children` (list of ASTNode-Input, required) — Untergeordnete Knoten des logischen Operators. - `type`: `string_literal` (ASTStringNode) - `value` (string, required) — Wert dieses Literals. - `type`: `sub_operator` (ASTSubtractionOperatorNode) - `left` (ASTNode-Input, required) — Linker Operand des binären Operators. - `right` (ASTNode-Input, required) — Rechter Operand des binären Operators. ### ASRConversationalConfigWorkflowOverride - `quality` (enum, optional, nullable, default: high) — Die Qualität der Transkription - Allowed values: `high` - `provider` (enum, optional, nullable, default: scribe_realtime) — Der Anbieter des Transkriptionsdienstes - Allowed values: `elevenlabs`, `scribe_realtime`, `scribe_v2_turbo` - `user_input_audio_format` (enum, optional, nullable, default: pcm_16000) — Das Format des zu transkribierenden Audios - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000` - `keywords` (list of string, optional, nullable) — Schlüsselwörter, deren Vorhersagewahrscheinlichkeit erhöht werden soll ### TurnConfigWorkflowOverride - `turn_timeout` (double, optional, nullable) — Maximale Wartezeit auf die Antwort des Nutzers, bevor der Nutzer erneut angesprochen wird - `initial_wait_time` (double, optional, nullable) — Wie lange der Agent wartet, bis der Benutzer die Unterhaltung beginnt, wenn die erste Nachricht leer ist. Wenn nicht festgelegt, wird der reguläre turn_timeout verwendet. - `silence_end_call_timeout` (double, optional, nullable) — Maximale Zeit seit der letzten Äußerung des Nutzers, bevor der Anruf beendet wird - `turn_eagerness` (enum, optional, nullable, default: normal) — Steuert, wie schnell der Agent antwortet. Niedrig = weniger schnell (wartet länger), Standard = Standardgeschwindigkeit, Hoch = schneller (antwortet früher) - Allowed values: `patient`, `normal`, `eager` - `spelling_patience` (enum, optional, nullable, default: auto) — Steuert, ob der Agent geduldiger sein soll, wenn der Nutzer Zahlen und benannte Entitäten buchstabiert. Auto = modellbasiert, Off = nie zusätzlich warten - Allowed values: `auto`, `off` - `speculative_turn` (boolean, optional, nullable) — Wenn aktiviert, beginnt die Generierung von LLM-Antworten während Stille, bevor die volle Turn-Konfidenz erreicht ist. Dies reduziert die wahrgenommene Latenz, kann aber die LLM-Kosten erhöhen. - `retranscribe_on_turn_timeout` (boolean, optional, nullable) — Wenn aktiviert und VAD keine Sprache erkennt, wird beim Turn-Timeout versucht, das angesammelte Audio erneut zu transkribieren. Deaktiviert die Abrechnung mit Stille-Rabatt, solange die Funktion für den aktiven Agenten oder Workflow-Knoten aktiviert ist. - `turn_model` (enum, optional, nullable, default: turn_v3) — Zu verwendende Version des Turn-Detection-Modells. - Allowed values: `turn_v2`, `turn_v3` - `interruption_ignore_terms` (list of string, optional, nullable) — Liste von Begriffen, die keine Unterbrechung auslösen sollen, wenn der Nutzer sie sagt (z. B. 'gotcha', 'understood'). Verwendet exakte Groß-/Kleinschreibungsunabhängige Übereinstimmung. - `interruption_ignore_term_languages` (list of string, optional, nullable) — Sprachcodes, für die voreingestellte Kategorien ignorierter Begriffe aktiviert wurden. Sie werden explizit gespeichert, damit die Anzeige nicht aus Begriffsüberschneidungen abgeleitet wird. - `merge_with_default_ignore_terms` (boolean, optional, nullable) — Wenn aktiviert, werden zusätzlich zu interruption_ignore_terms die kuratierten Standardbegriffe für interruption_ignore_term_languages verwendet. - `transcribe_on_disabled_interruptions` (boolean, optional, nullable) — Wenn Unterbrechungen deaktiviert sind, wird das Gesagte des Benutzers dennoch transkribiert, damit es in den nächsten Turn übernommen werden kann. Wenn deaktiviert, wird Benutzersprache während eines nicht unterbrechbaren Turns ignoriert und löst keinen Turn aus. - `soft_timeout_config` (SoftTimeoutConfigWorkflowOverride, optional, nullable) — Konfiguration für die Soft-Timeout-Funktion. Liefert sofortiges Feedback bei längeren LLM-Antworten. ### TTSConversationalConfigWorkflowOverride-Input - `model_id` (enum, optional, nullable, default: eleven_v4_turbo) — Das für TTS zu verwendende Modell - Allowed values: `eleven_turbo_v2`, `eleven_turbo_v2_5`, `eleven_flash_v2`, `eleven_flash_v2_5`, `eleven_multilingual_v2`, `eleven_v3_conversational`, `eleven_v4`, `eleven_v4_turbo` - `voice_id` (string, optional, nullable) — Die für TTS zu verwendende Stimmen-ID - `supported_voices` (list of SupportedVoice, optional, nullable) — Zusätzlich unterstützte Stimmen für den Agenten - `expressive_mode` (boolean, optional, nullable) — Wenn aktiviert, wird der Prompt für ausdrucksstarke Audiotags angewendet. Für Nicht-v3-Modelle wird er automatisch deaktiviert. - `suggested_audio_tags` (list of SuggestedAudioTag, optional, nullable) — Vorgeschlagene Audio-Tags für ausdrucksstärkere Sprache (für die Modelle eleven_v3 und eleven_v3_conversational). Der Agent kann weiterhin andere, hier nicht aufgeführte Tags verwenden. - `agent_output_audio_format` (enum, optional, nullable, default: pcm_16000) — Das für TTS zu verwendende Audioformat - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000` - `optimize_streaming_latency` (enum, optional, nullable) — Veraltet: Dieses Feld hat keine Wirkung und wird ignoriert. - Allowed values: `0`, `1`, `2`, `3`, `4` - `stability` (double, optional, nullable) — Die Stabilität der generierten Sprache - `speed` (double, optional, nullable) — Die Geschwindigkeit der generierten Sprache - `similarity_boost` (double, optional, nullable) — Der Ähnlichkeits-Boost für generierte Sprache - `text_normalisation_type` (enum, optional, nullable, default: system_prompt) — Methode zum Umwandeln von Zahlen in Wörter vor der Umwandlung von Text in Sprache. Bei SYSTEM_PROMPT wird der System-Prompt um Normalisierungsanweisungen ergänzt. Bei ELEVENLABS wird der Text nach der Generierung normalisiert, was eine leicht erhöhte Latenz verursacht. - Allowed values: `system_prompt`, `elevenlabs` - `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional, nullable) — Die Referenzen auf Aussprachewörterbücher - `enable_phoneme_tags` (boolean, optional, nullable) — Aktivierung der Verarbeitung von SSML-Phonem-Tags für V3-Modelle. Wenn aktiviert, werden Phonem-Tags (inline und aus Aussprachewörterbüchern) vor dem Senden an das Modell in inline-IPA geparst. - `audio_effects` (EffectsSpec-Input, optional, nullable) — Optionale TTS-Effektspezifikation: Filtervoreinstellung, Distanz (Proximity-EQ) und Umgebung (Convolution-Reverb). ### ConversationConfigWorkflowOverride-Input - `text_only` (boolean, optional, nullable) — Wenn aktiviert, wird Audio nicht verarbeitet und nur Text verwendet. Verwenden Sie dies, um Audiokosten zu vermeiden. - `max_duration_seconds` (integer, optional, nullable) — Die maximale Dauer einer Unterhaltung in Sekunden - `client_events` (list of enum, optional, nullable) — Die Ereignisse, die an den Client gesendet werden - Allowed values: `conversation_initiation_metadata`, `asr_initiation_metadata`, `ping`, `audio`, `interruption`, `user_transcript`, `tentative_user_transcript`, `agent_response`, `agent_response_correction`, `client_tool_call`, `mcp_tool_call`, `mcp_connection_status`, `agent_tool_request`, `agent_tool_response`, `agent_tool_response_full_payload`, `agent_response_metadata`, `vad_score`, `agent_chat_response_part`, `client_error`, `guardrail_triggered`, `dtmf_request`, `agent_response_complete`, `context_usage`, `internal_turn_probability`, `internal_tentative_agent_response` - `file_input` (FileInputConfigWorkflowOverride, optional, nullable) — Konfiguration für Dateieingaben (Bild-/PDF-Uploads) während Unterhaltungen. - `monitoring_enabled` (boolean, optional, nullable) — Aktiviert die Echtzeitüberwachung von Gesprächen über WebSocket - `monitoring_events` (list of enum, optional, nullable) — Die Ereignisse, die an Monitoring-Verbindungen gesendet werden. - Allowed values: `conversation_initiation_metadata`, `asr_initiation_metadata`, `ping`, `audio`, `interruption`, `user_transcript`, `tentative_user_transcript`, `agent_response`, `agent_response_correction`, `client_tool_call`, `mcp_tool_call`, `mcp_connection_status`, `agent_tool_request`, `agent_tool_response`, `agent_tool_response_full_payload`, `agent_response_metadata`, `vad_score`, `agent_chat_response_part`, `client_error`, `guardrail_triggered`, `dtmf_request`, `agent_response_complete`, `context_usage`, `internal_turn_probability`, `internal_tentative_agent_response` - `dtmf_input_settings` (DTMFInputConfig, optional, nullable) — Erfassung von DTMF-Eingaben (Tastenfeld) während Telefonanrufen konfigurieren - `background_sound` (BackgroundSoundConfigWorkflowOverride, optional, nullable) — Konfiguration für Hintergrundgeräusche während Unterhaltungen. - `source_attribution` (boolean, optional, nullable) — Wenn aktiviert und Inhalte der Wissensbasis vorhanden sind, wird das LLM angewiesen anzugeben, welche Quellen es verwendet hat. ### VADConfigWorkflowOverride ### AgentConfigAPIModelWorkflowOverride-Input - `first_message` (string, optional, nullable) — Wenn nicht leer, die erste Nachricht, die der Agent sagt. Wenn leer, wartet der Agent, bis der Nutzer die Unterhaltung beginnt. - `language` (string, optional, nullable) — Sprache des Agenten – verwendet für ASR und TTS - `hinglish_mode` (boolean, optional, nullable) — Wenn aktiviert, mischt der Agent englische Wörter und Ausdrücke in Antworten auf Hindi, Malayalam, Telugu oder Kannada. - `dynamic_variables` (DynamicVariablesConfigWorkflowOverride, optional, nullable) — Konfiguration für dynamische Variablen - `disable_first_message_interruptions` (boolean, optional, nullable) — Wenn true, kann der Nutzer den Agenten nicht unterbrechen, während die erste Nachricht übermittelt wird. - `max_conversation_duration_message` (string, optional, nullable) — Wenn nicht leer, die Nachricht, die der Agent sendet, wenn die maximale Gesprächsdauer erreicht ist. - `text_behavior_overrides` (map from string to BehaviorOverride, optional, nullable) — Überschreibungen des Antwortverhaltens pro Kanal für Textunterhaltungen. Wenn nicht festgelegt, gelten die integrierten Kanalstandards. - `prompt` (PromptAgentAPIModelWorkflowOverride-Input, optional, nullable) — Der Prompt für den Agenten ### WorkflowToolLocatorSchemaOverrides - `source`: `constant` (ConstantSchemaOverride) - `constant_value` (WorkflowToolLocatorSchemaOverridesDiscriminatorMappingConstantConstantValue, required, nullable) — Der zu verwendende konstante Wert - `source`: `dynamic_variable` (DynamicVariableSchemaOverride) - `dynamic_variable` (string, required) — Der Name der zu verwendenden dynamischen Variable - `source`: `llm` (LLMSchemaOverride) - `prompt` (string, optional, nullable) — Prompt-Überschreibung für das LLM. Wenn nicht angegeben, wird die ursprüngliche Schemabeschreibung verwendet. - `source`: `omit` (OmitSchemaOverride) ### TranslatedString - `value` (string, required) ### SoftTimeoutConfigOverride - `message` (string, optional, nullable) — Nachricht, die angezeigt wird, wenn beim Warten auf die LLM-Antwort der erste weiche Timeout erreicht wird. Unterstützt dynamische Variablen (z. B. \{\{system\_\_time}}, \{\{custom\_variable}}). - `additional_soft_timeout_messages` (list of string, optional, nullable) — Zusätzliche statische Füllnachrichten für nachfolgende Soft-Timeouts in derselben LLM-Generierung. Das erste Timeout verwendet `message`. Wenn weniger Nachrichten als `max_soft_timeouts_per_generation` konfiguriert sind, wird die zuletzt konfigurierte Nachricht wiederholt; andernfalls wird eine integrierte Füllnachricht verwendet. ### PromptAgentAPIModelOverride-Input - `prompt` (string, optional, nullable) — Der Prompt für den Agenten - `llm` (enum, optional, nullable) — Das LLM, das mit dem Prompt und dem Chatverlauf abgefragt wird. Bei Verwendung von Datenresidenz muss das LLM in der Datenresidenzumgebung unterstützt werden. - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b` - `tool_ids` (list of string, optional, nullable) — Eine Liste der IDs von Tools, die der Agent verwendet - `tool_ids_strict` (boolean, optional, nullable) — Gilt nur als Überschreibung für eine Unterhaltung und ist zulässig, wenn tool_ids überschrieben werden dürfen. Wenn true, enthält die überschreibende tool_ids die vollständige Liste der in der Unterhaltung erlaubten Tools, einschließlich der Tools in Workflow-Knoten. Wird ignoriert, wenn es für den Agenten festgelegt ist. - `native_mcp_server_ids` (list of string, optional, nullable) — Eine Liste der nativen MCP-Server-IDs, die der Agent verwenden soll - `knowledge_base` (list of KnowledgeBaseLocator, optional, nullable) — Eine Liste der Wissensdatenbanken, die der Agent verwenden soll ### SystemToolConfig Ein System-Tool ist ein Tool, das zum Aufrufen einer Systemmethode auf dem Server verwendet wird - `name` (string, required) - `params` (ToolRequestModelToolConfigDiscriminatorMappingSystemParams, required) - `description` (string, optional, default: ) — Beschreibung, wann das Tool verwendet werden soll und was es tut. Leer lassen, um die für den jeweiligen Tooltyp optimierte Standardbeschreibung zu verwenden. - `response_timeout_secs` (integer, optional, default: 20) — Die maximale Wartezeit in Sekunden für den Abschluss des Tool-Aufrufs. - `interruption_mode` (enum, optional, default: allow) — Controls whether the user can interrupt the agent around this tool call. 'allow' (default) lets the user interrupt at any time, 'disable_during_tool' suppresses interruptions only while the tool is running, 'disable_during_tool_and_turn' suppresses interruptions while the tool runs and for the agent response that follows it. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Controls whether the agent speaks before this tool is called. 'auto' (default) decides based on recent tool latency, 'force' always asks the agent to speak, 'off' fully opts out regardless of latency. - Allowed values: `auto`, `force`, `off` - `assignments` (list of DynamicVariableAssignment, optional) — Konfiguration zum Extrahieren von Werten aus Tool-Antworten und Zuweisen zu dynamischen Variablen - `tool_call_sound` (enum, optional, nullable) — Vordefinierter Tool-Aufruf-Soundtyp, der während der Tool-Ausführung abgespielt wird. Wenn nicht angegeben, wird kein Tool-Aufruf-Sound abgespielt. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Legt fest, wann der Ton für Tool-Aufrufe abgespielt werden soll. 'auto' spielt ihn nur ab, wenn vor dem Tool-Aufruf gesprochen wird; 'always' spielt ihn bei jedem Tool-Aufruf ab. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Controls how tool errors are processed before being shared with the agent. 'auto' determines handling based on tool type (summarized for native integrations, hide for others), 'summarized' sends an LLM-generated summary, 'passthrough' sends the raw error, 'hide' does not share the error with the agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `interruption_mode`. Bei true kann der Benutzer den Agenten nicht unterbrechen, während dieses Tool ausgeführt wird. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `pre_tool_speech`. Bei true spricht der Agent vor dem Tool-Aufruf. ### CustomLlmApiKey Der API-Schlüssel zur Authentifizierung. Entweder eine Arbeitsbereichs-Secret-Referenz \{'secret\_id': '...'} oder eine Umgebungsvariablen-Referenz \{'env\_var\_label': '...'}. ### CustomLlmAuthConnection Optionale Workspace-Authentifizierungsverbindung. Es werden nur Authentifizierungsverbindungen unterstützt, die ein Authorization-Bearer-Token erzeugen. Basic Auth, mTLS, benutzerdefinierte Header und URL-Secret-Authentifizierungsverbindungen werden nicht unterstützt. ### CustomLlmRequestHeaders ### KnowledgeBaseToolInfo - `enabled_strategies` (list of enum, optional) — Für das Modell verfügbare Suchstrategien. Darf nicht leer sein. - Allowed values: `cat`, `keyword`, `semantic`, `ls` ### ApiIntegrationWebhookOverrides - `schema_overrides` (map from string to ApiIntegrationWebhookOverridesSchemaOverrides, optional, nullable) - `response_filter_mode` (enum, optional, nullable, default: all) — Steuert, wie Tool-Antworten gefiltert werden, bevor sie für den Agenten sichtbar sind. - Allowed values: `all`, `allow`, `hide_all` - `response_filters` (list of string, optional, nullable) - `request_headers` (map from string to ApiIntegrationWebhookOverridesRequestHeaders, optional, nullable) ### DynamicVariableAssignment Konfiguration zum Extrahieren von Werten aus Tool-Antworten und Zuweisen zu dynamischen Variablen. - `dynamic_variable` (string, required) — Der Name der dynamischen Variable, der der extrahierte Wert zugewiesen wird - `value_path` (string, required) — Pfad in Punktnotation zum Extrahieren des Werts aus der Quelle (z. B. 'user.name' oder 'data.0.id') - `source` ("response", optional, default: response) — Die Quelle, aus der der Wert extrahiert wird. Derzeit wird nur „response“ unterstützt. - `sanitize` (boolean, optional, default: false) — Wenn true, wird der Wert dieser Zuweisung aus der Tool-Antwort entfernt, bevor sie an das LLM und Transkript gesendet wird, aber weiterhin für die Variablenzuweisung verarbeitet. - `preserve_native_type` (boolean, optional, default: false) — Wenn true, werden nicht skalare Werte (Listen, Objekte), die aus der Tool-Antwort extrahiert werden, in ihrem nativen Typ gespeichert, statt in JSON-Strings umgewandelt zu werden. Aktivieren Sie dies, um extrahierte Arrays direkt als dynamische Listenvariablen zu verwenden. ### DynamicVariablesConfig - `dynamic_variable_placeholders` (map from string to any, optional) — Ein Wörterbuch mit Platzhaltern für dynamische Variablen und ihren Werten ### ObjectJsonSchemaProperty-Input - `property_kind` (enum, optional, default: object) - Allowed values: `array`, `object` - `description` (string, optional, default: ) - `dynamic_variable` (string, optional, default: ) — Wenn festgelegt, wird der gesamte Parameter zur Laufzeit mit dieser dynamischen Variable befüllt. Schließt sich gegenseitig mit description (vom LLM bereitgestellter Wert), constant_value und is_omitted aus. - `constant_value` (map from string to any, optional, nullable) — Wenn festgelegt, verwendet das gesamte Objekt zur Laufzeit diesen konstanten JSON-Wert. Schließt sich gegenseitig mit description (vom LLM bereitgestelltes Objekt), dynamic_variable und is_omitted aus. - `is_omitted` (boolean, optional, default: false) — Wenn true, wird dieser Parameter vollständig aus der Anfrage weggelassen. Nur für optionale Parameter gültig. Schließt sich gegenseitig mit description, dynamic_variable und constant_value aus. - `type` ("object", optional, default: object) - `required` (list of string, optional) - `properties` (map from string to ObjectJsonSchemaPropertyInput, optional) - `required_constraints` (RequiredConstraints, optional, nullable) — Wrapper für auf erforderliche Felder begrenzte anyOf/allOf-Kompositionseinschränkungen. ### ToolRequestModelToolConfigDiscriminatorMappingSystemParams - `system_tool_type`: `end_call` (EndCallToolConfig) - `system_tool_type`: `end_procedure` (EndProcedureToolConfig) - `procedures` (map from string to ToolResponseModelToolConfigDiscriminatorMappingSystemParamsDiscriminatorMappingEndProcedureProcedures, optional) - `system_tool_type`: `knowledge_base` (KnowledgeBaseToolConfig) - `enabled_strategies` (list of enum, optional) - Allowed values: `cat`, `keyword`, `semantic`, `ls` - `system_tool_type`: `knowledge_base_rag` (KnowledgeBaseRagToolConfig) - `system_tool_type`: `language_detection` (LanguageDetectionToolConfig) - `only_at_conversation_start` (boolean, optional, default: false) — Wenn in den ersten 2 Nutzer-Turns kein Sprachwechsel erfolgt, schlagen spätere Versuche fehl und die Unterhaltung bleibt in der aktuellen Sprache. Erfolgt während dieser Turns ein Sprachwechsel, bleiben spätere Wechsel möglich. Aktivieren Sie dies, um die Wahrscheinlichkeit falscher Sprachwechsel zu verringern. - `system_tool_type`: `play_keypad_touch_tone` (PlayDTMFToolConfig) - `suppress_turn_after_dtmf` (boolean, optional, default: false) — Wenn true, generiert der Agent nach dem Abspielen von DTMF-Tönen keine weitere Sprache. Dadurch wird verhindert, dass die Sprache des Agenten IVR-Systeme stört. - `use_out_of_band_dtmf` (boolean, optional, default: true) — DTMF-Töne als Out-of-Band-RTP-Ereignisse (RFC 4733) statt als In-Band-Audio senden. Nur für aus SIP-Trunks importierte Nummern wirksam. - `system_tool_type`: `skip_turn` (SkipTurnToolConfig) - `wait_timeout_secs` (double, optional, default: -1) — Sekunden, die nach skip_turn gewartet werden, bevor der Agent eine kontextbezogene Rückmeldung generiert. Der Timer „Unterhaltung nach Stille beenden“ wird während der Wartezeit pausiert. -1 deaktiviert die Wartezeit: Nach skip_turn bleibt der Agent still, bis der Aufrufer spricht, und dieser Timer läuft weiter. Gilt nur für Sprachunterhaltungen. - `system_tool_type`: `start_procedure` (StartProcedureToolConfig) - `procedures` (map from string to ToolResponseModelToolConfigDiscriminatorMappingSystemParamsDiscriminatorMappingStartProcedureProcedures, optional) - `system_tool_type`: `transfer_to_agent` (TransferToAgentToolConfig) - `transfers` (list of AgentTransfer-Input, required) - `system_tool_type`: `transfer_to_number` (TransferToNumberToolConfig) - `transfers` (list of PhoneNumberTransfer, required) - `enable_client_message` (boolean, optional, default: true) — Ob dem Kunden während der Wartezeit auf die Weiterleitung eine Nachricht abgespielt werden soll. Aus Gründen der Abwärtskompatibilität ist der Standardwert true. - `system_tool_type`: `voicemail_detection` (VoicemailDetectionToolConfig) - `voicemail_message` (string, optional, nullable) — Optionale Nachricht, die bei erkannter Mailbox hinterlassen wird. Wenn nicht angegeben, wird der Anruf sofort beendet, sobald eine Mailbox erkannt wird. Unterstützt dynamische Variablen, z. B. \{\{system\_\_time}}, \{\{system\_\_call\_duration\_secs}}, \{\{custom\_variable}}. ### WebhookToolApiSchemaConfig-Input - `url` (string, required) — Die URL, an die der Webhook gesendet wird. Kann Pfadparameter enthalten, z. B. [https://example.com/agents/\{agent\_id}](https://example.com/agents/\{agent_id}) - `request_headers` (map from string to WebhookToolApiSchemaConfigInputRequestHeaders, optional) — Header, die in die Anfrage aufgenommen werden sollen - `method` (enum, optional, default: GET) — Die für den Webhook zu verwendende HTTP-Methode - Allowed values: `GET`, `POST`, `PUT`, `PATCH`, `DELETE` - `path_params_schema` (map from string to LiteralJsonSchemaProperty, optional) — Schema für Pfadparameter, falls vorhanden. Die Schlüssel sollten den Platzhaltern in der URL entsprechen. - `query_params_schema` (QueryParamsJsonSchema-Input, optional, nullable) — Schema für Query-Parameter, falls vorhanden. Diese werden als Query-Parameter an das Ende der URL angehängt. Hinweis: Eigenschaften in einem Query-Parameter müssen alle literale Typen sein. - `request_body_schema` (ObjectJsonSchemaProperty-Input, optional, nullable) — Schema für die Body-Parameter, falls vorhanden. Wird für POST-/PATCH-/PUT-Anfragen verwendet. Das Schema sollte ein Objekt sein, das als JSON-Body gesendet wird. - `response_body_schema` (ObjectJsonSchemaProperty-Input, optional, nullable) — Schema, das die erwartete Struktur des Antworttextkörpers beschreibt. Nur zur Dokumentation; wird nicht an das LLM übermittelt. - `response_filter` (ResponseFilter, optional, nullable) — Optionaler Allowlist-Filter, der auf die Antwort angewendet wird, bevor das LLM sie sieht, damit große Antworten den Kontext nicht überladen. Standardmäßig wird die vollständige Antwort verwendet. - `content_type` (enum, optional, default: application/json) — Inhaltstyp für den Anfrage-Body. Gilt nur für POST-/PUT-/PATCH-Anfragen. - Allowed values: `application/json`, `application/x-www-form-urlencoded` - `auth_resolved_params` (list of string, optional) — URL-Platzhalter werden über die Authentifizierungsverbindung aufgelöst (z. B. über UrlSecretAuthConnection eingefügte Secrets) und nicht über path_params_schema. - `auth_connection` (WebhookToolApiSchemaConfigInputAuthConnection, optional, nullable) — Optionale Authentifizierungsverbindung zur Anmeldung bei diesem Webhook ### SoftTimeoutConfigOverrideConfig - `message` (boolean, optional, default: false) — Ob das Überschreiben des Felds message erlaubt werden soll. - `additional_soft_timeout_messages` (boolean, optional, default: false) — Ob das Überschreiben des Felds additional_soft_timeout_messages erlaubt werden soll. ### PromptAgentAPIModelOverrideConfig - `prompt` (boolean, optional, default: false) — Ob das Überschreiben des Felds prompt erlaubt werden soll. - `llm` (boolean, optional, default: false) — Ob das Überschreiben des Felds llm erlaubt werden soll. - `tool_ids` (boolean, optional, default: false) — Ob das Überschreiben des Felds tool_ids erlaubt werden soll. - `tool_ids_strict` (boolean, optional, default: false) — Ob das Überschreiben des Felds tool_ids_strict erlaubt werden soll. - `native_mcp_server_ids` (boolean, optional, default: false) — Ob das Überschreiben des Felds native_mcp_server_ids erlaubt werden soll. - `knowledge_base` (boolean, optional, default: false) — Ob das Überschreiben des Felds knowledge_base erlaubt werden soll. ### ConvAISecretLocator Wird verwendet, um auf ein Secret aus dem Secret-Speicher des Agenten zu verweisen. - `secret_id` (string, required) ### ContentThresholdGuardrail - `is_enabled` (boolean, optional, default: false) - `threshold` (ContentThresholdGuardrailThreshold, optional, default: 0.3) ### CustomGuardrailConfig Konfiguration einer einzelnen benutzerdefinierten Guardrail - `name` (string, required) — Nutzerseitiger Name für diese Leitplanke - `prompt` (string, required) — Anweisung, die beschreibt, was blockiert werden soll, z. B. „Sprich nicht über Politik“ - `is_enabled` (boolean, optional, default: false) - `execution_mode` (enum, optional, default: streaming) - Allowed values: `streaming`, `blocking` - `model` (enum, optional, default: gemini-3.1-flash-lite) — LLM-Modell für die Bewertung benutzerdefinierter Guardrails - Allowed values: `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `claude-haiku-4-5`, `claude-sonnet-4-6`, `gpt-5.4-nano`, `gpt-5.4-mini` - `history_message_count` (integer, optional, default: 0) — Wie viel des jüngsten Verlaufs das Guardrail vor der bewerteten Antwort sieht, gezählt in Benutzernachrichten (die Agent-Antworten dazwischen werden ebenfalls einbezogen). Das Guardrail erhält immer ein einzelnes \-Transkript, das mit der bewerteten Antwort endet und mit 'AGENT \[current reply]:' markiert ist. 0 (Standard) fügt keinen vorherigen Verlauf hinzu (nur diese Zeile); 1 fügt die neueste Benutzernachricht und alles Folgende hinzu. - `trigger_action` (CustomGuardrailConfigTriggerAction, optional) - `evaluate_full_response_only` (boolean, optional, default: false) — Einmal anhand der vollständigen Nicht-TTS-Antwort statt anhand kumulierter Teilantworten auswerten. Erfordert den Blocking-Modus. ### AstNumberNodeInputValue Wert dieses Literals. ### SoftTimeoutConfigWorkflowOverride - `timeout_seconds` (double, optional, nullable) — Zeit in Sekunden, bevor die vordefinierte Nachricht während des Wartens auf die LLM-Antwort angezeigt wird. Zum Deaktivieren auf -1 setzen. - `message` (string, optional, nullable) — Nachricht, die angezeigt wird, wenn beim Warten auf die LLM-Antwort der erste weiche Timeout erreicht wird. Unterstützt dynamische Variablen (z. B. \{\{system\_\_time}}, \{\{custom\_variable}}). - `additional_soft_timeout_messages` (list of string, optional, nullable) — Zusätzliche statische Füllnachrichten für nachfolgende Soft-Timeouts in derselben LLM-Generierung. Das erste Timeout verwendet `message`. Wenn weniger Nachrichten als `max_soft_timeouts_per_generation` konfiguriert sind, wird die zuletzt konfigurierte Nachricht wiederholt; andernfalls wird eine integrierte Füllnachricht verwendet. - `use_llm_generated_message` (boolean, optional, nullable) — Wenn aktiviert, wird die Nachricht bei einem Soft-Timeout dynamisch generiert, statt die statische Nachricht zu verwenden. - `randomize_fillers` (boolean, optional, nullable) — Wenn aktiviert, wird die Reihenfolge statischer Nachrichten bei einem Soft-Timeout einmal zu Beginn jedes Turns zufällig gemischt. Gilt nur, wenn use_llm_generated_message false ist. - `max_soft_timeouts_per_generation` (integer, optional, nullable) — Maximale Anzahl von Füllnachrichten beim Warten auf eine einzelne LLM-Antwort. Wird alle timeout_seconds ausgelöst, bis das LLM Inhalte streamt oder dieses Limit erreicht ist. - `llm_generated_message_prompt_override` (string, optional, nullable) — Benutzerdefinierter Prompt zum Generieren der Überbrückungsnachricht bei Soft-Timeout, wenn use\_llm\_generated\_message aktiviert ist. Der aktuelle Gesprächskontext wird als separate Benutzernachricht bereitgestellt. Wenn nicht festgelegt, wird der Standard-Prompt verwendet. Unterstützt dynamische Variablen (z. B. \{\{system\_\_time}}, \{\{custom\_variable}}). - `disable_until_first_user_message` (boolean, optional, nullable) — Wenn true, werden weiche Timeout-Fülltexte unterdrückt, bis die Unterhaltung mindestens eine tatsächliche Benutzernachricht enthält. Verhindert Fülltexte während des Eröffnungsturns des Agenten, z. B. bei Workflow generate-immediately oder Tool-Aufrufen, bevor der Benutzer spricht. ### FileInputConfigWorkflowOverride - `enabled` (boolean, optional, nullable) — Wenn aktiviert, können Nutzer im Chat Bilder, PDFs oder Textdateien anhängen, sofern das LLM multimodale Eingaben unterstützt. - `max_files_in_memory` (integer, optional, nullable) — Anzahl der zuletzt verwendeten Dateien, die während einer Unterhaltung im Speicher bleiben. Ältere Dateien werden zusammengefasst und ihr Speicher wird freigegeben. - `max_files_per_conversation` (integer, optional, nullable) — Gesamtzahl der Dateien, die ein Nutzer in einer Unterhaltung hochladen kann. Uploads werden pro Datei abgerechnet. Verwenden Sie -1 für kein Limit oder einen Wert >= max_files_in_memory. ### BackgroundSoundConfigWorkflowOverride - `source_type` (enum, optional, nullable) — Der Typ der Hintergrundgeräuschquelle. - Allowed values: `preset` - `source_id` (enum, optional, nullable) — Kennung der Klangquelle. - Allowed values: `office2`, `office1`, `restaurant`, `city`, `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `volume` (double, optional, nullable) — Lautstärke des Hintergrundsounds (0,01 bis 1,0). - `crossfade_loop` (boolean, optional, nullable) — Wendet am Schleifenübergang eine Überblendung an, um hörbare Knackgeräusche bei der Wiederholung zu vermeiden. ### DynamicVariablesConfigWorkflowOverride - `dynamic_variable_placeholders` (map from string to any, optional, nullable) — Ein Wörterbuch mit Platzhaltern für dynamische Variablen und ihren Werten ### PromptAgentAPIModelWorkflowOverride-Input - `prompt` (string, optional, nullable) — Der Prompt für den Agenten - `llm` (enum, optional, nullable) — Das LLM, das mit dem Prompt und dem Chatverlauf abgefragt wird. Bei Verwendung von Datenresidenz muss das LLM in der Datenresidenzumgebung unterstützt werden. - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b` - `reasoning_effort` (enum, optional, nullable) — Reasoning-Aufwand des Modells. Nur für einige Modelle verfügbar. - Allowed values: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max` - `thinking_budget` (integer, optional, nullable) — Maximale Anzahl der für das Denken verwendeten Token. Verwenden Sie 0 zum Deaktivieren, falls das Modell dies unterstützt. - `enable_reasoning_summary` (boolean, optional, nullable) — Aktiviert Zusammenfassungen der Modellüberlegungen. Wenn deaktiviert, fordern wir nach Möglichkeit keine Zusammenfassungen vom Anbieter an, um eine schnellere TTFB zu erreichen. Nicht ZRM-kompatibel. - `temperature` (double, optional, nullable) — Die Temperatur für das LLM. Der Standardwert ist 0. Setzen Sie den Wert auf null, um den Parameter vollständig aus der LLM-Anfrage auszuschließen. Das ist für benutzerdefinierte LLMs nützlich, die das Feld temperature ablehnen. - `max_tokens` (integer, optional, nullable) — Wenn größer als 0: maximale Anzahl an Tokens, die das LLM vorhersagen kann - `tool_ids` (list of string, optional, nullable) — Eine Liste der IDs von Tools, die der Agent verwendet - `tool_ids_strict` (boolean, optional, nullable) — Gilt nur als Überschreibung für eine Unterhaltung und ist zulässig, wenn tool_ids überschrieben werden dürfen. Wenn true, enthält die überschreibende tool_ids die vollständige Liste der in der Unterhaltung erlaubten Tools, einschließlich der Tools in Workflow-Knoten. Wird ignoriert, wenn es für den Agenten festgelegt ist. - `built_in_tools` (BuiltInToolsWorkflowOverride-Input, optional, nullable) — Integrierte System-Tools, die vom Agent verwendet werden - `enable_parallel_tool_calls` (boolean, optional, nullable) — Aktiviert parallele Tool-Aufrufe. Wenn aktiviert, kann der Agent mehrere Tools innerhalb eines einzelnen Turns parallel ausführen. Nicht von allen Modellen unterstützt. - `mcp_server_ids` (list of string, optional, nullable) — Eine Liste der MCP-Server-IDs, die der Agent verwenden soll - `native_mcp_server_ids` (list of string, optional, nullable) — Eine Liste der nativen MCP-Server-IDs, die der Agent verwenden soll - `knowledge_base` (list of KnowledgeBaseLocator, optional, nullable) — Eine Liste der Wissensdatenbanken, die der Agent verwenden soll - `custom_llm` (CustomLLM, optional, nullable) — Definition für ein benutzerdefiniertes LLM, wenn das LLM-Feld auf 'CUSTOM_LLM' gesetzt ist - `ignore_default_personality` (boolean, optional, nullable) — Ob die standardmäßigen Persönlichkeitszeilen aus dem System-Prompt entfernt werden sollen - `rag` (RagConfigWorkflowOverride-Input, optional, nullable) — Konfiguration für RAG - `timezone` (string, optional, nullable) — Zeitzone zur Anzeige der aktuellen Zeit im System-Prompt. Wenn festgelegt, wird die aktuelle Zeit in dieser Zeitzone in den System-Prompt aufgenommen. Muss ein gültiger Zeitzonenname sein, z. B. 'America/New_York', 'Europe/London' oder 'UTC'. Für präzise zeitbezogene Antworten empfohlen. Andernfalls kennt der Agent das aktuelle Datum und die Uhrzeit nicht, sofern Sie diese nicht über dynamische Variablen oder Tools bereitstellen. Das kann zu falschen oder halluzinierten Zeitangaben führen. - `backup_llm_config` (PromptAgentApiModelWorkflowOverrideInputBackupLlmConfig, optional, nullable) — Konfiguration für die Kaskadierung von Backup-LLMs. Kann deaktiviert sein, Systemstandards verwenden oder eine benutzerdefinierte Reihenfolge festlegen. - `cascade_timeout_seconds` (double, optional, nullable) — Zeit in Sekunden, bevor auf das Backup-LLM gewechselt wird. Muss zwischen 2 und 15 Sekunden liegen. - `tools` (list of PromptAgentApiModelWorkflowOverrideInputToolsItems, optional, nullable) — Eine Liste von Tools, die der Agent während des Gesprächs verwenden kann. Verwenden Sie stattdessen tool_ids. ### WorkflowToolLocatorSchemaOverridesDiscriminatorMappingConstantConstantValue Der zu verwendende konstante Wert ### ConvAIEnvVarLocator Wird verwendet, um über ihr Label auf eine Umgebungsvariable zu verweisen. - `env_var_label` (string, required) ### AuthConnectionLocator Wird verwendet, um auf eine Authentifizierungsverbindung aus dem Speicher für Authentifizierungsverbindungen des Workspace zu verweisen. - `auth_connection_id` (string, required) ### EnvironmentAuthConnectionLocator Verweist per Label auf eine Umgebungsvariable vom Typ 'auth_connection'. Zur Laufzeit wird die Authentifizierungsverbindung für die aktuelle Umgebung aufgelöst, wobei auf die Standardumgebung zurückgegriffen wird. - `env_var_label` (string, required) ### ConvAIDynamicVariable Wird verwendet, um auf eine dynamische Variable zu verweisen. - `variable_name` (string, required) ### ApiIntegrationWebhookOverridesSchemaOverrides - `source`: `constant` (ConstantSchemaOverride) - `constant_value` (WorkflowToolLocatorSchemaOverridesDiscriminatorMappingConstantConstantValue, required, nullable) — Der zu verwendende konstante Wert - `source`: `dynamic_variable` (DynamicVariableSchemaOverride) - `dynamic_variable` (string, required) — Der Name der zu verwendenden dynamischen Variable - `source`: `llm` (LLMSchemaOverride) - `prompt` (string, optional, nullable) — Prompt-Überschreibung für das LLM. Wenn nicht angegeben, wird die ursprüngliche Schemabeschreibung verwendet. - `source`: `omit` (OmitSchemaOverride) ### ApiIntegrationWebhookOverridesRequestHeaders ### ObjectJsonSchemaPropertyInput ### RequiredConstraints Wrapper für auf erforderliche Felder begrenzte anyOf/allOf-Kompositionseinschränkungen. - `any_of` (list of RequiredConstraint, optional) - `all_of` (list of RequiredConstraint, optional) ### ToolResponseModelToolConfigDiscriminatorMappingSystemParamsDiscriminatorMappingEndProcedureProcedures ### ToolResponseModelToolConfigDiscriminatorMappingSystemParamsDiscriminatorMappingStartProcedureProcedures ### AgentTransfer-Input - `condition` (string, required) - `agent_id` (string, optional, nullable) - `branch_id` (string, optional, nullable) - `node_id` (string, optional, nullable) - `delay_ms` (integer, optional, default: 0) - `transfer_message` (string, optional, nullable) - `enable_transferred_agent_first_message` (boolean, optional, default: false) - `is_workflow_node_transfer` (boolean, optional, default: false) - `preserve_client_tts_overrides` (boolean, optional, default: false) — Legt fest, ob TTS-Client-Überschreibungen auf den weitergeleiteten Agenten übertragen werden sollen. - `preserve_voice_settings` (boolean, optional, default: false) — Legt fest, ob die Basisstimme, das TTS-Modell und die Stimmeinstellungen auf den übertragenen Agenten übernommen werden sollen. ### PhoneNumberTransfer - `transfer_destination` (PhoneNumberTransferTransferDestination, required) - `condition` (string, required) - `custom_sip_headers` (list of PhoneNumberTransferCustomSipHeadersItems, optional) — Benutzerdefinierte SIP-Header, die bei der Gesprächsweiterleitung eingeschlossen werden. Jeder Header kann entweder ein statischer Wert oder ein Verweis auf eine dynamische Variable sein. - `transfer_type` (enum, optional, default: conference) - Allowed values: `blind`, `conference`, `sip_refer` - `sip_refer_play_dialtone` (boolean, optional, default: true) — Wenn True, wird auf dem ursprünglichen Anrufzweig ein Klingelton wiedergegeben, während eine SIP-REFER-Weiterleitung abgeschlossen wird. Der Ton wird über RTP an den SIP-Peer übertragen, der den REFER ausführt. Deaktivieren Sie dies, wenn das empfangende System, z. B. ein SBC oder Contact Center, ihn nicht hören soll. Wenn deaktiviert, hört der Anrufer bis zum Abschluss der Weiterleitung Stille. Nur für SIP-REFER-Weiterleitungen. - `uui` (UUITransferConfig, optional, nullable) — User-to-User Information (RFC 7433), die SIP-REFER-Weiterleitungen beigefügt wird. Überträgt den Anrufkontext, etwa CRM-Identifikatoren oder den Eskalationsgrund, über die Weiterleitungsgrenze hinweg. - `post_dial_digits` (PhoneNumberTransferPostDialDigits, optional, nullable) — Nach dem Verbindungsaufbau zu sendende DTMF-Ziffern (z. B. 'ww1234' für eine Durchwahl). Kann ein statischer Wert oder ein Verweis auf eine dynamische Variable sein. Verwenden Sie 'w' für eine Pause von 0,5 Sekunden. Nur für Twilio-Weiterleitungen unterstützt. - `phone_number` (string, optional, nullable, deprecated) ### WebhookToolApiSchemaConfigInputRequestHeaders ### LiteralJsonSchemaProperty Schema-Eigenschaft für literale JSON-Typen. WICHTIG: Es kann nur EINES der folgenden Felder festgelegt werden: description (LLM liefert Wert), dynamic_variable (Wert aus Variable), is_system_provided (System liefert Wert), constant_value (fester Wert) oder is_omitted (Parameter wird ausgelassen). Diese schließen sich gegenseitig aus. - `type` (LiteralJsonSchemaPropertyType, required) - `description` (string, optional, default: ) — Die Beschreibung der Eigenschaft. Wenn festgelegt, stellt das LLM den Wert anhand dieser Beschreibung bereit. Nicht gleichzeitig mit dynamic_variable, is_system_provided, constant_value und is_omitted verwendbar. - `enum` (list of string, optional, nullable) — List of allowed string values for string type parameters - `is_system_provided` (boolean, optional, default: false) — Wenn true, wird der Wert vom System zur Laufzeit ausgefüllt. Wird von API-Integration-Webhook-Tools für Vorlagen verwendet. Schließt sich gegenseitig mit description, dynamic_variable, constant_value und is_omitted aus. - `dynamic_variable` (string, optional, default: ) — Der Name der dynamischen Variable, die für den Wert dieser Eigenschaft verwendet werden soll. Kann nicht zusammen mit description, is_system_provided, constant_value und is_omitted verwendet werden. - `allowed_values` (AllowedValues, optional, nullable) — Serverseitige Ablehnungsprüfung für einen von der LLM bereitgestellten Wert: Die Laufzeit lehnt jeden Wert außerhalb der von diesem Objekt benannten zulässigen Menge ab. Die Menge wird der LLM nicht als Enum mitgeteilt. Wird nur unterstützt, wenn die Wertquelle `description` ist; eine Kombination mit dynamic_variable, is_system_provided, constant_value oder is_omitted wird abgelehnt. - `constant_value` (LiteralJsonSchemaPropertyConstantValue, optional, nullable, default: ) — Ein konstanter Wert für diese Eigenschaft. Schließt sich gegenseitig mit description, dynamic_variable, is_system_provided und is_omitted aus. - `is_omitted` (boolean, optional, default: false) — Wenn true, wird dieser Parameter vollständig aus der Anfrage weggelassen. Nur für optionale Parameter gültig. Schließt sich gegenseitig mit description, dynamic_variable, is_system_provided und constant_value aus. - `allowed_values_dynamic_variable` (string, optional, default: , deprecated) — VERALTET: Verwenden Sie stattdessen `allowed_values`. Wenn festgelegt, liefert das LLM den Wert, aber die Laufzeitumgebung lehnt jeden Wert ab, der nicht in der Liste dieser dynamischen Variable enthalten ist (muss ein JSON-Array wie ["ws_alpha", "ws_beta"] sein). Verwenden Sie dies, damit das LLM aus einer serverseitig verifizierten Menge auswählen kann (z. B. den IDs, auf die der aktuelle Benutzer zugreifen darf). Erfordert description; schließt sich gegenseitig mit dynamic_variable, is_system_provided, constant_value und is_omitted aus. ### QueryParamsJsonSchema-Input - `properties` (map from string to LiteralJsonSchemaProperty, required) - `required` (list of string, optional) ### ResponseFilter Konfiguration zum Filtern von Tool-Antworten, bevor sie für den Agent sichtbar sind. - `mode` (enum, optional, default: all) — Controls how tool responses are filtered. 'all' returns entire response, 'allow' returns only specified paths, 'hide_all' hides the entire response. - Allowed values: `all`, `allow`, `hide_all` - `filters` (list of string, optional) — Pfade in Punktnotation, die einbezogen werden, wenn der Modus 'allow' ist (z. B. ['ticket.id', 'ticket.status']). - `content_type` ("application/json", optional, default: application/json) — Inhaltstyp für die Antwortfilterung. Nur Antworten vom Typ „application/json“ werden gefiltert. ### WebhookToolApiSchemaConfigInputAuthConnection Optionale Authentifizierungsverbindung zur Anmeldung bei diesem Webhook ### ContentThresholdGuardrailThreshold ### CustomGuardrailConfigTriggerAction - `type`: `end_call` (EndCallTriggerAction) - `type`: `retry` (RetryTriggerAction) - `feedback` (string, optional, default: Your response was blocked by a guardrail that blocks content that matches this condition/category: '{{trigger_reason}}' During your next turn you must tell the user "I'm sorry but I can't answer that question, would you like to know something else?".) — Benutzerdefiniertes Feedback, das dem Agenten bei einem erneuten Versuch nach Auslösung einer Guardrail übergeben wird. ### BuiltInToolsWorkflowOverride-Input - `transfer_to_agent` (SystemToolConfig, optional, nullable) — Das Tool zum Weiterleiten an einen Agenten - `end_call` (SystemToolConfig, optional, nullable) — Das Tool zum Beenden des Anrufs - `language_detection` (SystemToolConfig, optional, nullable) — Das Tool zur Spracherkennung - `transfer_to_number` (SystemToolConfig, optional, nullable) — Das Tool zum Weiterleiten an eine Nummer - `skip_turn` (SystemToolConfig, optional, nullable) — Das Tool zum Überspringen eines Gesprächszugs - `play_keypad_touch_tone` (SystemToolConfig, optional, nullable) — Das DTMF-Wiedergabetool - `voicemail_detection` (SystemToolConfig, optional, nullable) — Das Tool zur Mailbox-Erkennung ### RagConfigWorkflowOverride-Input - `enabled` (boolean, optional, nullable) - `embedding_model` (enum, optional, nullable, default: e5_mistral_7b_instruct) - Allowed values: `e5_mistral_7b_instruct`, `multilingual_e5_large_instruct` - `max_vector_distance` (double, optional, nullable) — Maximale Vektordistanz abgerufener Chunks. - `max_documents_length` (integer, optional, nullable) — Maximale Gesamtlänge der von RAG abgerufenen Dokument-Chunks. - `max_retrieved_rag_chunks_count` (integer, optional, nullable) — Maximale Anzahl von RAG-Dokument-Chunks, die zunächst aus dem Vektorspeicher abgerufen werden. Diese werden anschließend nach Vektordistanz und Gesamtlänge weiter gefiltert. - `num_candidates` (integer, optional, nullable) — Anzahl der in der ANN-Vektorsuche bewerteten Kandidaten. Eine höhere Anzahl liefert bessere Ergebnisse, erhöht aber die Latenz. Der empfohlene Mindestwert beträgt 100. Wenn deaktiviert, wird der Standardwert verwendet. - `query_rewrite_prompt_override` (string, optional, nullable) — Benutzerdefinierter Prompt zum Umschreiben von Benutzeranfragen vor dem RAG-Abruf. Der Gesprächsverlauf wird automatisch am Ende angehängt. Wenn nicht festgelegt, wird der Standard-Prompt verwendet. - `knowledge_base_tool_info` (KnowledgeBaseToolInfo, optional, nullable) — Wenn festgelegt, verwendet der Agent das Tool knowledge_base statt des veralteten Tools knowledge_base_rag. None bedeutet, dass der Agent nicht aktiviert ist. ### PromptAgentApiModelWorkflowOverrideInputBackupLlmConfig Konfiguration für die Kaskadierung von Backup-LLMs. Kann deaktiviert sein, Systemstandards verwenden oder eine benutzerdefinierte Reihenfolge festlegen. ### PromptAgentApiModelWorkflowOverrideInputToolsItems Der Tool-Typ - `type`: `api_integration_webhook` (ApiIntegrationWebhookToolConfig) - `api_integration_connection_id` (string, required) - `api_integration_id` (string, required) - `description` (string, required) — Beschreibung, wann das Tool verwendet werden soll und was es tut. - `name` (string, required) - `api_schema_overrides` (ApiIntegrationWebhookOverrides, optional, nullable) — Nutzerüberschreibungen, die zusätzlich zu api_schema angewendet werden - `assignments` (list of DynamicVariableAssignment, optional) — Konfiguration zum Extrahieren von Werten aus Tool-Antworten und Zuweisen zu dynamischen Variablen - `dynamic_variables` (DynamicVariablesConfig, optional) — Konfiguration für dynamische Variablen - `execution_mode` (enum, optional, default: immediate) — Legt fest, wann und wie das Tool ausgeführt wird: 'immediate' führt das Tool sofort aus, wenn das LLM es anfordert, 'post_tool_speech' wartet, bis der Agent zu Ende gesprochen hat, und 'async' führt das Tool im Hintergrund ohne Blockierung aus – ideal für lang laufende Vorgänge. - Allowed values: `immediate`, `post_tool_speech`, `async` - `interruption_mode` (enum, optional, default: allow) — Controls whether the user can interrupt the agent around this tool call. 'allow' (default) lets the user interrupt at any time, 'disable_during_tool' suppresses interruptions only while the tool is running, 'disable_during_tool_and_turn' suppresses interruptions while the tool runs and for the agent response that follows it. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Controls whether the agent speaks before this tool is called. 'auto' (default) decides based on recent tool latency, 'force' always asks the agent to speak, 'off' fully opts out regardless of latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — Die maximale Wartezeit in Sekunden für den Abschluss des Tool-Aufrufs. Muss zwischen 5 und 300 Sekunden liegen, einschließlich. - `tool_call_sound` (enum, optional, nullable) — Vordefinierter Tool-Aufruf-Soundtyp, der während der Tool-Ausführung abgespielt wird. Wenn nicht angegeben, wird kein Tool-Aufruf-Sound abgespielt. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Legt fest, wann der Ton für Tool-Aufrufe abgespielt werden soll. 'auto' spielt ihn nur ab, wenn vor dem Tool-Aufruf gesprochen wird; 'always' spielt ihn bei jedem Tool-Aufruf ab. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Controls how tool errors are processed before being shared with the agent. 'auto' determines handling based on tool type (summarized for native integrations, hide for others), 'summarized' sends an LLM-generated summary, 'passthrough' sends the raw error, 'hide' does not share the error with the agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `tool_version` (string, optional, default: 1.0.0) — Die Version des API-Integrationstools - `disable_interruptions` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `interruption_mode`. Bei true kann der Benutzer den Agenten nicht unterbrechen, während dieses Tool ausgeführt wird. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `pre_tool_speech`. Bei true spricht der Agent vor dem Tool-Aufruf. - `type`: `client` (ClientToolConfig) - `description` (string, required) — Beschreibung, wann das Tool verwendet werden soll und was es tut. - `name` (string, required) - `assignments` (list of DynamicVariableAssignment, optional) — Konfiguration zum Extrahieren von Werten aus Tool-Antworten und Zuweisen zu dynamischen Variablen - `dynamic_variables` (DynamicVariablesConfig, optional) — Konfiguration für dynamische Variablen - `execution_mode` (enum, optional, default: immediate) — Legt fest, wann und wie das Tool ausgeführt wird: 'immediate' führt das Tool sofort aus, wenn das LLM es anfordert, 'post_tool_speech' wartet, bis der Agent zu Ende gesprochen hat, und 'async' führt das Tool im Hintergrund ohne Blockierung aus – ideal für lang laufende Vorgänge. - Allowed values: `immediate`, `post_tool_speech`, `async` - `expects_response` (boolean, optional, default: false) — Wenn true, soll der Aufruf dieses Tools die Unterhaltung blockieren, bis der Client antwortet und die Antwort an das LLM übergeben wird. Wenn false, wird die Unterhaltung fortgesetzt, ohne auf die Antwort des Clients zu warten. Dies eignet sich, um Nutzern Inhalte anzuzeigen, ohne die Unterhaltung zu blockieren. - `interruption_mode` (enum, optional, default: allow) — Controls whether the user can interrupt the agent around this tool call. 'allow' (default) lets the user interrupt at any time, 'disable_during_tool' suppresses interruptions only while the tool is running, 'disable_during_tool_and_turn' suppresses interruptions while the tool runs and for the agent response that follows it. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `parameters` (ObjectJsonSchemaProperty-Input, optional, nullable) — Schema für alle an den Client zu übergebenden Parameter - `pre_tool_speech` (enum, optional, default: auto) — Controls whether the agent speaks before this tool is called. 'auto' (default) decides based on recent tool latency, 'force' always asks the agent to speak, 'off' fully opts out regardless of latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — Die maximale Wartezeit in Sekunden, bis der Tool-Aufruf abgeschlossen ist. Muss zwischen 1 und 120 Sekunden (einschließlich) liegen oder -1, um unbegrenzt auf die Antwort des Clients zu warten (erfordert expects_response). - `tool_call_sound` (enum, optional, nullable) — Vordefinierter Tool-Aufruf-Soundtyp, der während der Tool-Ausführung abgespielt wird. Wenn nicht angegeben, wird kein Tool-Aufruf-Sound abgespielt. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Legt fest, wann der Ton für Tool-Aufrufe abgespielt werden soll. 'auto' spielt ihn nur ab, wenn vor dem Tool-Aufruf gesprochen wird; 'always' spielt ihn bei jedem Tool-Aufruf ab. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Controls how tool errors are processed before being shared with the agent. 'auto' determines handling based on tool type (summarized for native integrations, hide for others), 'summarized' sends an LLM-generated summary, 'passthrough' sends the raw error, 'hide' does not share the error with the agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `interruption_mode`. Bei true kann der Benutzer den Agenten nicht unterbrechen, während dieses Tool ausgeführt wird. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `pre_tool_speech`. Bei true spricht der Agent vor dem Tool-Aufruf. - `type`: `mcp` (mcp) - `type`: `smb` (smb) - `type`: `system` (SystemToolConfig) - `name` (string, required) - `params` (ToolRequestModelToolConfigDiscriminatorMappingSystemParams, required) - `assignments` (list of DynamicVariableAssignment, optional) — Konfiguration zum Extrahieren von Werten aus Tool-Antworten und Zuweisen zu dynamischen Variablen - `description` (string, optional, default: ) — Beschreibung, wann das Tool verwendet werden soll und was es tut. Leer lassen, um die für den jeweiligen Tooltyp optimierte Standardbeschreibung zu verwenden. - `interruption_mode` (enum, optional, default: allow) — Controls whether the user can interrupt the agent around this tool call. 'allow' (default) lets the user interrupt at any time, 'disable_during_tool' suppresses interruptions only while the tool is running, 'disable_during_tool_and_turn' suppresses interruptions while the tool runs and for the agent response that follows it. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Controls whether the agent speaks before this tool is called. 'auto' (default) decides based on recent tool latency, 'force' always asks the agent to speak, 'off' fully opts out regardless of latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — Die maximale Wartezeit in Sekunden für den Abschluss des Tool-Aufrufs. - `tool_call_sound` (enum, optional, nullable) — Vordefinierter Tool-Aufruf-Soundtyp, der während der Tool-Ausführung abgespielt wird. Wenn nicht angegeben, wird kein Tool-Aufruf-Sound abgespielt. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Legt fest, wann der Ton für Tool-Aufrufe abgespielt werden soll. 'auto' spielt ihn nur ab, wenn vor dem Tool-Aufruf gesprochen wird; 'always' spielt ihn bei jedem Tool-Aufruf ab. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Controls how tool errors are processed before being shared with the agent. 'auto' determines handling based on tool type (summarized for native integrations, hide for others), 'summarized' sends an LLM-generated summary, 'passthrough' sends the raw error, 'hide' does not share the error with the agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `interruption_mode`. Bei true kann der Benutzer den Agenten nicht unterbrechen, während dieses Tool ausgeführt wird. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `pre_tool_speech`. Bei true spricht der Agent vor dem Tool-Aufruf. - `type`: `webhook` (WebhookToolConfig) - `api_schema` (WebhookToolApiSchemaConfig-Input, required) — Das Schema für den ausgehenden Webhook, einschließlich Parameter und URL-Spezifikation - `description` (string, required) — Beschreibung, wann das Tool verwendet werden soll und was es tut. - `name` (string, required) - `assignments` (list of DynamicVariableAssignment, optional) — Konfiguration zum Extrahieren von Werten aus Tool-Antworten und Zuweisen zu dynamischen Variablen - `dynamic_variables` (DynamicVariablesConfig, optional) — Konfiguration für dynamische Variablen - `execution_mode` (enum, optional, default: immediate) — Legt fest, wann und wie das Tool ausgeführt wird: 'immediate' führt das Tool sofort aus, wenn das LLM es anfordert, 'post_tool_speech' wartet, bis der Agent zu Ende gesprochen hat, und 'async' führt das Tool im Hintergrund ohne Blockierung aus – ideal für lang laufende Vorgänge. - Allowed values: `immediate`, `post_tool_speech`, `async` - `follow_redirects` (boolean, optional, default: false) — Ob einer Weiterleitung vom Endpunkt gefolgt und die endgültige Antwort zurückgegeben werden soll. Einer Weiterleitung wird als GET ohne Request-Body gefolgt. Keine für dieses Tool konfigurierte Einstellung (Header, Authentifizierung, Client-Zertifikat) wird an das Weiterleitungsziel gesendet. Sowohl der Endpunkt als auch das Weiterleitungsziel müssen HTTPS verwenden. Wird von API-Integrationstools nicht unterstützt. - `follow_redirects_allowed_domains` (list of string, optional) — Domains, auf die eine Weiterleitung verweisen darf, z. B. 'test.example.com'. Erforderlich beim Folgen von Weiterleitungen; Ziele außerhalb der Liste werden abgelehnt. - `interruption_mode` (enum, optional, default: allow) — Controls whether the user can interrupt the agent around this tool call. 'allow' (default) lets the user interrupt at any time, 'disable_during_tool' suppresses interruptions only while the tool is running, 'disable_during_tool_and_turn' suppresses interruptions while the tool runs and for the agent response that follows it. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Controls whether the agent speaks before this tool is called. 'auto' (default) decides based on recent tool latency, 'force' always asks the agent to speak, 'off' fully opts out regardless of latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — Die maximale Wartezeit in Sekunden für den Abschluss des Tool-Aufrufs. Muss zwischen 5 und 300 Sekunden liegen, einschließlich. - `tool_call_sound` (enum, optional, nullable) — Vordefinierter Tool-Aufruf-Soundtyp, der während der Tool-Ausführung abgespielt wird. Wenn nicht angegeben, wird kein Tool-Aufruf-Sound abgespielt. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Legt fest, wann der Ton für Tool-Aufrufe abgespielt werden soll. 'auto' spielt ihn nur ab, wenn vor dem Tool-Aufruf gesprochen wird; 'always' spielt ihn bei jedem Tool-Aufruf ab. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Controls how tool errors are processed before being shared with the agent. 'auto' determines handling based on tool type (summarized for native integrations, hide for others), 'summarized' sends an LLM-generated summary, 'passthrough' sends the raw error, 'hide' does not share the error with the agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `interruption_mode`. Bei true kann der Benutzer den Agenten nicht unterbrechen, während dieses Tool ausgeführt wird. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VERALTET: Verwenden Sie stattdessen `pre_tool_speech`. Bei true spricht der Agent vor dem Tool-Aufruf. ### ArrayJsonSchemaProperty-Input - `property_kind` (enum, optional, default: array) - Allowed values: `array`, `object` - `description` (string, optional, default: ) - `dynamic_variable` (string, optional, default: ) — Wenn festgelegt, wird der gesamte Parameter zur Laufzeit mit dieser dynamischen Variable befüllt. Schließt sich gegenseitig mit description (vom LLM bereitgestellter Wert), constant_value und is_omitted aus. - `constant_value` (list of any, optional, nullable) — Wenn festgelegt, verwendet das gesamte Array zur Laufzeit diesen konstanten Wert. Schließt sich gegenseitig mit description (vom LLM bereitgestelltes Array), dynamic_variable und is_omitted aus. - `is_omitted` (boolean, optional, default: false) — Wenn true, wird dieser Parameter vollständig aus der Anfrage weggelassen. Nur für optionale Parameter gültig. Schließt sich gegenseitig mit description, dynamic_variable und constant_value aus. - `type` ("array", optional, default: array) - `items` (ArrayJsonSchemaPropertyInputItems, optional, default: {"allowed_values_dynamic_variable":"","constant_value":"","description":"Array element","dynamic_variable":"","is_omitted":false,"is_system_provided":false,"type":"string"}) — Schema für Array-Elemente. ### RequiredConstraint Eine Menge von Feldern, die alle vorhanden sein müssen, um diese Einschränkung zu erfüllen. - `required` (list of string, required) ### ProcedureVersionRef - `procedure_id` (string, required) — Prozedur-ID - `version_id` (string, required) — Versions-ID der Verfahrensversion. ### ProcedureDraftRef - `procedure_id` (string, required) — Prozedur-ID - `version_id` (any, optional) ### PhoneNumberTransferTransferDestination - `type`: `phone` (PhoneNumberTransferDestination) - `phone_number` (string, required) - `type`: `phone_dynamic_variable` (PhoneNumberDynamicVariableTransferDestination) - `phone_number` (string, required) - `type`: `sip_uri` (SIPUriTransferDestination) - `sip_uri` (string, required) - `type`: `sip_uri_dynamic_variable` (SIPUriDynamicVariableTransferDestination) - `sip_uri` (string, required) ### PhoneNumberTransferCustomSipHeadersItems - `type`: `dynamic` (CustomSIPHeaderWithDynamicVariable) - `key` (string, required) — Der SIP-Headername (z. B. 'X-Customer-ID') - `value` (string, required) — Der aufzulösende Name der dynamischen Variable - `type`: `static` (CustomSIPHeader) - `key` (string, required) — Der SIP-Headername (z. B. 'X-Customer-ID') - `value` (string, required) — Der Header-Wert ### PhoneNumberTransferPostDialDigits Nach dem Verbindungsaufbau zu sendende DTMF-Ziffern (z. B. 'ww1234' für eine Durchwahl). Kann ein statischer Wert oder ein Verweis auf eine dynamische Variable sein. Verwenden Sie 'w' für eine Pause von 0,5 Sekunden. Nur für Twilio-Weiterleitungen unterstützt. - `type`: `dynamic` (PostDialDigitsDynamicVariable) - `value` (string, required) — Der aufzulösende Name der dynamischen Variable - `type`: `static` (PostDialDigitsStatic) - `value` (string, required) — Nach dem Verbindungsaufbau zu sendende DTMF-Ziffern (z. B. 'ww1234' für eine Durchwahl) ### LiteralJsonSchemaPropertyType ### LiteralJsonSchemaPropertyConstantValue Ein konstanter Wert für diese Eigenschaft. Schließt sich gegenseitig mit description, dynamic_variable, is_system_provided und is_omitted aus. ### BackupLLMDefault ### BackupLLMDisabled ### BackupLLMOverride - `order` (list of enum, required) - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b` ### ArrayJsonSchemaPropertyInputItems Schema für Array-Elemente. ## Examples **Request** ```json {} ``` **Response** ```json { "agent_id": "J3Pbu5gP6NNKBscdCdwB" } ``` **SDK Code** ```python import requests url = "https://api.elevenlabs.io/v1/convai/agents/create" payload = {} headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.elevenlabs.io/v1/convai/agents/create'; const options = {method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{}'}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.elevenlabs.io/v1/convai/agents/create" payload := strings.NewReader("{}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.elevenlabs.io/v1/convai/agents/create") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Content-Type"] = 'application/json' request.body = "{}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.elevenlabs.io/v1/convai/agents/create") .header("Content-Type", "application/json") .body("{}") .asString(); ``` ```php request('POST', 'https://api.elevenlabs.io/v1/convai/agents/create', [ 'body' => '{}', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.elevenlabs.io/v1/convai/agents/create"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "application/json"] let parameters = [] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/convai/agents/create")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```