> 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. # Tests op de agent uitvoeren POST https://api.elevenlabs.io/v1/convai/agents/{agent_id}/run-tests Content-Type: application/json Voer geselecteerde tests uit op de agent met de opgegeven configuratie. Als de agentconfiguratie is opgegeven, wordt deze gebruikt om de standaardagentconfiguratie te overschrijven. Reference: https://elevenlabs.io/docs/eleven-agents/api-reference/tests/run-tests ## 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 ### Path parameters - `agent_id` (string, required) — De id van een agent. Deze wordt teruggegeven wanneer de agent wordt gemaakt. ### Body (application/json) This endpoint expects an object. - `tests` (list of SingleTestRunRequestModel, required) — Lijst met tests die voor de agent moeten worden uitgevoerd - `agent_config_override` (AdhocAgentConfigOverrideForTestRequestModel, optional) — Configuratie-overschrijvingen voor tests. Als deze niet worden opgegeven, wordt de standaardconfiguratie van de agent gebruikt. - `branch_id` (string, optional) — ID van de branch waarop de tests moeten worden uitgevoerd. Als deze niet is opgegeven, worden de tests uitgevoerd op de hoofdbranch van de agent. - `repeat_count` (integer, optional, default: 1) — Aantal keer dat elke test moet worden uitgevoerd. Bij meer dan 1 worden de resultaten gegroepeerd en samengevat. ## Response ### 200 Geslaagde response - `id` (string, required) - `test_runs` (list of UnitTestRunResponseModel, required) - `agent_id` (string, optional) - `branch_id` (string, optional) - `version_id` (string, optional) - `ran_against_draft` (boolean, optional, default: false) - `created_at` (integer, optional) - `folder_id` (string, optional) - `repeat_count` (integer, optional, default: 1) - `cancelled` (boolean, optional, default: false) - `bucketing_status` (enum, optional) — Geen wanneer repeat_count==1 (geen bucketing). Anders wordt de levenscyclus van bucketing bijgehouden. - Allowed values: `pending`, `completed`, `failed` - `result_groups` (list of TestRunResultSummary, optional) ## Errors ### 422 Agents Run Tests Request Unprocessable Entity Error Validatiefout - `detail` (list of ValidationError, optional) ## Types ### SingleTestRunRequestModel - `test_id` (string, required) — ID van de uit te voeren test - `workflow_node_id` (string, optional) — ID van het workflowknooppunt waarop de test moet worden uitgevoerd. Als deze niet is opgegeven, wordt de test uitgevoerd op het standaardworkflowknooppunt van de agent. - `root_folder_id` (string, optional) — ID van de hoofdmap waarop de test moet worden uitgevoerd. Als deze niet is opgegeven, wordt de test uitgevoerd in de standaardmap van de agent. - `root_folder_name` (string, optional) — Naam van de hoofdmap waarop de test moet worden uitgevoerd. Als deze niet wordt opgegeven, wordt de test uitgevoerd op de standaardmap van de agent. ### AdhocAgentConfigOverrideForTestRequestModel - `conversation_config` (ConversationalConfig, required) - `platform_settings` (AgentPlatformSettingsRequestModel, required) - `workflow` (AgentWorkflowRequestModel, optional) ### UnitTestRunResponseModel - `test_run_id` (string, required) - `test_invocation_id` (string, required) - `agent_id` (string, required) - `status` (enum, required) - Allowed values: `pending`, `passed`, `failed`, `cancelled` - `test_id` (string, required) - `test_info` (UnitTestRunResponseModelTestInfo, optional) - `branch_id` (string, optional) - `version_id` (string, optional) - `ran_against_draft` (boolean, optional, default: false) - `workflow_node_id` (string, optional) - `agent_responses` (list of ConversationHistoryTranscriptCommonModelOutput, optional) - `test_name` (string, optional, default: Unknown Test) - `condition_result` (TestConditionResultCommonModel, optional) - `last_updated_at_unix` (integer, optional) - `metadata` (TestRunMetadata, optional) - `root_folder_id` (string, optional) - `root_folder_name` (string, optional) - `environment` (string, optional) - `credits_used` (integer, optional) — Credits die voor deze testrun in rekening zijn gebracht. None voor runs die zijn gemaakt vóór kostentracking. - `charging` (ConversationChargingCommonModel, optional) — Definitieve uitsplitsing van facturering en providergebruik voor deze testuitvoering. ### TestRunResultSummary - `test_id` (string, required) - `test_name` (string, required) - `buckets` (list of TestRunResultBucket, required) - `workflow_node_id` (string, optional) ### ValidationError - `loc` (list of ValidationErrorLocItem, required) - `msg` (string, required) - `type` (string, required) ### ConversationalConfig - `asr` (AsrConversationalConfig, optional) — Configuratie voor conversationele transcriptie - `turn` (TurnConfig, optional) — Configuratie voor beurtdetectie - `tts` (TtsConversationalConfigOutput, optional) — Configuratie voor conversationele Text to Speech - `conversation` (ConversationConfigOutput, optional) — Configuratie voor gespreksgebeurtenissen - `language_presets` (map from string to LanguagePresetOutput, optional) — Taalvoorinstellingen voor gesprekken - `vad` (VadConfig, optional) — Configuratie voor stemactiviteitsdetectie - `agent` (AgentConfig, optional) — Agentspecifieke configuratie ### AgentPlatformSettingsRequestModel - `evaluation` (EvaluationSettingsInput, optional) — Instellingen voor evaluatie - `widget` (WidgetConfig, optional) — Configuratie voor de widget - `data_collection` (map from string to AnalysisProperty, optional) — Instellingen voor gegevensverzameling - `data_collection_scopes` (map from string to enum, optional) — Scope per ID van gegevensverzamelingsitem. Ontbrekende sleutels gebruiken standaard de gespreksscope. - Allowed values: `conversation`, `agent` - `analysis_items` (AgentAnalysisItemsInput, optional) — Evaluatie- en dataverzamelingsitems die via een verwijzing zijn gekoppeld. None betekent dat de agent nog niet is gemigreerd naar analyse-items (anders dan een lege, gemigreerde set); in dat geval vallen leesbewerkingen terug op de verouderde velden evaluation/data_collection. - `overrides` (ConversationInitiationClientDataConfigInput, optional) — Aanvullende overschrijvingen voor de agent tijdens het starten van het gesprek - `workspace_overrides` (AgentWorkspaceOverridesInput, optional) — Workspace-overschrijvingen voor de agent - `testing` (AgentTestingSettings, optional) — Testconfiguratie voor de agent - `archived` (boolean, optional, default: false) — Of de agent is gearchiveerd - `guardrails` (GuardrailsV1Input, optional) — Guardrails-configuratie voor de agent - `summary_language` (string, optional) — Taal voor alle uitvoer van de gespreksanalyse (samenvattingen, titels, evaluatietoelichtingen, toelichtingen voor gegevensverzameling). Als deze niet is ingesteld, wordt de taal afgeleid uit het gesprek. Moet een van de ondersteunde gesprekstalen zijn. - `auto_translate_transcript_to_app_language` (boolean, optional) — Wanneer dit is ingeschakeld, wordt een gesprekstranscript automatisch vertaald naar de applicatietaal van de kijker wanneer diegene de transcriptpagina opent. Als deze optie niet is ingesteld of false is, worden transcripts in de oorspronkelijke taal getoond, tenzij de kijker handmatig een vertaling selecteert. - `auth` (AuthSettings, optional) — Instellingen voor authenticatie - `call_limits` (AgentCallLimits, optional) — Gesprekslimieten voor de agent - `queueing_config` (AgentQueueingConfig, optional) — Configuratie van de wachtrij voor gelijktijdigheid voor de agent - `privacy` (PrivacyConfigInput, optional) — Privacyinstellingen voor de agent - `trust_context` (enum, optional, default: unknown) — De vertrouwenscontext waarin de agent werkt. - Allowed values: `unknown`, `low`, `high` - `analysis_llm` (enum, optional) — Standaard LLM-model voor analyse na het gesprek (evaluatie en gegevensverzameling) - 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`, `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) — Configuratie voor topicdetectie per agent - `sentiment_analysis` (SentimentAnalysisSettings, optional) — Configuratie voor sentimentanalyse na een gesprek per agent - `alerting` (AlertingSettings, optional) — Waarschuwingsconfiguratie op agentniveau die de workspace-instellingen overschrijft. ### AgentWorkflowRequestModel - `edges` (map from string to WorkflowEdgeModelInput, optional) - `nodes` (map from string to AgentWorkflowRequestModelNodesValue, optional) - `prevent_subagent_loops` (boolean, optional, default: false) — Of loops in de uitvoering van de workflow moeten worden voorkomen. ### UnitTestRunResponseModelTestInfo - `type`: `llm` - `chat_history` (list of ConversationHistoryTranscriptCommonModelOutput, optional) - `conversation_initiation_source` (enum, optional, default: unknown) — Simuleer de test alsof het gesprek vanuit dit kanaal is gestart. - Allowed values: `unknown`, `android_sdk`, `node_js_sdk`, `react_native_sdk`, `react_sdk`, `js_sdk`, `python_sdk`, `widget`, `sip_trunk`, `twilio`, `exotel`, `genesys`, `avaya`, `audiocodes`, `swift_sdk`, `whatsapp`, `twilio_sms`, `flutter_sdk`, `zendesk_integration`, `slack_integration`, `telegram_integration`, `intercom_integration`, `freshdesk_integration`, `salesforce_integration`, `template_preview`, `genesys_bot_connector`, `subagent_tool` - `dynamic_variables` (map from string to any, optional) — Dynamische variabelen die tijdens het testen in de agentconfiguratie moeten worden vervangen - `environment` (string, optional) — De omgeving waarmee omgevingsspecifieke variabelewaarden worden opgelost bij het uitvoeren van deze test (URL, headers, auth-verbindingen). Als deze niet is opgegeven, is de standaardwaarde 'production'. Voor simulatietests heeft simulation_environment voorrang wanneer deze is ingesteld. - `failure_examples` (list of AgentFailureResponseExample, optional) — Niet-lege lijst met voorbeeldreacties die als mislukt moeten worden beschouwd - `from_conversation_metadata` (TestFromConversationMetadataOutput, optional) — Metadata van een gesprek waaruit deze test is gemaakt (indien van toepassing). - `success_condition` (string, optional, default: ) — Een prompt die beoordeelt of het antwoord van de agent succesvol is. Moet True of False retourneren. - `success_examples` (list of AgentSuccessfulResponseExample, optional) — Niet-lege lijst met voorbeeldreacties die als geslaagd moeten worden beschouwd - `type`: `simulation` - `chat_history` (list of ConversationHistoryTranscriptCommonModelOutput, optional) - `conversation_initiation_source` (enum, optional, default: unknown) — Simuleer de test alsof het gesprek vanuit dit kanaal is gestart. - Allowed values: `unknown`, `android_sdk`, `node_js_sdk`, `react_native_sdk`, `react_sdk`, `js_sdk`, `python_sdk`, `widget`, `sip_trunk`, `twilio`, `exotel`, `genesys`, `avaya`, `audiocodes`, `swift_sdk`, `whatsapp`, `twilio_sms`, `flutter_sdk`, `zendesk_integration`, `slack_integration`, `telegram_integration`, `intercom_integration`, `freshdesk_integration`, `salesforce_integration`, `template_preview`, `genesys_bot_connector`, `subagent_tool` - `dynamic_variables` (map from string to any, optional) — Dynamische variabelen die tijdens het testen in de agentconfiguratie moeten worden vervangen - `environment` (string, optional) — De omgeving waarmee omgevingsspecifieke variabelewaarden worden opgelost bij het uitvoeren van deze test (URL, headers, auth-verbindingen). Als deze niet is opgegeven, is de standaardwaarde 'production'. Voor simulatietests heeft simulation_environment voorrang wanneer deze is ingesteld. - `evaluation_model` (enum, optional) — LLM-model dat moet worden gebruikt voor het evalueren van simulatieresultaten. - 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`, `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` - `from_conversation_metadata` (TestFromConversationMetadataOutput, optional) — Metadata van een gesprek waaruit deze test is gemaakt (indien van toepassing). - `simulated_user_model` (enum, optional) — LLM-model voor de gesimuleerde gebruiker. - 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`, `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` - `simulation_environment` (string, optional) — De omgeving die wordt gebruikt bij het uitvoeren van deze simulatietest. Als deze niet is opgegeven, is de standaardwaarde 'production'. - `simulation_max_turns` (integer, optional, default: 5) — Maximumaantal conversatiebeurten voor simulatietests. - `simulation_scenario` (string, optional, default: ) — Beschrijving van het simulatiescenario en de gebruikerspersona voor simulatietests. - `success_conditions` (list of string, optional) — Lijst met prompts die beoordelen of de simulatie is geslaagd. Indien opgegeven, worden alle criteria beoordeeld en samengevoegd tot een eindresultaat. Beperkt tot het maximumaantal evaluatiecriteria. - `tool_mock_config` (SimulationToolMockBehaviorConfig, optional) — Configuratie voor de tools die moeten worden gemockt en het fallbackgedrag. - `tool_mock_overrides` (map from string to list of ToolResponseMockConfigOutput, optional) — Testspecifieke response-mocks, met de tool-ID als sleutel. Worden vóór de gedeelde mocks van de tool toegepast en alleen binnen deze test. Hebben alleen effect voor tools die worden gemockt (zie tool_mock_config). - `success_condition` (string, optional, deprecated) — Verouderd verouderd enkel succescriterium. Gebruik in plaats daarvan success_conditions. Minstens één van success_condition of success_conditions is vereist. - `type`: `tool` - `chat_history` (list of ConversationHistoryTranscriptCommonModelOutput, optional) - `check_any_tool_matches` (boolean, optional) — Als dit is ingesteld op True, slaagt deze test als een tool call die door het LLM wordt geretourneerd aan de criteria voldoet. Anders mislukt de test als de agent meer dan één tool retourneert. - `conversation_initiation_source` (enum, optional, default: unknown) — Simuleer de test alsof het gesprek vanuit dit kanaal is gestart. - Allowed values: `unknown`, `android_sdk`, `node_js_sdk`, `react_native_sdk`, `react_sdk`, `js_sdk`, `python_sdk`, `widget`, `sip_trunk`, `twilio`, `exotel`, `genesys`, `avaya`, `audiocodes`, `swift_sdk`, `whatsapp`, `twilio_sms`, `flutter_sdk`, `zendesk_integration`, `slack_integration`, `telegram_integration`, `intercom_integration`, `freshdesk_integration`, `salesforce_integration`, `template_preview`, `genesys_bot_connector`, `subagent_tool` - `dynamic_variables` (map from string to any, optional) — Dynamische variabelen die tijdens het testen in de agentconfiguratie moeten worden vervangen - `environment` (string, optional) — De omgeving waarmee omgevingsspecifieke variabelewaarden worden opgelost bij het uitvoeren van deze test (URL, headers, auth-verbindingen). Als deze niet is opgegeven, is de standaardwaarde 'production'. Voor simulatietests heeft simulation_environment voorrang wanneer deze is ingesteld. - `from_conversation_metadata` (TestFromConversationMetadataOutput, optional) — Metadata van een gesprek waaruit deze test is gemaakt (indien van toepassing). - `tool_call_parameters` (UnitTestToolCallEvaluationModelOutput, optional) — Hoe de toolaanroep van de agent moet worden geëvalueerd, indien aanwezig. Als dit leeg is, wordt de toolaanroep niet geëvalueerd. ### ConversationHistoryTranscriptCommonModelOutput - `role` (enum, required) - Allowed values: `user`, `agent` - `time_in_call_secs` (integer, required) - `agent_metadata` (AgentMetadata, optional) - `message` (string, optional) - `multivoice_message` (ConversationHistoryMultivoiceMessageModel, optional) — Vertegenwoordigt een bericht van een agent met meerdere stemmen. - `tool_calls` (list of ConversationHistoryTranscriptToolCallCommonModelOutput, optional) - `tool_results` (list of ConversationHistoryTranscriptCommonModelOutputToolResultsItem, optional) - `feedback` (UserFeedback, optional) - `llm_override` (string, optional) - `producing_llm` (string, optional) - `conversation_turn_metrics` (ConversationTurnMetrics, optional) - `rag_retrieval_info` (RagRetrievalInfo, optional) - `llm_usage` (LlmUsageOutput, optional) - `interrupted` (boolean, optional, default: false) - `ignored_as_backchannel` (boolean, optional, default: false) - `platform_event` (enum, optional) - Allowed values: `user_turn_timeout`, `skip_turn_wait_elapsed` - `original_message` (string, optional) - `reasoning` (list of ConversationReasoningModel, optional) - `source_medium` (enum, optional) - Allowed values: `audio`, `dtmf`, `text`, `image`, `file` - `source_event_id` (integer, optional) - `used_static_kb_document_ids` (list of string, optional) - `user_identifier` (string, optional) - `id` (string, optional) - `triggered_guardrails` (list of TriggeredGuardrailCommonModel, optional) ### TestConditionResultCommonModel - `result` (enum, required) - Allowed values: `success`, `failure`, `unknown` - `rationale` (TestConditionRationaleCommonModel, optional) — Gestructureerde onderbouwing voor resultaten van testvoorwaarden, met afzonderlijke redenen voor mislukking of succes. ### TestRunMetadata - `workspace_id` (string, required) - `test_name` (string, required) - `ran_by_user_email` (string, required) - `test_type` (enum, optional, default: llm) - Allowed values: `llm`, `tool_call`, `simulation` ### ConversationChargingCommonModel - `dev_discount` (boolean, optional, default: false) - `is_burst` (boolean, optional, default: false) - `tier` (string, optional) - `llm_usage` (LlmCategoryUsage, optional) - `llm_price` (double, optional) - `llm_charge` (integer, optional) - `call_charge` (integer, optional) - `platform_charge` (integer, optional) - `platform_usage` (PlatformUsage, optional) — Uitsplitsing per categorie van ``platform_charge`` (het equivalent van ``llm_usage``). - `platform_price` (double, optional) - `free_minutes_consumed` (double, optional, default: 0) - `free_llm_dollars_consumed` (double, optional, default: 0) - `tts_usage` (ConversationTtsUsageModel, optional) — Geaggregeerd TTS-gebruik voor een gesprek (alleen voor analytics, niet voor facturering). - `asr_usage` (ConversationAsrUsageModel, optional) — Geaggregeerd ASR-gebruik voor een gesprek (alleen voor analytics, niet voor facturering). - `analysis` (AnalysisCharging, optional) — Kosten voor het uitvoeren van een analyse na het gesprek voor dit gesprek. Aanwezig zodra een analyse is uitgevoerd, ongeacht of deze in rekening is gebracht. ### TestRunResultBucket - `test_run_ids` (list of string, required) - `title` (string, required) — Korte titel van één regel voor deze bucket - `reason` (string, required) — Korte samenvatting van waarom de testruns in deze bucket zijn geslaagd of mislukt - `status` (enum, required) - Allowed values: `pending`, `passed`, `failed`, `cancelled` ### ValidationErrorLocItem ### AsrConversationalConfig - `quality` ("high", optional) — De kwaliteit van de transcriptie - `provider` (enum, optional, default: scribe_realtime) — De provider van de transcriptieservice - Allowed values: `elevenlabs`, `scribe_realtime`, `scribe_v2_turbo` - `user_input_audio_format` (enum, optional, default: pcm_16000) — Het formaat van de audio die moet worden getranscribeerd - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000` - `keywords` (list of string, optional) — Trefwoorden waarvoor de voorspellingskans moet worden verhoogd ### TurnConfig - `turn_timeout` (double, optional, default: 7) — Maximale wachttijd op het antwoord van de gebruiker voordat opnieuw contact wordt opgenomen - `initial_wait_time` (double, optional) — Hoe lang de agent wacht tot de gebruiker het gesprek start als het eerste bericht leeg is. Als dit niet is ingesteld, wordt de gewone turn_timeout gebruikt. - `silence_end_call_timeout` (double, optional, default: -1) — Maximale tijd sinds de gebruiker voor het laatst sprak voordat het gesprek wordt beëindigd - `turn_eagerness` (enum, optional, default: normal) — Bepaalt hoe snel de agent reageert. Laag = minder snel (wacht langer), Standaard = standaardreactiesnelheid, Hoog = sneller (reageert eerder) - Allowed values: `patient`, `normal`, `eager` - `spelling_patience` (enum, optional, default: auto) — Bepaalt of de agent geduldiger moet zijn wanneer de gebruiker getallen en benoemde entiteiten spelt. Auto = gebaseerd op het model, Uit = nooit extra wachten - Allowed values: `auto`, `off` - `speculative_turn` (boolean, optional, default: false) — Wanneer dit is ingeschakeld, begint het tijdens stilte met het genereren van LLM-antwoorden voordat de volledige turn confidence is bereikt, waardoor de waargenomen vertraging afneemt. Dit kan de LLM-kosten verhogen. - `retranscribe_on_turn_timeout` (boolean, optional, default: false) — Wanneer dit is ingeschakeld en VAD geen spraak detecteert, wordt geprobeerd de verzamelde audio opnieuw te transcriberen bij de turn timeout. Schakelt facturering met stiltekorting uit zolang dit is ingeschakeld voor de actieve agent of workflownode. - `turn_model` (enum, optional, default: turn_v3) — Versie van het te gebruiken beurtwisselingsdetectiemodel. - Allowed values: `turn_v2`, `turn_v3` - `interruption_ignore_terms` (list of string, optional) — Lijst met termen die geen onderbreking mogen veroorzaken wanneer de gebruiker ze uitspreekt (bijv. 'gotcha', 'understood'). Gebruikt exacte overeenkomst zonder hoofdlettergevoeligheid. - `interruption_ignore_term_languages` (list of string, optional) — Taalcodes waarvoor vooraf ingestelde categorieën voor te negeren termen zijn geactiveerd. Expliciet opgeslagen, zodat de weergave niet wordt afgeleid uit overlappende termen. - `merge_with_default_ignore_terms` (boolean, optional, default: false) — Wanneer dit is ingeschakeld, worden naast interruption_ignore_terms ook de samengestelde standaardtermen voor interruption_ignore_term_languages gebruikt. - `transcribe_on_disabled_interruptions` (boolean, optional, default: false) — Transcribeer ook wanneer onderbrekingen zijn uitgeschakeld wat de gebruiker zegt, zodat dit kan worden meegenomen naar de volgende beurt. Wanneer dit is uitgeschakeld, wordt spraak van de gebruiker tijdens een niet-onderbreekbare beurt genegeerd en wordt geen beurt gestart. - `soft_timeout_config` (SoftTimeoutConfig, optional) — Configuratie voor soft-time-outfunctionaliteit. Geeft direct feedback tijdens langere LLM-responses. ### TtsConversationalConfigOutput - `model_id` (enum, optional, default: eleven_v4_turbo) — Het model dat voor TTS moet worden gebruikt - 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) — De stem-ID die voor TTS moet worden gebruikt - `supported_voices` (list of SupportedVoice, optional) — Aanvullende ondersteunde stemmen voor de agent - `expressive_mode` (boolean, optional, default: true) — Wanneer dit is ingeschakeld, wordt de prompt voor expressieve audiotags toegepast. Automatisch uitgeschakeld voor niet-v3-modellen. - `suggested_audio_tags` (list of SuggestedAudioTag, optional) — Voorgestelde audiotags om expressieve spraak te versterken (voor modellen eleven_v3 en eleven_v3_conversational). De agent kan nog steeds andere, hier niet vermelde tags gebruiken. - `agent_output_audio_format` (enum, optional, default: pcm_16000) — De audio-indeling die je voor TTS wilt gebruiken - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000` - `optimize_streaming_latency` (integer, optional) — Verouderd: dit veld heeft geen effect en wordt genegeerd. - `stability` (double, optional, default: 0.5) — De stabiliteit van gegenereerde spraak - `speed` (double, optional, default: 1) — De snelheid van gegenereerde spraak - `similarity_boost` (double, optional, default: 0.8) — De similariteitsboost voor gegenereerde spraak - `text_normalisation_type` (enum, optional, default: system_prompt) — Methode om getallen naar woorden om te zetten voordat tekst naar spraak wordt omgezet. Als dit is ingesteld op SYSTEM_PROMPT, wordt de systeemprompt bijgewerkt met normalisatie-instructies. Als dit is ingesteld op ELEVENLABS, wordt de tekst na het genereren genormaliseerd, wat voor een kleine extra vertraging zorgt. - Allowed values: `system_prompt`, `elevenlabs` - `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional) — De locators voor het uitspraakwoordenboek - `enable_phoneme_tags` (boolean, optional, default: true) — Meld je aan voor verwerking van SSML-foneemtags voor V3-modellen. Indien ingeschakeld, worden foneemtags (inline en uit uitspraakwoordenboeken) geparseerd naar inline IPA voordat ze naar het model worden verzonden. - `audio_effects` (EffectsSpecOutput, optional) — Optionele specificatie voor TTS-effecten: filterpreset, afstand (proximity-EQ) en omgeving (convolution reverb). ### ConversationConfigOutput - `text_only` (boolean, optional, default: false) — Als dit is ingeschakeld, wordt audio niet verwerkt en wordt alleen tekst gebruikt. Gebruik dit om audiokosten te vermijden. - `max_duration_seconds` (integer, optional, default: 600) — De maximale duur van een conversatie in seconden - `client_events` (list of enum, optional) — De gebeurtenissen die naar de client worden verzonden - 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) — Configuratie voor bestandsinvoer (uploads van afbeeldingen/PDF's) tijdens gesprekken. - `monitoring_enabled` (boolean, optional, default: false) — Schakel realtime monitoring van gesprekken via WebSocket in - `monitoring_events` (list of enum, optional) — De gebeurtenissen die naar monitoringverbindingen worden verzonden. - 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) — Configureer het verzamelen van DTMF-invoer (toetsenblok) tijdens telefoongesprekken - `background_sound` (BackgroundSoundConfig, optional) — Configuratie voor achtergrondgeluid tijdens gesprekken. - `source_attribution` (boolean, optional, default: false) — Wanneer dit is ingeschakeld en er inhoud in de kennisbank aanwezig is, krijgt de LLM de instructie om te vermelden welke bronnen zijn gebruikt. ### LanguagePresetOutput - `overrides` (ConversationConfigClientOverrideOutput, required) — De overschrijvingen voor de taalpreset - `first_message_translation` (LanguagePresetTranslation, optional) — De vertaling van het eerste bericht - `soft_timeout_translation` (LanguagePresetTranslation, optional) — De vertaling van het bericht voor de zachte time-out ### VadConfig ### AgentConfig - `first_message` (string, optional, default: ) — Als dit niet leeg is, het eerste bericht dat de agent uitspreekt. Als het leeg is, wacht de agent tot de gebruiker het gesprek start. - `language` (string, optional, default: en) — Taal van de agent - gebruikt voor ASR en TTS - `hinglish_mode` (boolean, optional, default: false) — Wanneer dit is ingeschakeld, voegt de agent Engelse woorden en zinnen toe aan antwoorden in het Hindi, Malayalam, Telugu of Kannada. - `dynamic_variables` (any, optional) - `disable_first_message_interruptions` (boolean, optional, default: false) — Als true, kan de gebruiker de agent niet onderbreken terwijl het eerste bericht wordt geleverd. - `max_conversation_duration_message` (string, optional, default: ) — Als dit niet leeg is, het bericht dat de agent verstuurt wanneer de maximale gespreksduur is bereikt. - `text_behavior_overrides` (map from string to BehaviorOverride, optional) — Overschrijvingen van antwoordgedrag per kanaal voor tekstgesprekken. Als deze niet zijn ingesteld, gelden de ingebouwde standaardwaarden van het kanaal. - `prompt` (PromptAgentApiModelOutput, optional) — De prompt voor de agent ### EvaluationSettingsInput Instellingen om de prestaties van een agent te evalueren. Agents worden beoordeeld aan de hand van een reeks criteria, waarbij succes wordt gedefinieerd als het voldoen aan een combinatie van die criteria. - `criteria` (list of PromptEvaluationCriteria, optional) — Afzonderlijke criteria waarop de agent moet worden geëvalueerd ### WidgetConfig - `variant` (enum, optional, default: full) — De variant van de widget - Allowed values: `tiny`, `compact`, `full`, `expandable` - `placement` (enum, optional, default: bottom-right) — De positie van de widget op het scherm - Allowed values: `top-left`, `top`, `top-right`, `bottom-left`, `bottom`, `bottom-right` - `expandable` (enum, optional, default: never) — Of de widget kan worden uitgeklapt - Allowed values: `never`, `mobile`, `desktop`, `always` - `avatar` (WidgetConfigAvatar, optional) — De avatar van de widget - `feedback_mode` (enum, optional, default: none) — De feedbackmodus van de widget - Allowed values: `none`, `during`, `end` - `end_feedback` (WidgetEndFeedbackConfig, optional) — Configuratie voor feedback die aan het einde van het gesprek wordt verzameld - `bg_color` (string, optional, default: #ffffff) — De achtergrondkleur van de widget - `text_color` (string, optional, default: #000000) — De tekstkleur van de widget - `btn_color` (string, optional, default: #000000) — De knopkleur van de widget - `btn_text_color` (string, optional, default: #ffffff) — De tekstkleur van de knop van de widget - `border_color` (string, optional, default: #e1e1e1) — De randkleur van de widget - `focus_color` (string, optional, default: #000000) — De focuskleur van de widget - `border_radius` (integer, optional) — De hoekafronding van de widget - `btn_radius` (integer, optional) — De hoekafronding van de knop van de widget - `action_text` (string, optional) — De actietekst van de widget - `start_call_text` (string, optional) — De tekst voor het starten van een gesprek in de widget - `end_call_text` (string, optional) — De tekst bij het beëindigen van het gesprek in de widget - `expand_text` (string, optional) — De uitvouwtekst van de widget - `listening_text` (string, optional) — De tekst die wordt weergegeven wanneer de agent luistert - `speaking_text` (string, optional) — De tekst die wordt weergegeven wanneer de agent spreekt - `shareable_page_text` (string, optional) — De tekst die wordt weergegeven bij delen - `shareable_page_show_terms` (boolean, optional, default: true) — Of de algemene voorwaarden op de deelbare pagina moeten worden weergegeven - `terms_text` (string, optional) — De tekst die voor de algemene voorwaarden wordt weergegeven - `terms_html` (string, optional) — De HTML die wordt weergegeven voor de algemene voorwaarden - `terms_key` (string, optional) — De weer te geven sleutel voor de algemene voorwaarden - `show_avatar_when_collapsed` (boolean, optional) — Of de avatar moet worden weergegeven wanneer de widget is ingeklapt - `disable_banner` (boolean, optional, default: false) — Of de banner moet worden uitgeschakeld - `override_link` (string, optional) — De overschrijvingslink voor de widget - `markdown_link_allowed_hosts` (list of AllowlistItem, optional) — Lijst met toegestane hostnamen voor klikbare Markdown-links. Gebruik \{ hostname: '\*' } om elk domein toe te staan. Leeg betekent dat er geen links zijn toegestaan. - `markdown_link_include_www` (boolean, optional, default: true) — Of www.-varianten van toegestane hosts automatisch moeten worden opgenomen - `markdown_link_allow_http` (boolean, optional, default: true) — Of http:// naast https:// moet worden toegestaan voor toegestane hosts - `mic_muting_enabled` (boolean, optional, default: true) — Of het dempen van de microfoon moet worden ingeschakeld - `transcript_enabled` (boolean, optional, default: true) — Of de widget het gesprekstranscript tijdens het gesprek moet weergeven - `text_input_enabled` (boolean, optional, default: true) — Of de gebruiker tekstberichten moet kunnen sturen - `conversation_mode_toggle_enabled` (boolean, optional, default: false) — Of de schakelaar voor gespreksmodus in de widget moet worden ingeschakeld - `default_expanded` (boolean, optional, default: false) — Of de widget standaard moet zijn uitgeklapt - `always_expanded` (boolean, optional, default: false) — Of de widget altijd moet zijn uitgeklapt - `dismissible` (boolean, optional, default: false) — Of de widget door de gebruiker kan worden gesloten - `show_agent_status` (boolean, optional, default: false) — Of de status bezig/klaar/fout van de agent tijdens het gebruik van tools moet worden weergegeven - `show_conversation_id` (boolean, optional, default: true) — Of de gespreks-ID na verbreking van de verbinding moet worden weergegeven. - `strip_audio_tags` (boolean, optional, default: true) — Of audio-markup uit berichten moet worden verwijderd. - `syntax_highlight_theme` (enum, optional) — Thema voor syntax highlighting in codeblokken. Standaard wordt automatische detectie door de widget gebruikt wanneer dit niet is ingesteld. - Allowed values: `light`, `dark` - `text_contents` (WidgetTextContents, optional) — Tekstinhoud van de widget - `styles` (WidgetStyles, optional) — Stijlen voor de widget - `show_resize_button` (boolean, optional, default: true) — Of de knop voor formaat wijzigen moet worden weergegeven - `end_confirmation_enabled` (boolean, optional, default: false) — Of de gebruiker om bevestiging moet worden gevraagd voordat een chat of gesprek wordt beëindigd - `language_selector` (boolean, optional, default: false) — Of de taalkiezer moet worden weergegeven - `supports_text_only` (boolean, optional, default: true) — Of de widget kan overschakelen naar de modus voor alleen tekst - `custom_avatar_path` (string, optional) — Het pad naar de aangepaste avatar - `language_presets` (map from string to WidgetLanguagePreset, optional) — Taalvoorinstellingen voor de widget ### AnalysisProperty Eigenschap voor gegevensverzameling met optionele LLM-overschrijving per item voor analyse na het gesprek. TODO: migreren naar compositie (value_schema: LiteralJsonSchemaProperty + llm) in plaats van overerving, zodat dit in de toekomst goed generaliseert naar object-/arrayschema's. - `type` (enum, required) - Allowed values: `boolean`, `string`, `integer`, `number` - `description` (string, optional, default: ) — De beschrijving van de eigenschap. Wanneer deze is ingesteld, geeft de LLM de waarde op basis van deze beschrijving. Kan niet samen worden gebruikt met dynamic_variable, is_system_provided, constant_value en is_omitted. - `enum` (list of string, optional) — List of allowed string values for string type parameters - `is_system_provided` (boolean, optional, default: false) — Als true, wordt de waarde tijdens runtime door het systeem ingevuld. Wordt door API Integration Webhook-tools gebruikt voor templating. Kan niet tegelijk worden gebruikt met description, dynamic_variable, constant_value en is_omitted. - `dynamic_variable` (string, optional, default: ) — De naam van de dynamische variabele die voor de waarde van deze eigenschap moet worden gebruikt. Kan niet worden gecombineerd met description, is_system_provided, constant_value en is_omitted. - `allowed_values` (AllowedValues, optional) — Server-side afwijscontrole voor een door de LLM opgegeven waarde: de runtime wijst elke waarde buiten de toegestane set die dit object benoemt af, en de set wordt niet als enum aan de LLM getoond. Alleen ondersteund wanneer de waardebron `description` is; een combinatie met dynamic_variable, is_system_provided, constant_value of is_omitted wordt afgewezen. - `constant_value` (AnalysisPropertyConstantValue, optional) — Een constante waarde voor deze eigenschap. Kan niet samen worden gebruikt met description, dynamic_variable, is_system_provided en is_omitted. - `is_omitted` (boolean, optional, default: false) — Als true is, wordt deze parameter volledig uit de request weggelaten. Alleen geldig voor optionele parameters. Kan niet samen worden gebruikt met description, dynamic_variable, is_system_provided en constant_value. - `name` (string, optional) — De naam van dit gegevensverzamelingsitem. - `llm` (enum, optional) — LLM-model dat moet worden gebruikt voor dit analyse-item. Indien niet ingesteld, wordt de standaardwaarde analysis_llm van de agent gebruikt. - 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`, `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) — VEROUDERD: gebruik in plaats daarvan `allowed_values`. Wanneer ingesteld, levert de LLM de waarde, maar weigert de runtime elke waarde die niet voorkomt in de lijst van deze dynamische variabele (moet een JSON-array zijn zoals ["ws_alpha", "ws_beta"]). Gebruik dit om de LLM te laten kiezen uit een door de server geverifieerde set (bijv. de ID's waartoe de huidige gebruiker toegang heeft). Vereist description; kan niet samen met dynamic_variable, is_system_provided, constant_value en is_omitted worden gebruikt. ### AgentAnalysisItemsInput - `evaluation_criteria` (list of AgentAnalysisItemsInputEvaluationCriteriaItem, optional) - `data_collection` (list of AgentAnalysisItemsInputDataCollectionItem, optional) ### ConversationInitiationClientDataConfigInput - `conversation_config_override` (ConversationConfigClientOverrideConfigInput, optional) — Overschrijvingen voor de gespreksconfiguratie - `custom_llm_extra_body` (boolean, optional, default: false) — Of een aangepaste extra body voor de LLM moet worden opgenomen - `enable_conversation_initiation_client_data_from_webhook` (boolean, optional, default: false) — Of clientdata voor het starten van gesprekken vanuit webhooks moet worden ingeschakeld - `enable_starting_workflow_node_id_from_client` (boolean, optional, default: false) — Of clients starting_workflow_node_id mogen doorgeven in initiële clientdata; als false, mislukt het starten van het gesprek wanneer dit wordt verzonden. - `enable_procedure_ids_from_client` (boolean, optional, default: false) — Of clients procedure_ids mogen doorgeven in initiële clientdata om te kiezen welke procedures van de agent beschikbaar zijn voor het gesprek; als false, mislukt het starten van het gesprek wanneer dit wordt verzonden. ### AgentWorkspaceOverridesInput - `conversation_initiation_client_data_webhook` (ConversationInitiationClientDataWebhook, optional) — De webhook waarnaar clientgegevens voor het starten van een gesprek moeten worden verzonden - `webhooks` (ConvAiWebhooks, optional) ### AgentTestingSettings Instellingen voor de testconfiguratie van de agent. - `attached_tests` (list of AttachedTestModel, optional) — Lijst met test-ID's die voor deze agent moeten worden uitgevoerd ### GuardrailsV1Input - `version` ("1", optional) - `focus` (FocusGuardrail, optional) - `prompt_injection` (PromptInjectionGuardrail, optional) - `content` (ContentGuardrailInput, optional) - `custom` (CustomGuardrailInput, optional) — Container voor aangepaste guardrails, volgens het ModerationGuardrail-patroon ### AuthSettings - `enable_auth` (boolean, optional, default: false) — Als dit is ingesteld op true, is een ondertekend token vereist om een gesprek met een agent te starten - `allowlist` (list of AllowlistItem, optional) — Een lijst met hosts die gesprekken met de agent mogen starten - `require_origin_header` (boolean, optional, default: false) — Wanneer dit is ingeschakeld, worden verbindingen zonder origin-header geweigerd. Als de allowlist leeg is, heeft deze optie geen effect. - `shareable_token` (string, optional) — Een deelbare token waarmee je een gesprek met de agent kunt starten ### AgentCallLimits - `agent_concurrency_limit` (integer, optional, default: -1) — Het maximumaantal gelijktijdige conversaties. -1 geeft aan dat er geen maximum is - `daily_limit` (integer, optional, default: 100000) — Het maximumaantal conversaties per dag - `bursting_enabled` (boolean, optional, default: true) — Of bursting moet worden ingeschakeld. Als dit true is, mag de gelijktijdigheidslimiet van de workspace tot 3 keer de limiet worden overschreden. Bij overschrijding van de limiet worden calls tegen het dubbele tarief berekend. ### AgentQueueingConfig - `enabled` (boolean, optional, default: false) — Houd bellers in een wachtrij wanneer de agent de gelijktijdigheidslimiet heeft bereikt, in plaats van ze onmiddellijk te weigeren. Nieuwe agents worden gemaakt met wachtrijbeheer ingeschakeld, tenzij dit veld expliciet is ingesteld. - `wait_timeout_seconds` (integer, optional, default: 180) — Maximale tijd dat een beller in de wachtrij kan wachten voordat deze wordt afgewezen - `hold_audio` (AgentHoldAudioConfig, optional) — Aangepaste wachtmuziek die wordt afgespeeld voor bellers in de wachtrij; als deze niet is ingesteld, horen bellers de standaardwachttijdtoon. Alleen-lezen: stel dit in door een bestand te uploaden via het endpoint voor wachtmuziek van de agent. ### PrivacyConfigInput - `record_voice` (boolean, optional, default: true) — Of het gesprek moet worden opgenomen - `retention_days` (integer, optional, default: -1) — Het aantal dagen dat het gesprek wordt bewaard. -1 geeft aan dat er geen bewaarlimiet is - `delete_transcript_and_pii` (boolean, optional, default: false) — Of het transcript en de PII moeten worden verwijderd - `delete_audio` (boolean, optional, default: false) — Of de audio moet worden verwijderd - `apply_to_existing_conversations` (boolean, optional, default: false) — Of de privacyinstellingen moeten worden toegepast op bestaande gesprekken - `zero_retention_mode` (boolean, optional, default: false) — Of de modus zonder gegevensbewaring moet worden ingeschakeld - er worden geen PII-gegevens opgeslagen - `conversation_history_redaction` (ConversationHistoryRedactionConfig, optional) — Configuratie voor het redigeren van PII in de gespreksgeschiedenis ### TopicDiscoverySettings Configuratie voor topicdetectie per agent. Frequentie en analysevenster worden intern beheerd; dit biedt alleen de aan/uit-schakelaar voor klanten. ### SentimentAnalysisSettings ### AlertingSettings Waarschuwingsconfiguratie die zowel op agent- als workspaceniveau wordt gebruikt. Volgorde van overname voor de drempelwaarde en automatische oplossing per monitor: agent → workspace → systeemstandaard. - `monitor_configs` (map from string to AlertingMonitorConfig, optional) — Waarschuwingsconfiguratie ingedeeld op monitornaam. - `auto_resolve_after_inactive_minutes` (integer, optional) — Hoeveel minuten een waarschuwing inactief kan blijven voordat deze automatisch wordt opgelost. Niet-ingestelde waarden vallen terug op de volgende laag. - `notifiers` (list of AlertingSettingsNotifiersItem, optional) — Bezorgkanalen voor meldingen over de levenscyclus van waarschuwingen. Gestapeld met andere lagen en gededupliceerd op ``webhook_id``, PagerDuty ``connection_id`` of Slack ``(connection_id, channel_id)``. ### WorkflowEdgeModelInput - `source` (string, required) — ID van het bronknooppunt. - `target` (string, required) — ID van het doelknooppunt. - `forward_condition` (WorkflowEdgeModelInputForwardCondition, optional) — Voorwaarde waaraan moet worden voldaan om de rand in voorwaartse richting te doorlopen (bron naar doel). - `backward_condition` (WorkflowEdgeModelInputBackwardCondition, optional) — Voorwaarde waaraan moet worden voldaan om de rand in achterwaartse richting te doorlopen (doel naar bron). ### AgentWorkflowRequestModelNodesValue - `type`: `end` - `edge_order` (list of string, optional) — De ID's van uitgaande verbindingen in de volgorde waarin ze moeten worden geëvalueerd. - `outcome` (enum, optional, default: success) — Of het bereiken van dit End-knooppunt het gesprek als succes of mislukking beëindigt. - Allowed values: `success`, `failure` - `position` (PositionInput, optional) — Positie van de node in de workflow. - `type`: `override_agent` - `label` (string, required) — Voor mensen leesbaar label voor het knooppunt dat in de hele UI wordt gebruikt. - `additional_knowledge_base` (list of KnowledgeBaseLocator, optional) — Aanvullende kennisbankdocumenten waartoe de subagent toegang heeft. Deze worden gebruikt naast de documenten van de hoofdagent. - `additional_prompt` (string, optional) — Specifiek doel voor deze subagent. Dit wordt toegevoegd aan de system prompt en kan worden gebruikt om het gedrag van de agent in deze specifieke context verder te verfijnen. - `additional_tool_ids` (list of string, optional) — ID's van aanvullende tools waartoe de subagent toegang heeft. Deze worden naast de tools van de hoofdagent gebruikt. - `conversation_config` (ConversationalConfigApiModelWorkflowOverrideInput, optional) — Configuratie-overschrijvingen die worden toegepast terwijl de subagent het gesprek voert. - `edge_order` (list of string, optional) — De ID's van uitgaande verbindingen in de volgorde waarin ze moeten worden geëvalueerd. - `entry_behavior` (enum, optional, default: auto) — Bepaalt of dit knooppunt bij binnenkomst direct een antwoord moet genereren of op gebruikersinvoer moet wachten. Wanneer ingesteld op "auto", wordt het gedrag bepaald op basis van het type voorgaande knooppunt: "wait_for_user" na de knooppunten "say" en "start", en anders "generate_immediately". - Allowed values: `generate_immediately`, `wait_for_user`, `auto` - `position` (PositionInput, optional) — Positie van de node in de workflow. - `type`: `phone_number` - `transfer_destination` (WorkflowPhoneNumberNodeModelInputTransferDestination, required) - `custom_sip_headers` (list of WorkflowPhoneNumberNodeModelInputCustomSipHeadersItem, optional) — Aangepaste SIP-headers die moeten worden opgenomen bij het doorverbinden van het gesprek. Elke header kan een statische waarde of een verwijzing naar een dynamische variabele zijn. - `edge_order` (list of string, optional) — De ID's van uitgaande verbindingen in de volgorde waarin ze moeten worden geëvalueerd. - `position` (PositionInput, optional) — Positie van de node in de workflow. - `post_dial_digits` (WorkflowPhoneNumberNodeModelInputPostDialDigits, optional) — DTMF-cijfers die moeten worden verzonden nadat de oproep is verbonden (bijvoorbeeld 'ww1234' voor een doorkiesnummer). Kan een statische waarde of een verwijzing naar een dynamische variabele zijn. Gebruik 'w' voor een pauze van 0,5 s. Alleen ondersteund voor Twilio-transfers. - `sip_refer_play_dialtone` (boolean, optional, default: true) — Wanneer True, wordt op het oorspronkelijke gesprekstraject een beltoon afgespeeld terwijl een SIP REFER-transfer wordt voltooid. De toon wordt via RTP doorgegeven aan de SIP-peer die de REFER uitvoert, dus schakel dit uit als het ontvangende systeem (bijvoorbeeld een SBC of contactcenter) deze niet mag horen. Wanneer dit is uitgeschakeld, hoort de beller stilte totdat de transfer is voltooid. Alleen voor SIP REFER-transfers. - `transfer_type` (enum, optional, default: conference) - Allowed values: `blind`, `conference`, `sip_refer` - `uui` (UuiTransferConfig, optional) — User-to-User Information (RFC 7433) om aan SIP REFER-transfers toe te voegen. Draagt oproepcontext, zoals CRM-identificatiecodes of de reden voor escalatie, over de transfergrens heen. - `type`: `standalone_agent` - `agent_id` (string, optional) — De ID van de agent waarnaar het gesprek moet worden overgedragen. None betekent overdracht binnen de huidige agent. - `branch_id` (string, optional) — Optionele branch-ID voor de doelagent. None volgt de traffic deployment van de doelagent, of gebruikt de hoofdbranch als node_id is ingesteld. - `delay_ms` (integer, optional, default: 0) — Kunstmatige vertraging in milliseconden die wordt toegepast voordat het gesprek wordt doorgeschakeld. - `edge_order` (list of string, optional) — De ID's van uitgaande verbindingen in de volgorde waarin ze moeten worden geëvalueerd. - `enable_transferred_agent_first_message` (boolean, optional, default: false) — Of de overgedragen agent na de overdracht het ingestelde eerste bericht mag verzenden. - `node_id` (string, optional) — Optionele doelnode-ID in de workflow van de bestemmingsagent. Wanneer deze is ingesteld, begint de overdracht bij deze node in plaats van bij de standaardinvoernode. - `position` (PositionInput, optional) — Positie van de node in de workflow. - `preserve_client_tts_overrides` (boolean, optional, default: false) — Definieert of TTS-clientoverschrijvingen moeten worden overgedragen naar de doorverbonden agent. - `preserve_voice_settings` (boolean, optional, default: false) — Definieert of de basisstem, het TTS-model en de steminstellingen moeten worden overgedragen naar de doorverbonden agent. - `transfer_message` (string, optional) — Optioneel bericht dat naar de gebruiker wordt verzonden voordat de overdracht wordt gestart. - `type`: `start` - `edge_order` (list of string, optional) — De ID's van uitgaande verbindingen in de volgorde waarin ze moeten worden geëvalueerd. - `position` (PositionInput, optional) — Positie van de node in de workflow. - `type`: `tool` - `edge_order` (list of string, optional) — De ID's van uitgaande verbindingen in de volgorde waarin ze moeten worden geëvalueerd. - `position` (PositionInput, optional) — Positie van de node in de workflow. - `tools` (list of WorkflowToolLocator, optional) — Lijst met tools die parallel moeten worden uitgevoerd. Het volledige knooppunt wordt als geslaagd beschouwd als alle tools succesvol zijn uitgevoerd. - `type`: `say` - `label` (string, required) — Voor mensen leesbaar label voor het knooppunt dat in de hele UI wordt gebruikt. - `message` (WorkflowSayNodeModelInputMessage, required) — Bericht dat door deze node wordt uitgesproken. Gebruik `literal` voor exacte tekst of `prompt` om de LLM het bericht op basis van een beschrijving te laten genereren. - `additional_knowledge_base` (list of KnowledgeBaseLocator, optional) — Kennisbankdocumenten die beschikbaar zijn voor de LLM terwijl deze node zijn bericht genereert, naast de documenten van de agent. - `additional_prompt` (string, optional) — Geaccepteerd voor consistentie met subagentnodes, maar niet gebruikt. Beschrijf het bericht in `message.prompt`, of vervang de systeemprompt door `conversation_config.agent.prompt.prompt`. - `additional_tool_ids` (list of string, optional) — Geaccepteerd voor consistentie met subagentnodes, maar niet gebruikt. Een say-node kan geen tools aanroepen. - `conversation_config` (ConversationalConfigApiModelWorkflowOverrideInput, optional) — Configuratie-overschrijvingen die worden toegepast terwijl dit knooppunt spreekt, zoals de stem of, voor promptberichten, de LLM en systeemprompt. - `edge_order` (list of string, optional) — De ID's van uitgaande verbindingen in de volgorde waarin ze moeten worden geëvalueerd. - `position` (PositionInput, optional) — Positie van de node in de workflow. - `wait_for_speech_completion` (boolean, optional, default: false) — Wanneer true, gaat de workflow pas naar de volgende node nadat het bericht volledig is uitgesproken. - `wait_for_user_response` (boolean, optional, default: false) — Wanneer true, spreekt de node zijn bericht uit en wacht vervolgens op antwoord van de gebruiker voordat uitgaande edges worden geëvalueerd, zodat edges kunnen vertakken op basis van het antwoord. Als de gebruiker stil blijft, gaat de workflow verder na de turn timeout. - `type`: `update_state` - `label` (string, required) — Voor mensen leesbaar label voor het knooppunt dat in de hele UI wordt gebruikt. - `updates` (list of WorkflowStateUpdateInput, required) — Statusupdates die worden toegepast wanneer de workflow dit knooppunt bereikt. Een knooppunt accepteert maximaal 50 updates. - `edge_order` (list of string, optional) — De ID's van uitgaande verbindingen in de volgorde waarin ze moeten worden geëvalueerd. - `position` (PositionInput, optional) — Positie van de node in de workflow. ### AgentFailureResponseExample - `response` (string, required) - `type` ("failure", required) ### TestFromConversationMetadataOutput - `conversation_id` (string, required) - `agent_id` (string, required) - `branch_id` (string, optional) - `workflow_node_id` (string, optional) - `original_agent_reply` (list of ConversationHistoryTranscriptCommonModelOutput, optional, default: []) ### AgentSuccessfulResponseExample - `response` (string, required) - `type` ("success", required) ### SimulationToolMockBehaviorConfig Configuratie aan de simulatie-/previewzijde: tools worden geïdentificeerd door ID's en tijdens runtime naar namen omgezet. - `mocking_strategy` (enum, optional, default: none) — Welke tools moeten worden gemockt: 'all' mockt elke mockbare tool, 'selected' mockt alleen de tools in mocked_tool_names/mocked_tool_ids en 'none' schakelt mocking uit. - Allowed values: `all`, `selected`, `none` - `fallback_strategy` (enum, optional, default: raise_error) — Gedrag wanneer geen mock overeenkomt met een toolaanroep. - Allowed values: `call_real_tool`, `raise_error` - `mocked_tool_ids` (list of string, optional) — Tool-ID's die moeten worden gemockt. Worden omgezet naar toolnamen voordat ze aan de orchestrator worden doorgegeven. ### ToolResponseMockConfigOutput - `mock_result` (string, required) — De retourwaarde die de LLM ziet wanneer deze mock actief is. - `parameter_conditions` (list of UnitTestToolCallParameter, optional) — Als de lijst leeg is, wordt de mock altijd geactiveerd. - `is_error` (boolean, optional, default: false) — Als true, wordt het mockresultaat aan het LLM weergegeven als een toolfout in plaats van als een geslaagd resultaat. ### UnitTestToolCallEvaluationModelOutput - `parameters` (list of UnitTestToolCallParameter, optional) — Parameters om te evalueren voor de tool call van de agent. Als deze leeg zijn, worden de parameters van de tool call niet geëvalueerd. - `referenced_tool` (ReferencedToolCommonModel, optional) — De tool waarmee een oproep wordt geëvalueerd. - `verify_absence` (boolean, optional, default: false) — Of moet worden geverifieerd dat de tool NIET is aangeroepen. - `workflow_node_transition` (UnitTestWorkflowNodeTransitionEvaluationNodeId, optional) — Configuratie voor het testen van overgangen tussen workflowknooppunten. Indien ingesteld, verifieert de test dat de agent naar het opgegeven workflowknooppunt overgaat. ### AgentMetadata - `agent_id` (string, required) - `branch_id` (string, optional) - `workflow_node_id` (string, optional) - `version_id` (string, optional) ### ConversationHistoryMultivoiceMessageModel Vertegenwoordigt een bericht van een agent met meerdere stemmen. - `parts` (list of ConversationHistoryMultivoiceMessagePartModel, required) ### ConversationHistoryTranscriptToolCallCommonModelOutput - `request_id` (string, required) - `tool_name` (string, required) - `params_as_json` (string, required) - `tool_has_been_called` (boolean, required) - `type` (enum, optional) - Allowed values: `system`, `webhook`, `client`, `mcp`, `workflow`, `api_integration_webhook`, `api_integration_mcp`, `smb` - `tool_details` (ConversationHistoryTranscriptToolCallCommonModelOutputToolDetails, optional) ### ConversationHistoryTranscriptCommonModelOutputToolResultsItem ### UserFeedback - `score` (enum, required) - Allowed values: `like`, `dislike` - `time_in_call_secs` (integer, required) ### ConversationTurnMetrics - `metrics` (map from string to MetricRecord, optional) - `convai_asr_provider` (string, optional) - `convai_tts_model` (string, optional) - `convai_tts_cascade` (string, optional) - `voice_id` (string, optional) ### RagRetrievalInfo - `chunks` (list of RagChunkMetadata, required) - `embedding_model` (enum, required, default: e5_mistral_7b_instruct) - Allowed values: `e5_mistral_7b_instruct`, `multilingual_e5_large_instruct` - `retrieval_query` (string, required) - `rag_latency_secs` (double, required) - `used_chunk_ids` (list of string, optional) ### LlmUsageOutput - `model_usage` (map from string to LlmInputOutputTokensUsage, optional) ### ConversationReasoningModel - `summary` (string, optional) - `provider_redact` (boolean, optional, default: false) ### TriggeredGuardrailCommonModel - `guardrail_type` (enum, required) - Allowed values: `custom`, `prompt_injection`, `self_harm_intent`, `violence_graphic`, `sexual`, `violence`, `harassment`, `sexual_minors`, `self_harm`, `self_harm_instructions`, `harassment_threatening`, `hate`, `hate_threatening`, `profanity`, `religion_or_politics`, `medical_and_legal`, `guardrail` - `guardrail_name` (string, optional) ### TestConditionRationaleCommonModel Gestructureerde onderbouwing voor resultaten van testvoorwaarden, met afzonderlijke redenen voor mislukking of succes. - `messages` (list of string, optional) — Lijst met afzonderlijke berichten of redenen voor parameterevaluatie - `summary` (string, optional, default: ) — Samenvatting op hoofdlijnen van het evaluatieresultaat ### LlmCategoryUsage - `irreversible_generation` (LlmUsageOutput, optional) - `initiated_generation` (LlmUsageOutput, optional) ### PlatformUsage Uitsplitsing per categorie van ``platform_charge`` (het equivalent van ``llm_usage``). - `category_usage` (map from string to PlatformCategoryUsage, optional) ### ConversationTtsUsageModel Geaggregeerd TTS-gebruik voor een gesprek (alleen voor analytics, niet voor facturering). - `primary_tts_model` (string, optional) - `total_audio_output_seconds` (double, optional, default: 0) - `total_characters` (integer, optional, default: 0) - `per_voice_usage` (list of ConversationVoiceUsageModel, optional) ### ConversationAsrUsageModel Geaggregeerd ASR-gebruik voor een gesprek (alleen voor analytics, niet voor facturering). - `asr_model` (string, optional) - `total_transcription_calls` (integer, optional, default: 0) - `total_audio_input_seconds` (double, optional, default: 0) ### AnalysisCharging Kosten voor het uitvoeren van een analyse na het gesprek voor dit gesprek. Aanwezig zodra een analyse is uitgevoerd, ongeacht of deze in rekening is gebracht. - `total` (AnalysisRunningTotal, required) — Cumulatieve LLM-kosten voor het uitvoeren van analyse na het gesprek voor deze conversatie. - `last_run` (AnalysisRunSnapshot, required) — LLM-kosten van de meest recente analyse na het gesprek voor deze conversatie. ### SoftTimeoutConfig Configuratie voor soft-time-outfunctionaliteit tijdens het genereren van LLM-responses. - `timeout_seconds` (double, optional, default: -1) — Tijd in seconden voordat het vooraf gedefinieerde bericht wordt getoond tijdens het wachten op een LLM-reactie. Stel in op -1 om uit te schakelen. - `message` (string, optional, default: Hhmmmm...yeah.) — Bericht dat wordt weergegeven wanneer de eerste zachte time-out wordt bereikt tijdens het wachten op een reactie van de LLM. Ondersteunt dynamische variabelen (bijv. \{\{system\_\_time}}, \{\{custom\_variable}}). - `additional_soft_timeout_messages` (list of string, optional) — Extra statische opvulberichten voor volgende soft time-outs in dezelfde LLM-generatie. De eerste time-out gebruikt `message`. Als er minder berichten zijn geconfigureerd dan `max_soft_timeouts_per_generation`, wordt het laatst geconfigureerde bericht herhaald; anders wordt een ingebouwd opvulbericht gebruikt. - `use_llm_generated_message` (boolean, optional, default: false) — Als dit is ingeschakeld, wordt het soft-timeoutbericht dynamisch gegenereerd in plaats van het statische bericht te gebruiken. - `randomize_fillers` (boolean, optional, default: false) — Als dit is ingeschakeld, wordt de volgorde van statische soft-timeoutberichten eenmaal aan het begin van elke beurt geschud. Geldt alleen wanneer use_llm_generated_message false is. - `max_soft_timeouts_per_generation` (integer, optional, default: 1) — Maximumaantal opvulberichten tijdens het wachten op één LLM-respons. Wordt elke timeout_seconds geactiveerd totdat het LLM content streamt of deze limiet is bereikt. - `llm_generated_message_prompt_override` (string, optional) — Aangepaste prompt voor het genereren van het opvulbericht bij een zachte time-out wanneer use\_llm\_generated\_message is ingeschakeld. Recente conversatiecontext wordt als afzonderlijk gebruikersbericht verstrekt. Als dit niet is ingesteld, wordt de standaardprompt gebruikt. Ondersteunt dynamische variabelen (bijv. \{\{system\_\_time}}, \{\{custom\_variable}}). - `disable_until_first_user_message` (boolean, optional, default: false) — Wanneer true, worden fillers bij een soft timeout onderdrukt totdat het gesprek minstens één echt gebruikersbericht bevat. Dit voorkomt fillers tijdens de openingsbeurt van de agent (bijvoorbeeld workflow generate-immediately / tool calls voordat de gebruiker spreekt). ### SupportedVoice - `label` (string, required) - `voice_id` (string, required) - `description` (string, optional) - `language` (string, optional) - `model_family` (enum, optional) - Allowed values: `turbo`, `flash`, `multilingual`, `v3_conversational`, `v4`, `v4_turbo` - `optimize_streaming_latency` (integer, optional) - `stability` (double, optional) - `speed` (double, optional) - `similarity_boost` (double, optional) ### SuggestedAudioTag - `tag` (string, required) — Te gebruiken audiotag (voor de beste prestaties 1-2 woorden, bijvoorbeeld 'happy', 'excited') - `description` (string, optional) — Optionele beschrijving van wanneer je deze tag gebruikt ### PydanticPronunciationDictionaryVersionLocator Een locator waarmee andere documenten naar een specifiek woordenboek en de bijbehorende versie kunnen verwijzen. Dit is een pydantic-versie van PronunciationDictionaryVersionLocatorDBModel. Vereist om compatibiliteit met de overige datamodellen van de agent te waarborgen. - `pronunciation_dictionary_id` (string, required) — De ID van het uitspraakwoordenboek - `version_id` (string, optional) — De ID van de versie van het uitspraakwoordenboek ### EffectsSpecOutput Audio-effecten die worden toegepast op gegenereerde spraak: een filterpreset, waargenomen afstand, een galm- omgeving, achtergrondruis en stereopanning. Laat elk veld op de standaardwaarde staan om onbewerkte audio te krijgen. - `distance` (double, required, default: 0) — Hoe ver de spreker van de microfoon lijkt te staan, van 0 (dichtbij, ongewijzigd) tot 1 (ver weg). Hogere waarden dempen lage en hoge frequenties en verschuiven, wanneer een omgeving is ingesteld, de balans van de droge stem naar de galm. - `send_level` (double, required, default: 1) — Hoeveel van de stem naar de reverb gaat, van 0 (geen) tot 1 (volledig). Geldt alleen wanneer `environment_id` is ingesteld; 0 schakelt de reverb uit. - `pan` (double, required, default: 0) — Stereopositie van de stem, van -1 (volledig links) via 0 (midden) tot 1 (volledig rechts). Alleen de stem wordt gepand; galm en achtergrondruis blijven in het midden. - `filter_preset_id` (string, optional) — ID van een filterpreset die de stem kleurt, zoals `phone` of `old_radio`. Geef geldige ID's weer met `GET /v1/audio-effects/catalog`. - `environment_id` (string, optional) — ID van een reverbomgeving die de stem in een ruimte plaatst, zoals `small_room` of `hall`. Geef geldige ID's weer met `GET /v1/audio-effects/catalog`. Reverb wordt in stereo gerenderd en voegt een galmstaart van maximaal enkele seconden toe nadat de spraak eindigt. - `background_noise_id` (string, optional) — ID van een achtergrondgeluidsbed dat onder de stem wordt geloopt, zoals `cafe` of `keyboard`. Geef geldige ID's weer met `GET /v1/audio-effects/catalog`. - `seed` (integer, optional, deprecated) — Heeft geen effect. ### FileInputConfig - `enabled` (boolean, optional, default: true) — Wanneer dit is ingeschakeld, kunnen gebruikers afbeeldingen, pdf's of tekstbestanden toevoegen in de chat wanneer de LLM multimodale invoer ondersteunt. - `max_files_in_memory` (integer, optional, default: 10) — Aantal meest recente bestanden dat tijdens een gesprek in het geheugen wordt bewaard. Oudere bestanden worden samengevat en hun bytes worden vrijgegeven. - `max_files_per_conversation` (integer, optional, default: 10) — Totaal aantal bestanden dat een gebruiker in één gesprek kan uploaden. Uploads worden per bestand gefactureerd. Gebruik -1 voor geen limiet, of een waarde >= max_files_in_memory. ### DtmfInputConfig Configuratie voor het verzamelen van DTMF-invoer (toetsenblok) tijdens telefoongesprekken. - `dtmf_input_timeout` (double, optional, default: 2) — Time-out in seconden om te wachten op aanvullende DTMF-cijfers - `hash_terminator` (boolean, optional, default: true) — Als true, voltooit het indrukken van # de DTMF-invoer direct - `redact_input` (boolean, optional, default: false) — Als true, vervang je de DTMF-invoer (toetsenbord) van de beller door een afschermingsmarkering in het transcript, het gesprekslogboek en de analyse. Cijfers die de agent herhaalt of aan een tool doorgeeft, worden niet beïnvloed. ### BackgroundSoundConfig - `source_type` ("preset", optional) — Het type bron voor achtergrondgeluid. - `source_id` (enum, optional) — ID voor de geluidsbron. - Allowed values: `office2`, `office1`, `restaurant`, `city`, `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `volume` (double, optional, default: 0.15) — Volumeniveau voor achtergrondgeluid (0.01 tot 1.0). - `crossfade_loop` (boolean, optional, default: true) — Pas een crossfade toe bij de loopgrens om hoorbare tikken te voorkomen wanneer het geluid wordt herhaald. ### ConversationConfigClientOverrideOutput - `asr` (AsrConversationalConfigOverride, optional) — Configuratie voor conversationele transcriptie - `turn` (TurnConfigOverride, optional) — Configuratie voor beurtdetectie - `tts` (TtsConversationalConfigOverride, optional) — Configuratie voor conversationele Text to Speech - `conversation` (ConversationConfigOverride, optional) — Configuratie voor gespreksgebeurtenissen - `agent` (AgentConfigOverrideOutput, optional) — Agentspecifieke configuratie ### LanguagePresetTranslation - `source_hash` (string, required) - `text` (string, required) ### BehaviorOverride - `verbosity` (enum, optional) — Overschrijving voor uitgebreidheid. De onderliggende standaardwaarde geldt wanneer deze niet is ingesteld. - Allowed values: `auto`, `concise`, `thorough` - `output_format` (enum, optional) — Overschrijving van het uitvoerformaat. Als deze niet is ingesteld, geldt de onderliggende standaardwaarde. - 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) — Overschrijving van het interactiebudget. Als dit niet is ingesteld, geldt de onderliggende standaardwaarde. - Allowed values: `realtime`, `5_minutes`, `10_minutes`, `1_hour` ### PromptAgentApiModelOutput - `prompt` (string, optional, default: ) — De prompt voor de agent - `llm` (enum, optional) — De LLM die met de prompt en de chatgeschiedenis moet worden bevraagd. Bij gebruik van dataresidency moet de LLM worden ondersteund in de dataresidencyomgeving. - 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`, `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) — Redeneerinspanning van het model. Alleen beschikbaar voor sommige modellen. - Allowed values: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max` - `thinking_budget` (integer, optional) — Maximumaantal tokens dat voor redeneren wordt gebruikt. Gebruik 0 om dit uit te schakelen als het model dit ondersteunt. - `enable_reasoning_summary` (boolean, optional, default: false) — Schakel samenvattingen van de modelredenering in. Als deze optie is uitgeschakeld, vragen we de provider waar mogelijk niet om samenvattingen voor een snellere TTFB. Niet compatibel met ZRM. - `temperature` (double, optional) — De temperatuur voor de LLM. Standaard is dit 0. Stel in op null om de parameter volledig uit het LLM-request weg te laten (handig voor aangepaste LLM's die het temperatuurveld afwijzen). - `max_tokens` (integer, optional, default: -1) — Als de waarde groter is dan 0, het maximale aantal tokens dat het LLM kan voorspellen - `tool_ids` (list of string, optional) — Een lijst met ID's van tools die door de agent worden gebruikt - `tool_ids_strict` (boolean, optional, default: false) — Alleen van toepassing als overschrijving voor een gesprek en toegestaan wanneer tool_ids mag worden overschreven. Wanneer true is, bevat de overschreven tool_ids de volledige lijst met tools die in het gesprek zijn toegestaan, inclusief tools op workflownodes. Genegeerd wanneer ingesteld op de agent. - `built_in_tools` (BuiltInToolsOutput, optional) — Ingebouwde systeemtools die de agent kan gebruiken - `enable_parallel_tool_calls` (boolean, optional, default: true) — Schakel parallel tool calling in. Wanneer dit is ingeschakeld, kan de agent meerdere tools parallel uitvoeren binnen één beurt. Niet door alle modellen ondersteund. - `mcp_server_ids` (list of string, optional) — Een lijst met MCP-server-id's die door de agent moeten worden gebruikt - `native_mcp_server_ids` (list of string, optional) — Een lijst met Native MCP-server-id's die door de agent moeten worden gebruikt - `knowledge_base` (list of KnowledgeBaseLocator, optional) — Een lijst met kennisbanken die door de agent moeten worden gebruikt - `custom_llm` (CustomLlm, optional) — Definitie voor een aangepaste LLM als het LLM-veld is ingesteld op 'CUSTOM_LLM' - `ignore_default_personality` (boolean, optional) — Of de standaard persoonlijkheidsregels uit de systeemprompt moeten worden verwijderd - `rag` (RagConfigOutput, optional) — Configuratie voor RAG - `timezone` (string, optional) — Tijdzone voor het weergeven van de huidige tijd in de systeemprompt. Indien ingesteld, wordt de huidige tijd met deze tijdzone opgenomen in de systeemprompt. Moet een geldige tijdzonenaam zijn (bijvoorbeeld 'America/New_York', 'Europe/London', 'UTC'). Aanbevolen voor nauwkeurige tijdsbewuste reacties; zonder deze instelling heeft de agent geen kennis van de huidige datum/tijd, tenzij je die via dynamische variabelen of tools opgeeft. Dit kan leiden tot onjuiste of gehallucineerde tijdsverwijzingen. - `backup_llm_config` (PromptAgentApiModelOutputBackupLlmConfig, optional) — Configuratie voor cascade van back-up-LLM's. Kan worden uitgeschakeld, systeemstandaarden gebruiken of een aangepaste volgorde opgeven. - `cascade_timeout_seconds` (double, optional, default: 4) — Tijd in seconden voordat wordt overgeschakeld naar de back-up-LLM. Moet tussen 2 en 15 seconden liggen. - `tools` (list of PromptAgentApiModelOutputToolsItem, optional, deprecated) — Een lijst met tools die de agent tijdens het gesprek kan gebruiken; gebruik in plaats daarvan tool_ids ### PromptEvaluationCriteria Een evaluatie met het transcript en een prompt voor een ja/nee-antwoord op de vraag of het doel is bereikt - `id` (string, required) — De unieke identificatiecode voor de evaluatiecriteria - `name` (string, required) - `conversation_goal_prompt` (string, required) — De prompt die de agent moet gebruiken om het gesprek te evalueren - `type` ("prompt", optional) — Het type evaluatiecriteria - `use_knowledge_base` (boolean, optional, default: false) — Of de kennisbank van de agent moet worden gebruikt bij het evalueren van de prompt. - `scope` (enum, optional, default: conversation) — Het bereik van de transcriptcontext die wordt gebruikt bij het beoordelen van dit criterium. 'conversation' gebruikt het volledige transcript; 'agent' gebruikt alleen het gedeelte waarin de bepalende agent actief was. - Allowed values: `conversation`, `agent` - `llm` (enum, optional) — LLM-model dat moet worden gebruikt voor dit evaluatiecriterium. Indien niet ingesteld, wordt de standaardwaarde analysis_llm van de agent gebruikt. - 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`, `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) — Hoe dit criterium wordt beoordeeld. 'binary' resulteert in geslaagd/mislukt/onbekend. 'numeric_uniform' retourneert een getal op de schaal [0, max_score], dat wordt genormaliseerd naar het totale succespercentage van het gesprek. - Allowed values: `binary`, `numeric_uniform` - `max_score` (integer, optional, default: 100) — Maximale waarde van de numerieke beoordelingsschaal (het minimum is altijd 0). Alleen gebruikt wanneer scoring_mode 'numeric_uniform' is. - `score_instructions` (string, optional) — Optionele vrije-tekstinstructies die beschrijven hoe waarden op de numerieke schaal moeten worden toegekend. Alleen gebruikt wanneer scoring_mode 'numeric_uniform' is. ### WidgetConfigAvatar De avatar van de widget - `type`: `orb` - `color_1` (string, optional, default: #2792dc) — De eerste kleur van de avatar - `color_2` (string, optional, default: #9ce6e6) — De tweede kleur van de avatar - `type`: `url` - `custom_url` (string, optional, default: ) — De aangepaste URL van de avatar - `type`: `image` - `url` (string, optional, default: ) — De URL van de avatar ### WidgetEndFeedbackConfig - `type` ("rating", optional) — Het type feedback dat aan het einde van het gesprek moet worden verzameld ### AllowlistItem - `hostname` (string, required) — De hostnaam van de toegestane oorsprong ### WidgetTextContents - `main_label` (string, optional) — Call-to-action die wordt weergegeven in de compacte en volledige varianten. - `start_call` (string, optional) — Tekst en ARIA-label voor de knop om een gesprek te starten. - `start_chat` (string, optional) — Tekst en ARIA-label voor de knop om een chat te starten (alleen tekst) - `new_call` (string, optional) — Tekst en ARIA-label voor de knop voor een nieuw gesprek. Wordt weergegeven wanneer de beller al ten minste één gesprek heeft afgerond om het volgende te starten. - `end_call` (string, optional) — Tekst en ARIA-label voor de knop om het gesprek te beëindigen. - `mute_microphone` (string, optional) — ARIA-label voor de knop om de microfoon te dempen. - `change_language` (string, optional) — ARIA-label voor de vervolgkeuzelijst om de taal te wijzigen. - `collapse` (string, optional) — ARIA-label voor de knop om in te klappen. - `expand` (string, optional) — ARIA-label voor de knop om uit te klappen. - `copied` (string, optional) — Tekst die wordt weergegeven wanneer de gebruiker een waarde kopieert met de kopieerknop. - `accept_terms` (string, optional) — Tekst en ARIA-label voor de knop om de voorwaarden te accepteren. - `dismiss_terms` (string, optional) — Tekst en ARIA-label voor de knop om de voorwaarden te annuleren. - `listening_status` (string, optional) — Status die wordt weergegeven wanneer de agent luistert. - `speaking_status` (string, optional) — Status die wordt weergegeven wanneer de agent spreekt. - `connecting_status` (string, optional) — Status die wordt weergegeven wanneer de agent verbinding maakt. - `chatting_status` (string, optional) — Status die wordt weergegeven wanneer de agent chat (alleen tekst) - `queue_waiting_status` (string, optional) — Status die wordt weergegeven tijdens het wachten in de wachtrij op een beschikbare agent. - `queue_waiting_status_short` (string, optional) — Korte status die wordt weergegeven tijdens het wachten op een beschikbare agent. - `input_label` (string, optional) — ARIA-label voor het invoerveld voor tekstberichten. - `input_placeholder` (string, optional) — Placeholdertekst voor de invoer van tekstberichten. - `input_placeholder_text_only` (string, optional) — Placeholdertekst voor de invoer van tekstberichten (alleen tekst) - `input_placeholder_new_conversation` (string, optional) — Placeholdertekst voor de invoer van tekstberichten bij het starten van een nieuw gesprek (alleen tekst) - `user_ended_conversation` (string, optional) — Informatiebericht dat wordt weergegeven wanneer de gebruiker het gesprek beëindigt. - `agent_ended_conversation` (string, optional) — Informatiebericht dat wordt weergegeven wanneer de agent het gesprek beëindigt. - `conversation_id` (string, optional) — Tekstlabel dat naast de gespreks-ID wordt gebruikt. - `error_occurred` (string, optional) — Tekstlabel dat wordt gebruikt wanneer er een fout optreedt. - `queue_timed_out` (string, optional) — Foutmelding die wordt weergegeven wanneer de wachttijd in de wachtrij verloopt. - `copy_id` (string, optional) — Tekst en ARIA-label voor de knop om de ID te kopiëren. - `initiate_feedback` (string, optional) — Tekst die wordt weergegeven om de gebruiker om feedback te vragen. - `request_follow_up_feedback` (string, optional) — Tekst die wordt weergegeven om aanvullende feedbackdetails te vragen. - `thanks_for_feedback` (string, optional) — Tekst die wordt weergegeven om de gebruiker te bedanken voor de feedback. - `thanks_for_feedback_details` (string, optional) — Aanvullende weergegeven tekst die de waarde van gebruikersfeedback uitlegt. - `follow_up_feedback_placeholder` (string, optional) — Placeholdertekst voor het invoerveld voor vervolgfeedback. - `submit` (string, optional) — Tekst en ARIA-label voor de verzendknop. - `go_back` (string, optional) — Tekst en ARIA-label voor de terugknop. - `send_message` (string, optional) — Tekst en ARIA-label voor de knop om een bericht te versturen. - `text_mode` (string, optional) — Tekst en ARIA-label voor de knop om naar tekstmodus te schakelen. - `voice_mode` (string, optional) — Tekst en ARIA-label voor de knop om naar stemmodus te schakelen. - `switched_to_text_mode` (string, optional) — Toastmelding die wordt weergegeven bij het overschakelen naar tekstmodus. - `switched_to_voice_mode` (string, optional) — Toastmelding die wordt weergegeven bij het overschakelen naar stemmodus. - `copy` (string, optional) — Tekst en ARIA-label voor de kopieerknop. - `download` (string, optional) — Tekst en ARIA-label voor de downloadknop. - `wrap` (string, optional) — Tekst en ARIA-label voor de knop om tekstterugloop in of uit te schakelen. - `agent_working` (string, optional) — Statustekst die wordt weergegeven wanneer de agent een toolaanroep verwerkt. - `agent_done` (string, optional) — Statustekst die wordt weergegeven wanneer de agent klaar is met het verwerken van een toolaanroep. - `agent_error` (string, optional) — Statustekst die wordt weergegeven wanneer de agent tijdens een toolaanroep een fout tegenkomt. - `attach_file` (string, optional) — Tekst en ARIA-label voor de knop om een bestand bij te voegen. - `remove_file` (string, optional) — ARIA-label voor de knop om het bestand te verwijderen. - `file_upload_error` (string, optional) — Foutmelding die wordt weergegeven wanneer het uploaden van een bestand mislukt. - `file_type_unsupported` (string, optional) — Foutmelding die wordt weergegeven wanneer een niet-ondersteund bestandstype is geselecteerd. Gevolgd door de lijst met geaccepteerde typen. - `file_too_large` (string, optional) — Foutmelding die wordt weergegeven wanneer een bestand de maximale grootte overschrijdt. - `file_limit_reached` (string, optional) — Foutmelding die wordt weergegeven wanneer het maximumaantal bestanden voor een gesprek is bereikt. - `typing_indicator` (string, optional) — Statustekst die wordt weergegeven terwijl de agent typt. - `rich_content_unavailable` (string, optional) — Fallbackbericht dat wordt weergegeven wanneer rich content niet kan worden gerenderd. ### WidgetStyles - `base` (string, optional) — De basiskleur van de achtergrond. - `base_hover` (string, optional) — De kleur van de basisachtergrond bij aanwijzen. - `base_active` (string, optional) — De kleur van de basisachtergrond wanneer deze actief is (aangeklikt). - `base_border` (string, optional) — De kleur van de rand tegen de basisachtergrond. - `base_subtle` (string, optional) — De kleur van subtiele tekst tegen de basisachtergrond. - `base_primary` (string, optional) — De kleur van primaire tekst tegen de basisachtergrond. - `base_error` (string, optional) — De kleur van fouttekst tegen de basisachtergrond. - `accent` (string, optional) — De achtergrondkleur van het accent. - `accent_hover` (string, optional) — De kleur van de accentachtergrond bij aanwijzen. - `accent_active` (string, optional) — De kleur van de accentachtergrond wanneer deze actief is (aangeklikt). - `accent_border` (string, optional) — De kleur van de rand tegen de accentachtergrond. - `accent_subtle` (string, optional) — De kleur van subtiele tekst tegen de accentachtergrond. - `accent_primary` (string, optional) — De kleur van primaire tekst tegen de accentachtergrond. - `overlay_padding` (double, optional) — De padding rond de randen van de viewport. - `button_radius` (double, optional) — De afrondingsstraal van de knoppen. - `input_radius` (double, optional) — De afrondingsstraal van de invoervelden. - `bubble_radius` (double, optional) — De afrondingsstraal van de chatbubbels. - `sheet_radius` (double, optional) — De standaardhoekafronding van sheets. - `compact_sheet_radius` (double, optional) — De afrondingsstraal van het paneel in compacte modus. - `dropdown_sheet_radius` (double, optional) — De afrondingsstraal van het dropdownpaneel. ### WidgetLanguagePreset - `text_contents` (WidgetTextContents, optional) — De tekstinhoud voor de geselecteerde taal - `text_contents_translation` (WidgetTextContentsTranslation, optional) — De vertaalcache voor de tekstinhoud - `terms_text` (string, optional) — De tekst die voor de algemene voorwaarden in deze taal wordt weergegeven - `terms_html` (string, optional) — De HTML die wordt weergegeven voor de algemene voorwaarden in deze taal - `terms_key` (string, optional) — De weer te geven sleutel voor de algemene voorwaarden in deze taal - `terms_translation` (WidgetTermsTranslation, optional) — De vertaalcache voor de termen ### AllowedValues - `dynamic_variable` (string, required) — Naam van een dynamische variabele die moet worden opgelost naar een JSON-array met toegestane waarden, bijv. ["ws_alpha", "ws_beta"]. Systeemvariabelen werken alleen als ze worden opgelost naar een lijst. ### AnalysisPropertyConstantValue Een constante waarde voor deze eigenschap. Kan niet samen worden gebruikt met description, dynamic_variable, is_system_provided en is_omitted. ### AgentAnalysisItemsInputEvaluationCriteriaItem - `source`: `system` - `analysis_item_id` (enum, required) — ID van de waarnaar verwezen ingebouwde systeemevaluatie. - Allowed values: `__system_eval_criteria_sentiment`, `__system_eval_criteria_frustration` - `scope` (enum, optional, default: conversation) — Transcriptcontext ('conversation' of 'agent') die wordt gebruikt bij het uitvoeren van dit item. - Allowed values: `conversation`, `agent` - `weight` (double, optional) — Optioneel relatief gewicht voor geaggregeerde scoreberekening. - `source`: `user` - `analysis_item_id` (string, required) — ID van het waarnaar verwezen gebruikersevaluatie-item. - `additional_version_ids` (list of string, optional) — Extra itemversies die ook worden uitgevoerd ter vergelijking (A/B). Deze worden uitgevoerd en opgeslagen, maar uitgesloten van de score; de primaire version_id wordt gescoord. - `scope` (enum, optional, default: conversation) — Transcriptcontext ('conversation' of 'agent') die wordt gebruikt bij het uitvoeren van dit item. - Allowed values: `conversation`, `agent` - `version_id` (string, optional) — Primaire itemversie waarvan het resultaat wordt gebruikt voor scoring. None volgt de nieuwste gepubliceerde versie van het item. - `weight` (double, optional) — Optioneel relatief gewicht voor geaggregeerde scoreberekening. ### AgentAnalysisItemsInputDataCollectionItem - `source`: `system` - `analysis_item_id` ("__system_data_collection_topic", required) — ID van het waarnaar verwezen ingebouwde systeemgegevenverzamelingsitem. - `scope` (enum, optional, default: conversation) — Transcriptcontext ('conversation' of 'agent') die wordt gebruikt bij het uitvoeren van dit item. - Allowed values: `conversation`, `agent` - `source`: `user` - `analysis_item_id` (string, required) — ID van het waarnaar verwezen gebruikersgegevenverzamelingsitem. - `scope` (enum, optional, default: conversation) — Transcriptcontext ('conversation' of 'agent') die wordt gebruikt bij het uitvoeren van dit item. - Allowed values: `conversation`, `agent` - `version_id` (string, optional) — Vastgezette itemversie. None volgt de nieuwste gepubliceerde versie van het item. ### ConversationConfigClientOverrideConfigInput - `asr` (AsrConversationalConfigOverrideConfig, optional) — Configureert overschrijvingen voor geneste velden. - `turn` (TurnConfigOverrideConfig, optional) — Configureert overschrijvingen voor geneste velden. - `tts` (TtsConversationalConfigOverrideConfig, optional) — Configureert overschrijvingen voor geneste velden. - `conversation` (ConversationConfigOverrideConfig, optional) — Configureert overschrijvingen voor geneste velden. - `agent` (AgentConfigOverrideConfig, optional) — Configureert overschrijvingen voor geneste velden. ### ConversationInitiationClientDataWebhook - `url` (string, required) — De URL waarnaar de webhook moet worden verzonden - `request_headers` (map from string to ConversationInitiationClientDataWebhookRequestHeadersValue, required) — De headers die met de webhookrequest moeten worden verzonden ### ConvAiWebhooks - `post_call_webhook_id` (string, optional) - `events` (list of enum, optional) — Lijst met gebeurtenistypen die via webhook moeten worden verzonden. Opties: 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) — Indeling voor transcriptwebhooks. - Allowed values: `json`, `opentelemetry` - `exclude_transcript` (boolean, optional, default: false) — Wanneer true, bevatten JSON-webhooks voor transcriptie na gesprekken niet het transcript per beurt. Analyse, metadata en andere gespreksvelden worden wel verzonden. Genegeerd voor de OpenTelemetry-transcriptindeling. - `send_audio` (boolean, optional, deprecated) — VEROUDERD: gebruik in plaats daarvan het veld 'events'. Of audiogegevens met webhooks na het gesprek voor ConvAI-conversaties moeten worden verzonden ### AttachedTestModel - `test_id` (string, required) - `workflow_node_id` (string, optional) ### FocusGuardrail - `is_enabled` (boolean, optional, default: false) ### PromptInjectionGuardrail - `is_enabled` (boolean, optional, default: false) ### ContentGuardrailInput - `execution_mode` (enum, optional, default: streaming) - Allowed values: `streaming`, `blocking` - `config` (ContentConfig, optional) - `trigger_action` (ContentGuardrailInputTriggerAction, optional) ### CustomGuardrailInput Container voor aangepaste guardrails, volgens het ModerationGuardrail-patroon - `config` (CustomGuardrailsConfigInput, optional) — Configuratiecontainer voor de lijst met aangepaste guardrails ### AgentHoldAudioConfig Aangepaste wachtmuziek die in een lus wordt afgespeeld voor bellers die in de wachtrij van de agent wachten. Stel dit in door een bestand te uploaden via het endpoint voor wachtmuziek van de agent. Waarden die worden verzonden in requests voor het maken of bijwerken van een agent worden genegeerd. - `audio_path` (string, required) — Opslagpad van de geüploade clip - `audio_url` (string, required) — Openbare CDN-URL van de geüploade clip - `original_filename` (string, required) — Bestandsnaam van de geüploade clip zoals opgegeven door de gebruiker - `duration_secs` (double, required) — Duur van de geüploade clip in seconden - `size_bytes` (integer, required) — Grootte van de geüploade clip in bytes ### ConversationHistoryRedactionConfig - `enabled` (boolean, optional, default: false) — Of anonimisering van de gespreksgeschiedenis is ingeschakeld - `entities` (list of enum, optional) — De entiteiten die uit het gesprekstranscript, de audio en de analyse moeten worden verwijderd. Gebruik typen op hoofdniveau zoals 'name', 'email_address' of puntnotatie voor specifieke subtypen zoals '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) — ID's van gegevensverzamelingsitems waarvan de geëxtraheerde waarden niet zijn geredigeerd. De onderbouwingen worden nog steeds geredigeerd. ### AlertingMonitorConfig - `enabled` (boolean, optional) — Of deze monitor is ingeschakeld en meldingen kan versturen - `threshold` (double, optional) — Drempelwaarde voor het foutenpercentage waarop deze monitor een melding kan sturen. - `relative_increase_threshold` (double, optional) — Relatieve toename ten opzichte van de voortschrijdende basislijn waarbij deze monitor een melding kan geven (0.2 = 20% boven de basislijn, 0 = elke mislukking). Voor conversation_volume_drop is dit het aandeel van het gebruikelijke volume dat moet ontbreken, tussen 0.1 en 0.9 (0.5 = de helft). - `min_failure_count` (integer, optional) — Minimaal aantal fouten in het venster voordat deze monitor kan worden geactiveerd. - `min_history_bucket_count` (integer, optional) — Minimaal aantal voorgaande buckets met verkeer voordat piekdetectie kan worden geactiveerd. - `min_sample_count` (integer, optional) — Minimaal aantal samples in het venster voordat deze monitor kan worden geactiveerd. - `suspect_trigger_threshold` (integer, optional) — Hoeveel verdachte buckets binnen het terugkijkvenster vereist zijn om een verdachte status te promoveren tot waarschuwing. - `auto_resolve_after_inactive_minutes` (integer, optional) — Hoeveel minuten een melding inactief kan blijven voordat deze automatisch wordt opgelost. ### AlertingSettingsNotifiersItem - `type`: `webhook` - `webhook_id` (string, required) — ID van de workspace-webhook waarnaar meldingen over de levenscyclus van waarschuwingen moeten worden verstuurd. - `type`: `integration` - `connection_id` (string, required) — ID van de workspace-integratieverbinding waarnaar meldingen over de levenscyclus van waarschuwingen moeten worden verstuurd. De integratie van de verbinding moet de monitoringmogelijkheid hebben en overeenkomen met ``integration_type``. - `channel_id` (string, optional) — ID van het Slack-kanaal waarnaar waarschuwingsmeldingen moeten worden verstuurd, bijv. ``C0123456789``. Vereist wanneer ``integration_type`` ``slack`` is. De Slack-app moet lid zijn van het kanaal en het bereik ``chat:write`` hebben, of ``chat:write.public`` voor openbare kanalen waaraan deze niet is toegevoegd. - `integration_type` (enum, optional) — Integratie waarnaar moet worden verzonden. De server behandelt een weggelaten waarde als ``pagerduty``. - Allowed values: `pagerduty`, `slack` ### WorkflowEdgeModelInputForwardCondition - `type`: `expression` - `expression` (AstNodeInput, required) — Te evalueren expressie. - `label` (string, optional) — Optioneel leesbaar label voor de voorwaarde, dat in de hele UI wordt gebruikt. - `type`: `llm` - `condition` (string, required) — Te evalueren voorwaarde - `label` (string, optional) — Optioneel leesbaar label voor de voorwaarde, dat in de hele UI wordt gebruikt. - `type`: `result` - `successful` (boolean, required) — Of alle tools in de eerder uitgevoerde toolnode zijn uitgevoerd. - `label` (string, optional) — Optioneel leesbaar label voor de voorwaarde, dat in de hele UI wordt gebruikt. - `type`: `unconditional` - `label` (string, optional) — Optioneel leesbaar label voor de voorwaarde, dat in de hele UI wordt gebruikt. ### WorkflowEdgeModelInputBackwardCondition - `type`: `expression` - `expression` (AstNodeInput, required) — Te evalueren expressie. - `label` (string, optional) — Optioneel leesbaar label voor de voorwaarde, dat in de hele UI wordt gebruikt. - `type`: `llm` - `condition` (string, required) — Te evalueren voorwaarde - `label` (string, optional) — Optioneel leesbaar label voor de voorwaarde, dat in de hele UI wordt gebruikt. - `type`: `result` - `successful` (boolean, required) — Of alle tools in de eerder uitgevoerde toolnode zijn uitgevoerd. - `label` (string, optional) — Optioneel leesbaar label voor de voorwaarde, dat in de hele UI wordt gebruikt. - `type`: `unconditional` - `label` (string, optional) — Optioneel leesbaar label voor de voorwaarde, dat in de hele UI wordt gebruikt. ### PositionInput - `x` (double, optional, default: 0) - `y` (double, optional, default: 0) ### KnowledgeBaseLocator - `type` (enum, required) — Het type kennisbank - Allowed values: `file`, `url`, `text`, `folder` - `name` (string, required) — De naam van de kennisbank - `id` (string, required) — De ID van de kennisbank - `usage_mode` (enum, optional, default: auto) — De gebruiksmodus van de kennisbank - Allowed values: `prompt`, `auto` ### ConversationalConfigApiModelWorkflowOverrideInput - `asr` (AsrConversationalConfigWorkflowOverride, optional) — Configuratie voor conversationele transcriptie - `turn` (TurnConfigWorkflowOverride, optional) — Configuratie voor beurtdetectie - `tts` (TtsConversationalConfigWorkflowOverrideInput, optional) — Configuratie voor conversationele Text to Speech - `conversation` (ConversationConfigWorkflowOverrideInput, optional) — Configuratie voor gespreksgebeurtenissen - `language_presets` (map from string to LanguagePresetInput, optional) — Taalvoorinstellingen voor gesprekken - `vad` (VadConfigWorkflowOverride, optional) — Configuratie voor stemactiviteitsdetectie - `agent` (AgentConfigApiModelWorkflowOverrideInput, optional) — Agentspecifieke configuratie ### WorkflowPhoneNumberNodeModelInputTransferDestination - `type`: `phone` - `phone_number` (string, required) - `type`: `phone_dynamic_variable` - `phone_number` (string, required) - `type`: `sip_uri` - `sip_uri` (string, required) - `type`: `sip_uri_dynamic_variable` - `sip_uri` (string, required) ### WorkflowPhoneNumberNodeModelInputCustomSipHeadersItem - `type`: `dynamic` - `key` (string, required) — De naam van de SIP-header (bijvoorbeeld 'X-Customer-ID') - `value` (string, required) — De naam van de dynamische variabele die moet worden opgelost - `type`: `static` - `key` (string, required) — De naam van de SIP-header (bijvoorbeeld 'X-Customer-ID') - `value` (string, required) — De headerwaarde ### WorkflowPhoneNumberNodeModelInputPostDialDigits - `type`: `dynamic` - `value` (string, required) — De naam van de dynamische variabele die moet worden opgelost - `type`: `static` - `value` (string, required) — DTMF-cijfers die moeten worden verzonden nadat de oproep is verbonden (bijvoorbeeld 'ww1234' voor een doorkiesnummer) ### UuiTransferConfig User-to-User Information-envelop voor SIP REFER-transfers (RFC 7433). Uitgaande payloads zijn hex-gecodeerd (de enige codering die RFC 7433 definieert). Met de protocol-discriminatoras kunnen formaten per platform (Talkdesk, Genesys, ...) via configuratie worden uitgedrukt in plaats van via verspreide transferflags. Verdere assen (ASCII-codering, headernaam, doel-/inhoudsparameters) kunnen hier worden toegevoegd zonder het transfermodel aan te passen. - `data` (string, required) — UUI-payload om te versturen bij SIP REFER-transfers. Ondersteunt inline dynamische variabelen en wordt tijdens de transfer hex-gecodeerd. - `protocol_discriminator` (string, optional) — Optionele protocolonderscheider van één octet (twee hexadecimale cijfers, bijv. '00'). Vereist door platforms zoals Genesys Cloud, die anders het eerste octet van de payload verwijderen. Laat niet ingesteld voor platforms zoals Talkdesk die een kale hexadecimale payload verwachten. - `protocol_discriminator_mode` (enum, optional, default: prefix) — Hoe protocol\_discriminator moet worden toegevoegd. 'prefix' plaatst het octet vóór de hex-payload (User-to-User=XX\;encoding=hex). 'pd\_parameter' verstuurt het als afzonderlijke parameter (User-to-User=\;pd=XX;encoding=hex). Wordt genegeerd wanneer protocol\_discriminator niet is ingesteld. - Allowed values: `prefix`, `pd_parameter` ### WorkflowToolLocator - `tool_id` (string, required) - `schema_overrides` (map from string to WorkflowToolLocatorSchemaOverridesValue, optional) — Parameteroverschrijvingen per node, toegepast boven op de eigen configuratie van de tool. Sleutels zijn parameterpaden met punten (webhooktools laten sleutels voorafgaan door path_params./query_params./request_body.). Deze hebben voorrang op overschrijvingen die al in de tool zelf zijn gedefinieerd. ### WorkflowSayNodeModelInputMessage Bericht dat door deze node wordt uitgesproken. Gebruik `literal` voor exacte tekst of `prompt` om de LLM het bericht op basis van een beschrijving te laten genereren. - `type`: `literal` - `text` (string, required) — Exacte tekst die door de agent wordt uitgesproken. Ondersteunt placeholders voor dynamische variabelen: `{{variable_name}}`. - `text_translations` (map from string to TranslatedString, optional) — Vertalingen van `text`, ingedeeld op taalcode. Wanneer de gesprekstaal een invoer heeft, wordt de waarde daarvan uitgesproken in plaats van `text`. - `type`: `prompt` - `prompt` (string, required) — Beschrijving van het bericht dat de LLM moet genereren. Dit wordt toegevoegd aan de systeemprompt van de agent zolang dit knooppunt actief is. ### WorkflowStateUpdateInput - `variable_name` (string, required) — Naam van de dynamische variabele die moet worden toegewezen. - `expression` (AstNodeInput, required) — Expressie waarvan het resultaat aan de variabele wordt toegewezen. Deze kan constanten, andere dynamische variabelen, door een LLM geëxtraheerde waarden en operators combineren. - `type` ("dynamic_variable", optional) - `required` (boolean, optional, default: true) — Wanneer false, kan de LLM de waarden weglaten waarop deze update is gebaseerd. De update wordt dan overgeslagen en de variabele behoudt de huidige waarde. ### UnitTestToolCallParameter - `eval` (UnitTestToolCallParameterEval, required) - `path` (string, required) ### ReferencedToolCommonModel Verwijzing naar een tool voor unit-testevaluatie. - `id` (string, required) — De ID van de tool - `type` (enum, required) — Het type tool - Allowed values: `system`, `webhook`, `client`, `workflow`, `api_integration_webhook`, `mcp`, `code` ### UnitTestWorkflowNodeTransitionEvaluationNodeId - `agent_id` (string, required) — De ID van de agent waarvan de workflow het doelknooppunt bevat. - `target_node_id` (string, required) — De ID van het workflownode waarnaar de agent moet overgaan. - `type` ("node_id", optional) ### ConversationHistoryMultivoiceMessagePartModel Vertegenwoordigt één stemonderdeel van een bericht met meerdere stemmen. - `text` (string, required) - `voice_label` (string, optional) - `time_in_call_secs` (integer, optional) ### ConversationHistoryTranscriptToolCallCommonModelOutputToolDetails - `type`: `api_integration_webhook` - `credential_id` (string, required, default: ) - `integration_connection_id` (string, required, default: ) - `integration_id` (string, required, default: ) - `webhook_details` (ConversationHistoryTranscriptToolCallWebhookDetails, required) - `type`: `client` - `parameters` (string, required) - `type`: `mcp` - `approval_policy` (string, required) - `integration_type` (string, required) - `mcp_server_id` (string, required) - `mcp_server_name` (string, required) - `mcp_tool_description` (string, optional, default: ) - `mcp_tool_name` (string, optional, default: ) - `parameters` (map from string to string, optional) - `requires_approval` (boolean, optional, default: false) - `type`: `webhook` - `method` (string, required) - `url` (string, required) - `body` (string, optional) - `headers` (map from string to string, optional) - `path_params` (map from string to string, optional) - `query_params` (map from string to string, optional) ### ConversationHistoryTranscriptOtherToolsResultCommonModel - `request_id` (string, required) - `tool_name` (string, required) - `result_value` (string, required) - `is_error` (boolean, required) - `tool_has_been_called` (boolean, required) - `is_blocked` (boolean, optional, default: false) - `tool_latency_secs` (double, optional, default: 0) - `error_type` (string, optional, default: ) - `raw_error_message` (string, optional, default: ) - `dynamic_variable_updates` (list of DynamicVariableUpdateCommonModel, optional) - `type` (enum, optional) - Allowed values: `client`, `webhook`, `mcp`, `code` ### ConversationHistoryTranscriptSystemToolResultCommonModelOutput - `request_id` (string, required) - `tool_name` (string, required) - `result_value` (string, required) - `is_error` (boolean, required) - `tool_has_been_called` (boolean, required) - `type` ("system", required) - `is_blocked` (boolean, optional, default: false) - `tool_latency_secs` (double, optional, default: 0) - `error_type` (string, optional, default: ) - `raw_error_message` (string, optional, default: ) - `dynamic_variable_updates` (list of DynamicVariableUpdateCommonModel, optional) - `result` (ConversationHistoryTranscriptSystemToolResultCommonModelOutputResult, optional) ### ConversationHistoryTranscriptApiIntegrationWebhookToolsResultCommonModelOutput - `request_id` (string, required) - `tool_name` (string, required) - `result_value` (string, required) - `is_error` (boolean, required) - `is_blocked` (boolean, required, default: false) - `tool_has_been_called` (boolean, required) - `tool_latency_secs` (double, required, default: 0) - `error_type` (string, required, default: ) - `raw_error_message` (string, required, default: ) - `dynamic_variable_updates` (list of DynamicVariableUpdateCommonModel, required) - `type` ("api_integration_webhook", required) - `integration_id` (string, required, default: ) - `credential_id` (string, required, default: ) - `integration_connection_id` (string, required, default: ) ### ConversationHistoryTranscriptWorkflowToolsResultCommonModelOutput - `request_id` (string, required) - `tool_name` (string, required) - `result_value` (string, required) - `is_error` (boolean, required) - `tool_has_been_called` (boolean, required) - `type` ("workflow", required) - `is_blocked` (boolean, optional, default: false) - `tool_latency_secs` (double, optional, default: 0) - `error_type` (string, optional, default: ) - `raw_error_message` (string, optional, default: ) - `dynamic_variable_updates` (list of DynamicVariableUpdateCommonModel, optional) - `result` (WorkflowToolResponseModelOutput, optional) — Een algemeen model voor responses van workflowtools. ### MetricRecord - `elapsed_time` (double, required) ### RagChunkMetadata - `document_id` (string, required) - `chunk_id` (string, required) - `vector_distance` (double, required) ### LlmInputOutputTokensUsage - `input` (LlmTokensCategoryUsage, optional) - `input_cache_read` (LlmTokensCategoryUsage, optional) - `input_cache_write` (LlmTokensCategoryUsage, optional) - `output_total` (LlmTokensCategoryUsage, optional) ### PlatformCategoryUsage Opgebouwde kosten voor één :class:`PlatformCategory`. - `credits` (integer, optional, default: 0) - `price` (double, optional, default: 0) - `quantity` (double, optional, default: 0) ### ConversationVoiceUsageModel - `voice_id` (string, required) - `audio_output_seconds` (double, optional, default: 0) ### AnalysisRunningTotal Cumulatieve LLM-kosten voor het uitvoeren van analyse na het gesprek voor deze conversatie. - `price` (double, optional, default: 0) - `charge` (integer, optional, default: 0) - `runs` (integer, optional, default: 0) - `price_per_feature` (map from string to double, optional) - `charge_per_feature` (map from string to integer, optional) ### AnalysisRunSnapshot LLM-kosten van de meest recente analyse na het gesprek voor deze conversatie. - `price` (double, optional, default: 0) - `charge` (integer, optional, default: 0) - `price_per_feature` (map from string to double, optional) - `charge_per_feature` (map from string to integer, optional) ### AsrConversationalConfigOverride - `keywords` (list of string, optional) — Trefwoorden waarvoor de voorspellingskans moet worden verhoogd ### TurnConfigOverride - `soft_timeout_config` (SoftTimeoutConfigOverride, optional) — Configuratie voor soft-time-outfunctionaliteit. Geeft direct feedback tijdens langere LLM-responses. ### TtsConversationalConfigOverride - `model_id` (enum, optional, default: eleven_v4_turbo) — Het model dat voor TTS moet worden gebruikt - 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) — De stem-ID die voor TTS moet worden gebruikt - `supported_voices` (list of SupportedVoice, optional) — Aanvullende ondersteunde stemmen voor de agent - `stability` (double, optional) — De stabiliteit van gegenereerde spraak - `speed` (double, optional) — De snelheid van gegenereerde spraak - `similarity_boost` (double, optional) — De similariteitsboost voor gegenereerde spraak - `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional) — De locators voor het uitspraakwoordenboek ### ConversationConfigOverride - `text_only` (boolean, optional) — Als dit is ingeschakeld, wordt audio niet verwerkt en wordt alleen tekst gebruikt. Gebruik dit om audiokosten te vermijden. - `max_duration_seconds` (integer, optional) — De maximale duur van een conversatie in seconden ### AgentConfigOverrideOutput - `first_message` (string, optional) — Als dit niet leeg is, het eerste bericht dat de agent uitspreekt. Als het leeg is, wacht de agent tot de gebruiker het gesprek start. - `language` (string, optional) — Taal van de agent - gebruikt voor ASR en TTS - `max_conversation_duration_message` (string, optional) — Als dit niet leeg is, het bericht dat de agent verstuurt wanneer de maximale gespreksduur is bereikt. - `prompt` (PromptAgentApiModelOverrideOutput, optional) — De prompt voor de agent ### BuiltInToolsOutput Systeemtools die aan een gespreksagent kunnen worden gegeven. Bewust niet ConversationalBuiltInTools genoemd: BuiltInToolsInput en BuiltInToolsOutput maken deel uit van de openbare API-specificatie en de gegenereerde SDK's. - `transfer_to_agent` (SystemToolConfigOutput, optional) — De tool voor doorverbinden met een agent - `end_call` (SystemToolConfigOutput, optional) — De tool voor het beëindigen van het gesprek - `language_detection` (SystemToolConfigOutput, optional) — De taalherkenningstool - `transfer_to_number` (SystemToolConfigOutput, optional) — De tool voor doorverbinden met een nummer - `skip_turn` (SystemToolConfigOutput, optional) — De tool om een beurt over te slaan - `play_keypad_touch_tone` (SystemToolConfigOutput, optional) — De play DTMF-tool - `voicemail_detection` (SystemToolConfigOutput, optional) — De tool voor voicemaildetectie ### CustomLlm - `url` (string, required) — De URL van het endpoint dat compatibel is met Chat Completions - `model_id` (string, optional) — De model-ID die moet worden gebruikt als de URL meerdere modellen aanbiedt - `api_key` (CustomLlmApiKey, optional) — De API-sleutel voor authenticatie. Ofwel een verwijzing naar een workspacegeheim \{'secret\_id': '...'} of een verwijzing naar een omgevingsvariabele \{'env\_var\_label': '...'}. - `auth_connection` (CustomLlmAuthConnection, optional) — Optionele workspace-authverbinding voor authenticatie. Alleen authverbindingen die een Authorization Bearer-token produceren, worden ondersteund; Basic-auth, mTLS, aangepaste headers en authverbindingen met een URL-secret worden niet ondersteund. - `request_headers` (map from string to CustomLlmRequestHeadersValue, optional) — Headers die in de aanvraag moeten worden opgenomen - `api_version` (string, optional) — De API-versie die je voor de request wilt gebruiken - `api_type` (enum, optional, default: chat_completions) — Het te gebruiken API-type (chat_completions, responses of websocket) - Allowed values: `chat_completions`, `responses`, `websocket` ### RagConfigOutput - `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 vectorafstand van opgehaalde chunks. - `max_documents_length` (integer, optional, default: 50000) — Maximale totale lengte van documentchunks die uit RAG worden opgehaald. - `max_retrieved_rag_chunks_count` (integer, optional, default: 20) — Maximumaantal RAG-documentchunks dat aanvankelijk uit de vectorstore moet worden opgehaald. Deze worden vervolgens verder gefilterd op vectorafstand en totale lengte. - `num_candidates` (integer, optional) — Aantal kandidaten dat wordt geëvalueerd bij ANN-vectorzoeken. Een hoger aantal betekent betere resultaten, maar ook hogere latentie. De minimaal aanbevolen waarde is 100. Als dit is uitgeschakeld, wordt de standaardwaarde gebruikt. - `query_rewrite_prompt_override` (string, optional) — Aangepaste prompt om gebruikersquery's te herschrijven vóór RAG-ophaling. De conversatiegeschiedenis wordt automatisch aan het einde toegevoegd. Als dit niet is ingesteld, wordt de standaardprompt gebruikt. - `knowledge_base_tool_info` (KnowledgeBaseToolInfo, optional) — Wanneer ingesteld, gebruikt de agent de tool knowledge_base in plaats van de verouderde tool knowledge_base_rag. None betekent dat de agent niet is aangemeld. ### PromptAgentApiModelOutputBackupLlmConfig Configuratie voor cascade van back-up-LLM's. Kan worden uitgeschakeld, systeemstandaarden gebruiken of een aangepaste volgorde opgeven. - `preference`: `default` - `preference`: `disabled` - `preference`: `override` - `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`, `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` ### PromptAgentApiModelOutputToolsItem Het type tool - `type`: `api_integration_webhook` - `api_integration_connection_id` (string, required) - `api_integration_id` (string, required) - `assignments` (list of DynamicVariableAssignment, required) — Configuratie voor het extraheren van waarden uit toolresponses en deze toewijzen aan dynamische variabelen - `description` (string, required) — Beschrijving van wanneer de tool moet worden gebruikt en wat deze doet. - `dynamic_variables` (DynamicVariablesConfig, required) — Configuratie voor dynamische variabelen - `execution_mode` (enum, required, default: immediate) — Bepaalt wanneer en hoe de tool wordt uitgevoerd: 'immediate' voert de tool direct uit wanneer de LLM hierom vraagt, 'post_tool_speech' wacht tot de agent is uitgesproken voordat de tool wordt uitgevoerd en 'async' voert de tool op de achtergrond uit zonder te blokkeren - het beste voor langlopende bewerkingen. - Allowed values: `immediate`, `post_tool_speech`, `async` - `interruption_mode` (enum, required, default: allow) — Bepaalt of de gebruiker de agent tijdens deze toolaanroep kan onderbreken. 'allow' (standaard) staat de gebruiker toe om op elk moment te onderbreken, 'disable_during_tool' onderdrukt onderbrekingen alleen terwijl de tool actief is en 'disable_during_tool_and_turn' onderdrukt onderbrekingen terwijl de tool actief is en tijdens de daaropvolgende reactie van de agent. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `name` (string, required) - `pre_tool_speech` (enum, required, default: auto) — Bepaalt of de agent spreekt voordat deze tool wordt aangeroepen. 'auto' (standaard) beslist op basis van recente toollatency, 'force' laat de agent altijd spreken en 'off' schakelt dit volledig uit, ongeacht de latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, required, default: 20) — De maximale wachttijd in seconden tot de toolcall is voltooid. Moet tussen 5 en 300 seconden liggen (inclusief). - `tool_call_sound_behavior` (enum, required, default: auto) — Bepaalt wanneer het geluid voor de toolaanroep moet worden afgespeeld. 'auto' speelt alleen af als er spraak vóór de tool is, 'always' speelt af bij elke toolaanroep. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, required, default: auto) — Bepaalt hoe toolfouten worden verwerkt voordat ze met de agent worden gedeeld. 'auto' bepaalt de afhandeling op basis van het tooltype (samengevat voor native integraties, verbergen voor andere), 'summarized' stuurt een door een LLM gegenereerde samenvatting, 'passthrough' stuurt de onbewerkte fout en 'hide' deelt de fout niet met de agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `tool_version` (string, required, default: 1.0.0) — De versie van de API-integratietool - `disable_interruptions` (boolean, required, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `interruption_mode`. Als dit true is, kan de gebruiker de agent niet onderbreken terwijl deze tool wordt uitgevoerd. - `force_pre_tool_speech` (boolean, required, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `pre_tool_speech`. Als dit waar is, spreekt de agent vóór de toolaanroep. - `api_schema_overrides` (ApiIntegrationWebhookOverrides, optional) — Gebruikersoverschrijvingen die boven op de basis-api_schema worden toegepast - `tool_call_sound` (enum, optional) — Vooraf gedefinieerd type tool-callgeluid dat tijdens het uitvoeren van een tool wordt afgespeeld. Als dit niet is opgegeven, wordt er geen tool-callgeluid afgespeeld. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `type`: `client` - `description` (string, required) — Beschrijving van wanneer de tool moet worden gebruikt en wat deze doet. - `name` (string, required) - `assignments` (list of DynamicVariableAssignment, optional) — Configuratie voor het extraheren van waarden uit toolresponses en deze toewijzen aan dynamische variabelen - `dynamic_variables` (DynamicVariablesConfig, optional) — Configuratie voor dynamische variabelen - `execution_mode` (enum, optional, default: immediate) — Bepaalt wanneer en hoe de tool wordt uitgevoerd: 'immediate' voert de tool direct uit wanneer de LLM hierom vraagt, 'post_tool_speech' wacht tot de agent is uitgesproken voordat de tool wordt uitgevoerd en 'async' voert de tool op de achtergrond uit zonder te blokkeren - het beste voor langlopende bewerkingen. - Allowed values: `immediate`, `post_tool_speech`, `async` - `expects_response` (boolean, optional, default: false) — Als true, moet het aanroepen van deze tool het gesprek blokkeren totdat de client reageert met een reactie die aan het LLM wordt doorgegeven. Als false, zetten we het gesprek voort zonder op een reactie van de client te wachten. Dit is nuttig om content aan een gebruiker te tonen zonder het gesprek te blokkeren. - `interruption_mode` (enum, optional, default: allow) — Bepaalt of de gebruiker de agent tijdens deze toolaanroep kan onderbreken. 'allow' (standaard) staat de gebruiker toe om op elk moment te onderbreken, 'disable_during_tool' onderdrukt onderbrekingen alleen terwijl de tool actief is en 'disable_during_tool_and_turn' onderdrukt onderbrekingen terwijl de tool actief is en tijdens de daaropvolgende reactie van de agent. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `parameters` (ObjectJsonSchemaPropertyOutput, optional) — Schema voor alle parameters die aan de client moeten worden doorgegeven - `pre_tool_speech` (enum, optional, default: auto) — Bepaalt of de agent spreekt voordat deze tool wordt aangeroepen. 'auto' (standaard) beslist op basis van recente toollatency, 'force' laat de agent altijd spreken en 'off' schakelt dit volledig uit, ongeacht de latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — De maximale wachttijd in seconden tot de toolcall is voltooid. Moet tussen 1 en 120 seconden liggen (inclusief), of -1 om onbeperkt op de reactie van de client te wachten (vereist expects_response). - `tool_call_sound` (enum, optional) — Vooraf gedefinieerd type tool-callgeluid dat tijdens het uitvoeren van een tool wordt afgespeeld. Als dit niet is opgegeven, wordt er geen tool-callgeluid afgespeeld. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Bepaalt wanneer het geluid voor de toolaanroep moet worden afgespeeld. 'auto' speelt alleen af als er spraak vóór de tool is, 'always' speelt af bij elke toolaanroep. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Bepaalt hoe toolfouten worden verwerkt voordat ze met de agent worden gedeeld. 'auto' bepaalt de afhandeling op basis van het tooltype (samengevat voor native integraties, verbergen voor andere), 'summarized' stuurt een door een LLM gegenereerde samenvatting, 'passthrough' stuurt de onbewerkte fout en 'hide' deelt de fout niet met de agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `interruption_mode`. Als dit true is, kan de gebruiker de agent niet onderbreken terwijl deze tool wordt uitgevoerd. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `pre_tool_speech`. Als dit waar is, spreekt de agent vóór de toolaanroep. - `type`: `mcp` - `value` (any, required) - `type`: `smb` - `value` (any, required) - `type`: `system` - `name` (string, required) - `params` (SystemToolConfigOutputParams, required) - `assignments` (list of DynamicVariableAssignment, optional) — Configuratie voor het extraheren van waarden uit toolresponses en deze toewijzen aan dynamische variabelen - `description` (string, optional, default: ) — Beschrijving van wanneer de tool moet worden gebruikt en wat deze doet. Laat leeg om de standaardbeschrijving te gebruiken, die is geoptimaliseerd voor het specifieke tooltype. - `interruption_mode` (enum, optional, default: allow) — Bepaalt of de gebruiker de agent tijdens deze toolaanroep kan onderbreken. 'allow' (standaard) staat de gebruiker toe om op elk moment te onderbreken, 'disable_during_tool' onderdrukt onderbrekingen alleen terwijl de tool actief is en 'disable_during_tool_and_turn' onderdrukt onderbrekingen terwijl de tool actief is en tijdens de daaropvolgende reactie van de agent. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Bepaalt of de agent spreekt voordat deze tool wordt aangeroepen. 'auto' (standaard) beslist op basis van recente toollatency, 'force' laat de agent altijd spreken en 'off' schakelt dit volledig uit, ongeacht de latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — De maximale wachttijd in seconden tot de toolcall is voltooid. - `tool_call_sound` (enum, optional) — Vooraf gedefinieerd type tool-callgeluid dat tijdens het uitvoeren van een tool wordt afgespeeld. Als dit niet is opgegeven, wordt er geen tool-callgeluid afgespeeld. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Bepaalt wanneer het geluid voor de toolaanroep moet worden afgespeeld. 'auto' speelt alleen af als er spraak vóór de tool is, 'always' speelt af bij elke toolaanroep. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Bepaalt hoe toolfouten worden verwerkt voordat ze met de agent worden gedeeld. 'auto' bepaalt de afhandeling op basis van het tooltype (samengevat voor native integraties, verbergen voor andere), 'summarized' stuurt een door een LLM gegenereerde samenvatting, 'passthrough' stuurt de onbewerkte fout en 'hide' deelt de fout niet met de agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `interruption_mode`. Als dit true is, kan de gebruiker de agent niet onderbreken terwijl deze tool wordt uitgevoerd. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `pre_tool_speech`. Als dit waar is, spreekt de agent vóór de toolaanroep. - `type`: `webhook` - `api_schema` (WebhookToolApiSchemaConfigOutput, required) — Het schema voor de uitgaande webhook, inclusief parameters en URL-specificatie - `description` (string, required) — Beschrijving van wanneer de tool moet worden gebruikt en wat deze doet. - `name` (string, required) - `assignments` (list of DynamicVariableAssignment, optional) — Configuratie voor het extraheren van waarden uit toolresponses en deze toewijzen aan dynamische variabelen - `dynamic_variables` (DynamicVariablesConfig, optional) — Configuratie voor dynamische variabelen - `execution_mode` (enum, optional, default: immediate) — Bepaalt wanneer en hoe de tool wordt uitgevoerd: 'immediate' voert de tool direct uit wanneer de LLM hierom vraagt, 'post_tool_speech' wacht tot de agent is uitgesproken voordat de tool wordt uitgevoerd en 'async' voert de tool op de achtergrond uit zonder te blokkeren - het beste voor langlopende bewerkingen. - Allowed values: `immediate`, `post_tool_speech`, `async` - `follow_redirects` (boolean, optional, default: false) — Of een redirect vanaf het endpoint moet worden gevolgd en de uiteindelijke response moet worden teruggestuurd. Er wordt één redirect gevolgd, als een GET zonder de requestbody; niets dat voor deze tool is geconfigureerd (headers, authenticatie, clientcertificaat) wordt naar het redirectdoel gestuurd. Zowel het endpoint als het redirectdoel moet HTTPS gebruiken. Niet ondersteund voor API-integratietools. - `follow_redirects_allowed_domains` (list of string, optional) — Domeinen waarnaar een redirect kan verwijzen, bijvoorbeeld 'test.example.com'. Vereist bij het volgen van redirects; een doel buiten de lijst wordt geweigerd. - `interruption_mode` (enum, optional, default: allow) — Bepaalt of de gebruiker de agent tijdens deze toolaanroep kan onderbreken. 'allow' (standaard) staat de gebruiker toe om op elk moment te onderbreken, 'disable_during_tool' onderdrukt onderbrekingen alleen terwijl de tool actief is en 'disable_during_tool_and_turn' onderdrukt onderbrekingen terwijl de tool actief is en tijdens de daaropvolgende reactie van de agent. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Bepaalt of de agent spreekt voordat deze tool wordt aangeroepen. 'auto' (standaard) beslist op basis van recente toollatency, 'force' laat de agent altijd spreken en 'off' schakelt dit volledig uit, ongeacht de latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — De maximale wachttijd in seconden tot de toolcall is voltooid. Moet tussen 5 en 300 seconden liggen (inclusief). - `tool_call_sound` (enum, optional) — Vooraf gedefinieerd type tool-callgeluid dat tijdens het uitvoeren van een tool wordt afgespeeld. Als dit niet is opgegeven, wordt er geen tool-callgeluid afgespeeld. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Bepaalt wanneer het geluid voor de toolaanroep moet worden afgespeeld. 'auto' speelt alleen af als er spraak vóór de tool is, 'always' speelt af bij elke toolaanroep. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Bepaalt hoe toolfouten worden verwerkt voordat ze met de agent worden gedeeld. 'auto' bepaalt de afhandeling op basis van het tooltype (samengevat voor native integraties, verbergen voor andere), 'summarized' stuurt een door een LLM gegenereerde samenvatting, 'passthrough' stuurt de onbewerkte fout en 'hide' deelt de fout niet met de agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `interruption_mode`. Als dit true is, kan de gebruiker de agent niet onderbreken terwijl deze tool wordt uitgevoerd. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `pre_tool_speech`. Als dit waar is, spreekt de agent vóór de toolaanroep. ### WidgetTextContentsTranslation - `source` (map from string to string, optional) — De brontekst waarvan elk vertaald veld is afgeleid - `text` (map from string to string, optional) — De laatste automatisch vertaalde uitvoer voor elk vertaald veld ### WidgetTermsTranslation - `source_hash` (string, required) - `text` (string, required) ### AsrConversationalConfigOverrideConfig - `keywords` (boolean, optional, default: false) — Of het overschrijven van het veld keywords moet worden toegestaan. ### TurnConfigOverrideConfig - `soft_timeout_config` (SoftTimeoutConfigOverrideConfig, optional) — Configureert overschrijvingen voor geneste velden. ### TtsConversationalConfigOverrideConfig - `model_id` (boolean, optional, default: false) — Of het overschrijven van het veld model_id moet worden toegestaan. - `voice_id` (boolean, optional, default: false) — Of het overschrijven van het veld voice_id moet worden toegestaan. - `supported_voices` (boolean, optional, default: false) — Of het overschrijven van het veld supported_voices moet worden toegestaan. - `stability` (boolean, optional, default: false) — Of het overschrijven van het veld stability moet worden toegestaan. - `speed` (boolean, optional, default: false) — Of het overschrijven van het veld speed moet worden toegestaan. - `similarity_boost` (boolean, optional, default: false) — Of het overschrijven van het veld similarity_boost moet worden toegestaan. - `pronunciation_dictionary_locators` (boolean, optional, default: false) — Of het overschrijven van het veld pronunciation_dictionary_locators moet worden toegestaan. ### ConversationConfigOverrideConfig - `text_only` (boolean, optional, default: false) — Of het overschrijven van het veld text_only moet worden toegestaan. - `max_duration_seconds` (boolean, optional, default: false) — Of het overschrijven van het veld max_duration_seconds moet worden toegestaan. ### AgentConfigOverrideConfig - `first_message` (boolean, optional, default: false) — Of het overschrijven van het veld first_message moet worden toegestaan. - `language` (boolean, optional, default: false) — Of het overschrijven van het veld language moet worden toegestaan. - `max_conversation_duration_message` (boolean, optional, default: false) — Of het overschrijven van het veld max_conversation_duration_message moet worden toegestaan. - `prompt` (PromptAgentApiModelOverrideConfig, optional) — Configureert overschrijvingen voor geneste velden. ### ConversationInitiationClientDataWebhookRequestHeadersValue ### 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` - `type`: `retry` - `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?".) — Aangepaste feedback die bij een nieuwe poging na het activeren van een guardrail in de agent wordt ingevoegd. ### CustomGuardrailsConfigInput Configuratiecontainer voor de lijst met aangepaste guardrails - `configs` (list of CustomGuardrailConfig, optional) ### AstNodeInput - `type`: `add_operator` - `left` (AstNodeInput, required) — Linkeroperand van de binaire operator. - `right` (AstNodeInput, required) — Rechteroperand van de binaire operator. - `type`: `and_operator` - `children` (list of AstNodeInput, required) — Onderliggende knooppunten van de logische operator. - `type`: `boolean_literal` - `value` (boolean, required) — Waarde van dit literal. - `type`: `conditional_operator` - `condition` (AstNodeInput, required) — Voorwaarde die bepaalt welke expressie moet worden geselecteerd. - `falseExpression` (AstNodeInput, required) — Expressie die wordt geselecteerd als de voorwaarde onwaar is. - `trueExpression` (AstNodeInput, required) — Expressie die wordt geselecteerd als de voorwaarde waar is. - `type`: `div_operator` - `left` (AstNodeInput, required) — Linkeroperand van de binaire operator. - `right` (AstNodeInput, required) — Rechteroperand van de binaire operator. - `type`: `dynamic_variable` - `name` (string, required) — De naam van de dynamische variabele. - `type`: `eq_operator` - `left` (AstNodeInput, required) — Linkeroperand van de binaire operator. - `right` (AstNodeInput, required) — Rechteroperand van de binaire operator. - `type`: `gt_operator` - `left` (AstNodeInput, required) — Linkeroperand van de binaire operator. - `right` (AstNodeInput, required) — Rechteroperand van de binaire operator. - `type`: `gte_operator` - `left` (AstNodeInput, required) — Linkeroperand van de binaire operator. - `right` (AstNodeInput, required) — Rechteroperand van de binaire operator. - `type`: `llm` - `value_schema` (LlmLiteralJsonSchemaProperty, optional) — JSON-schema dat de waarde beschrijft die de LLM moet extraheren. - `prompt` (string, optional, deprecated) — De prompt die moet worden geëvalueerd tot een booleaanse waarde. Verouderd. Gebruik in plaats daarvan een booleaans schema. - `type`: `lt_operator` - `left` (AstNodeInput, required) — Linkeroperand van de binaire operator. - `right` (AstNodeInput, required) — Rechteroperand van de binaire operator. - `type`: `lte_operator` - `left` (AstNodeInput, required) — Linkeroperand van de binaire operator. - `right` (AstNodeInput, required) — Rechteroperand van de binaire operator. - `type`: `mul_operator` - `left` (AstNodeInput, required) — Linkeroperand van de binaire operator. - `right` (AstNodeInput, required) — Rechteroperand van de binaire operator. - `type`: `neq_operator` - `left` (AstNodeInput, required) — Linkeroperand van de binaire operator. - `right` (AstNodeInput, required) — Rechteroperand van de binaire operator. - `type`: `null_literal` - `type`: `number_literal` - `value` (AstNumberNodeInputValue, required) — Waarde van dit literal. - `type`: `or_operator` - `children` (list of AstNodeInput, required) — Onderliggende knooppunten van de logische operator. - `type`: `string_literal` - `value` (string, required) — Waarde van dit literal. - `type`: `sub_operator` - `left` (AstNodeInput, required) — Linkeroperand van de binaire operator. - `right` (AstNodeInput, required) — Rechteroperand van de binaire operator. ### AsrConversationalConfigWorkflowOverride - `quality` ("high", optional) — De kwaliteit van de transcriptie - `provider` (enum, optional, default: scribe_realtime) — De provider van de transcriptieservice - Allowed values: `elevenlabs`, `scribe_realtime`, `scribe_v2_turbo` - `user_input_audio_format` (enum, optional, default: pcm_16000) — Het formaat van de audio die moet worden getranscribeerd - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000` - `keywords` (list of string, optional) — Trefwoorden waarvoor de voorspellingskans moet worden verhoogd ### TurnConfigWorkflowOverride - `turn_timeout` (double, optional) — Maximale wachttijd op het antwoord van de gebruiker voordat opnieuw contact wordt opgenomen - `initial_wait_time` (double, optional) — Hoe lang de agent wacht tot de gebruiker het gesprek start als het eerste bericht leeg is. Als dit niet is ingesteld, wordt de gewone turn_timeout gebruikt. - `silence_end_call_timeout` (double, optional) — Maximale tijd sinds de gebruiker voor het laatst sprak voordat het gesprek wordt beëindigd - `turn_eagerness` (enum, optional, default: normal) — Bepaalt hoe snel de agent reageert. Laag = minder snel (wacht langer), Standaard = standaardreactiesnelheid, Hoog = sneller (reageert eerder) - Allowed values: `patient`, `normal`, `eager` - `spelling_patience` (enum, optional, default: auto) — Bepaalt of de agent geduldiger moet zijn wanneer de gebruiker getallen en benoemde entiteiten spelt. Auto = gebaseerd op het model, Uit = nooit extra wachten - Allowed values: `auto`, `off` - `speculative_turn` (boolean, optional) — Wanneer dit is ingeschakeld, begint het tijdens stilte met het genereren van LLM-antwoorden voordat de volledige turn confidence is bereikt, waardoor de waargenomen vertraging afneemt. Dit kan de LLM-kosten verhogen. - `retranscribe_on_turn_timeout` (boolean, optional) — Wanneer dit is ingeschakeld en VAD geen spraak detecteert, wordt geprobeerd de verzamelde audio opnieuw te transcriberen bij de turn timeout. Schakelt facturering met stiltekorting uit zolang dit is ingeschakeld voor de actieve agent of workflownode. - `turn_model` (enum, optional, default: turn_v3) — Versie van het te gebruiken beurtwisselingsdetectiemodel. - Allowed values: `turn_v2`, `turn_v3` - `interruption_ignore_terms` (list of string, optional) — Lijst met termen die geen onderbreking mogen veroorzaken wanneer de gebruiker ze uitspreekt (bijv. 'gotcha', 'understood'). Gebruikt exacte overeenkomst zonder hoofdlettergevoeligheid. - `interruption_ignore_term_languages` (list of string, optional) — Taalcodes waarvoor vooraf ingestelde categorieën voor te negeren termen zijn geactiveerd. Expliciet opgeslagen, zodat de weergave niet wordt afgeleid uit overlappende termen. - `merge_with_default_ignore_terms` (boolean, optional) — Wanneer dit is ingeschakeld, worden naast interruption_ignore_terms ook de samengestelde standaardtermen voor interruption_ignore_term_languages gebruikt. - `transcribe_on_disabled_interruptions` (boolean, optional) — Transcribeer ook wanneer onderbrekingen zijn uitgeschakeld wat de gebruiker zegt, zodat dit kan worden meegenomen naar de volgende beurt. Wanneer dit is uitgeschakeld, wordt spraak van de gebruiker tijdens een niet-onderbreekbare beurt genegeerd en wordt geen beurt gestart. - `soft_timeout_config` (SoftTimeoutConfigWorkflowOverride, optional) — Configuratie voor soft-time-outfunctionaliteit. Geeft direct feedback tijdens langere LLM-responses. ### TtsConversationalConfigWorkflowOverrideInput - `model_id` (enum, optional, default: eleven_v4_turbo) — Het model dat voor TTS moet worden gebruikt - 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) — De stem-ID die voor TTS moet worden gebruikt - `supported_voices` (list of SupportedVoice, optional) — Aanvullende ondersteunde stemmen voor de agent - `expressive_mode` (boolean, optional) — Wanneer dit is ingeschakeld, wordt de prompt voor expressieve audiotags toegepast. Automatisch uitgeschakeld voor niet-v3-modellen. - `suggested_audio_tags` (list of SuggestedAudioTag, optional) — Voorgestelde audiotags om expressieve spraak te versterken (voor modellen eleven_v3 en eleven_v3_conversational). De agent kan nog steeds andere, hier niet vermelde tags gebruiken. - `agent_output_audio_format` (enum, optional, default: pcm_16000) — De audio-indeling die je voor TTS wilt gebruiken - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000` - `optimize_streaming_latency` (integer, optional) — Verouderd: dit veld heeft geen effect en wordt genegeerd. - `stability` (double, optional) — De stabiliteit van gegenereerde spraak - `speed` (double, optional) — De snelheid van gegenereerde spraak - `similarity_boost` (double, optional) — De similariteitsboost voor gegenereerde spraak - `text_normalisation_type` (enum, optional, default: system_prompt) — Methode om getallen naar woorden om te zetten voordat tekst naar spraak wordt omgezet. Als dit is ingesteld op SYSTEM_PROMPT, wordt de systeemprompt bijgewerkt met normalisatie-instructies. Als dit is ingesteld op ELEVENLABS, wordt de tekst na het genereren genormaliseerd, wat voor een kleine extra vertraging zorgt. - Allowed values: `system_prompt`, `elevenlabs` - `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional) — De locators voor het uitspraakwoordenboek - `enable_phoneme_tags` (boolean, optional) — Meld je aan voor verwerking van SSML-foneemtags voor V3-modellen. Indien ingeschakeld, worden foneemtags (inline en uit uitspraakwoordenboeken) geparseerd naar inline IPA voordat ze naar het model worden verzonden. - `audio_effects` (EffectsSpecInput, optional) — Optionele specificatie voor TTS-effecten: filterpreset, afstand (proximity-EQ) en omgeving (convolution reverb). ### ConversationConfigWorkflowOverrideInput - `text_only` (boolean, optional) — Als dit is ingeschakeld, wordt audio niet verwerkt en wordt alleen tekst gebruikt. Gebruik dit om audiokosten te vermijden. - `max_duration_seconds` (integer, optional) — De maximale duur van een conversatie in seconden - `client_events` (list of enum, optional) — De gebeurtenissen die naar de client worden verzonden - 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) — Configuratie voor bestandsinvoer (uploads van afbeeldingen/PDF's) tijdens gesprekken. - `monitoring_enabled` (boolean, optional) — Schakel realtime monitoring van gesprekken via WebSocket in - `monitoring_events` (list of enum, optional) — De gebeurtenissen die naar monitoringverbindingen worden verzonden. - 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) — Configureer het verzamelen van DTMF-invoer (toetsenblok) tijdens telefoongesprekken - `background_sound` (BackgroundSoundConfigWorkflowOverride, optional) — Configuratie voor achtergrondgeluid tijdens gesprekken. - `source_attribution` (boolean, optional) — Wanneer dit is ingeschakeld en er inhoud in de kennisbank aanwezig is, krijgt de LLM de instructie om te vermelden welke bronnen zijn gebruikt. ### LanguagePresetInput - `overrides` (ConversationConfigClientOverrideInput, required) — De overschrijvingen voor de taalpreset - `first_message_translation` (LanguagePresetTranslation, optional) — De vertaling van het eerste bericht - `soft_timeout_translation` (LanguagePresetTranslation, optional) — De vertaling van het bericht voor de zachte time-out ### VadConfigWorkflowOverride ### AgentConfigApiModelWorkflowOverrideInput - `first_message` (string, optional) — Als dit niet leeg is, het eerste bericht dat de agent uitspreekt. Als het leeg is, wacht de agent tot de gebruiker het gesprek start. - `language` (string, optional) — Taal van de agent - gebruikt voor ASR en TTS - `hinglish_mode` (boolean, optional) — Wanneer dit is ingeschakeld, voegt de agent Engelse woorden en zinnen toe aan antwoorden in het Hindi, Malayalam, Telugu of Kannada. - `dynamic_variables` (DynamicVariablesConfigWorkflowOverride, optional) — Configuratie voor dynamische variabelen - `disable_first_message_interruptions` (boolean, optional) — Als true, kan de gebruiker de agent niet onderbreken terwijl het eerste bericht wordt geleverd. - `max_conversation_duration_message` (string, optional) — Als dit niet leeg is, het bericht dat de agent verstuurt wanneer de maximale gespreksduur is bereikt. - `text_behavior_overrides` (map from string to BehaviorOverride, optional) — Overschrijvingen van antwoordgedrag per kanaal voor tekstgesprekken. Als deze niet zijn ingesteld, gelden de ingebouwde standaardwaarden van het kanaal. - `prompt` (PromptAgentApiModelWorkflowOverrideInput, optional) — De prompt voor de agent ### WorkflowToolLocatorSchemaOverridesValue - `source`: `constant` - `constant_value` (ConstantSchemaOverrideConstantValue, optional) — De constante waarde die je wilt gebruiken - `source`: `dynamic_variable` - `dynamic_variable` (string, required) — De naam van de te gebruiken dynamische variabele - `source`: `llm` - `prompt` (string, optional) — Promptoverschrijving voor de LLM. Als deze niet is opgegeven, wordt de oorspronkelijke schemabeschrijving gebruikt. - `source`: `omit` ### TranslatedString - `value` (string, required) ### UnitTestToolCallParameterEval - `type`: `anything` - `type`: `exact` - `expected_value` (string, required) — De exacte tekenreekswaarde waarmee de parameter moet overeenkomen. - `type`: `llm` - `description` (string, required) — Een beschrijving van de evaluatiestrategie voor de test. - `type`: `regex` - `pattern` (string, required) — Een regex-patroon waarmee het antwoord van de agent wordt vergeleken. ### ConversationHistoryTranscriptToolCallWebhookDetails - `method` (string, required) - `url` (string, required) - `type` ("webhook", optional) - `headers` (map from string to string, optional) - `path_params` (map from string to string, optional) - `query_params` (map from string to string, optional) - `body` (string, optional) ### DynamicVariableUpdateCommonModel Houdt een update van een dynamische variabele bij die tijdens de uitvoering van een tool plaatsvond. - `variable_name` (string, required) - `new_value` (string, required) - `updated_at` (double, required) - `tool_name` (string, required) - `tool_request_id` (string, required) - `old_value` (string, optional) ### ConversationHistoryTranscriptSystemToolResultCommonModelOutputResult - `result_type`: `dummy` - `result_type`: `end_call_success` - `message` (string, optional) - `reason` (string, optional) - `status` ("success", optional) - `result_type`: `end_procedure_error` - `message` (string, required) - `status` (enum, required) - Allowed values: `not_found`, `invalid_id` - `procedure_id` (string, optional) - `result_type`: `end_procedure_success` - `procedure_id` (string, required) - `procedure_name` (string, required) - `message` (string, optional, default: ) - `status` ("success", optional) - `result_type`: `knowledge_base_rag_success` - `chunk_count` (integer, optional, default: 0) — Aantal opgehaalde relevante chunks - `chunks` (list of KnowledgeBaseRagChunkModel, optional) — Opgehaalde chunks; alleen gevuld in de modus rag-result-in-tool-result - `message` (string, optional, default: Referenced knowledge base.) — Voor mensen leesbare status voor de LLM over de zoekresultaten - `status` (enum, optional, default: success) - Allowed values: `success`, `no_documents`, `no_results` - `result_type`: `knowledge_base_success` - `chunk_count` (integer, optional, default: 0) - `message` (string, optional, default: Referenced knowledge base.) - `status` (enum, optional, default: success) - Allowed values: `success`, `no_matching_documents`, `no_results` - `result_type`: `language_detection_success` - `language` (string, optional) - `reason` (string, optional) - `status` ("success", optional) - `result_type`: `play_dtmf_error` - `error` (string, required) - `details` (string, optional) - `status` ("error", optional) - `result_type`: `play_dtmf_success` - `dtmf_tones` (string, required) - `reason` (string, optional) - `status` ("success", optional) - `result_type`: `skip_turn_success` - `reason` (string, optional) - `status` ("success", optional) - `result_type`: `start_procedure_error` - `message` (string, required) - `status` (enum, required) - Allowed values: `not_found`, `invalid_name`, `already_active` - `procedure_id` (string, optional) - `result_type`: `start_procedure_success` - `procedure_id` (string, required) - `procedure_name` (string, required) - `message` (string, optional, default: Procedure is now started. Follow its instructions from the section of your system prompt.) - `procedure_entry_workflow_node` (string, optional) - `procedure_return_workflow_node` (string, optional) - `status` ("success", optional) - `result_type`: `testing_tool_result` - `reason` (string, optional, default: Skipping tool call in test mode) - `status` ("success", optional) - `result_type`: `transfer_to_agent_error` - `error` (string, required) - `from_agent` (string, required) - `status` ("error", optional) - `result_type`: `transfer_to_agent_success` - `condition` (string, required) - `from_agent` (string, required) - `to_agent` (string, required) - `branch_info` (TransferToAgentToolResultSuccessModelOutputBranchInfo, optional) - `delay_ms` (integer, optional, default: 0) - `enable_transferred_agent_first_message` (boolean, optional, default: false) - `preserve_client_tts_overrides` (boolean, optional, default: false) - `preserve_voice_settings` (boolean, optional, default: false) - `status` ("success", optional) - `to_node` (string, optional) - `transfer_message` (string, optional) - `result_type`: `transfer_to_number_amazon_connect_success` - `client_message` (string, optional) — Bericht dat aan de beller wordt uitgesproken voordat de sessie wordt teruggegeven aan Amazon Connect. - `note` (string, optional) — Ingesteld wanneer de agent een ongeldige optie herhaalde en de enige geconfigureerde optie werd gebruikt. - `reason` (string, optional) — Waarom de agent heeft geëscaleerd, zoals verstuurd naar Amazon Connect met de uitkomst Escalate. - `status` ("success", optional) - `result_type`: `transfer_to_number_error` - `error` (string, required) - `details` (string, optional) - `status` ("error", optional) - `result_type`: `transfer_to_number_exotel_success` - `transfer_number` (string, required) - `agent_message` (string, optional) - `note` (string, optional) - `reason` (string, optional) - `status` ("success", optional) - `result_type`: `transfer_to_number_sip_success` - `transfer_number` (string, required) - `note` (string, optional) - `reason` (string, optional) - `status` ("success", optional) - `result_type`: `transfer_to_number_twilio_success` - `agent_message` (string, required) - `conference_name` (string, required) - `transfer_number` (string, required) - `client_message` (string, optional) - `note` (string, optional) - `post_dial_digits` (string, optional) - `reason` (string, optional) - `status` ("success", optional) - `result_type`: `voicemail_detection_success` - `reason` (string, optional) - `status` ("success", optional) - `voicemail_message` (string, optional) ### WorkflowToolResponseModelOutput Een algemeen model voor responses van workflowtools. - `steps` (list of WorkflowToolResponseModelOutputStepsItem, optional) ### LlmTokensCategoryUsage - `tokens` (integer, optional, default: 0) - `price` (double, optional, default: 0) ### SoftTimeoutConfigOverride - `message` (string, optional) — Bericht dat wordt weergegeven wanneer de eerste zachte time-out wordt bereikt tijdens het wachten op een reactie van de LLM. Ondersteunt dynamische variabelen (bijv. \{\{system\_\_time}}, \{\{custom\_variable}}). - `additional_soft_timeout_messages` (list of string, optional) — Extra statische opvulberichten voor volgende soft time-outs in dezelfde LLM-generatie. De eerste time-out gebruikt `message`. Als er minder berichten zijn geconfigureerd dan `max_soft_timeouts_per_generation`, wordt het laatst geconfigureerde bericht herhaald; anders wordt een ingebouwd opvulbericht gebruikt. ### PromptAgentApiModelOverrideOutput - `prompt` (string, optional) — De prompt voor de agent - `llm` (enum, optional) — De LLM die met de prompt en de chatgeschiedenis moet worden bevraagd. Bij gebruik van dataresidency moet de LLM worden ondersteund in de dataresidencyomgeving. - 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`, `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) — Een lijst met ID's van tools die door de agent worden gebruikt - `tool_ids_strict` (boolean, optional) — Alleen van toepassing als overschrijving voor een gesprek en toegestaan wanneer tool_ids mag worden overschreven. Wanneer true is, bevat de overschreven tool_ids de volledige lijst met tools die in het gesprek zijn toegestaan, inclusief tools op workflownodes. Genegeerd wanneer ingesteld op de agent. - `native_mcp_server_ids` (list of string, optional) — Een lijst met Native MCP-server-id's die door de agent moeten worden gebruikt - `knowledge_base` (list of KnowledgeBaseLocator, optional) — Een lijst met kennisbanken die door de agent moeten worden gebruikt ### SystemToolConfigOutput Een systeemtool is een tool die wordt gebruikt om een systeemmethode op de server aan te roepen - `name` (string, required) - `params` (SystemToolConfigOutputParams, required) - `type` ("system", optional) — Het type tool - `description` (string, optional, default: ) — Beschrijving van wanneer de tool moet worden gebruikt en wat deze doet. Laat leeg om de standaardbeschrijving te gebruiken, die is geoptimaliseerd voor het specifieke tooltype. - `response_timeout_secs` (integer, optional, default: 20) — De maximale wachttijd in seconden tot de toolcall is voltooid. - `interruption_mode` (enum, optional, default: allow) — Bepaalt of de gebruiker de agent tijdens deze toolaanroep kan onderbreken. 'allow' (standaard) staat de gebruiker toe om op elk moment te onderbreken, 'disable_during_tool' onderdrukt onderbrekingen alleen terwijl de tool actief is en 'disable_during_tool_and_turn' onderdrukt onderbrekingen terwijl de tool actief is en tijdens de daaropvolgende reactie van de agent. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Bepaalt of de agent spreekt voordat deze tool wordt aangeroepen. 'auto' (standaard) beslist op basis van recente toollatency, 'force' laat de agent altijd spreken en 'off' schakelt dit volledig uit, ongeacht de latency. - Allowed values: `auto`, `force`, `off` - `assignments` (list of DynamicVariableAssignment, optional) — Configuratie voor het extraheren van waarden uit toolresponses en deze toewijzen aan dynamische variabelen - `tool_call_sound` (enum, optional) — Vooraf gedefinieerd type tool-callgeluid dat tijdens het uitvoeren van een tool wordt afgespeeld. Als dit niet is opgegeven, wordt er geen tool-callgeluid afgespeeld. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Bepaalt wanneer het geluid voor de toolaanroep moet worden afgespeeld. 'auto' speelt alleen af als er spraak vóór de tool is, 'always' speelt af bij elke toolaanroep. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Bepaalt hoe toolfouten worden verwerkt voordat ze met de agent worden gedeeld. 'auto' bepaalt de afhandeling op basis van het tooltype (samengevat voor native integraties, verbergen voor andere), 'summarized' stuurt een door een LLM gegenereerde samenvatting, 'passthrough' stuurt de onbewerkte fout en 'hide' deelt de fout niet met de agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `interruption_mode`. Als dit true is, kan de gebruiker de agent niet onderbreken terwijl deze tool wordt uitgevoerd. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `pre_tool_speech`. Als dit waar is, spreekt de agent vóór de toolaanroep. ### CustomLlmApiKey De API-sleutel voor authenticatie. Ofwel een verwijzing naar een workspacegeheim \{'secret\_id': '...'} of een verwijzing naar een omgevingsvariabele \{'env\_var\_label': '...'}. ### CustomLlmAuthConnection Optionele workspace-authverbinding voor authenticatie. Alleen authverbindingen die een Authorization Bearer-token produceren, worden ondersteund; Basic-auth, mTLS, aangepaste headers en authverbindingen met een URL-secret worden niet ondersteund. ### CustomLlmRequestHeadersValue ### KnowledgeBaseToolInfo - `enabled_strategies` (list of enum, optional) — Zoekstrategieën die beschikbaar zijn voor het model. Mag niet leeg zijn. - Allowed values: `cat`, `keyword`, `semantic`, `ls` ### DynamicVariableAssignment Configuratie voor het extraheren van waarden uit toolresponses en deze toewijzen aan dynamische variabelen. - `dynamic_variable` (string, required) — De naam van de dynamische variabele waaraan de geëxtraheerde waarde wordt toegewezen - `value_path` (string, required) — Pad in puntnotatie om de waarde uit de bron te extraheren (bijvoorbeeld 'user.name' of 'data.0.id') - `source` ("response", optional) — De bron waaruit de waarde wordt geëxtraheerd. Momenteel wordt alleen 'response' ondersteund. - `sanitize` (boolean, optional, default: false) — Als true, wordt de waarde van deze toewijzing uit de toolreactie verwijderd voordat deze naar het LLM en het transcript wordt verzonden, maar wordt deze nog wel verwerkt voor variabeletoewijzing. - `preserve_native_type` (boolean, optional, default: false) — Als true, worden niet-scalaire waarden (lijsten, objecten) uit de toolreactie opgeslagen in hun oorspronkelijke type, in plaats van als JSON-string. Schakel dit in om geëxtraheerde arrays rechtstreeks als dynamische lijstvariabelen te gebruiken. ### DynamicVariablesConfig - `dynamic_variable_placeholders` (map from string to any, optional) — Een woordenboek met tijdelijke aanduidingen voor dynamische variabelen en hun waarden ### ApiIntegrationWebhookOverrides - `schema_overrides` (map from string to ApiIntegrationWebhookOverridesSchemaOverridesValue, optional) - `response_filter_mode` (enum, optional, default: all) — Bepaalt hoe toolresponses worden gefilterd voordat ze zichtbaar zijn voor de agent. - Allowed values: `all`, `allow`, `hide_all` - `response_filters` (list of string, optional) - `request_headers` (map from string to ApiIntegrationWebhookOverridesRequestHeadersValue, optional) ### ObjectJsonSchemaPropertyOutput - `description` (string, optional, default: ) - `dynamic_variable` (string, optional, default: ) — Wanneer ingesteld, wordt de volledige parameter tijdens runtime ingevuld vanuit deze dynamische variabele. Kan niet samen worden gebruikt met description (door de LLM aangeleverde waarde), constant_value en is_omitted. - `constant_value` (map from string to any, optional) — Wanneer ingesteld, gebruikt het volledige object deze constante JSON-waarde tijdens runtime. Kan niet samen worden gebruikt met description (door de LLM aangeleverd object), dynamic_variable en is_omitted. - `is_omitted` (boolean, optional, default: false) — Als true is, wordt deze parameter volledig uit de request weggelaten. Alleen geldig voor optionele parameters. Kan niet samen worden gebruikt met description, dynamic_variable en constant_value. - `type` ("object", optional) - `required` (list of string, optional) - `properties` (map from string to ObjectJsonSchemaPropertyOutputPropertiesValue, optional) - `required_constraints` (RequiredConstraints, optional) — Wrapper voor anyOf/allOf-compositiebeperkingen die gelden voor verplichte velden. ### SystemToolConfigOutputParams - `system_tool_type`: `end_call` - `system_tool_type`: `end_procedure` - `procedures` (map from string to EndProcedureToolConfigProceduresValue, optional) - `system_tool_type`: `knowledge_base` - `enabled_strategies` (list of enum, optional) - Allowed values: `cat`, `keyword`, `semantic`, `ls` - `system_tool_type`: `knowledge_base_rag` - `system_tool_type`: `language_detection` - `only_at_conversation_start` (boolean, optional, default: false) — Als er in de eerste 2 gebruikersbeurten geen taalwissel plaatsvindt, mislukken latere pogingen en blijft het gesprek in de huidige taal. Als de taal tijdens die beurten wisselt, blijft later wisselen mogelijk. Schakel dit in om de kans op onjuiste taalwisselingen te verkleinen. - `system_tool_type`: `play_keypad_touch_tone` - `suppress_turn_after_dtmf` (boolean, optional, default: false) — Als true, genereert de agent geen verdere spraak nadat DTMF-tonen zijn afgespeeld. Dit voorkomt dat de spraak van de agent IVR-systemen verstoort. - `use_out_of_band_dtmf` (boolean, optional, default: true) — Verstuur DTMF-tonen als out-of-band RTP-events (RFC 4733) in plaats van als in-band audio. Alleen effectief voor nummers die via een SIP trunk zijn geïmporteerd. - `system_tool_type`: `skip_turn` - `wait_timeout_secs` (double, optional, default: -1) — Seconden om na skip_turn te wachten voordat de agent een contextuele check-in genereert. De timer "Gesprek beëindigen na stilte" wordt tijdens het wachten gepauzeerd. -1 schakelt het wachten uit: na skip_turn blijft de agent stil totdat de beller spreekt, terwijl die timer blijft lopen. Alleen van toepassing op spraakgesprekken. - `system_tool_type`: `start_procedure` - `procedures` (map from string to StartProcedureToolConfigProceduresValue, optional) - `system_tool_type`: `transfer_to_agent` - `transfers` (list of AgentTransferOutput, required) - `system_tool_type`: `transfer_to_number` - `transfers` (list of PhoneNumberTransfer, required) - `enable_client_message` (boolean, optional, default: true) — Of er een bericht voor de klant moet worden afgespeeld terwijl die op overdracht wacht. Standaard is dit true voor achterwaartse compatibiliteit. - `system_tool_type`: `voicemail_detection` - `voicemail_message` (string, optional) — Optioneel bericht om achter te laten op de voicemail wanneer deze wordt gedetecteerd. Als dit niet wordt opgegeven, wordt het gesprek onmiddellijk beëindigd wanneer voicemail wordt gedetecteerd. Ondersteunt dynamische variabelen (bijv. \{\{system\_\_time}}, \{\{system\_\_call\_duration\_secs}}, \{\{custom\_variable}}). ### WebhookToolApiSchemaConfigOutput - `url` (string, required) — De URL waarnaar de webhook wordt verzonden. Kan path parameters bevatten, bijvoorbeeld [https://example.com/agents/\{agent\_id}](https://example.com/agents/\{agent_id}) - `request_headers` (map from string to WebhookToolApiSchemaConfigOutputRequestHeadersValue, optional) — Headers die in de aanvraag moeten worden opgenomen - `method` (enum, optional, default: GET) — De HTTP-methode die voor de webhook moet worden gebruikt - Allowed values: `GET`, `POST`, `PUT`, `PATCH`, `DELETE` - `path_params_schema` (map from string to LiteralJsonSchemaProperty, optional) — Schema voor eventuele padparameters. De sleutels moeten overeenkomen met de placeholders in de URL. - `query_params_schema` (QueryParamsJsonSchemaOutput, optional) — Schema voor eventuele queryparameters. Deze worden als queryparameters aan het einde van de URL toegevoegd. Let op: eigenschappen in een queryparameter moeten allemaal letterlijke typen zijn - `request_body_schema` (ObjectJsonSchemaPropertyOutput, optional) — Schema voor eventuele bodyparameters. Wordt gebruikt voor POST/PATCH/PUT-requests. Het schema moet een object zijn dat als JSON-body wordt verzonden - `response_body_schema` (ObjectJsonSchemaPropertyOutput, optional) — Schema dat de verwachte structuur van de responsebody beschrijft. Alleen voor documentatie; niet beschikbaar voor de LLM. - `response_filter` (ResponseFilter, optional) — Optioneel allowlistfilter dat op het antwoord wordt toegepast voordat de LLM het ziet, zodat grote antwoorden de context niet vervuilen. Standaard wordt het volledige antwoord gebruikt. - `content_type` (enum, optional, default: application/json) — Contenttype voor de requestbody. Alleen van toepassing op POST/PUT/PATCH-requests. - Allowed values: `application/json`, `application/x-www-form-urlencoded` - `auth_resolved_params` (list of string, optional) — URL-placeholders die worden opgelost vanuit de auth connection (bijvoorbeeld geheimen die via UrlSecretAuthConnection worden ingevoegd) in plaats van vanuit path_params_schema. - `auth_connection` (WebhookToolApiSchemaConfigOutputAuthConnection, optional) — Optionele authverbinding voor authenticatie bij deze webhook ### SoftTimeoutConfigOverrideConfig - `message` (boolean, optional, default: false) — Of het overschrijven van het veld message moet worden toegestaan. - `additional_soft_timeout_messages` (boolean, optional, default: false) — Of het overschrijven van het veld additional_soft_timeout_messages moet worden toegestaan. ### PromptAgentApiModelOverrideConfig - `prompt` (boolean, optional, default: false) — Of het overschrijven van het veld prompt moet worden toegestaan. - `llm` (boolean, optional, default: false) — Of het overschrijven van het veld llm moet worden toegestaan. - `tool_ids` (boolean, optional, default: false) — Of het overschrijven van het veld tool_ids moet worden toegestaan. - `tool_ids_strict` (boolean, optional, default: false) — Of het overschrijven van het veld tool_ids_strict moet worden toegestaan. - `native_mcp_server_ids` (boolean, optional, default: false) — Of het overschrijven van het veld native_mcp_server_ids moet worden toegestaan. - `knowledge_base` (boolean, optional, default: false) — Of het overschrijven van het veld knowledge_base moet worden toegestaan. ### ConvAiSecretLocator Gebruikt om naar een geheim uit de secret store van de agent te verwijzen. - `secret_id` (string, required) ### ContentThresholdGuardrail - `is_enabled` (boolean, optional, default: false) - `threshold` (ContentThresholdGuardrailThreshold, optional) ### CustomGuardrailConfig Configuratie voor één aangepaste guardrail - `name` (string, required) — Gebruikersgerichte naam voor deze guardrail - `prompt` (string, required) — Instructie die beschrijft wat moet worden geblokkeerd, bijvoorbeeld 'praat niet over politiek' - `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-model dat moet worden gebruikt voor aangepaste guardrail-evaluatie - 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) — Hoeveel recente geschiedenis de guardrail ziet vóór het antwoord dat deze evalueert, geteld in gebruikersberichten (de tussenliggende antwoorden van de agent worden ook opgenomen). De guardrail ontvangt altijd één \-transcript dat eindigt met het geëvalueerde antwoord, gemarkeerd met 'AGENT \[current reply]:'. 0 (standaard) voegt geen eerdere geschiedenis toe (alleen die regel); 1 voegt alles vanaf het meest recente gebruikersbericht toe. - `trigger_action` (CustomGuardrailConfigTriggerAction, optional) - `evaluate_full_response_only` (boolean, optional, default: false) — Evalueer één keer op basis van de volledige niet-TTS-respons in plaats van cumulatieve gedeeltelijke reacties. Vereist blocking mode. ### LlmLiteralJsonSchemaProperty - `type` (LlmLiteralJsonSchemaPropertyType, required) - `description` (string, required) - `enum` (list of string, optional) — List of allowed string values for string type parameters ### AstNumberNodeInputValue Waarde van dit literal. ### SoftTimeoutConfigWorkflowOverride - `timeout_seconds` (double, optional) — Tijd in seconden voordat het vooraf gedefinieerde bericht wordt getoond tijdens het wachten op een LLM-reactie. Stel in op -1 om uit te schakelen. - `message` (string, optional) — Bericht dat wordt weergegeven wanneer de eerste zachte time-out wordt bereikt tijdens het wachten op een reactie van de LLM. Ondersteunt dynamische variabelen (bijv. \{\{system\_\_time}}, \{\{custom\_variable}}). - `additional_soft_timeout_messages` (list of string, optional) — Extra statische opvulberichten voor volgende soft time-outs in dezelfde LLM-generatie. De eerste time-out gebruikt `message`. Als er minder berichten zijn geconfigureerd dan `max_soft_timeouts_per_generation`, wordt het laatst geconfigureerde bericht herhaald; anders wordt een ingebouwd opvulbericht gebruikt. - `use_llm_generated_message` (boolean, optional) — Als dit is ingeschakeld, wordt het soft-timeoutbericht dynamisch gegenereerd in plaats van het statische bericht te gebruiken. - `randomize_fillers` (boolean, optional) — Als dit is ingeschakeld, wordt de volgorde van statische soft-timeoutberichten eenmaal aan het begin van elke beurt geschud. Geldt alleen wanneer use_llm_generated_message false is. - `max_soft_timeouts_per_generation` (integer, optional) — Maximumaantal opvulberichten tijdens het wachten op één LLM-respons. Wordt elke timeout_seconds geactiveerd totdat het LLM content streamt of deze limiet is bereikt. - `llm_generated_message_prompt_override` (string, optional) — Aangepaste prompt voor het genereren van het opvulbericht bij een zachte time-out wanneer use\_llm\_generated\_message is ingeschakeld. Recente conversatiecontext wordt als afzonderlijk gebruikersbericht verstrekt. Als dit niet is ingesteld, wordt de standaardprompt gebruikt. Ondersteunt dynamische variabelen (bijv. \{\{system\_\_time}}, \{\{custom\_variable}}). - `disable_until_first_user_message` (boolean, optional) — Wanneer true, worden fillers bij een soft timeout onderdrukt totdat het gesprek minstens één echt gebruikersbericht bevat. Dit voorkomt fillers tijdens de openingsbeurt van de agent (bijvoorbeeld workflow generate-immediately / tool calls voordat de gebruiker spreekt). ### EffectsSpecInput Audio-effecten die worden toegepast op gegenereerde spraak: een filterpreset, waargenomen afstand, een galm- omgeving, achtergrondruis en stereopanning. Laat elk veld op de standaardwaarde staan om onbewerkte audio te krijgen. - `filter_preset_id` (string, optional) — ID van een filterpreset die de stem kleurt, zoals `phone` of `old_radio`. Geef geldige ID's weer met `GET /v1/audio-effects/catalog`. - `distance` (double, optional, default: 0) — Hoe ver de spreker van de microfoon lijkt te staan, van 0 (dichtbij, ongewijzigd) tot 1 (ver weg). Hogere waarden dempen lage en hoge frequenties en verschuiven, wanneer een omgeving is ingesteld, de balans van de droge stem naar de galm. - `environment_id` (string, optional) — ID van een reverbomgeving die de stem in een ruimte plaatst, zoals `small_room` of `hall`. Geef geldige ID's weer met `GET /v1/audio-effects/catalog`. Reverb wordt in stereo gerenderd en voegt een galmstaart van maximaal enkele seconden toe nadat de spraak eindigt. - `background_noise_id` (string, optional) — ID van een achtergrondgeluidsbed dat onder de stem wordt geloopt, zoals `cafe` of `keyboard`. Geef geldige ID's weer met `GET /v1/audio-effects/catalog`. - `send_level` (double, optional, default: 1) — Hoeveel van de stem naar de reverb gaat, van 0 (geen) tot 1 (volledig). Geldt alleen wanneer `environment_id` is ingesteld; 0 schakelt de reverb uit. - `pan` (double, optional, default: 0) — Stereopositie van de stem, van -1 (volledig links) via 0 (midden) tot 1 (volledig rechts). Alleen de stem wordt gepand; galm en achtergrondruis blijven in het midden. - `seed` (integer, optional, deprecated) — Heeft geen effect. ### FileInputConfigWorkflowOverride - `enabled` (boolean, optional) — Wanneer dit is ingeschakeld, kunnen gebruikers afbeeldingen, pdf's of tekstbestanden toevoegen in de chat wanneer de LLM multimodale invoer ondersteunt. - `max_files_in_memory` (integer, optional) — Aantal meest recente bestanden dat tijdens een gesprek in het geheugen wordt bewaard. Oudere bestanden worden samengevat en hun bytes worden vrijgegeven. - `max_files_per_conversation` (integer, optional) — Totaal aantal bestanden dat een gebruiker in één gesprek kan uploaden. Uploads worden per bestand gefactureerd. Gebruik -1 voor geen limiet, of een waarde >= max_files_in_memory. ### BackgroundSoundConfigWorkflowOverride - `source_type` ("preset", optional) — Het type bron voor achtergrondgeluid. - `source_id` (enum, optional) — ID voor de geluidsbron. - Allowed values: `office2`, `office1`, `restaurant`, `city`, `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `volume` (double, optional) — Volumeniveau voor achtergrondgeluid (0.01 tot 1.0). - `crossfade_loop` (boolean, optional) — Pas een crossfade toe bij de loopgrens om hoorbare tikken te voorkomen wanneer het geluid wordt herhaald. ### ConversationConfigClientOverrideInput - `asr` (AsrConversationalConfigOverride, optional) — Configuratie voor conversationele transcriptie - `turn` (TurnConfigOverride, optional) — Configuratie voor beurtdetectie - `tts` (TtsConversationalConfigOverride, optional) — Configuratie voor conversationele Text to Speech - `conversation` (ConversationConfigOverride, optional) — Configuratie voor gespreksgebeurtenissen - `agent` (AgentConfigOverrideInput, optional) — Agentspecifieke configuratie ### DynamicVariablesConfigWorkflowOverride - `dynamic_variable_placeholders` (map from string to any, optional) — Een woordenboek met tijdelijke aanduidingen voor dynamische variabelen en hun waarden ### PromptAgentApiModelWorkflowOverrideInput - `prompt` (string, optional) — De prompt voor de agent - `llm` (enum, optional) — De LLM die met de prompt en de chatgeschiedenis moet worden bevraagd. Bij gebruik van dataresidency moet de LLM worden ondersteund in de dataresidencyomgeving. - 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`, `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) — Redeneerinspanning van het model. Alleen beschikbaar voor sommige modellen. - Allowed values: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max` - `thinking_budget` (integer, optional) — Maximumaantal tokens dat voor redeneren wordt gebruikt. Gebruik 0 om dit uit te schakelen als het model dit ondersteunt. - `enable_reasoning_summary` (boolean, optional) — Schakel samenvattingen van de modelredenering in. Als deze optie is uitgeschakeld, vragen we de provider waar mogelijk niet om samenvattingen voor een snellere TTFB. Niet compatibel met ZRM. - `temperature` (double, optional) — De temperatuur voor de LLM. Standaard is dit 0. Stel in op null om de parameter volledig uit het LLM-request weg te laten (handig voor aangepaste LLM's die het temperatuurveld afwijzen). - `max_tokens` (integer, optional) — Als de waarde groter is dan 0, het maximale aantal tokens dat het LLM kan voorspellen - `tool_ids` (list of string, optional) — Een lijst met ID's van tools die door de agent worden gebruikt - `tool_ids_strict` (boolean, optional) — Alleen van toepassing als overschrijving voor een gesprek en toegestaan wanneer tool_ids mag worden overschreven. Wanneer true is, bevat de overschreven tool_ids de volledige lijst met tools die in het gesprek zijn toegestaan, inclusief tools op workflownodes. Genegeerd wanneer ingesteld op de agent. - `built_in_tools` (BuiltInToolsWorkflowOverrideInput, optional) — Ingebouwde systeemtools die de agent kan gebruiken - `enable_parallel_tool_calls` (boolean, optional) — Schakel parallel tool calling in. Wanneer dit is ingeschakeld, kan de agent meerdere tools parallel uitvoeren binnen één beurt. Niet door alle modellen ondersteund. - `mcp_server_ids` (list of string, optional) — Een lijst met MCP-server-id's die door de agent moeten worden gebruikt - `native_mcp_server_ids` (list of string, optional) — Een lijst met Native MCP-server-id's die door de agent moeten worden gebruikt - `knowledge_base` (list of KnowledgeBaseLocator, optional) — Een lijst met kennisbanken die door de agent moeten worden gebruikt - `custom_llm` (CustomLlm, optional) — Definitie voor een aangepaste LLM als het LLM-veld is ingesteld op 'CUSTOM_LLM' - `ignore_default_personality` (boolean, optional) — Of de standaard persoonlijkheidsregels uit de systeemprompt moeten worden verwijderd - `rag` (RagConfigWorkflowOverrideInput, optional) — Configuratie voor RAG - `timezone` (string, optional) — Tijdzone voor het weergeven van de huidige tijd in de systeemprompt. Indien ingesteld, wordt de huidige tijd met deze tijdzone opgenomen in de systeemprompt. Moet een geldige tijdzonenaam zijn (bijvoorbeeld 'America/New_York', 'Europe/London', 'UTC'). Aanbevolen voor nauwkeurige tijdsbewuste reacties; zonder deze instelling heeft de agent geen kennis van de huidige datum/tijd, tenzij je die via dynamische variabelen of tools opgeeft. Dit kan leiden tot onjuiste of gehallucineerde tijdsverwijzingen. - `backup_llm_config` (PromptAgentApiModelWorkflowOverrideInputBackupLlmConfig, optional) — Configuratie voor cascade van back-up-LLM's. Kan worden uitgeschakeld, systeemstandaarden gebruiken of een aangepaste volgorde opgeven. - `cascade_timeout_seconds` (double, optional) — Tijd in seconden voordat wordt overgeschakeld naar de back-up-LLM. Moet tussen 2 en 15 seconden liggen. - `tools` (list of PromptAgentApiModelWorkflowOverrideInputToolsItem, optional) — Een lijst met tools die de agent tijdens het gesprek kan gebruiken; gebruik in plaats daarvan tool_ids ### ConstantSchemaOverrideConstantValue De constante waarde die je wilt gebruiken ### KnowledgeBaseRagChunkModel - `chunk_id` (string, required) - `document_id` (string, required) - `content` (string, required) ### TransferToAgentToolResultSuccessModelOutputBranchInfo - `branch_reason`: `configured` - `branch_id` (string, required) - `branch_reason`: `defaulting_to_main` - `branch_id` (string, required) - `branch_reason`: `traffic_split` - `branch_id` (string, required) - `traffic_percentage` (double, required) ### WorkflowToolResponseModelOutputStepsItem - `type`: `edge` - `edge_id` (string, required) - `step_latency_secs` (double, required) - `target_node_id` (string, required) - `type`: `max_iterations_exceeded` - `max_iterations` (integer, required) - `step_latency_secs` (double, required) - `type`: `nested_tools` - `is_successful` (boolean, required) - `node_id` (string, required) - `requests` (list of ConversationHistoryTranscriptToolCallCommonModelOutput, required) - `results` (list of WorkflowToolNestedToolsStepModelOutputResultsItem, required) - `step_latency_secs` (double, required) ### ConvAiEnvVarLocator Gebruikt om via een label naar een omgevingsvariabele te verwijzen. - `env_var_label` (string, required) ### AuthConnectionLocator Gebruikt om naar een auth connection uit de auth connection-store van de workspace te verwijzen. - `auth_connection_id` (string, required) ### EnvironmentAuthConnectionLocator Verwijst op label naar een omgevingsvariabele van het type 'auth_connection'. Tijdens runtime wordt deze omgezet naar de auth connection voor de huidige omgeving, met terugval op de standaardomgeving. - `env_var_label` (string, required) ### ConvAiDynamicVariable Gebruikt om naar een dynamische variabele te verwijzen. - `variable_name` (string, required) ### ApiIntegrationWebhookOverridesSchemaOverridesValue - `source`: `constant` - `constant_value` (ConstantSchemaOverrideConstantValue, optional) — De constante waarde die je wilt gebruiken - `source`: `dynamic_variable` - `dynamic_variable` (string, required) — De naam van de te gebruiken dynamische variabele - `source`: `llm` - `prompt` (string, optional) — Promptoverschrijving voor de LLM. Als deze niet is opgegeven, wordt de oorspronkelijke schemabeschrijving gebruikt. - `source`: `omit` ### ApiIntegrationWebhookOverridesRequestHeadersValue ### ObjectJsonSchemaPropertyOutputPropertiesValue ### RequiredConstraints Wrapper voor anyOf/allOf-compositiebeperkingen die gelden voor verplichte velden. - `any_of` (list of RequiredConstraint, optional) - `all_of` (list of RequiredConstraint, optional) ### EndProcedureToolConfigProceduresValue ### StartProcedureToolConfigProceduresValue ### AgentTransferOutput - `condition` (string, required) - `agent_id` (string, optional) - `branch_id` (string, optional) - `node_id` (string, optional) - `delay_ms` (integer, optional, default: 0) - `transfer_message` (string, optional) - `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) — Definieert of TTS-clientoverschrijvingen moeten worden overgedragen naar de doorverbonden agent. - `preserve_voice_settings` (boolean, optional, default: false) — Definieert of de basisstem, het TTS-model en de steminstellingen moeten worden overgedragen naar de doorverbonden agent. ### PhoneNumberTransfer - `transfer_destination` (PhoneNumberTransferTransferDestination, required) - `condition` (string, required) - `custom_sip_headers` (list of PhoneNumberTransferCustomSipHeadersItem, optional) — Aangepaste SIP-headers die moeten worden opgenomen bij het doorverbinden van het gesprek. Elke header kan een statische waarde of een verwijzing naar een dynamische variabele zijn. - `transfer_type` (enum, optional, default: conference) - Allowed values: `blind`, `conference`, `sip_refer` - `sip_refer_play_dialtone` (boolean, optional, default: true) — Wanneer True, wordt op het oorspronkelijke gesprekstraject een beltoon afgespeeld terwijl een SIP REFER-transfer wordt voltooid. De toon wordt via RTP doorgegeven aan de SIP-peer die de REFER uitvoert, dus schakel dit uit als het ontvangende systeem (bijvoorbeeld een SBC of contactcenter) deze niet mag horen. Wanneer dit is uitgeschakeld, hoort de beller stilte totdat de transfer is voltooid. Alleen voor SIP REFER-transfers. - `uui` (UuiTransferConfig, optional) — User-to-User Information (RFC 7433) om aan SIP REFER-transfers toe te voegen. Draagt oproepcontext, zoals CRM-identificatiecodes of de reden voor escalatie, over de transfergrens heen. - `post_dial_digits` (PhoneNumberTransferPostDialDigits, optional) — DTMF-cijfers die moeten worden verzonden nadat de oproep is verbonden (bijvoorbeeld 'ww1234' voor een doorkiesnummer). Kan een statische waarde of een verwijzing naar een dynamische variabele zijn. Gebruik 'w' voor een pauze van 0,5 s. Alleen ondersteund voor Twilio-transfers. - `phone_number` (string, optional, deprecated) ### WebhookToolApiSchemaConfigOutputRequestHeadersValue ### LiteralJsonSchemaProperty Schema-eigenschap voor letterlijke JSON-typen. BELANGRIJK: slechts EEN van de volgende velden kan worden ingesteld: description (LLM levert waarde), dynamic_variable (waarde uit variabele), is_system_provided (systeem levert waarde), constant_value (vaste waarde) of is_omitted (parameter wordt weggelaten). Deze sluiten elkaar uit. - `type` (LiteralJsonSchemaPropertyType, required) - `description` (string, optional, default: ) — De beschrijving van de eigenschap. Wanneer deze is ingesteld, geeft de LLM de waarde op basis van deze beschrijving. Kan niet samen worden gebruikt met dynamic_variable, is_system_provided, constant_value en is_omitted. - `enum` (list of string, optional) — List of allowed string values for string type parameters - `is_system_provided` (boolean, optional, default: false) — Als true, wordt de waarde tijdens runtime door het systeem ingevuld. Wordt door API Integration Webhook-tools gebruikt voor templating. Kan niet tegelijk worden gebruikt met description, dynamic_variable, constant_value en is_omitted. - `dynamic_variable` (string, optional, default: ) — De naam van de dynamische variabele die voor de waarde van deze eigenschap moet worden gebruikt. Kan niet worden gecombineerd met description, is_system_provided, constant_value en is_omitted. - `allowed_values` (AllowedValues, optional) — Server-side afwijscontrole voor een door de LLM opgegeven waarde: de runtime wijst elke waarde buiten de toegestane set die dit object benoemt af, en de set wordt niet als enum aan de LLM getoond. Alleen ondersteund wanneer de waardebron `description` is; een combinatie met dynamic_variable, is_system_provided, constant_value of is_omitted wordt afgewezen. - `constant_value` (LiteralJsonSchemaPropertyConstantValue, optional) — Een constante waarde voor deze eigenschap. Kan niet samen worden gebruikt met description, dynamic_variable, is_system_provided en is_omitted. - `is_omitted` (boolean, optional, default: false) — Als true is, wordt deze parameter volledig uit de request weggelaten. Alleen geldig voor optionele parameters. Kan niet samen worden gebruikt met description, dynamic_variable, is_system_provided en constant_value. - `allowed_values_dynamic_variable` (string, optional, default: , deprecated) — VEROUDERD: gebruik in plaats daarvan `allowed_values`. Wanneer ingesteld, levert de LLM de waarde, maar weigert de runtime elke waarde die niet voorkomt in de lijst van deze dynamische variabele (moet een JSON-array zijn zoals ["ws_alpha", "ws_beta"]). Gebruik dit om de LLM te laten kiezen uit een door de server geverifieerde set (bijv. de ID's waartoe de huidige gebruiker toegang heeft). Vereist description; kan niet samen met dynamic_variable, is_system_provided, constant_value en is_omitted worden gebruikt. ### QueryParamsJsonSchemaOutput - `properties` (map from string to LiteralJsonSchemaProperty, required) - `required` (list of string, optional) ### ResponseFilter Configuratie voor het filteren van toolresponses voordat ze zichtbaar zijn voor de agent. - `mode` (enum, optional, default: all) — Bepaalt hoe toolresponses worden gefilterd. 'all' retourneert de volledige response, 'allow' retourneert alleen opgegeven paden en 'hide_all' verbergt de volledige response. - Allowed values: `all`, `allow`, `hide_all` - `filters` (list of string, optional) — Paden in puntnotatie die moeten worden opgenomen wanneer de modus 'allow' is (bijvoorbeeld ['ticket.id', 'ticket.status']). - `content_type` ("application/json", optional) — Contenttype voor het filteren van responses. Alleen responses van het type 'application/json' worden gefilterd. ### WebhookToolApiSchemaConfigOutputAuthConnection Optionele authverbinding voor authenticatie bij deze webhook ### ContentThresholdGuardrailThreshold ### CustomGuardrailConfigTriggerAction - `type`: `end_call` - `type`: `retry` - `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?".) — Aangepaste feedback die bij een nieuwe poging na het activeren van een guardrail in de agent wordt ingevoegd. ### LlmLiteralJsonSchemaPropertyType ### AgentConfigOverrideInput - `first_message` (string, optional) — Als dit niet leeg is, het eerste bericht dat de agent uitspreekt. Als het leeg is, wacht de agent tot de gebruiker het gesprek start. - `language` (string, optional) — Taal van de agent - gebruikt voor ASR en TTS - `max_conversation_duration_message` (string, optional) — Als dit niet leeg is, het bericht dat de agent verstuurt wanneer de maximale gespreksduur is bereikt. - `prompt` (PromptAgentApiModelOverrideInput, optional) — De prompt voor de agent ### BuiltInToolsWorkflowOverrideInput - `transfer_to_agent` (SystemToolConfigInput, optional) — De tool voor doorverbinden met een agent - `end_call` (SystemToolConfigInput, optional) — De tool voor het beëindigen van het gesprek - `language_detection` (SystemToolConfigInput, optional) — De taalherkenningstool - `transfer_to_number` (SystemToolConfigInput, optional) — De tool voor doorverbinden met een nummer - `skip_turn` (SystemToolConfigInput, optional) — De tool om een beurt over te slaan - `play_keypad_touch_tone` (SystemToolConfigInput, optional) — De play DTMF-tool - `voicemail_detection` (SystemToolConfigInput, optional) — De tool voor voicemaildetectie ### RagConfigWorkflowOverrideInput - `enabled` (boolean, optional) - `embedding_model` (enum, optional, default: e5_mistral_7b_instruct) - Allowed values: `e5_mistral_7b_instruct`, `multilingual_e5_large_instruct` - `max_vector_distance` (double, optional) — Maximale vectorafstand van opgehaalde chunks. - `max_documents_length` (integer, optional) — Maximale totale lengte van documentchunks die uit RAG worden opgehaald. - `max_retrieved_rag_chunks_count` (integer, optional) — Maximumaantal RAG-documentchunks dat aanvankelijk uit de vectorstore moet worden opgehaald. Deze worden vervolgens verder gefilterd op vectorafstand en totale lengte. - `num_candidates` (integer, optional) — Aantal kandidaten dat wordt geëvalueerd bij ANN-vectorzoeken. Een hoger aantal betekent betere resultaten, maar ook hogere latentie. De minimaal aanbevolen waarde is 100. Als dit is uitgeschakeld, wordt de standaardwaarde gebruikt. - `query_rewrite_prompt_override` (string, optional) — Aangepaste prompt om gebruikersquery's te herschrijven vóór RAG-ophaling. De conversatiegeschiedenis wordt automatisch aan het einde toegevoegd. Als dit niet is ingesteld, wordt de standaardprompt gebruikt. - `knowledge_base_tool_info` (KnowledgeBaseToolInfo, optional) — Wanneer ingesteld, gebruikt de agent de tool knowledge_base in plaats van de verouderde tool knowledge_base_rag. None betekent dat de agent niet is aangemeld. ### PromptAgentApiModelWorkflowOverrideInputBackupLlmConfig Configuratie voor cascade van back-up-LLM's. Kan worden uitgeschakeld, systeemstandaarden gebruiken of een aangepaste volgorde opgeven. ### PromptAgentApiModelWorkflowOverrideInputToolsItem Het type tool - `type`: `api_integration_webhook` - `api_integration_connection_id` (string, required) - `api_integration_id` (string, required) - `description` (string, required) — Beschrijving van wanneer de tool moet worden gebruikt en wat deze doet. - `name` (string, required) - `api_schema_overrides` (ApiIntegrationWebhookOverrides, optional) — Gebruikersoverschrijvingen die boven op de basis-api_schema worden toegepast - `assignments` (list of DynamicVariableAssignment, optional) — Configuratie voor het extraheren van waarden uit toolresponses en deze toewijzen aan dynamische variabelen - `dynamic_variables` (DynamicVariablesConfig, optional) — Configuratie voor dynamische variabelen - `execution_mode` (enum, optional, default: immediate) — Bepaalt wanneer en hoe de tool wordt uitgevoerd: 'immediate' voert de tool direct uit wanneer de LLM hierom vraagt, 'post_tool_speech' wacht tot de agent is uitgesproken voordat de tool wordt uitgevoerd en 'async' voert de tool op de achtergrond uit zonder te blokkeren - het beste voor langlopende bewerkingen. - Allowed values: `immediate`, `post_tool_speech`, `async` - `interruption_mode` (enum, optional, default: allow) — Bepaalt of de gebruiker de agent tijdens deze toolaanroep kan onderbreken. 'allow' (standaard) staat de gebruiker toe om op elk moment te onderbreken, 'disable_during_tool' onderdrukt onderbrekingen alleen terwijl de tool actief is en 'disable_during_tool_and_turn' onderdrukt onderbrekingen terwijl de tool actief is en tijdens de daaropvolgende reactie van de agent. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Bepaalt of de agent spreekt voordat deze tool wordt aangeroepen. 'auto' (standaard) beslist op basis van recente toollatency, 'force' laat de agent altijd spreken en 'off' schakelt dit volledig uit, ongeacht de latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — De maximale wachttijd in seconden tot de toolcall is voltooid. Moet tussen 5 en 300 seconden liggen (inclusief). - `tool_call_sound` (enum, optional) — Vooraf gedefinieerd type tool-callgeluid dat tijdens het uitvoeren van een tool wordt afgespeeld. Als dit niet is opgegeven, wordt er geen tool-callgeluid afgespeeld. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Bepaalt wanneer het geluid voor de toolaanroep moet worden afgespeeld. 'auto' speelt alleen af als er spraak vóór de tool is, 'always' speelt af bij elke toolaanroep. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Bepaalt hoe toolfouten worden verwerkt voordat ze met de agent worden gedeeld. 'auto' bepaalt de afhandeling op basis van het tooltype (samengevat voor native integraties, verbergen voor andere), 'summarized' stuurt een door een LLM gegenereerde samenvatting, 'passthrough' stuurt de onbewerkte fout en 'hide' deelt de fout niet met de agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `tool_version` (string, optional, default: 1.0.0) — De versie van de API-integratietool - `disable_interruptions` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `interruption_mode`. Als dit true is, kan de gebruiker de agent niet onderbreken terwijl deze tool wordt uitgevoerd. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `pre_tool_speech`. Als dit waar is, spreekt de agent vóór de toolaanroep. - `type`: `client` - `description` (string, required) — Beschrijving van wanneer de tool moet worden gebruikt en wat deze doet. - `name` (string, required) - `assignments` (list of DynamicVariableAssignment, optional) — Configuratie voor het extraheren van waarden uit toolresponses en deze toewijzen aan dynamische variabelen - `dynamic_variables` (DynamicVariablesConfig, optional) — Configuratie voor dynamische variabelen - `execution_mode` (enum, optional, default: immediate) — Bepaalt wanneer en hoe de tool wordt uitgevoerd: 'immediate' voert de tool direct uit wanneer de LLM hierom vraagt, 'post_tool_speech' wacht tot de agent is uitgesproken voordat de tool wordt uitgevoerd en 'async' voert de tool op de achtergrond uit zonder te blokkeren - het beste voor langlopende bewerkingen. - Allowed values: `immediate`, `post_tool_speech`, `async` - `expects_response` (boolean, optional, default: false) — Als true, moet het aanroepen van deze tool het gesprek blokkeren totdat de client reageert met een reactie die aan het LLM wordt doorgegeven. Als false, zetten we het gesprek voort zonder op een reactie van de client te wachten. Dit is nuttig om content aan een gebruiker te tonen zonder het gesprek te blokkeren. - `interruption_mode` (enum, optional, default: allow) — Bepaalt of de gebruiker de agent tijdens deze toolaanroep kan onderbreken. 'allow' (standaard) staat de gebruiker toe om op elk moment te onderbreken, 'disable_during_tool' onderdrukt onderbrekingen alleen terwijl de tool actief is en 'disable_during_tool_and_turn' onderdrukt onderbrekingen terwijl de tool actief is en tijdens de daaropvolgende reactie van de agent. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `parameters` (ObjectJsonSchemaPropertyInput, optional) — Schema voor alle parameters die aan de client moeten worden doorgegeven - `pre_tool_speech` (enum, optional, default: auto) — Bepaalt of de agent spreekt voordat deze tool wordt aangeroepen. 'auto' (standaard) beslist op basis van recente toollatency, 'force' laat de agent altijd spreken en 'off' schakelt dit volledig uit, ongeacht de latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — De maximale wachttijd in seconden tot de toolcall is voltooid. Moet tussen 1 en 120 seconden liggen (inclusief), of -1 om onbeperkt op de reactie van de client te wachten (vereist expects_response). - `tool_call_sound` (enum, optional) — Vooraf gedefinieerd type tool-callgeluid dat tijdens het uitvoeren van een tool wordt afgespeeld. Als dit niet is opgegeven, wordt er geen tool-callgeluid afgespeeld. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Bepaalt wanneer het geluid voor de toolaanroep moet worden afgespeeld. 'auto' speelt alleen af als er spraak vóór de tool is, 'always' speelt af bij elke toolaanroep. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Bepaalt hoe toolfouten worden verwerkt voordat ze met de agent worden gedeeld. 'auto' bepaalt de afhandeling op basis van het tooltype (samengevat voor native integraties, verbergen voor andere), 'summarized' stuurt een door een LLM gegenereerde samenvatting, 'passthrough' stuurt de onbewerkte fout en 'hide' deelt de fout niet met de agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `interruption_mode`. Als dit true is, kan de gebruiker de agent niet onderbreken terwijl deze tool wordt uitgevoerd. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `pre_tool_speech`. Als dit waar is, spreekt de agent vóór de toolaanroep. - `type`: `mcp` - `value` (any, required) - `type`: `smb` - `value` (any, required) - `type`: `system` - `name` (string, required) - `params` (SystemToolConfigInputParams, required) - `assignments` (list of DynamicVariableAssignment, optional) — Configuratie voor het extraheren van waarden uit toolresponses en deze toewijzen aan dynamische variabelen - `description` (string, optional, default: ) — Beschrijving van wanneer de tool moet worden gebruikt en wat deze doet. Laat leeg om de standaardbeschrijving te gebruiken, die is geoptimaliseerd voor het specifieke tooltype. - `interruption_mode` (enum, optional, default: allow) — Bepaalt of de gebruiker de agent tijdens deze toolaanroep kan onderbreken. 'allow' (standaard) staat de gebruiker toe om op elk moment te onderbreken, 'disable_during_tool' onderdrukt onderbrekingen alleen terwijl de tool actief is en 'disable_during_tool_and_turn' onderdrukt onderbrekingen terwijl de tool actief is en tijdens de daaropvolgende reactie van de agent. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Bepaalt of de agent spreekt voordat deze tool wordt aangeroepen. 'auto' (standaard) beslist op basis van recente toollatency, 'force' laat de agent altijd spreken en 'off' schakelt dit volledig uit, ongeacht de latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — De maximale wachttijd in seconden tot de toolcall is voltooid. - `tool_call_sound` (enum, optional) — Vooraf gedefinieerd type tool-callgeluid dat tijdens het uitvoeren van een tool wordt afgespeeld. Als dit niet is opgegeven, wordt er geen tool-callgeluid afgespeeld. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Bepaalt wanneer het geluid voor de toolaanroep moet worden afgespeeld. 'auto' speelt alleen af als er spraak vóór de tool is, 'always' speelt af bij elke toolaanroep. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Bepaalt hoe toolfouten worden verwerkt voordat ze met de agent worden gedeeld. 'auto' bepaalt de afhandeling op basis van het tooltype (samengevat voor native integraties, verbergen voor andere), 'summarized' stuurt een door een LLM gegenereerde samenvatting, 'passthrough' stuurt de onbewerkte fout en 'hide' deelt de fout niet met de agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `interruption_mode`. Als dit true is, kan de gebruiker de agent niet onderbreken terwijl deze tool wordt uitgevoerd. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `pre_tool_speech`. Als dit waar is, spreekt de agent vóór de toolaanroep. - `type`: `webhook` - `api_schema` (WebhookToolApiSchemaConfigInput, required) — Het schema voor de uitgaande webhook, inclusief parameters en URL-specificatie - `description` (string, required) — Beschrijving van wanneer de tool moet worden gebruikt en wat deze doet. - `name` (string, required) - `assignments` (list of DynamicVariableAssignment, optional) — Configuratie voor het extraheren van waarden uit toolresponses en deze toewijzen aan dynamische variabelen - `dynamic_variables` (DynamicVariablesConfig, optional) — Configuratie voor dynamische variabelen - `execution_mode` (enum, optional, default: immediate) — Bepaalt wanneer en hoe de tool wordt uitgevoerd: 'immediate' voert de tool direct uit wanneer de LLM hierom vraagt, 'post_tool_speech' wacht tot de agent is uitgesproken voordat de tool wordt uitgevoerd en 'async' voert de tool op de achtergrond uit zonder te blokkeren - het beste voor langlopende bewerkingen. - Allowed values: `immediate`, `post_tool_speech`, `async` - `follow_redirects` (boolean, optional, default: false) — Of een redirect vanaf het endpoint moet worden gevolgd en de uiteindelijke response moet worden teruggestuurd. Er wordt één redirect gevolgd, als een GET zonder de requestbody; niets dat voor deze tool is geconfigureerd (headers, authenticatie, clientcertificaat) wordt naar het redirectdoel gestuurd. Zowel het endpoint als het redirectdoel moet HTTPS gebruiken. Niet ondersteund voor API-integratietools. - `follow_redirects_allowed_domains` (list of string, optional) — Domeinen waarnaar een redirect kan verwijzen, bijvoorbeeld 'test.example.com'. Vereist bij het volgen van redirects; een doel buiten de lijst wordt geweigerd. - `interruption_mode` (enum, optional, default: allow) — Bepaalt of de gebruiker de agent tijdens deze toolaanroep kan onderbreken. 'allow' (standaard) staat de gebruiker toe om op elk moment te onderbreken, 'disable_during_tool' onderdrukt onderbrekingen alleen terwijl de tool actief is en 'disable_during_tool_and_turn' onderdrukt onderbrekingen terwijl de tool actief is en tijdens de daaropvolgende reactie van de agent. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Bepaalt of de agent spreekt voordat deze tool wordt aangeroepen. 'auto' (standaard) beslist op basis van recente toollatency, 'force' laat de agent altijd spreken en 'off' schakelt dit volledig uit, ongeacht de latency. - Allowed values: `auto`, `force`, `off` - `response_timeout_secs` (integer, optional, default: 20) — De maximale wachttijd in seconden tot de toolcall is voltooid. Moet tussen 5 en 300 seconden liggen (inclusief). - `tool_call_sound` (enum, optional) — Vooraf gedefinieerd type tool-callgeluid dat tijdens het uitvoeren van een tool wordt afgespeeld. Als dit niet is opgegeven, wordt er geen tool-callgeluid afgespeeld. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Bepaalt wanneer het geluid voor de toolaanroep moet worden afgespeeld. 'auto' speelt alleen af als er spraak vóór de tool is, 'always' speelt af bij elke toolaanroep. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Bepaalt hoe toolfouten worden verwerkt voordat ze met de agent worden gedeeld. 'auto' bepaalt de afhandeling op basis van het tooltype (samengevat voor native integraties, verbergen voor andere), 'summarized' stuurt een door een LLM gegenereerde samenvatting, 'passthrough' stuurt de onbewerkte fout en 'hide' deelt de fout niet met de agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `interruption_mode`. Als dit true is, kan de gebruiker de agent niet onderbreken terwijl deze tool wordt uitgevoerd. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `pre_tool_speech`. Als dit waar is, spreekt de agent vóór de toolaanroep. ### WorkflowToolNestedToolsStepModelOutputResultsItem ### ArrayJsonSchemaPropertyOutput - `description` (string, optional, default: ) - `dynamic_variable` (string, optional, default: ) — Wanneer ingesteld, wordt de volledige parameter tijdens runtime ingevuld vanuit deze dynamische variabele. Kan niet samen worden gebruikt met description (door de LLM aangeleverde waarde), constant_value en is_omitted. - `constant_value` (list of any, optional) — Wanneer ingesteld, gebruikt de volledige array deze constante waarde tijdens runtime. Kan niet samen worden gebruikt met description (door de LLM aangeleverde array), dynamic_variable en is_omitted. - `is_omitted` (boolean, optional, default: false) — Als true is, wordt deze parameter volledig uit de request weggelaten. Alleen geldig voor optionele parameters. Kan niet samen worden gebruikt met description, dynamic_variable en constant_value. - `type` ("array", optional) - `items` (ArrayJsonSchemaPropertyOutputItems, optional) — Schema voor arrayelementen. ### RequiredConstraint Een set velden die allemaal aanwezig moeten zijn om aan deze beperking te voldoen. - `required` (list of string, required) ### ProcedureVersionRef - `procedure_id` (string, required) — Procedure-ID - `version_id` (string, required) — Versie-ID van de procedureversie. ### ProcedureDraftRef - `procedure_id` (string, required) — Procedure-ID - `version_id` (any, optional) ### PhoneNumberTransferTransferDestination - `type`: `phone` - `phone_number` (string, required) - `type`: `phone_dynamic_variable` - `phone_number` (string, required) - `type`: `sip_uri` - `sip_uri` (string, required) - `type`: `sip_uri_dynamic_variable` - `sip_uri` (string, required) ### PhoneNumberTransferCustomSipHeadersItem - `type`: `dynamic` - `key` (string, required) — De naam van de SIP-header (bijvoorbeeld 'X-Customer-ID') - `value` (string, required) — De naam van de dynamische variabele die moet worden opgelost - `type`: `static` - `key` (string, required) — De naam van de SIP-header (bijvoorbeeld 'X-Customer-ID') - `value` (string, required) — De headerwaarde ### PhoneNumberTransferPostDialDigits - `type`: `dynamic` - `value` (string, required) — De naam van de dynamische variabele die moet worden opgelost - `type`: `static` - `value` (string, required) — DTMF-cijfers die moeten worden verzonden nadat de oproep is verbonden (bijvoorbeeld 'ww1234' voor een doorkiesnummer) ### LiteralJsonSchemaPropertyType ### LiteralJsonSchemaPropertyConstantValue Een constante waarde voor deze eigenschap. Kan niet samen worden gebruikt met description, dynamic_variable, is_system_provided en is_omitted. ### PromptAgentApiModelOverrideInput - `prompt` (string, optional) — De prompt voor de agent - `llm` (enum, optional) — De LLM die met de prompt en de chatgeschiedenis moet worden bevraagd. Bij gebruik van dataresidency moet de LLM worden ondersteund in de dataresidencyomgeving. - 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`, `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) — Een lijst met ID's van tools die door de agent worden gebruikt - `tool_ids_strict` (boolean, optional) — Alleen van toepassing als overschrijving voor een gesprek en toegestaan wanneer tool_ids mag worden overschreven. Wanneer true is, bevat de overschreven tool_ids de volledige lijst met tools die in het gesprek zijn toegestaan, inclusief tools op workflownodes. Genegeerd wanneer ingesteld op de agent. - `native_mcp_server_ids` (list of string, optional) — Een lijst met Native MCP-server-id's die door de agent moeten worden gebruikt - `knowledge_base` (list of KnowledgeBaseLocator, optional) — Een lijst met kennisbanken die door de agent moeten worden gebruikt ### SystemToolConfigInput Een systeemtool is een tool die wordt gebruikt om een systeemmethode op de server aan te roepen - `name` (string, required) - `params` (SystemToolConfigInputParams, required) - `type` ("system", optional) — Het type tool - `description` (string, optional, default: ) — Beschrijving van wanneer de tool moet worden gebruikt en wat deze doet. Laat leeg om de standaardbeschrijving te gebruiken, die is geoptimaliseerd voor het specifieke tooltype. - `response_timeout_secs` (integer, optional, default: 20) — De maximale wachttijd in seconden tot de toolcall is voltooid. - `interruption_mode` (enum, optional, default: allow) — Bepaalt of de gebruiker de agent tijdens deze toolaanroep kan onderbreken. 'allow' (standaard) staat de gebruiker toe om op elk moment te onderbreken, 'disable_during_tool' onderdrukt onderbrekingen alleen terwijl de tool actief is en 'disable_during_tool_and_turn' onderdrukt onderbrekingen terwijl de tool actief is en tijdens de daaropvolgende reactie van de agent. - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn` - `pre_tool_speech` (enum, optional, default: auto) — Bepaalt of de agent spreekt voordat deze tool wordt aangeroepen. 'auto' (standaard) beslist op basis van recente toollatency, 'force' laat de agent altijd spreken en 'off' schakelt dit volledig uit, ongeacht de latency. - Allowed values: `auto`, `force`, `off` - `assignments` (list of DynamicVariableAssignment, optional) — Configuratie voor het extraheren van waarden uit toolresponses en deze toewijzen aan dynamische variabelen - `tool_call_sound` (enum, optional) — Vooraf gedefinieerd type tool-callgeluid dat tijdens het uitvoeren van een tool wordt afgespeeld. Als dit niet is opgegeven, wordt er geen tool-callgeluid afgespeeld. - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4` - `tool_call_sound_behavior` (enum, optional, default: auto) — Bepaalt wanneer het geluid voor de toolaanroep moet worden afgespeeld. 'auto' speelt alleen af als er spraak vóór de tool is, 'always' speelt af bij elke toolaanroep. - Allowed values: `auto`, `always` - `tool_error_handling_mode` (enum, optional, default: auto) — Bepaalt hoe toolfouten worden verwerkt voordat ze met de agent worden gedeeld. 'auto' bepaalt de afhandeling op basis van het tooltype (samengevat voor native integraties, verbergen voor andere), 'summarized' stuurt een door een LLM gegenereerde samenvatting, 'passthrough' stuurt de onbewerkte fout en 'hide' deelt de fout niet met de agent. - Allowed values: `auto`, `summarized`, `passthrough`, `hide` - `disable_interruptions` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `interruption_mode`. Als dit true is, kan de gebruiker de agent niet onderbreken terwijl deze tool wordt uitgevoerd. - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — VEROUDERD: gebruik in plaats daarvan `pre_tool_speech`. Als dit waar is, spreekt de agent vóór de toolaanroep. ### BackupLlmDefault - `preference` ("default", optional) ### BackupLlmDisabled - `preference` ("disabled", optional) ### 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`, `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` - `preference` ("override", optional) ### ObjectJsonSchemaPropertyInput - `property_kind` (enum, optional, default: object) - Allowed values: `array`, `object` - `description` (string, optional, default: ) - `dynamic_variable` (string, optional, default: ) — Wanneer ingesteld, wordt de volledige parameter tijdens runtime ingevuld vanuit deze dynamische variabele. Kan niet samen worden gebruikt met description (door de LLM aangeleverde waarde), constant_value en is_omitted. - `constant_value` (map from string to any, optional) — Wanneer ingesteld, gebruikt het volledige object deze constante JSON-waarde tijdens runtime. Kan niet samen worden gebruikt met description (door de LLM aangeleverd object), dynamic_variable en is_omitted. - `is_omitted` (boolean, optional, default: false) — Als true is, wordt deze parameter volledig uit de request weggelaten. Alleen geldig voor optionele parameters. Kan niet samen worden gebruikt met description, dynamic_variable en constant_value. - `type` ("object", optional) - `required` (list of string, optional) - `properties` (map from string to ObjectJsonSchemaPropertyInputPropertiesValue, optional) - `required_constraints` (RequiredConstraints, optional) — Wrapper voor anyOf/allOf-compositiebeperkingen die gelden voor verplichte velden. ### SystemToolConfigInputParams - `system_tool_type`: `end_call` - `system_tool_type`: `end_procedure` - `procedures` (map from string to EndProcedureToolConfigProceduresValue, optional) - `system_tool_type`: `knowledge_base` - `enabled_strategies` (list of enum, optional) - Allowed values: `cat`, `keyword`, `semantic`, `ls` - `system_tool_type`: `knowledge_base_rag` - `system_tool_type`: `language_detection` - `only_at_conversation_start` (boolean, optional, default: false) — Als er in de eerste 2 gebruikersbeurten geen taalwissel plaatsvindt, mislukken latere pogingen en blijft het gesprek in de huidige taal. Als de taal tijdens die beurten wisselt, blijft later wisselen mogelijk. Schakel dit in om de kans op onjuiste taalwisselingen te verkleinen. - `system_tool_type`: `play_keypad_touch_tone` - `suppress_turn_after_dtmf` (boolean, optional, default: false) — Als true, genereert de agent geen verdere spraak nadat DTMF-tonen zijn afgespeeld. Dit voorkomt dat de spraak van de agent IVR-systemen verstoort. - `use_out_of_band_dtmf` (boolean, optional, default: true) — Verstuur DTMF-tonen als out-of-band RTP-events (RFC 4733) in plaats van als in-band audio. Alleen effectief voor nummers die via een SIP trunk zijn geïmporteerd. - `system_tool_type`: `skip_turn` - `wait_timeout_secs` (double, optional, default: -1) — Seconden om na skip_turn te wachten voordat de agent een contextuele check-in genereert. De timer "Gesprek beëindigen na stilte" wordt tijdens het wachten gepauzeerd. -1 schakelt het wachten uit: na skip_turn blijft de agent stil totdat de beller spreekt, terwijl die timer blijft lopen. Alleen van toepassing op spraakgesprekken. - `system_tool_type`: `start_procedure` - `procedures` (map from string to StartProcedureToolConfigProceduresValue, optional) - `system_tool_type`: `transfer_to_agent` - `transfers` (list of AgentTransferInput, required) - `system_tool_type`: `transfer_to_number` - `transfers` (list of PhoneNumberTransfer, required) - `enable_client_message` (boolean, optional, default: true) — Of er een bericht voor de klant moet worden afgespeeld terwijl die op overdracht wacht. Standaard is dit true voor achterwaartse compatibiliteit. - `system_tool_type`: `voicemail_detection` - `voicemail_message` (string, optional) — Optioneel bericht om achter te laten op de voicemail wanneer deze wordt gedetecteerd. Als dit niet wordt opgegeven, wordt het gesprek onmiddellijk beëindigd wanneer voicemail wordt gedetecteerd. Ondersteunt dynamische variabelen (bijv. \{\{system\_\_time}}, \{\{system\_\_call\_duration\_secs}}, \{\{custom\_variable}}). ### WebhookToolApiSchemaConfigInput - `url` (string, required) — De URL waarnaar de webhook wordt verzonden. Kan path parameters bevatten, bijvoorbeeld [https://example.com/agents/\{agent\_id}](https://example.com/agents/\{agent_id}) - `request_headers` (map from string to WebhookToolApiSchemaConfigInputRequestHeadersValue, optional) — Headers die in de aanvraag moeten worden opgenomen - `method` (enum, optional, default: GET) — De HTTP-methode die voor de webhook moet worden gebruikt - Allowed values: `GET`, `POST`, `PUT`, `PATCH`, `DELETE` - `path_params_schema` (map from string to LiteralJsonSchemaProperty, optional) — Schema voor eventuele padparameters. De sleutels moeten overeenkomen met de placeholders in de URL. - `query_params_schema` (QueryParamsJsonSchemaInput, optional) — Schema voor eventuele queryparameters. Deze worden als queryparameters aan het einde van de URL toegevoegd. Let op: eigenschappen in een queryparameter moeten allemaal letterlijke typen zijn - `request_body_schema` (ObjectJsonSchemaPropertyInput, optional) — Schema voor eventuele bodyparameters. Wordt gebruikt voor POST/PATCH/PUT-requests. Het schema moet een object zijn dat als JSON-body wordt verzonden - `response_body_schema` (ObjectJsonSchemaPropertyInput, optional) — Schema dat de verwachte structuur van de responsebody beschrijft. Alleen voor documentatie; niet beschikbaar voor de LLM. - `response_filter` (ResponseFilter, optional) — Optioneel allowlistfilter dat op het antwoord wordt toegepast voordat de LLM het ziet, zodat grote antwoorden de context niet vervuilen. Standaard wordt het volledige antwoord gebruikt. - `content_type` (enum, optional, default: application/json) — Contenttype voor de requestbody. Alleen van toepassing op POST/PUT/PATCH-requests. - Allowed values: `application/json`, `application/x-www-form-urlencoded` - `auth_resolved_params` (list of string, optional) — URL-placeholders die worden opgelost vanuit de auth connection (bijvoorbeeld geheimen die via UrlSecretAuthConnection worden ingevoegd) in plaats van vanuit path_params_schema. - `auth_connection` (WebhookToolApiSchemaConfigInputAuthConnection, optional) — Optionele authverbinding voor authenticatie bij deze webhook ### ArrayJsonSchemaPropertyOutputItems Schema voor arrayelementen. ### ObjectJsonSchemaPropertyInputPropertiesValue ### AgentTransferInput - `condition` (string, required) - `agent_id` (string, optional) - `branch_id` (string, optional) - `node_id` (string, optional) - `delay_ms` (integer, optional, default: 0) - `transfer_message` (string, optional) - `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) — Definieert of TTS-clientoverschrijvingen moeten worden overgedragen naar de doorverbonden agent. - `preserve_voice_settings` (boolean, optional, default: false) — Definieert of de basisstem, het TTS-model en de steminstellingen moeten worden overgedragen naar de doorverbonden agent. ### WebhookToolApiSchemaConfigInputRequestHeadersValue ### QueryParamsJsonSchemaInput - `properties` (map from string to LiteralJsonSchemaProperty, required) - `required` (list of string, optional) ### WebhookToolApiSchemaConfigInputAuthConnection Optionele authverbinding voor authenticatie bij deze webhook ### ArrayJsonSchemaPropertyInput - `property_kind` (enum, optional, default: array) - Allowed values: `array`, `object` - `description` (string, optional, default: ) - `dynamic_variable` (string, optional, default: ) — Wanneer ingesteld, wordt de volledige parameter tijdens runtime ingevuld vanuit deze dynamische variabele. Kan niet samen worden gebruikt met description (door de LLM aangeleverde waarde), constant_value en is_omitted. - `constant_value` (list of any, optional) — Wanneer ingesteld, gebruikt de volledige array deze constante waarde tijdens runtime. Kan niet samen worden gebruikt met description (door de LLM aangeleverde array), dynamic_variable en is_omitted. - `is_omitted` (boolean, optional, default: false) — Als true is, wordt deze parameter volledig uit de request weggelaten. Alleen geldig voor optionele parameters. Kan niet samen worden gebruikt met description, dynamic_variable en constant_value. - `type` ("array", optional) - `items` (ArrayJsonSchemaPropertyInputItems, optional) — Schema voor arrayelementen. ### ArrayJsonSchemaPropertyInputItems Schema voor arrayelementen. ## Examples **Request** ```json { "tests": [ { "test_id": "test_id" } ] } ``` **Response** ```json { "id": "id", "test_runs": [ { "test_run_id": "test_run_id", "test_invocation_id": "test_invocation_id", "agent_id": "agent_id", "status": "pending", "test_id": "test_id", "test_info": { "type": "llm" }, "branch_id": "branch_id", "version_id": "version_id", "ran_against_draft": true, "workflow_node_id": "workflow_node_id", "agent_responses": [ { "role": "user", "time_in_call_secs": 1 } ], "test_name": "test_name", "condition_result": { "result": "success" }, "last_updated_at_unix": 1, "metadata": { "workspace_id": "workspace_id", "test_name": "test_name", "ran_by_user_email": "ran_by_user_email" }, "root_folder_id": "root_folder_id", "root_folder_name": "root_folder_name", "environment": "environment", "credits_used": 1 } ], "agent_id": "agent_id", "branch_id": "branch_id", "version_id": "version_id", "ran_against_draft": true, "created_at": 1, "folder_id": "folder_id", "repeat_count": 1, "cancelled": true, "bucketing_status": "pending", "result_groups": [ { "test_id": "test_id", "test_name": "test_name", "buckets": [ { "test_run_ids": [ "test_run_ids" ], "title": "title", "reason": "reason", "status": "pending" } ], "workflow_node_id": "workflow_node_id" } ] } ``` **SDK Code** ```python import requests url = "https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/run-tests" payload = { "tests": [{ "test_id": "test_id" }] } 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/agent_3701k3ttaq12ewp8b7qv5rfyszkz/run-tests'; const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"tests":[{"test_id":"test_id"}]}' }; 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/agent_3701k3ttaq12ewp8b7qv5rfyszkz/run-tests" payload := strings.NewReader("{\n \"tests\": [\n {\n \"test_id\": \"test_id\"\n }\n ]\n}") 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/agent_3701k3ttaq12ewp8b7qv5rfyszkz/run-tests") 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 = "{\n \"tests\": [\n {\n \"test_id\": \"test_id\"\n }\n ]\n}" 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/agent_3701k3ttaq12ewp8b7qv5rfyszkz/run-tests") .header("Content-Type", "application/json") .body("{\n \"tests\": [\n {\n \"test_id\": \"test_id\"\n }\n ]\n}") .asString(); ``` ```php request('POST', 'https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/run-tests', [ 'body' => '{ "tests": [ { "test_id": "test_id" } ] }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/run-tests"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"tests\": [\n {\n \"test_id\": \"test_id\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "application/json"] let parameters = ["tests": [["test_id": "test_id"]]] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/run-tests")! 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() ```