> 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.

# Créer un agent

POST https://api.elevenlabs.io/v1/convai/agents/create
Content-Type: application/json

Crée un agent à partir d'un objet de configuration

Reference: https://elevenlabs.io/docs/eleven-agents/api-reference/agents/create

## Servers

- `https://api.elevenlabs.io` (Production, default)
- `https://api.us.elevenlabs.io` (Production US)
- `https://api.eu.residency.elevenlabs.io` (Production EU)
- `https://api.in.residency.elevenlabs.io` (Production India)
- `https://api.sg.residency.elevenlabs.io` (Production Singapore)

## Request

### Query parameters

- `enable_versioning` (boolean, optional, default: true, deprecated) — Obsolète : tous les agents sont versionnés. Ce paramètre est ignoré.

### Body (application/json)

This endpoint expects an object.

- `conversation_config` (ConversationalConfig, required) — Configuration de conversation pour un agent
- `platform_settings` (AgentPlatformSettingsRequestModel, optional) — Les paramètres de plateforme de l’agent regroupent tous les paramètres qui ne concernent pas l’orchestration ni le contenu des conversations.
- `workflow` (AgentWorkflowRequestModel, optional) — Workflow de l’agent. Il permet de définir le déroulement de la conversation et la façon dont l’agent interagit avec les outils.
- `name` (string, optional) — Un nom pour faciliter la recherche de l'agent
- `tags` (list of string, optional) — Étiquettes pour classer et filtrer l’agent

## Response

### 200

Réponse réussie

- `agent_id` (string, required) — ID de l’agent créé

## Errors

### 422 Agents Create Request Unprocessable Entity Error

Erreur de validation

- `detail` (list of ValidationError, optional)

## Types

### ConversationalConfig

- `asr` (AsrConversationalConfig, optional) — Configuration de la transcription conversationnelle
- `turn` (TurnConfig, optional) — Configuration de la détection des tours de parole
- `tts` (TtsConversationalConfigOutput, optional) — Configuration de la synthèse vocale conversationnelle
- `conversation` (ConversationConfigOutput, optional) — Configuration des événements conversationnels
- `language_presets` (map from string to LanguagePresetOutput, optional) — Paramètres prédéfinis de langue pour les conversations
- `vad` (VadConfig, optional) — Configuration de la détection d'activité vocale
- `agent` (AgentConfig, optional) — Configuration spécifique à l'agent

### AgentPlatformSettingsRequestModel

- `evaluation` (EvaluationSettingsInput, optional) — Paramètres d’évaluation
- `widget` (WidgetConfig, optional) — Configuration du widget
- `data_collection` (map from string to AnalysisProperty, optional) — Paramètres de collecte de données
- `data_collection_scopes` (map from string to enum, optional) — Portée par ID d’élément de collecte de données. Les clés manquantes utilisent par défaut la portée de la conversation.
  - Allowed values: `conversation`, `agent`
- `analysis_items` (AgentAnalysisItemsInput, optional) — Éléments d'évaluation et de collecte de données associés par référence. None signifie que l'agent n'a pas encore été migré vers les éléments d'analyse, à distinguer d'un ensemble migré vide ; dans ce cas, les lectures utilisent les champs hérités evaluation/data_collection.
- `overrides` (ConversationInitiationClientDataConfigInput, optional) — Remplacements supplémentaires pour l'agent lors de l'initialisation de la conversation
- `workspace_overrides` (AgentWorkspaceOverridesInput, optional) — Remplacements du Workspace pour l’agent
- `testing` (AgentTestingSettings, optional) — Configuration de test de l’agent
- `archived` (boolean, optional, default: false) — Indique si l’agent est archivé
- `guardrails` (GuardrailsV1Input, optional) — Configuration des garde-fous pour l’agent.
- `summary_language` (string, optional) — Langue de toutes les sorties d'analyse de conversation, y compris les résumés, titres, justifications d'évaluation et justifications de collecte de données. Si elle n'est pas définie, la langue sera déduite de la conversation. Doit faire partie des langues de conversation prises en charge.
- `auto_translate_transcript_to_app_language` (boolean, optional) — Lorsque cette option est activée, une transcription de conversation est automatiquement traduite dans la langue de l’application de la personne qui la consulte lorsqu’elle ouvre la page de transcription. Si elle n’est pas définie ou vaut false, les transcriptions s’affichent dans leur langue d’origine, sauf si la personne sélectionne manuellement une traduction.
- `auth` (AuthSettings, optional) — Paramètres d’authentification
- `call_limits` (AgentCallLimits, optional) — Limites d'appels pour l'agent
- `queueing_config` (AgentQueueingConfig, optional) — Configuration de la file d'attente de requêtes simultanées pour l'agent
- `privacy` (PrivacyConfigInput, optional) — Paramètres de confidentialité de l’agent
- `trust_context` (enum, optional, default: unknown) — Le contexte de confiance dans lequel l’agent opère.
  - Allowed values: `unknown`, `low`, `high`
- `analysis_llm` (enum, optional) — Modèle LLM par défaut pour l'analyse post-appel (évaluation et collecte de données)
  - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`
- `topic_discovery` (TopicDiscoverySettings, optional) — Configuration de la détection de sujets par agent
- `sentiment_analysis` (SentimentAnalysisSettings, optional) — Configuration de l'analyse des sentiments après appel par agent
- `alerting` (AlertingSettings, optional) — Configuration des alertes au niveau de l'agent, remplaçant les paramètres du Workspace.

### AgentWorkflowRequestModel

- `edges` (map from string to WorkflowEdgeModelInput, optional)
- `nodes` (map from string to AgentWorkflowRequestModelNodesValue, optional)
- `prevent_subagent_loops` (boolean, optional, default: false) — Indique s'il faut empêcher les boucles dans l'exécution du workflow.

### ValidationError

- `loc` (list of ValidationErrorLocItem, required)
- `msg` (string, required)
- `type` (string, required)

### AsrConversationalConfig

- `quality` ("high", optional) — La qualité de la transcription
- `provider` (enum, optional, default: scribe_realtime) — Le fournisseur du service de transcription
  - Allowed values: `elevenlabs`, `scribe_realtime`, `scribe_v2_turbo`
- `user_input_audio_format` (enum, optional, default: pcm_16000) — Le format de l’audio à transcrire
  - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000`
- `keywords` (list of string, optional) — Mots-clés dont la probabilité de prédiction doit être augmentée

### TurnConfig

- `turn_timeout` (double, optional, default: 7) — Temps d’attente maximal de la réponse de l’utilisateur avant de le solliciter à nouveau
- `initial_wait_time` (double, optional) — How long the agent will wait for the user to start the conversation if the first message is empty. If not set, uses the regular turn_timeout.
- `silence_end_call_timeout` (double, optional, default: -1) — Temps d’attente maximal depuis la dernière intervention de l’utilisateur avant de mettre fin à l’appel
- `turn_eagerness` (enum, optional, default: normal) — Contrôle la réactivité de l'agent. Faible = moins réactif (attend davantage), Standard = réactivité par défaut, Élevé = plus réactif (répond plus rapidement)
  - Allowed values: `patient`, `normal`, `eager`
- `spelling_patience` (enum, optional, default: auto) — Détermine si l'agent doit attendre davantage lorsque l'utilisateur épelle des nombres et des entités nommées. Auto = selon le modèle, Off = ne jamais attendre davantage
  - Allowed values: `auto`, `off`
- `speculative_turn` (boolean, optional, default: false) — Lorsque cette option est activée, la génération des réponses du LLM commence pendant le silence, avant que la confiance totale du tour de parole soit atteinte, afin de réduire la latence perçue. Peut augmenter les coûts du LLM.
- `retranscribe_on_turn_timeout` (boolean, optional, default: false) — Lorsqu’elle est activée, si la VAD ne détecte aucune parole, tente de retranscrire l’audio accumulé à l’expiration du délai du tour. Désactive la facturation avec réduction pour les silences tant qu’elle est activée pour l’agent ou le nœud de workflow actif.
- `turn_model` (enum, optional, default: turn_v3) — Version du modèle de détection des tours de parole à utiliser.
  - Allowed values: `turn_v2`, `turn_v3`
- `interruption_ignore_terms` (list of string, optional) — Liste des termes qui ne doivent pas déclencher d'interruption lorsqu'ils sont prononcés par l'utilisateur, par exemple « gotcha » ou « understood ». Utilise une correspondance exacte insensible à la casse.
- `interruption_ignore_term_languages` (list of string, optional) — Codes de langue pour lesquels des catégories prédéfinies de termes à ignorer ont été activées. Ils sont stockés explicitement afin que l'affichage ne soit pas déduit du chevauchement des termes.
- `merge_with_default_ignore_terms` (boolean, optional, default: false) — Lorsque cette option est activée, les termes par défaut sélectionnés pour interruption_ignore_term_languages sont utilisés en plus de interruption_ignore_terms.
- `transcribe_on_disabled_interruptions` (boolean, optional, default: false) — Lorsque les interruptions sont désactivées, transcrit tout de même ce que dit l’utilisateur afin de le reporter au tour suivant. Lorsque cette option est désactivée, la parole de l’utilisateur pendant un tour non interruptible est ignorée et ne déclenche pas de tour de parole.
- `soft_timeout_config` (SoftTimeoutConfig, optional) — Configuration de la fonctionnalité de délai d'expiration souple. Fournit un retour immédiat pendant les réponses plus longues des LLM.

### TtsConversationalConfigOutput

- `model_id` (enum, optional, default: eleven_v4_turbo) — Le modèle à utiliser pour le TTS
  - 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) — L’ID de voix à utiliser pour le TTS
- `supported_voices` (list of SupportedVoice, optional) — Voix supplémentaires prises en charge pour l'agent
- `expressive_mode` (boolean, optional, default: true) — Lorsque cette option est activée, applique le prompt de balises audio expressives. Elle est automatiquement désactivée pour les modèles autres que v3.
- `suggested_audio_tags` (list of SuggestedAudioTag, optional) — Suggested audio tags to boost expressive speech (for eleven_v3 and eleven_v3_conversational models). The agent can still use other tags not listed here.
- `agent_output_audio_format` (enum, optional, default: pcm_16000) — Format audio à utiliser pour le TTS
  - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000`
- `optimize_streaming_latency` (integer, optional) — Obsolète : ce champ n'a aucun effet et est ignoré.
- `stability` (double, optional, default: 0.5) — La stabilité de la parole générée
- `speed` (double, optional, default: 1) — La vitesse de la parole générée
- `similarity_boost` (double, optional, default: 0.8) — L'amélioration de similarité pour la parole générée
- `text_normalisation_type` (enum, optional, default: system_prompt) — Méthode de conversion des nombres en mots avant la synthèse vocale. Si elle est définie sur SYSTEM_PROMPT, le prompt système est mis à jour pour inclure des instructions de normalisation. Si elle est définie sur ELEVENLABS, le texte est normalisé après la génération, ce qui entraîne une légère latence supplémentaire.
  - Allowed values: `system_prompt`, `elevenlabs`
- `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional) — Les localisateurs de dictionnaires de prononciation
- `enable_phoneme_tags` (boolean, optional, default: true) — Active la gestion des balises de phonèmes SSML pour les modèles V3. Lorsqu'elle est activée, les balises de phonèmes, en ligne et issues des dictionnaires de prononciation, sont analysées en API en ligne avant d'être envoyées au modèle.
- `audio_effects` (EffectsSpecOutput, optional) — Spécification facultative des effets TTS : préréglage de filtre, distance (égalisation de proximité) et environnement (réverbération par convolution).

### ConversationConfigOutput

- `text_only` (boolean, optional, default: false) — Si cette option est activée, l’audio ne sera pas traité et seul le texte sera utilisé, afin d’éviter la tarification audio.
- `max_duration_seconds` (integer, optional, default: 600) — La durée maximale d’une conversation, en secondes
- `client_events` (list of enum, optional) — Les événements qui seront envoyés au client
  - 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) — Configuration des entrées de fichiers (chargements d'images/PDF) pendant les conversations.
- `monitoring_enabled` (boolean, optional, default: false) — Active la surveillance des conversations en temps réel via WebSocket
- `monitoring_events` (list of enum, optional) — Les événements qui seront envoyés aux connexions de surveillance.
  - 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) — Configurez la collecte de saisies DTMF (clavier téléphonique) pendant les appels
- `background_sound` (BackgroundSoundConfig, optional) — Configuration du son d'arrière-plan durant les conversations.
- `source_attribution` (boolean, optional, default: false) — Lorsque cette option est activée et que la base de connaissances contient du contenu, le LLM reçoit l’instruction d’indiquer les sources qu’il a utilisées.

### LanguagePresetOutput

- `overrides` (ConversationConfigClientOverrideOutput, required) — Les remplacements du préréglage linguistique
- `first_message_translation` (LanguagePresetTranslation, optional) — La traduction du premier message.
- `soft_timeout_translation` (LanguagePresetTranslation, optional) — La traduction du message de délai d’expiration souple.

### VadConfig

### AgentConfig

- `first_message` (string, optional, default: ) — S’il n’est pas vide, premier message que l’agent prononcera. S’il est vide, l’agent attend que l’utilisateur commence la discussion.
- `language` (string, optional, default: en) — Langue de l'agent, utilisée pour l'ASR et le TTS
- `hinglish_mode` (boolean, optional, default: false) — Lorsqu’elle est activée, l’agent intègre des mots et des expressions en anglais dans les réponses en hindi, en malayalam, en télougou ou en kannada.
- `dynamic_variables` (any, optional)
- `disable_first_message_interruptions` (boolean, optional, default: false) — Si true, l’utilisateur ne pourra pas interrompre l’agent pendant la diffusion du premier message.
- `max_conversation_duration_message` (string, optional, default: ) — S’il n’est pas vide, message que l’agent enverra lorsque la durée maximale de la conversation sera atteinte.
- `text_behavior_overrides` (map from string to BehaviorOverride, optional) — Remplacements du comportement de réponse par canal pour les conversations textuelles. Les valeurs par défaut intégrées au canal s’appliquent lorsqu’aucune valeur n’est définie.
- `prompt` (PromptAgentApiModelOutput, optional) — Le prompt de l’agent

### EvaluationSettingsInput

Paramètres permettant d’évaluer les performances d’un agent. Les agents sont évalués selon un ensemble de critères. La réussite est définie par le respect d’une combinaison de ces critères.

- `criteria` (list of PromptEvaluationCriteria, optional) — Critères individuels selon lesquels l’agent doit être évalué

### WidgetConfig

- `variant` (enum, optional, default: full) — La variante du widget
  - Allowed values: `tiny`, `compact`, `full`, `expandable`
- `placement` (enum, optional, default: bottom-right) — Le positionnement du widget à l’écran
  - Allowed values: `top-left`, `top`, `top-right`, `bottom-left`, `bottom`, `bottom-right`
- `expandable` (enum, optional, default: never) — Indique si le widget peut être développé
  - Allowed values: `never`, `mobile`, `desktop`, `always`
- `avatar` (WidgetConfigAvatar, optional) — Avatar du widget
- `feedback_mode` (enum, optional, default: none) — Le mode de retour du widget
  - Allowed values: `none`, `during`, `end`
- `end_feedback` (WidgetEndFeedbackConfig, optional) — Configuration des retours recueillis à la fin de la conversation
- `bg_color` (string, optional, default: #ffffff) — Couleur d’arrière-plan du widget
- `text_color` (string, optional, default: #000000) — La couleur du texte du widget.
- `btn_color` (string, optional, default: #000000) — Couleur du bouton du widget
- `btn_text_color` (string, optional, default: #ffffff) — Couleur du texte du bouton du widget
- `border_color` (string, optional, default: #e1e1e1) — Couleur de bordure du widget
- `focus_color` (string, optional, default: #000000) — La couleur de focus du widget
- `border_radius` (integer, optional) — Rayon de bordure du widget
- `btn_radius` (integer, optional) — Rayon du bouton du widget
- `action_text` (string, optional) — Texte d’action du widget
- `start_call_text` (string, optional) — Le texte de démarrage d'appel du widget
- `end_call_text` (string, optional) — Le texte de fin d’appel du widget
- `expand_text` (string, optional) — Le texte de développement du widget
- `listening_text` (string, optional) — Le texte à afficher lorsque l’agent écoute.
- `speaking_text` (string, optional) — Le texte à afficher lorsque l’agent parle.
- `shareable_page_text` (string, optional) — Le texte à afficher lors du partage.
- `shareable_page_show_terms` (boolean, optional, default: true) — Indique s'il faut afficher les conditions générales sur la page partageable.
- `terms_text` (string, optional) — Le texte à afficher pour les conditions générales.
- `terms_html` (string, optional) — Le HTML à afficher pour les conditions générales
- `terms_key` (string, optional) — La clé à afficher pour les conditions générales
- `show_avatar_when_collapsed` (boolean, optional) — Indique s'il faut afficher l'avatar lorsque le widget est réduit.
- `disable_banner` (boolean, optional, default: false) — Indique s'il faut désactiver la bannière.
- `override_link` (string, optional) — Le lien de remplacement du widget
- `markdown_link_allowed_hosts` (list of AllowlistItem, optional) — Liste des noms d'hôte autorisés pour les liens Markdown cliquables. Utilisez \{ hostname: '\*' } pour autoriser tous les domaines. Une liste vide signifie qu'aucun lien n'est autorisé.
- `markdown_link_include_www` (boolean, optional, default: true) — Indique s'il faut inclure automatiquement les variantes www. des hôtes autorisés.
- `markdown_link_allow_http` (boolean, optional, default: true) — Indique s’il faut autoriser http:// en plus de https:// pour les hôtes autorisés
- `mic_muting_enabled` (boolean, optional, default: true) — Indique s'il faut activer la mise en sourdine du microphone.
- `transcript_enabled` (boolean, optional, default: true) — Indique si le widget doit afficher la transcription de la conversation au fil de son déroulement
- `text_input_enabled` (boolean, optional, default: true) — Indique si l’utilisateur doit pouvoir envoyer des messages texte
- `conversation_mode_toggle_enabled` (boolean, optional, default: false) — Indique s'il faut activer le sélecteur de mode de conversation dans le widget.
- `default_expanded` (boolean, optional, default: false) — Indique si le widget doit être développé par défaut
- `always_expanded` (boolean, optional, default: false) — Indique si le widget doit toujours être développé
- `dismissible` (boolean, optional, default: false) — Indique si le widget peut être fermé par l’utilisateur
- `show_agent_status` (boolean, optional, default: false) — Indique s'il faut afficher l'état de l'agent, en cours/terminé/erreur, lors de l'utilisation d'un outil.
- `show_conversation_id` (boolean, optional, default: true) — Indique s'il faut afficher l'ID de la conversation après la déconnexion.
- `strip_audio_tags` (boolean, optional, default: true) — Indique s'il faut supprimer le balisage audio des messages.
- `syntax_highlight_theme` (enum, optional) — Thème de coloration syntaxique des blocs de code. Par défaut, le widget le détecte automatiquement lorsqu’il n’est pas défini.
  - Allowed values: `light`, `dark`
- `text_contents` (WidgetTextContents, optional) — Contenu textuel du widget
- `styles` (WidgetStyles, optional) — Styles du widget
- `show_resize_button` (boolean, optional, default: true) — Indique s'il faut afficher le bouton de redimensionnement.
- `end_confirmation_enabled` (boolean, optional, default: false) — Indique s’il faut demander à l’utilisateur de confirmer avant de mettre fin à un chat ou à un appel.
- `language_selector` (boolean, optional, default: false) — Indique s'il faut afficher le sélecteur de langue.
- `supports_text_only` (boolean, optional, default: true) — Indique si le widget peut basculer en mode texte uniquement
- `custom_avatar_path` (string, optional) — Chemin de l’avatar personnalisé
- `language_presets` (map from string to WidgetLanguagePreset, optional) — Paramètres prédéfinis de langue pour le widget

### AnalysisProperty

Propriété de collecte de données avec remplacement facultatif du LLM par élément pour l'analyse post-appel. TODO: migrer vers la composition (value_schema: LiteralJsonSchemaProperty + llm) plutôt que l'héritage, afin de généraliser proprement cette approche aux schémas d'objet/tableau à l'avenir.

- `type` (enum, required)
  - Allowed values: `boolean`, `string`, `integer`, `number`
- `description` (string, optional, default: ) — La description de la propriété. Lorsqu’elle est définie, le LLM fournit la valeur à partir de cette description. S’exclut mutuellement avec dynamic_variable, is_system_provided, constant_value et is_omitted.
- `enum` (list of string, optional) — List of allowed string values for string type parameters
- `is_system_provided` (boolean, optional, default: false) — Si true, la valeur sera renseignée par le système au moment de l’exécution. Utilisé par les outils Webhook d’intégration API pour le templating. Mutuellement exclusif avec description, dynamic_variable, constant_value et is_omitted.
- `dynamic_variable` (string, optional, default: ) — Le nom de la variable dynamique à utiliser pour la valeur de cette propriété. S’exclut mutuellement avec description, is_system_provided, constant_value et is_omitted.
- `allowed_values` (AllowedValues, optional) — Garde-fou de rejet côté serveur pour une valeur fournie par un LLM : l’environnement d’exécution rejette toute valeur en dehors de l’ensemble autorisé désigné par cet objet, et cet ensemble n’est pas communiqué au LLM comme une énumération. Pris en charge uniquement lorsque la source de la valeur est `description` ; toute combinaison avec dynamic_variable, is_system_provided, constant_value ou is_omitted est rejetée.
- `constant_value` (AnalysisPropertyConstantValue, optional) — Valeur constante à utiliser pour cette propriété. S’exclut mutuellement avec description, dynamic_variable, is_system_provided et is_omitted.
- `is_omitted` (boolean, optional, default: false) — Si true, ce paramètre sera entièrement omis de la requête. Valide uniquement pour les paramètres facultatifs. Mutuellement exclusif avec description, dynamic_variable, is_system_provided et constant_value.
- `name` (string, optional) — Le nom de cet élément de collecte de données.
- `llm` (enum, optional) — LLM model to use for this analysis item. If not set, uses agent's analysis_llm default.
  - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`
- `allowed_values_dynamic_variable` (string, optional, default: , deprecated) — OBSOLÈTE : utilisez plutôt `allowed_values`. Lorsqu'il est défini, le LLM fournit la valeur, mais l'environnement d'exécution rejette toute valeur absente de la liste contenue dans cette variable dynamique (doit être un tableau JSON tel que ["ws_alpha", "ws_beta"]). Utilisez-le pour permettre au LLM de choisir dans un ensemble vérifié par le serveur, par exemple les ID auxquels l'utilisateur actuel est autorisé à accéder. Requiert description ; mutuellement exclusif avec dynamic_variable, is_system_provided, constant_value et is_omitted.

### AgentAnalysisItemsInput

- `evaluation_criteria` (list of AgentAnalysisItemsInputEvaluationCriteriaItem, optional)
- `data_collection` (list of AgentAnalysisItemsInputDataCollectionItem, optional)

### ConversationInitiationClientDataConfigInput

- `conversation_config_override` (ConversationConfigClientOverrideConfigInput, optional) — Remplacements de la configuration de la conversation
- `custom_llm_extra_body` (boolean, optional, default: false) — Indique s'il faut inclure un corps supplémentaire de LLM personnalisé.
- `enable_conversation_initiation_client_data_from_webhook` (boolean, optional, default: false) — Indique s'il faut activer les données client d'initiation de conversation provenant des webhooks.
- `enable_starting_workflow_node_id_from_client` (boolean, optional, default: false) — Indique si les clients peuvent transmettre starting_workflow_node_id dans les données client d’initialisation. Si false, son envoi empêche le démarrage de la conversation.
- `enable_procedure_ids_from_client` (boolean, optional, default: false) — Indique si les clients peuvent transmettre procedure_ids dans les données client d’initialisation afin de sélectionner les procédures de l’agent disponibles pour la conversation. Si false, leur envoi empêche le démarrage de la conversation.

### AgentWorkspaceOverridesInput

- `conversation_initiation_client_data_webhook` (ConversationInitiationClientDataWebhook, optional) — Le webhook auquel envoyer les données client d’initialisation de la conversation
- `webhooks` (ConvAiWebhooks, optional)

### AgentTestingSettings

Paramètres de configuration des tests d’agent.

- `attached_tests` (list of AttachedTestModel, optional) — Liste des ID de tests à exécuter pour cet agent

### GuardrailsV1Input

- `version` ("1", optional)
- `focus` (FocusGuardrail, optional)
- `prompt_injection` (PromptInjectionGuardrail, optional)
- `content` (ContentGuardrailInput, optional)
- `custom` (CustomGuardrailInput, optional) — Conteneur de garde-fous personnalisés, conforme au modèle ModerationGuardrail

### AuthSettings

- `enable_auth` (boolean, optional, default: false) — Si défini sur true, démarrer une conversation avec un agent nécessitera un jeton signé.
- `allowlist` (list of AllowlistItem, optional) — Liste des hôtes autorisés à démarrer des conversations avec l’agent.
- `require_origin_header` (boolean, optional, default: false) — Lorsque cette option est activée, les connexions sans en-tête origin sont refusées. Si la liste d’autorisation est vide, cette option n’a aucun effet.
- `shareable_token` (string, optional) — Un jeton partageable permettant de démarrer une conversation avec l'agent

### AgentCallLimits

- `agent_concurrency_limit` (integer, optional, default: -1) — Le nombre maximal de conversations simultanées. La valeur -1 indique qu’il n’y a pas de maximum
- `daily_limit` (integer, optional, default: 100000) — Le nombre maximal de conversations par jour
- `bursting_enabled` (boolean, optional, default: true) — Indique s'il faut activer le dépassement ponctuel. Si la valeur est true, le dépassement de la limite de requêtes simultanées du Workspace est autorisé jusqu'à trois fois cette limite. Les appels au-delà de cette limite sont facturés au double du tarif.

### AgentQueueingConfig

- `enabled` (boolean, optional, default: false) — Place les appelants dans une file d’attente lorsque l’agent atteint sa limite de requêtes simultanées, au lieu de les refuser immédiatement. Les nouveaux agents sont créés avec la mise en file d’attente activée, sauf si ce champ est défini explicitement.
- `wait_timeout_seconds` (integer, optional, default: 180) — Temps maximal pendant lequel un appelant peut attendre dans la file avant d’être refusé
- `hold_audio` (AgentHoldAudioConfig, optional) — Audio d'attente personnalisé diffusé aux appelants dans la file ; s'il n'est pas défini, les appelants entendent la tonalité d'attente par défaut. Lecture seule : définissez-le en chargeant un fichier via le point de terminaison d'audio d'attente de l'agent.

### PrivacyConfigInput

- `record_voice` (boolean, optional, default: true) — Indique s'il faut enregistrer la conversation.
- `retention_days` (integer, optional, default: -1) — Le nombre de jours de conservation de la conversation. -1 indique qu’il n’existe aucune limite de conservation.
- `delete_transcript_and_pii` (boolean, optional, default: false) — Indique s'il faut supprimer la transcription et les données personnelles identifiables.
- `delete_audio` (boolean, optional, default: false) — Indique s'il faut supprimer l'audio.
- `apply_to_existing_conversations` (boolean, optional, default: false) — Indique s'il faut appliquer les paramètres de confidentialité aux conversations existantes.
- `zero_retention_mode` (boolean, optional, default: false) — Indique s'il faut activer le mode zéro rétention, aucune donnée personnelle identifiable n'est stockée.
- `conversation_history_redaction` (ConversationHistoryRedactionConfig, optional) — Configuration de la suppression des données personnelles dans l'historique des conversations

### TopicDiscoverySettings

Configuration de la détection de sujets par agent. La fréquence et la fenêtre d'analyse sont gérées en interne ; seul le bouton d'activation ou de désactivation destiné au client est exposé.

### SentimentAnalysisSettings

### AlertingSettings

Configuration des alertes utilisée au niveau de l'agent et du Workspace. Ordre de priorité pour le seuil par moniteur et la résolution automatique : agent → Workspace → valeur par défaut du système.

- `monitor_configs` (map from string to AlertingMonitorConfig, optional) — Configuration des alertes indexée par nom de moniteur.
- `auto_resolve_after_inactive_minutes` (integer, optional) — Nombre de minutes pendant lesquelles une alerte peut rester inactive avant d’être résolue automatiquement. Les valeurs non définies sont prises en charge par la couche suivante.
- `notifiers` (list of AlertingSettingsNotifiersItem, optional) — Canaux de diffusion des notifications du cycle de vie des alertes. Cumulés avec les autres couches et dédupliqués par ``webhook_id``, ``connection_id`` PagerDuty ou ``(connection_id, channel_id)`` Slack.

### WorkflowEdgeModelInput

- `source` (string, required) — ID du nœud source.
- `target` (string, required) — ID du nœud cible.
- `forward_condition` (WorkflowEdgeModelInputForwardCondition, optional) — Condition à remplir pour parcourir l'arête dans le sens direct (de la source vers la cible).
- `backward_condition` (WorkflowEdgeModelInputBackwardCondition, optional) — Condition à remplir pour parcourir l'arête dans le sens inverse (de la cible vers la source).

### AgentWorkflowRequestModelNodesValue

- `type`: `end`
  - `edge_order` (list of string, optional) — Les ID des arêtes sortantes, dans l’ordre où elles doivent être évaluées.
  - `outcome` (enum, optional, default: success) — Indique si l’atteinte de ce nœud End termine la conversation par une réussite ou un échec.
    - Allowed values: `success`, `failure`
  - `position` (PositionInput, optional) — Position du nœud dans le workflow.
- `type`: `override_agent`
  - `label` (string, required) — Libellé lisible du nœud, utilisé dans toute l’interface.
  - `additional_knowledge_base` (list of KnowledgeBaseLocator, optional) — Documents supplémentaires de la base de connaissances auxquels le sous-agent a accès. Ils seront utilisés en complément des documents de l'agent principal.
  - `additional_prompt` (string, optional) — Objectif spécifique de ce sous-agent. Il sera ajouté au prompt système et peut servir à affiner davantage le comportement de l’agent dans ce contexte précis.
  - `additional_tool_ids` (list of string, optional) — ID des outils supplémentaires auxquels le sous-agent a accès. Ils seront utilisés en plus des outils de l’agent principal.
  - `conversation_config` (ConversationalConfigApiModelWorkflowOverrideInput, optional) — Remplacements de configuration appliqués pendant que le sous-agent mène la conversation.
  - `edge_order` (list of string, optional) — Les ID des arêtes sortantes, dans l’ordre où elles doivent être évaluées.
  - `entry_behavior` (enum, optional, default: auto) — Indique si ce nœud doit générer une réponse immédiatement lorsqu’il est atteint ou attendre une entrée utilisateur. Lorsque cette valeur est définie sur "auto", le comportement dépend du type du nœud précédent : "wait_for_user" après les nœuds "say" et "start", et "generate_immediately" dans les autres cas.
    - Allowed values: `generate_immediately`, `wait_for_user`, `auto`
  - `position` (PositionInput, optional) — Position du nœud dans le workflow.
- `type`: `phone_number`
  - `transfer_destination` (WorkflowPhoneNumberNodeModelInputTransferDestination, required)
  - `custom_sip_headers` (list of WorkflowPhoneNumberNodeModelInputCustomSipHeadersItem, optional) — En-têtes SIP personnalisés à inclure lors du transfert de l'appel. Chaque en-tête peut être une valeur statique ou une référence de variable dynamique.
  - `edge_order` (list of string, optional) — Les ID des arêtes sortantes, dans l’ordre où elles doivent être évaluées.
  - `position` (PositionInput, optional) — Position du nœud dans le workflow.
  - `post_dial_digits` (WorkflowPhoneNumberNodeModelInputPostDialDigits, optional) — Chiffres DTMF à envoyer après la connexion de l’appel, par exemple 'ww1234' pour un poste. Peut correspondre à une valeur statique ou à une référence de variable dynamique. Utilisez 'w' pour une pause de 0,5 s. Pris en charge uniquement pour les transferts Twilio.
  - `sip_refer_play_dialtone` (boolean, optional, default: true) — Lorsque la valeur est True, une tonalité est diffusée sur la branche d’appel d’origine pendant l’exécution d’un transfert SIP REFER. La tonalité est transmise via RTP au pair SIP exécutant le REFER ; désactivez cette option si le système destinataire, par exemple un SBC ou un centre de contact, ne doit pas l’entendre. Lorsqu’elle est désactivée, l’appelant entend le silence jusqu’à la fin du transfert. Uniquement pour les transferts SIP REFER.
  - `transfer_type` (enum, optional, default: conference)
    - Allowed values: `blind`, `conference`, `sip_refer`
  - `uui` (UuiTransferConfig, optional) — Informations d’utilisateur à utilisateur (RFC 7433) à joindre aux transferts SIP REFER. Transmet le contexte de l’appel, tel que les identifiants CRM ou le motif d’escalade, lors du transfert.
- `type`: `standalone_agent`
  - `agent_id` (string, optional) — L’ID de l’agent vers lequel transférer la conversation. None signifie un transfert au sein de l’agent actuel.
  - `branch_id` (string, optional) — ID de branche facultatif pour l’agent cible. La valeur None suit le déploiement du trafic de l’agent cible ou utilise sa branche principale lorsque node_id est défini.
  - `delay_ms` (integer, optional, default: 0) — Délai artificiel en millisecondes appliqué avant le transfert de la conversation.
  - `edge_order` (list of string, optional) — Les ID des arêtes sortantes, dans l’ordre où elles doivent être évaluées.
  - `enable_transferred_agent_first_message` (boolean, optional, default: false) — Indique s'il faut autoriser l'agent transféré à envoyer son premier message configuré après le transfert.
  - `node_id` (string, optional) — ID facultatif du nœud cible dans le workflow de l'agent de destination. Lorsqu'il est défini, le transfert commence à ce nœud plutôt qu'au nœud d'entrée par défaut.
  - `position` (PositionInput, optional) — Position du nœud dans le workflow.
  - `preserve_client_tts_overrides` (boolean, optional, default: false) — Définit si les remplacements côté client du TTS doivent être transférés vers l'agent cible.
  - `preserve_voice_settings` (boolean, optional, default: false) — Définit si la voix de base, le modèle TTS et les paramètres vocaux doivent être transférés vers l'agent cible.
  - `transfer_message` (string, optional) — Message facultatif envoyé à l'utilisateur avant le lancement du transfert.
- `type`: `start`
  - `edge_order` (list of string, optional) — Les ID des arêtes sortantes, dans l’ordre où elles doivent être évaluées.
  - `position` (PositionInput, optional) — Position du nœud dans le workflow.
- `type`: `tool`
  - `edge_order` (list of string, optional) — Les ID des arêtes sortantes, dans l’ordre où elles doivent être évaluées.
  - `position` (PositionInput, optional) — Position du nœud dans le workflow.
  - `tools` (list of WorkflowToolLocator, optional) — Liste des outils à exécuter en parallèle. L'ensemble du nœud est considéré comme réussi si tous les outils s'exécutent correctement.
- `type`: `say`
  - `label` (string, required) — Libellé lisible du nœud, utilisé dans toute l’interface.
  - `message` (WorkflowSayNodeModelInputMessage, required) — Message prononcé par ce nœud. Utilisez `literal` pour un texte exact ou `prompt` pour que le LLM génère le message à partir d'une description.
  - `additional_knowledge_base` (list of KnowledgeBaseLocator, optional) — Documents de la base de connaissances disponibles pour le LLM lorsque ce nœud génère son message, en plus des documents de l'agent.
  - `additional_prompt` (string, optional) — Accepté pour assurer la cohérence avec les nœuds de sous-agents, mais non utilisé. Décrivez le message dans `message.prompt` ou remplacez le prompt système par `conversation_config.agent.prompt.prompt`.
  - `additional_tool_ids` (list of string, optional) — Accepté pour assurer la cohérence avec les nœuds de sous-agents, mais non utilisé. Un nœud say ne peut pas appeler d'outils.
  - `conversation_config` (ConversationalConfigApiModelWorkflowOverrideInput, optional) — Remplacements de configuration appliqués pendant que ce nœud parle, comme la voix ou, pour les messages de type prompt, le LLM et le prompt système.
  - `edge_order` (list of string, optional) — Les ID des arêtes sortantes, dans l’ordre où elles doivent être évaluées.
  - `position` (PositionInput, optional) — Position du nœud dans le workflow.
  - `wait_for_speech_completion` (boolean, optional, default: false) — Lorsque la valeur est true, le workflow ne passe au nœud suivant qu'une fois le message entièrement prononcé.
  - `wait_for_user_response` (boolean, optional, default: false) — Lorsque la valeur est true, le nœud prononce son message, puis attend la réponse de l'utilisateur avant d'évaluer les transitions sortantes afin qu'elles puissent varier selon cette réponse. Si l'utilisateur reste silencieux, le workflow avance après le délai d'expiration du tour.
- `type`: `update_state`
  - `label` (string, required) — Libellé lisible du nœud, utilisé dans toute l’interface.
  - `updates` (list of WorkflowStateUpdateInput, required) — Mises à jour d'état appliquées lorsque le workflow atteint ce nœud. Un nœud accepte au maximum 50 mises à jour.
  - `edge_order` (list of string, optional) — Les ID des arêtes sortantes, dans l’ordre où elles doivent être évaluées.
  - `position` (PositionInput, optional) — Position du nœud dans le workflow.

### ValidationErrorLocItem

- string
- integer

### SoftTimeoutConfig

Configuration de la fonctionnalité de délai d'expiration souple pendant la génération de réponses par LLM.

- `timeout_seconds` (double, optional, default: -1) — Délai, en secondes, avant l’affichage du message prédéfini pendant l’attente de la réponse du LLM. Définissez -1 pour désactiver cette option.
- `message` (string, optional, default: Hhmmmm...yeah.) — Message à afficher lorsque le premier délai d’expiration souple est atteint pendant l’attente d’une réponse LLM. Prend en charge les variables dynamiques, par exemple \{\{system\_\_time}} et \{\{custom\_variable}}.
- `additional_soft_timeout_messages` (list of string, optional) — Messages statiques de remplissage supplémentaires pour les délais d'attente souples suivants dans la même génération LLM. Le premier délai utilise `message`. Si moins de messages sont configurés que `max_soft_timeouts_per_generation`, le dernier message configuré est répété ; sinon, un message de remplissage intégré est utilisé.
- `use_llm_generated_message` (boolean, optional, default: false) — Si cette option est activée, le message de délai d’inactivité sera généré dynamiquement au lieu d’utiliser le message statique.
- `randomize_fillers` (boolean, optional, default: false) — Si cette option est activée, mélangez une fois l’ordre des messages statiques de délai d’inactivité au début de chaque tour. S’applique uniquement lorsque use_llm_generated_message est false.
- `max_soft_timeouts_per_generation` (integer, optional, default: 1) — Maximum filler messages while waiting for a single LLM response. Fires every timeout_seconds until the LLM streams content or this limit is reached.
- `llm_generated_message_prompt_override` (string, optional) — Prompt personnalisé pour générer le message de remplissage lors d'un délai d'attente souple lorsque use\_llm\_generated\_message est activé. Le contexte récent de la conversation est fourni dans un message utilisateur distinct. S'il n'est pas défini, le prompt par défaut est utilisé. Prend en charge les variables dynamiques (par exemple, \{\{system\_\_time}}, \{\{custom\_variable}}).
- `disable_until_first_user_message` (boolean, optional, default: false) — Lorsque la valeur est true, les fillers de délai d’expiration souple sont supprimés jusqu’à ce que la conversation comporte au moins un véritable message utilisateur. Empêche les fillers pendant le tour d’ouverture de l’agent, par exemple avec le workflow generate-immediately ou des appels d’outils avant que l’utilisateur ne parle.

### 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) — Balise audio à utiliser (pour de meilleures performances, 1 à 2 mots, par exemple « happy », « excited »)
- `description` (string, optional) — Description facultative des cas d'utilisation de cette balise

### PydanticPronunciationDictionaryVersionLocator

Un localisateur permettant à d'autres documents de référencer un dictionnaire spécifique et sa version. Il s'agit d'une version Pydantic de PronunciationDictionaryVersionLocatorDBModel. Requis pour assurer la compatibilité avec les autres modèles de données de l'agent.

- `pronunciation_dictionary_id` (string, required) — L’ID du dictionnaire de prononciation
- `version_id` (string, optional) — L’ID de la version du dictionnaire de prononciation

### EffectsSpecOutput

Effets audio appliqués à la parole générée : un préréglage de filtre, une distance perçue, un environnement de réverbération, un fond sonore et un panoramique stéréo. Laissez chaque champ à sa valeur par défaut pour obtenir un audio non traité.

- `distance` (double, required, default: 0) — Distance à laquelle le locuteur semble se trouver du microphone, de 0 (proche, inchangée) à 1 (loin). Des valeurs plus élevées atténuent les basses et hautes fréquences et, lorsqu’un environnement est défini, déplacent l’équilibre de la voix sèche vers la réverbération.
- `send_level` (double, required, default: 1) — Quantité de voix envoyée vers la réverbération, de 0 (aucune) à 1 (totale). S’applique uniquement lorsque `environment_id` est défini ; 0 désactive la réverbération.
- `pan` (double, required, default: 0) — Position stéréo de la voix, de -1 (complètement à gauche) à 1 (complètement à droite), en passant par 0 (au centre). Seule la voix est panoramiquée ; la réverbération et le bruit de fond restent centrés.
- `filter_preset_id` (string, optional) — ID d’un préréglage de filtre qui colore la voix, tel que `phone` ou `old_radio`. Répertoriez les ID valides avec `GET /v1/audio-effects/catalog`.
- `environment_id` (string, optional) — ID d’un environnement de réverbération qui place la voix dans un espace, tel que `small_room` ou `hall`. Répertoriez les ID valides avec `GET /v1/audio-effects/catalog`. La réverbération est produite en stéréo et ajoute une traîne pouvant durer plusieurs secondes après la fin de la parole.
- `background_noise_id` (string, optional) — ID d’un fond sonore diffusé en boucle sous la voix, tel que `cafe` ou `keyboard`. Répertoriez les ID valides avec `GET /v1/audio-effects/catalog`.

### FileInputConfig

- `enabled` (boolean, optional, default: true) — Lorsque cette option est activée, les utilisateurs peuvent joindre des images, des fichiers PDF ou des fichiers texte dans le chat si le LLM prend en charge les entrées multimodales.
- `max_files_in_memory` (integer, optional, default: 10) — Nombre de fichiers les plus récents conservés en mémoire au cours d’une conversation. Les fichiers plus anciens sont résumés et leur mémoire est libérée.
- `max_files_per_conversation` (integer, optional, default: 10) — Nombre total de fichiers qu’un utilisateur peut importer au cours d’une conversation. Les importations sont facturées par fichier. Utilisez -1 pour aucune limite, ou une valeur >= max_files_in_memory.

### DtmfInputConfig

Configuration de la collecte de saisies DTMF (clavier téléphonique) pendant les appels.

- `dtmf_input_timeout` (double, optional, default: 2) — Délai d’expiration, en secondes, pour attendre des chiffres DTMF supplémentaires
- `hash_terminator` (boolean, optional, default: true) — Si true, appuyer sur # termine immédiatement la saisie DTMF.
- `redact_input` (boolean, optional, default: false) — Si true, remplace les saisies DTMF du correspondant, effectuées au clavier, par un marqueur de masquage dans la transcription, le journal de conversation et l’analyse. Les chiffres que l’agent répète ou transmet à un outil ne sont pas concernés.

### BackgroundSoundConfig

- `source_type` ("preset", optional) — Le type de source sonore d’arrière-plan.
- `source_id` (enum, optional) — Identifiant de la source sonore.
  - Allowed values: `office2`, `office1`, `restaurant`, `city`, `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
- `volume` (double, optional, default: 0.15) — Niveau de volume du son d’arrière-plan (de 0,01 à 1,0).
- `crossfade_loop` (boolean, optional, default: true) — Applique un fondu enchaîné à la jonction de la boucle afin d'éviter les clics audibles lors de la répétition du son.

### ConversationConfigClientOverrideOutput

- `asr` (AsrConversationalConfigOverride, optional) — Configuration de la transcription conversationnelle
- `turn` (TurnConfigOverride, optional) — Configuration de la détection des tours de parole
- `tts` (TtsConversationalConfigOverride, optional) — Configuration de la synthèse vocale conversationnelle
- `conversation` (ConversationConfigOverride, optional) — Configuration des événements conversationnels
- `agent` (AgentConfigOverrideOutput, optional) — Configuration spécifique à l'agent

### LanguagePresetTranslation

- `source_hash` (string, required)
- `text` (string, required)

### BehaviorOverride

- `verbosity` (enum, optional) — Remplacement du niveau de verbosité. La valeur par défaut sous-jacente s’applique lorsqu’aucune valeur n’est définie.
  - Allowed values: `auto`, `concise`, `thorough`
- `output_format` (enum, optional) — Remplacement du format de sortie. La valeur par défaut sous-jacente s'applique s'il n'est pas défini.
  - 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) — Remplacement du budget d’interaction. La valeur par défaut sous-jacente s’applique si non défini.
  - Allowed values: `realtime`, `5_minutes`, `10_minutes`, `1_hour`

### PromptAgentApiModelOutput

- `prompt` (string, optional, default: ) — Le prompt de l’agent
- `llm` (enum, optional) — Le LLM à interroger avec le prompt et l’historique de discussion. En cas de résidence des données européenne, le LLM doit être pris en charge dans l’environnement de résidence des données.
  - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`
- `reasoning_effort` (enum, optional) — Effort de raisonnement du modèle. Disponible uniquement pour certains modèles.
  - Allowed values: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`
- `thinking_budget` (integer, optional) — Nombre maximal de jetons utilisés pour le raisonnement. Utilisez 0 pour le désactiver si le modèle le prend en charge.
- `enable_reasoning_summary` (boolean, optional, default: false) — Activez les résumés du raisonnement du modèle. Lorsqu’ils sont désactivés, nous ne demandons pas de résumés au fournisseur lorsque cela est possible, afin de réduire le TTFB. Non compatible avec ZRM.
- `temperature` (double, optional) — La température du LLM. La valeur par défaut est 0. Définissez-la sur null pour omettre entièrement le paramètre de la requête au LLM, ce qui est utile pour les LLM personnalisés qui refusent le champ de température.
- `max_tokens` (integer, optional, default: -1) — S’il est supérieur à 0, nombre maximal de jetons que le LLM peut prédire
- `tool_ids` (list of string, optional) — Liste des ID des outils utilisés par l’agent.
- `tool_ids_strict` (boolean, optional, default: false) — Only applies as a conversation override, allowed whenever tool_ids may be overridden. When true, the overridden tool_ids is the full list of tools allowed in the conversation, including tools on workflow nodes. Ignored when set on the agent.
- `built_in_tools` (BuiltInToolsOutput, optional) — Outils système intégrés à utiliser par l'agent
- `enable_parallel_tool_calls` (boolean, optional, default: true) — Activez les appels d’outils parallèles. Lorsqu’ils sont activés, l’agent peut exécuter plusieurs outils en parallèle au cours d’un même tour. Cette option n’est pas prise en charge par tous les modèles.
- `mcp_server_ids` (list of string, optional) — Liste des identifiants de serveurs MCP à utiliser par l'agent
- `native_mcp_server_ids` (list of string, optional) — Liste des identifiants de serveurs MCP natifs à utiliser par l'agent
- `knowledge_base` (list of KnowledgeBaseLocator, optional) — Liste des bases de connaissances à utiliser par l'agent
- `custom_llm` (CustomLlm, optional) — Définition d'un LLM personnalisé si le champ LLM est défini sur « CUSTOM_LLM »
- `ignore_default_personality` (boolean, optional) — Indique s'il faut supprimer les lignes de personnalité par défaut du prompt système.
- `rag` (RagConfigOutput, optional) — Configuration pour RAG
- `timezone` (string, optional) — Fuseau horaire utilisé pour afficher l’heure actuelle dans le prompt système. S’il est défini, l’heure actuelle sera incluse dans le prompt système à l’aide de ce fuseau horaire. Doit être un nom de fuseau horaire valide, par exemple « America/New_York », « Europe/London » ou « UTC ». Recommandé pour des réponses tenant compte de l’heure avec précision. Sans cela, l’agent ne connaît ni la date ni l’heure actuelles, sauf si vous les fournissez via des variables dynamiques ou des outils, ce qui peut entraîner des références temporelles incorrectes ou inventées.
- `backup_llm_config` (PromptAgentApiModelOutputBackupLlmConfig, optional) — Configuration du basculement en cascade des LLM de secours. Peut être désactivée, utiliser les valeurs par défaut du système ou spécifier un ordre personnalisé.
- `cascade_timeout_seconds` (double, optional, default: 4) — Délai, en secondes, avant le basculement vers le LLM de secours. Doit être compris entre 2 et 15 secondes.
- `tools` (list of PromptAgentApiModelOutputToolsItem, optional, deprecated) — Liste des outils que l'agent peut utiliser au cours de la conversation, utilisez plutôt tool_ids.

### PromptEvaluationCriteria

Une évaluation utilisant la transcription et un prompt pour obtenir une réponse oui/non

- `id` (string, required) — L’identifiant unique du critère d’évaluation.
- `name` (string, required)
- `conversation_goal_prompt` (string, required) — Le prompt que l’agent doit utiliser pour évaluer la conversation
- `type` ("prompt", optional) — Le type de critère d’évaluation.
- `use_knowledge_base` (boolean, optional, default: false) — Indique si la base de connaissances de l’agent doit être utilisée lors de l’évaluation du prompt.
- `scope` (enum, optional, default: conversation) — La portée du contexte de transcription utilisée pour évaluer ce critère. « conversation » utilise la transcription complète ; « agent » utilise uniquement la partie durant laquelle l'agent défini était actif.
  - Allowed values: `conversation`, `agent`
- `llm` (enum, optional) — LLM model to use for this evaluation criteria. If not set, uses agent's analysis_llm default.
  - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`
- `scoring_mode` (enum, optional, default: binary) — Mode d’évaluation de ce critère. 'binary' produit success/failure/unknown. 'numeric_uniform' renvoie un nombre sur l’échelle [0, max_score], normalisé en pourcentage global de réussite de la conversation.
  - Allowed values: `binary`, `numeric_uniform`
- `max_score` (integer, optional, default: 100) — Maximum value of the numeric score scale (minimum is always 0). Only used when scoring_mode is 'numeric_uniform'.
- `score_instructions` (string, optional) — Instructions facultatives en texte libre indiquant comment attribuer des valeurs sur l'échelle numérique. Utilisées uniquement lorsque scoring_mode est défini sur 'numeric_uniform'.

### WidgetConfigAvatar

Avatar du widget

- `type`: `orb`
  - `color_1` (string, optional, default: #2792dc) — La première couleur de l’avatar
  - `color_2` (string, optional, default: #9ce6e6) — La deuxième couleur de l'avatar
- `type`: `url`
  - `custom_url` (string, optional, default: ) — URL personnalisée de l’avatar
- `type`: `image`
  - `url` (string, optional, default: ) — L’URL de l’avatar

### WidgetEndFeedbackConfig

- `type` ("rating", optional) — Le type de retour à recueillir à la fin de la conversation.

### AllowlistItem

- `hostname` (string, required) — Le nom d’hôte de l’origine autorisée

### WidgetTextContents

- `main_label` (string, optional) — Appel à l'action affiché dans les variantes compacte et complète.
- `start_call` (string, optional) — Texte et libellé ARIA du bouton de démarrage d’appel.
- `start_chat` (string, optional) — Texte et libellé ARIA du bouton de démarrage du chat (texte uniquement)
- `new_call` (string, optional) — Texte et libellé ARIA du bouton de nouvel appel. Affiché lorsque l’appelant a déjà terminé au moins un appel afin d’en commencer un autre.
- `end_call` (string, optional) — Texte et libellé ARIA du bouton de fin d’appel.
- `mute_microphone` (string, optional) — Libellé ARIA du bouton de désactivation du microphone.
- `change_language` (string, optional) — Libellé ARIA de la liste déroulante de changement de langue.
- `collapse` (string, optional) — Libellé ARIA du bouton de réduction.
- `expand` (string, optional) — Libellé ARIA du bouton de développement.
- `copied` (string, optional) — Texte affiché lorsque l’utilisateur copie une valeur à l’aide du bouton de copie.
- `accept_terms` (string, optional) — Texte et libellé ARIA du bouton d’acceptation des conditions.
- `dismiss_terms` (string, optional) — Texte et libellé ARIA du bouton d’annulation des conditions.
- `listening_status` (string, optional) — Statut affiché lorsque l’agent écoute.
- `speaking_status` (string, optional) — Statut affiché lorsque l’agent parle.
- `connecting_status` (string, optional) — Statut affiché lorsque l’agent se connecte.
- `chatting_status` (string, optional) — Statut affiché lorsque l’agent échange par chat, texte uniquement
- `queue_waiting_status` (string, optional) — Statut affiché pendant l’attente dans la file d’un agent disponible.
- `queue_waiting_status_short` (string, optional) — Statut court affiché en attendant qu’un agent soit disponible.
- `input_label` (string, optional) — Libellé ARIA du champ de saisie de message texte.
- `input_placeholder` (string, optional) — Texte indicatif du champ de saisie des messages texte.
- `input_placeholder_text_only` (string, optional) — Texte indicatif du champ de saisie des messages texte (texte uniquement)
- `input_placeholder_new_conversation` (string, optional) — Texte indicatif du champ de saisie des messages texte lors du démarrage d’une nouvelle conversation (texte uniquement)
- `user_ended_conversation` (string, optional) — Message d’information affiché lorsque l’utilisateur met fin à la conversation.
- `agent_ended_conversation` (string, optional) — Message d’information affiché lorsque l’agent met fin à la conversation.
- `conversation_id` (string, optional) — Libellé textuel utilisé à côté de l’ID de conversation.
- `error_occurred` (string, optional) — Libellé textuel utilisé lorsqu’une erreur survient.
- `queue_timed_out` (string, optional) — Message d'erreur affiché lorsque le délai d'attente dans la file expire.
- `copy_id` (string, optional) — Texte et libellé ARIA utilisés pour le bouton de copie de l’ID.
- `initiate_feedback` (string, optional) — Texte affiché pour inviter l’utilisateur à donner son avis.
- `request_follow_up_feedback` (string, optional) — Texte affiché pour demander des précisions supplémentaires sur l’avis.
- `thanks_for_feedback` (string, optional) — Texte affiché pour remercier l’utilisateur d’avoir donné son avis.
- `thanks_for_feedback_details` (string, optional) — Texte supplémentaire affiché pour expliquer l'intérêt des retours utilisateurs.
- `follow_up_feedback_placeholder` (string, optional) — Texte indicatif du champ de saisie des commentaires de suivi.
- `submit` (string, optional) — Texte et libellé ARIA du bouton d’envoi.
- `go_back` (string, optional) — Texte et libellé ARIA du bouton de retour.
- `send_message` (string, optional) — Texte et libellé ARIA du bouton d’envoi de message.
- `text_mode` (string, optional) — Texte et libellé ARIA du bouton de basculement vers le mode texte.
- `voice_mode` (string, optional) — Texte et libellé ARIA du bouton de basculement vers le mode vocal.
- `switched_to_text_mode` (string, optional) — Notification toast affichée lors du passage en mode texte.
- `switched_to_voice_mode` (string, optional) — Notification toast affichée lors du passage en mode vocal.
- `copy` (string, optional) — Texte et libellé ARIA du bouton de copie.
- `download` (string, optional) — Texte et libellé ARIA du bouton de téléchargement.
- `wrap` (string, optional) — Texte et libellé ARIA du bouton d’activation du retour à la ligne.
- `agent_working` (string, optional) — Texte d’état affiché lorsque l’agent traite un appel d’outil.
- `agent_done` (string, optional) — Texte d’état affiché lorsque l’agent termine le traitement d’un appel d’outil.
- `agent_error` (string, optional) — Texte d’état affiché lorsque l’agent rencontre une erreur lors d’un appel d’outil.
- `attach_file` (string, optional) — Texte et libellé ARIA du bouton de pièce jointe.
- `remove_file` (string, optional) — Libellé ARIA du bouton de suppression de fichier.
- `file_upload_error` (string, optional) — Message d'erreur affiché lorsqu'un fichier ne parvient pas à être importé.
- `file_type_unsupported` (string, optional) — Message d'erreur affiché lorsqu'un type de fichier non pris en charge est sélectionné. Suivi de la liste des types acceptés.
- `file_too_large` (string, optional) — Message d'erreur affiché lorsqu'un fichier dépasse la taille maximale autorisée.
- `file_limit_reached` (string, optional) — Message d'erreur affiché lorsque le nombre maximal de fichiers pour une conversation est atteint.
- `typing_indicator` (string, optional) — Texte d’état affiché pendant que l’agent écrit.
- `rich_content_unavailable` (string, optional) — Message de secours affiché lorsque le contenu enrichi ne peut pas être rendu.

### WidgetStyles

- `base` (string, optional) — Couleur d’arrière-plan de base.
- `base_hover` (string, optional) — Couleur de l’arrière-plan de base au survol.
- `base_active` (string, optional) — Couleur de l’arrière-plan de base lorsqu’il est actif, après clic.
- `base_border` (string, optional) — Couleur de la bordure sur l’arrière-plan de base.
- `base_subtle` (string, optional) — Couleur du texte secondaire sur l’arrière-plan de base.
- `base_primary` (string, optional) — Couleur du texte principal sur l’arrière-plan de base.
- `base_error` (string, optional) — Couleur du texte d’erreur sur l’arrière-plan de base.
- `accent` (string, optional) — Couleur d’arrière-plan d’accentuation.
- `accent_hover` (string, optional) — Couleur de l’arrière-plan d’accentuation au survol.
- `accent_active` (string, optional) — Couleur de l’arrière-plan d’accentuation lorsqu’il est actif, après clic.
- `accent_border` (string, optional) — Couleur de la bordure sur l’arrière-plan d’accentuation.
- `accent_subtle` (string, optional) — Couleur du texte secondaire sur l’arrière-plan d’accentuation.
- `accent_primary` (string, optional) — Couleur du texte principal sur l’arrière-plan d’accentuation.
- `overlay_padding` (double, optional) — La marge intérieure autour des bords de la zone d’affichage.
- `button_radius` (double, optional) — Le rayon des boutons.
- `input_radius` (double, optional) — Le rayon des champs de saisie.
- `bubble_radius` (double, optional) — Le rayon des bulles de discussion.
- `sheet_radius` (double, optional) — Le rayon par défaut des feuilles.
- `compact_sheet_radius` (double, optional) — Le rayon du panneau en mode compact.
- `dropdown_sheet_radius` (double, optional) — Le rayon du panneau déroulant.

### WidgetLanguagePreset

- `text_contents` (WidgetTextContents, optional) — Le contenu textuel pour la langue sélectionnée.
- `text_contents_translation` (WidgetTextContentsTranslation, optional) — Le cache de traduction du contenu textuel.
- `terms_text` (string, optional) — Le texte à afficher pour les conditions générales dans cette langue.
- `terms_html` (string, optional) — Le HTML à afficher pour les conditions générales dans cette langue
- `terms_key` (string, optional) — La clé à afficher pour les conditions générales dans cette langue
- `terms_translation` (WidgetTermsTranslation, optional) — Le cache de traduction des termes.

### AllowedValues

- `dynamic_variable` (string, required) — Nom d’une variable dynamique qui doit correspondre à un tableau JSON de valeurs autorisées, par exemple ["ws_alpha", "ws_beta"]. Les variables système ne fonctionnent que si elles correspondent à une liste.

### AnalysisPropertyConstantValue

Valeur constante à utiliser pour cette propriété. S’exclut mutuellement avec description, dynamic_variable, is_system_provided et is_omitted.

- string
- integer
- double
- boolean

### AgentAnalysisItemsInputEvaluationCriteriaItem

- `source`: `system`
  - `analysis_item_id` (enum, required) — ID de l’évaluation système intégrée référencée.
    - Allowed values: `__system_eval_criteria_sentiment`, `__system_eval_criteria_frustration`
  - `scope` (enum, optional, default: conversation) — Contexte de transcription (« conversation » ou « agent ») utilisé lors de l’exécution de cet élément.
    - Allowed values: `conversation`, `agent`
  - `weight` (double, optional) — Poids relatif facultatif pour le calcul du score agrégé.
- `source`: `user`
  - `analysis_item_id` (string, required) — ID de l’élément d’évaluation utilisateur référencé.
  - `additional_version_ids` (list of string, optional) — Versions d'éléments supplémentaires à exécuter également à des fins de comparaison A/B. Elles sont exécutées et stockées, mais exclues du calcul du score ; le version_id principal est celui qui est évalué.
  - `scope` (enum, optional, default: conversation) — Contexte de transcription (« conversation » ou « agent ») utilisé lors de l’exécution de cet élément.
    - Allowed values: `conversation`, `agent`
  - `version_id` (string, optional) — Version principale de l’élément dont le résultat alimente le score. None suit la dernière version publiée de l’élément.
  - `weight` (double, optional) — Poids relatif facultatif pour le calcul du score agrégé.

### AgentAnalysisItemsInputDataCollectionItem

- `source`: `system`
  - `analysis_item_id` ("__system_data_collection_topic", required) — ID de l’élément de collecte de données système intégré référencé.
  - `scope` (enum, optional, default: conversation) — Contexte de transcription (« conversation » ou « agent ») utilisé lors de l’exécution de cet élément.
    - Allowed values: `conversation`, `agent`
- `source`: `user`
  - `analysis_item_id` (string, required) — ID de l’élément de collecte de données utilisateur référencé.
  - `scope` (enum, optional, default: conversation) — Contexte de transcription (« conversation » ou « agent ») utilisé lors de l’exécution de cet élément.
    - Allowed values: `conversation`, `agent`
  - `version_id` (string, optional) — Version épinglée de l’élément. None suit la dernière version publiée de l’élément.

### ConversationConfigClientOverrideConfigInput

- `asr` (AsrConversationalConfigOverrideConfig, optional) — Configure les remplacements pour les champs imbriqués.
- `turn` (TurnConfigOverrideConfig, optional) — Configure les remplacements pour les champs imbriqués.
- `tts` (TtsConversationalConfigOverrideConfig, optional) — Configure les remplacements pour les champs imbriqués.
- `conversation` (ConversationConfigOverrideConfig, optional) — Configure les remplacements pour les champs imbriqués.
- `agent` (AgentConfigOverrideConfig, optional) — Configure les remplacements pour les champs imbriqués.

### ConversationInitiationClientDataWebhook

- `url` (string, required) — L’URL à laquelle envoyer le webhook
- `request_headers` (map from string to ConversationInitiationClientDataWebhookRequestHeadersValue, required) — Les en-têtes à envoyer avec la requête webhook

### ConvAiWebhooks

- `post_call_webhook_id` (string, optional)
- `events` (list of enum, optional) — Liste des types d'événements à envoyer par webhook. Options : transcript, audio, call_initiation_failure, answering_machine_detection, unredacted_transcript, unredacted_audio.
  - Allowed values: `transcript`, `audio`, `call_initiation_failure`, `answering_machine_detection`, `unredacted_transcript`, `unredacted_audio`
- `transcript_format` (enum, optional, default: json) — Format des webhooks de transcription.
  - Allowed values: `json`, `opentelemetry`
- `exclude_transcript` (boolean, optional, default: false) — Lorsque la valeur est true, les webhooks JSON de transcription après appel omettent la transcription tour par tour. L’analyse, les métadonnées et les autres champs de conversation sont toujours envoyés. Ignoré pour le format de transcription OpenTelemetry.
- `send_audio` (boolean, optional, deprecated) — OBSOLÈTE : utilisez plutôt le champ « events ». Indique si les données audio doivent être envoyées avec les webhooks post-appel pour les conversations ConvAI.

### 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

Conteneur de garde-fous personnalisés, conforme au modèle ModerationGuardrail

- `config` (CustomGuardrailsConfigInput, optional) — Conteneur de configuration pour la liste de garde-fous personnalisés

### AgentHoldAudioConfig

Audio d'attente personnalisé diffusé en boucle aux appelants en attente dans la file de l'agent. Défini en chargeant un fichier via le point de terminaison d'audio d'attente de l'agent. Les valeurs envoyées dans les requêtes de création ou de mise à jour d'agent sont ignorées.

- `audio_path` (string, required) — Chemin de stockage du clip importé
- `audio_url` (string, required) — URL CDN publique du clip importé
- `original_filename` (string, required) — Nom du fichier du clip importé, tel que fourni par l'utilisateur
- `duration_secs` (double, required) — Durée du clip importé, en secondes
- `size_bytes` (integer, required) — Taille du clip importé en octets

### ConversationHistoryRedactionConfig

- `enabled` (boolean, optional, default: false) — Indique si le masquage de l’historique des conversations est activé
- `entities` (list of enum, optional) — Les entités à masquer dans la transcription, l’audio et l’analyse de la conversation. Utilisez des types de niveau supérieur tels que « name », « email_address », ou la notation par points pour des sous-types spécifiques tels que « 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 des éléments de collecte de données dont les valeurs extraites ne sont pas masquées. Leurs justifications restent masquées.

### AlertingMonitorConfig

- `enabled` (boolean, optional) — Indique si ce moniteur est activé et peut envoyer des notifications
- `threshold` (double, optional) — Seuil de taux d'échec à partir duquel ce moniteur peut envoyer une notification.
- `relative_increase_threshold` (double, optional) — Relative increase over the trailing baseline at which this monitor can notify (0.2 = 20% above baseline, 0 = any failure). For conversation_volume_drop it is the share of the usual volume that must be missing, between 0.1 and 0.9 (0.5 = half).
- `min_failure_count` (integer, optional) — Nombre minimal d’échecs dans la fenêtre avant que ce moniteur puisse se déclencher.
- `min_history_bucket_count` (integer, optional) — Nombre minimal de compartiments consécutifs avec du trafic avant que la détection de pic puisse se déclencher.
- `min_sample_count` (integer, optional) — Nombre minimal d’échantillons dans la fenêtre avant que ce moniteur puisse se déclencher.
- `suspect_trigger_threshold` (integer, optional) — Nombre de compartiments suspects requis dans la fenêtre de rétrospection pour faire passer un élément suspect au statut d’alerte.
- `auto_resolve_after_inactive_minutes` (integer, optional) — Nombre de minutes pendant lesquelles une alerte peut rester inactive avant d’être résolue automatiquement.

### AlertingSettingsNotifiersItem

- `type`: `webhook`
  - `webhook_id` (string, required) — ID du webhook du Workspace auquel envoyer les notifications du cycle de vie des alertes.
- `type`: `integration`
  - `connection_id` (string, required) — ID de la connexion d’intégration du Workspace à laquelle envoyer les notifications du cycle de vie des alertes. L’intégration de la connexion doit disposer de la capacité de surveillance et correspondre à ``integration_type``.
  - `channel_id` (string, optional) — ID du canal Slack dans lequel publier les notifications d’alerte, par exemple ``C0123456789``. Requis lorsque ``integration_type`` est ``slack``. L’application Slack doit être membre du canal et disposer de l’autorisation ``chat:write``, ou de ``chat:write.public`` pour les canaux publics qu’elle n’a pas rejoints.
  - `integration_type` (enum, optional) — Intégration vers laquelle effectuer l’envoi. Le serveur interprète une valeur omise comme ``pagerduty``.
    - Allowed values: `pagerduty`, `slack`

### WorkflowEdgeModelInputForwardCondition

- `type`: `expression`
  - `expression` (AstNodeInput, required) — Expression à évaluer.
  - `label` (string, optional) — Libellé facultatif lisible par l'utilisateur pour la condition, utilisé dans toute l'interface.
- `type`: `llm`
  - `condition` (string, required) — Condition à évaluer
  - `label` (string, optional) — Libellé facultatif lisible par l'utilisateur pour la condition, utilisé dans toute l'interface.
- `type`: `result`
  - `successful` (boolean, required) — Indique si tous les outils du nœud d’outils exécuté précédemment ont été exécutés avec succès.
  - `label` (string, optional) — Libellé facultatif lisible par l'utilisateur pour la condition, utilisé dans toute l'interface.
- `type`: `unconditional`
  - `label` (string, optional) — Libellé facultatif lisible par l'utilisateur pour la condition, utilisé dans toute l'interface.

### WorkflowEdgeModelInputBackwardCondition

- `type`: `expression`
  - `expression` (AstNodeInput, required) — Expression à évaluer.
  - `label` (string, optional) — Libellé facultatif lisible par l'utilisateur pour la condition, utilisé dans toute l'interface.
- `type`: `llm`
  - `condition` (string, required) — Condition à évaluer
  - `label` (string, optional) — Libellé facultatif lisible par l'utilisateur pour la condition, utilisé dans toute l'interface.
- `type`: `result`
  - `successful` (boolean, required) — Indique si tous les outils du nœud d’outils exécuté précédemment ont été exécutés avec succès.
  - `label` (string, optional) — Libellé facultatif lisible par l'utilisateur pour la condition, utilisé dans toute l'interface.
- `type`: `unconditional`
  - `label` (string, optional) — Libellé facultatif lisible par l'utilisateur pour la condition, utilisé dans toute l'interface.

### PositionInput

- `x` (double, optional, default: 0)
- `y` (double, optional, default: 0)

### KnowledgeBaseLocator

- `type` (enum, required) — Le type de base de connaissances.
  - Allowed values: `file`, `url`, `text`, `folder`
- `name` (string, required) — Le nom de la base de connaissances
- `id` (string, required) — L’ID de la base de connaissances
- `usage_mode` (enum, optional, default: auto) — Le mode d’utilisation de la base de connaissances
  - Allowed values: `prompt`, `auto`

### ConversationalConfigApiModelWorkflowOverrideInput

- `asr` (AsrConversationalConfigWorkflowOverride, optional) — Configuration de la transcription conversationnelle
- `turn` (TurnConfigWorkflowOverride, optional) — Configuration de la détection des tours de parole
- `tts` (TtsConversationalConfigWorkflowOverrideInput, optional) — Configuration de la synthèse vocale conversationnelle
- `conversation` (ConversationConfigWorkflowOverrideInput, optional) — Configuration des événements conversationnels
- `language_presets` (map from string to LanguagePresetInput, optional) — Paramètres prédéfinis de langue pour les conversations
- `vad` (VadConfigWorkflowOverride, optional) — Configuration de la détection d'activité vocale
- `agent` (AgentConfigApiModelWorkflowOverrideInput, optional) — Configuration spécifique à l'agent

### 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) — Le nom de l'en-tête SIP (par exemple, « X-Customer-ID »)
  - `value` (string, required) — Le nom de la variable dynamique à résoudre
- `type`: `static`
  - `key` (string, required) — Le nom de l'en-tête SIP (par exemple, « X-Customer-ID »)
  - `value` (string, required) — La valeur de l’en-tête

### WorkflowPhoneNumberNodeModelInputPostDialDigits

- `type`: `dynamic`
  - `value` (string, required) — Le nom de la variable dynamique à résoudre
- `type`: `static`
  - `value` (string, required) — Chiffres DTMF à envoyer après la connexion de l’appel, par exemple 'ww1234' pour un poste.

### UuiTransferConfig

Enveloppe User-to-User Information pour les transferts SIP REFER (RFC 7433). Les charges utiles sortantes sont encodées en hexadécimal, le seul encodage défini par la RFC 7433. L’axe de discrimination du protocole permet d’exprimer les formats propres à chaque plateforme (Talkdesk, Genesys, etc.) par configuration, plutôt que par des indicateurs de transfert dispersés. D’autres axes, comme l’encodage ASCII, le nom de l’en-tête ou les paramètres de finalité et de contenu, peuvent être ajoutés ici sans modifier le modèle de transfert.

- `data` (string, required) — Charge utile UUI à envoyer lors des transferts SIP REFER. Prend en charge les variables dynamiques intégrées et est encodée en hexadécimal au moment du transfert.
- `protocol_discriminator` (string, optional) — Discriminateur de protocole facultatif sur un octet, composé de deux chiffres hexadécimaux, par exemple '00'. Requis par des plateformes telles que Genesys Cloud, qui suppriment sinon le premier octet de la charge utile. Ne le définissez pas pour les plateformes comme Talkdesk qui attendent une charge utile hexadécimale brute.
- `protocol_discriminator_mode` (enum, optional, default: prefix) — Méthode d’ajout de protocol\_discriminator. 'prefix' ajoute l’octet avant la charge utile hexadécimale (User-to-User=XX\<hex>;encoding=hex). 'pd\_parameter' l’envoie comme paramètre distinct (User-to-User=\<hex>;pd=XX;encoding=hex). Ignoré lorsque protocol\_discriminator n’est pas défini.
  - Allowed values: `prefix`, `pd_parameter`

### WorkflowToolLocator

- `tool_id` (string, required)
- `schema_overrides` (map from string to WorkflowToolLocatorSchemaOverridesValue, optional) — Remplacements de paramètres par nœud appliqués en complément de la configuration propre à l’outil. Les clés sont des chemins de paramètres séparés par des points (les outils webhook préfixent les clés par path_params./query_params./request_body.). Ils prévalent sur tout remplacement déjà défini sur l’outil lui-même.

### WorkflowSayNodeModelInputMessage

Message prononcé par ce nœud. Utilisez `literal` pour un texte exact ou `prompt` pour que le LLM génère le message à partir d'une description.

- `type`: `literal`
  - `text` (string, required) — Texte exact prononcé par l'agent. Prend en charge les espaces réservés de variables dynamiques `{{variable_name}}`.
  - `text_translations` (map from string to TranslatedString, optional) — Traductions de `text`, indexées par code de langue. Lorsque la langue de la conversation possède une entrée, sa valeur est prononcée à la place de `text`.
- `type`: `prompt`
  - `prompt` (string, required) — Description du message que le LLM doit générer. Elle est ajoutée au prompt système de l'agent lorsque ce nœud est actif.

### WorkflowStateUpdateInput

- `variable_name` (string, required) — Nom de la variable dynamique à attribuer.
- `expression` (AstNodeInput, required) — Expression dont le résultat est attribué à la variable. Elle peut combiner des constantes, d'autres variables dynamiques, des valeurs extraites par le LLM et des opérateurs.
- `type` ("dynamic_variable", optional)
- `required` (boolean, optional, default: true) — Lorsque la valeur est false, le LLM peut omettre les valeurs dont dépend cette mise à jour. La mise à jour est alors ignorée et la variable conserve sa valeur actuelle.

### AsrConversationalConfigOverride

- `keywords` (list of string, optional) — Mots-clés dont la probabilité de prédiction doit être augmentée

### TurnConfigOverride

- `soft_timeout_config` (SoftTimeoutConfigOverride, optional) — Configuration de la fonctionnalité de délai d'expiration souple. Fournit un retour immédiat pendant les réponses plus longues des LLM.

### TtsConversationalConfigOverride

- `model_id` (enum, optional, default: eleven_v4_turbo) — Le modèle à utiliser pour le TTS
  - 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) — L’ID de voix à utiliser pour le TTS
- `supported_voices` (list of SupportedVoice, optional) — Voix supplémentaires prises en charge pour l'agent
- `stability` (double, optional) — La stabilité de la parole générée
- `speed` (double, optional) — La vitesse de la parole générée
- `similarity_boost` (double, optional) — L'amélioration de similarité pour la parole générée
- `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional) — Les localisateurs de dictionnaires de prononciation

### ConversationConfigOverride

- `text_only` (boolean, optional) — Si cette option est activée, l’audio ne sera pas traité et seul le texte sera utilisé, afin d’éviter la tarification audio.
- `max_duration_seconds` (integer, optional) — La durée maximale d’une conversation, en secondes

### AgentConfigOverrideOutput

- `first_message` (string, optional) — S’il n’est pas vide, premier message que l’agent prononcera. S’il est vide, l’agent attend que l’utilisateur commence la discussion.
- `language` (string, optional) — Langue de l'agent, utilisée pour l'ASR et le TTS
- `max_conversation_duration_message` (string, optional) — S’il n’est pas vide, message que l’agent enverra lorsque la durée maximale de la conversation sera atteinte.
- `prompt` (PromptAgentApiModelOverrideOutput, optional) — Le prompt de l’agent

### BuiltInToolsOutput

Outils système pouvant être attribués à un agent conversationnel. Ils ne sont délibérément pas nommés ConversationalBuiltInTools : BuiltInToolsInput et BuiltInToolsOutput font partie de la spécification publique de l’API et des SDK générés.

- `transfer_to_agent` (SystemToolConfigOutput, optional) — L’outil de transfert vers un agent.
- `end_call` (SystemToolConfigOutput, optional) — L’outil de fin d’appel
- `language_detection` (SystemToolConfigOutput, optional) — L’outil de détection de langue
- `transfer_to_number` (SystemToolConfigOutput, optional) — L’outil de transfert vers un numéro.
- `skip_turn` (SystemToolConfigOutput, optional) — L'outil d'ignorance de tour
- `play_keypad_touch_tone` (SystemToolConfigOutput, optional) — L’outil de lecture DTMF
- `voicemail_detection` (SystemToolConfigOutput, optional) — L’outil de détection de messagerie vocale

### CustomLlm

- `url` (string, required) — L’URL du point de terminaison compatible avec Chat Completions
- `model_id` (string, optional) — L’ID du modèle à utiliser si l’URL dessert plusieurs modèles
- `api_key` (CustomLlmApiKey, optional) — Clé API utilisée pour l’authentification. Il peut s’agir d’une référence à un secret du Workspace \{'secret\_id': '...'} ou d’une référence à une variable d’environnement \{'env\_var\_label': '...'}.
- `auth_connection` (CustomLlmAuthConnection, optional) — Connexion d'authentification facultative du Workspace. Seules les connexions d'authentification produisant un jeton Authorization Bearer sont prises en charge ; les connexions d'authentification Basic, mTLS, par en-tête personnalisé et par secret d'URL ne sont pas prises en charge.
- `request_headers` (map from string to CustomLlmRequestHeadersValue, optional) — En-têtes à inclure dans la requête.
- `api_version` (string, optional) — Version de l’API à utiliser pour la requête
- `api_type` (enum, optional, default: chat_completions) — Type d’API à utiliser (chat_completions, responses ou 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) — Distance vectorielle maximale des fragments récupérés.
- `max_documents_length` (integer, optional, default: 50000) — Longueur totale maximale des fragments de document récupérés depuis RAG.
- `max_retrieved_rag_chunks_count` (integer, optional, default: 20) — Nombre maximal de fragments de document RAG à récupérer initialement depuis la base vectorielle. Ils sont ensuite filtrés selon la distance vectorielle et la longueur totale.
- `num_candidates` (integer, optional) — Nombre de candidats évalués dans la recherche vectorielle ANN. Une valeur plus élevée améliore les résultats, mais augmente la latence. La valeur minimale recommandée est 100. Si cette option est désactivée, la valeur par défaut est utilisée.
- `query_rewrite_prompt_override` (string, optional) — Prompt personnalisé pour reformuler les requêtes utilisateur avant la récupération RAG. L'historique de la conversation est automatiquement ajouté à la fin. S'il n'est pas défini, le prompt par défaut est utilisé.
- `knowledge_base_tool_info` (KnowledgeBaseToolInfo, optional) — Lorsqu’il est défini, l’agent utilise l’outil knowledge_base au lieu de l’ancien outil knowledge_base_rag. None signifie que l’agent n’y a pas adhéré.

### PromptAgentApiModelOutputBackupLlmConfig

Configuration du basculement en cascade des LLM de secours. Peut être désactivée, utiliser les valeurs par défaut du système ou spécifier un ordre personnalisé.

- `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`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`

### PromptAgentApiModelOutputToolsItem

Le type d’outil.

- `type`: `api_integration_webhook`
  - `api_integration_connection_id` (string, required)
  - `api_integration_id` (string, required)
  - `assignments` (list of DynamicVariableAssignment, required) — Configuration permettant d'extraire des valeurs des réponses d'outils et de les attribuer à des variables dynamiques
  - `description` (string, required) — Description des situations dans lesquelles l’outil doit être utilisé et de ce qu’il fait.
  - `dynamic_variables` (DynamicVariablesConfig, required) — Configuration des variables dynamiques
  - `execution_mode` (enum, required, default: immediate) — Détermine quand et comment l’outil s’exécute : 'immediate' exécute l’outil immédiatement lorsqu’il est demandé par le LLM, 'post_tool_speech' attend que l’agent ait fini de parler avant de l’exécuter, et 'async' exécute l’outil en arrière-plan sans bloquer, idéal pour les opérations longues.
    - Allowed values: `immediate`, `post_tool_speech`, `async`
  - `interruption_mode` (enum, required, default: allow) — Détermine si l'utilisateur peut interrompre l'agent lors de cet appel d'outil. « allow » (valeur par défaut) permet à l'utilisateur d'interrompre à tout moment, « disable_during_tool » bloque les interruptions uniquement pendant l'exécution de l'outil et « disable_during_tool_and_turn » les bloque pendant l'exécution de l'outil et pour la réponse suivante de l'agent.
    - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
  - `name` (string, required)
  - `pre_tool_speech` (enum, required, default: auto) — Détermine si l'agent parle avant l'appel de cet outil. « auto » (valeur par défaut) décide selon la latence récente de l'outil, « force » demande toujours à l'agent de parler et « off » désactive entièrement cette fonction, quelle que soit la latence.
    - Allowed values: `auto`, `force`, `off`
  - `response_timeout_secs` (integer, required, default: 20) — Le délai maximal, en secondes, avant la fin de l’appel d’outil. Doit être compris entre 5 et 300 secondes, incluses.
  - `tool_call_sound_behavior` (enum, required, default: auto) — Détermine quand le son d’appel de l’outil doit être joué. 'auto' le joue uniquement lorsqu’une parole précède l’outil, tandis que 'always' le joue pour chaque appel d’outil.
    - Allowed values: `auto`, `always`
  - `tool_error_handling_mode` (enum, required, default: auto) — Contrôle le traitement des erreurs d'outil avant leur partage avec l'agent. « auto » détermine le traitement selon le type d'outil, avec un résumé pour les intégrations natives et le masquage pour les autres ; « summarized » envoie un résumé généré par un LLM, « passthrough » envoie l'erreur brute et « hide » ne partage pas l'erreur avec l'agent.
    - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
  - `tool_version` (string, required, default: 1.0.0) — La version de l’outil d’intégration API
  - `disable_interruptions` (boolean, required, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `interruption_mode`. Si la valeur est true, l'utilisateur ne pourra pas interrompre l'agent pendant l'exécution de cet outil.
  - `force_pre_tool_speech` (boolean, required, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `pre_tool_speech`. Si la valeur est true, l'agent parlera avant l'appel de l'outil.
  - `api_schema_overrides` (ApiIntegrationWebhookOverrides, optional) — Substitutions utilisateur appliquées en complément du api_schema de base
  - `tool_call_sound` (enum, optional) — Type de son d’appel d’outil prédéfini à diffuser lors de l’exécution de l’outil. S’il n’est pas spécifié, aucun son d’appel d’outil ne sera diffusé.
    - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
- `type`: `client`
  - `description` (string, required) — Description des situations dans lesquelles l’outil doit être utilisé et de ce qu’il fait.
  - `name` (string, required)
  - `assignments` (list of DynamicVariableAssignment, optional) — Configuration permettant d'extraire des valeurs des réponses d'outils et de les attribuer à des variables dynamiques
  - `dynamic_variables` (DynamicVariablesConfig, optional) — Configuration des variables dynamiques
  - `execution_mode` (enum, optional, default: immediate) — Détermine quand et comment l’outil s’exécute : 'immediate' exécute l’outil immédiatement lorsqu’il est demandé par le LLM, 'post_tool_speech' attend que l’agent ait fini de parler avant de l’exécuter, et 'async' exécute l’outil en arrière-plan sans bloquer, idéal pour les opérations longues.
    - Allowed values: `immediate`, `post_tool_speech`, `async`
  - `expects_response` (boolean, optional, default: false) — Si true, l’appel de cet outil doit bloquer la conversation jusqu’à ce que le client fournisse une réponse, qui est transmise au LLM. Si false, la conversation se poursuit sans attendre la réponse du client. Cela permet d’afficher du contenu à un utilisateur sans bloquer la conversation.
  - `interruption_mode` (enum, optional, default: allow) — Détermine si l'utilisateur peut interrompre l'agent lors de cet appel d'outil. « allow » (valeur par défaut) permet à l'utilisateur d'interrompre à tout moment, « disable_during_tool » bloque les interruptions uniquement pendant l'exécution de l'outil et « disable_during_tool_and_turn » les bloque pendant l'exécution de l'outil et pour la réponse suivante de l'agent.
    - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
  - `parameters` (ObjectJsonSchemaPropertyOutput, optional) — Schéma des paramètres à transmettre au client
  - `pre_tool_speech` (enum, optional, default: auto) — Détermine si l'agent parle avant l'appel de cet outil. « auto » (valeur par défaut) décide selon la latence récente de l'outil, « force » demande toujours à l'agent de parler et « off » désactive entièrement cette fonction, quelle que soit la latence.
    - Allowed values: `auto`, `force`, `off`
  - `response_timeout_secs` (integer, optional, default: 20) — Durée maximale, en secondes, d’attente de la fin de l’appel d’outil. Doit être comprise entre 1 et 120 secondes (incluses), ou égale à -1 pour attendre indéfiniment la réponse du client (nécessite expects_response).
  - `tool_call_sound` (enum, optional) — Type de son d’appel d’outil prédéfini à diffuser lors de l’exécution de l’outil. S’il n’est pas spécifié, aucun son d’appel d’outil ne sera diffusé.
    - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
  - `tool_call_sound_behavior` (enum, optional, default: auto) — Détermine quand le son d’appel de l’outil doit être joué. 'auto' le joue uniquement lorsqu’une parole précède l’outil, tandis que 'always' le joue pour chaque appel d’outil.
    - Allowed values: `auto`, `always`
  - `tool_error_handling_mode` (enum, optional, default: auto) — Contrôle le traitement des erreurs d'outil avant leur partage avec l'agent. « auto » détermine le traitement selon le type d'outil, avec un résumé pour les intégrations natives et le masquage pour les autres ; « summarized » envoie un résumé généré par un LLM, « passthrough » envoie l'erreur brute et « hide » ne partage pas l'erreur avec l'agent.
    - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
  - `disable_interruptions` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `interruption_mode`. Si la valeur est true, l'utilisateur ne pourra pas interrompre l'agent pendant l'exécution de cet outil.
  - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `pre_tool_speech`. Si la valeur est true, l'agent parlera avant l'appel de l'outil.
- `type`: `mcp`
  - `value` (any, required)
- `type`: `smb`
  - `value` (any, required)
- `type`: `system`
  - `name` (string, required)
  - `params` (SystemToolConfigOutputParams, required)
  - `assignments` (list of DynamicVariableAssignment, optional) — Configuration permettant d'extraire des valeurs des réponses d'outils et de les attribuer à des variables dynamiques
  - `description` (string, optional, default: ) — Description des situations dans lesquelles l’outil doit être utilisé et de ce qu’il fait. Laissez ce champ vide pour utiliser la description par défaut, optimisée pour le type d’outil concerné.
  - `interruption_mode` (enum, optional, default: allow) — Détermine si l'utilisateur peut interrompre l'agent lors de cet appel d'outil. « allow » (valeur par défaut) permet à l'utilisateur d'interrompre à tout moment, « disable_during_tool » bloque les interruptions uniquement pendant l'exécution de l'outil et « disable_during_tool_and_turn » les bloque pendant l'exécution de l'outil et pour la réponse suivante de l'agent.
    - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
  - `pre_tool_speech` (enum, optional, default: auto) — Détermine si l'agent parle avant l'appel de cet outil. « auto » (valeur par défaut) décide selon la latence récente de l'outil, « force » demande toujours à l'agent de parler et « off » désactive entièrement cette fonction, quelle que soit la latence.
    - Allowed values: `auto`, `force`, `off`
  - `response_timeout_secs` (integer, optional, default: 20) — Le délai maximal, en secondes, avant la fin de l’appel d’outil.
  - `tool_call_sound` (enum, optional) — Type de son d’appel d’outil prédéfini à diffuser lors de l’exécution de l’outil. S’il n’est pas spécifié, aucun son d’appel d’outil ne sera diffusé.
    - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
  - `tool_call_sound_behavior` (enum, optional, default: auto) — Détermine quand le son d’appel de l’outil doit être joué. 'auto' le joue uniquement lorsqu’une parole précède l’outil, tandis que 'always' le joue pour chaque appel d’outil.
    - Allowed values: `auto`, `always`
  - `tool_error_handling_mode` (enum, optional, default: auto) — Contrôle le traitement des erreurs d'outil avant leur partage avec l'agent. « auto » détermine le traitement selon le type d'outil, avec un résumé pour les intégrations natives et le masquage pour les autres ; « summarized » envoie un résumé généré par un LLM, « passthrough » envoie l'erreur brute et « hide » ne partage pas l'erreur avec l'agent.
    - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
  - `disable_interruptions` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `interruption_mode`. Si la valeur est true, l'utilisateur ne pourra pas interrompre l'agent pendant l'exécution de cet outil.
  - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `pre_tool_speech`. Si la valeur est true, l'agent parlera avant l'appel de l'outil.
- `type`: `webhook`
  - `api_schema` (WebhookToolApiSchemaConfigOutput, required) — Le schéma du webhook sortant, y compris les paramètres et la spécification de l'URL
  - `description` (string, required) — Description des situations dans lesquelles l’outil doit être utilisé et de ce qu’il fait.
  - `name` (string, required)
  - `assignments` (list of DynamicVariableAssignment, optional) — Configuration permettant d'extraire des valeurs des réponses d'outils et de les attribuer à des variables dynamiques
  - `dynamic_variables` (DynamicVariablesConfig, optional) — Configuration des variables dynamiques
  - `execution_mode` (enum, optional, default: immediate) — Détermine quand et comment l’outil s’exécute : 'immediate' exécute l’outil immédiatement lorsqu’il est demandé par le LLM, 'post_tool_speech' attend que l’agent ait fini de parler avant de l’exécuter, et 'async' exécute l’outil en arrière-plan sans bloquer, idéal pour les opérations longues.
    - Allowed values: `immediate`, `post_tool_speech`, `async`
  - `follow_redirects` (boolean, optional, default: false) — Indique s'il faut suivre une redirection depuis le point de terminaison et renvoyer la réponse finale. Une seule redirection est suivie, sous la forme d'une requête GET sans corps de requête ; aucun élément configuré sur cet outil, comme les en-têtes, l'authentification ou le certificat client, n'est envoyé à la cible de redirection. Le point de terminaison et la cible de redirection doivent tous deux utiliser HTTPS. Non pris en charge pour les outils d'intégration d'API.
  - `follow_redirects_allowed_domains` (list of string, optional) — Domaines vers lesquels une redirection peut pointer, par exemple 'test.example.com'. Requis pour suivre les redirections, toute cible hors de cette liste étant refusée.
  - `interruption_mode` (enum, optional, default: allow) — Détermine si l'utilisateur peut interrompre l'agent lors de cet appel d'outil. « allow » (valeur par défaut) permet à l'utilisateur d'interrompre à tout moment, « disable_during_tool » bloque les interruptions uniquement pendant l'exécution de l'outil et « disable_during_tool_and_turn » les bloque pendant l'exécution de l'outil et pour la réponse suivante de l'agent.
    - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
  - `pre_tool_speech` (enum, optional, default: auto) — Détermine si l'agent parle avant l'appel de cet outil. « auto » (valeur par défaut) décide selon la latence récente de l'outil, « force » demande toujours à l'agent de parler et « off » désactive entièrement cette fonction, quelle que soit la latence.
    - Allowed values: `auto`, `force`, `off`
  - `response_timeout_secs` (integer, optional, default: 20) — Le délai maximal, en secondes, avant la fin de l’appel d’outil. Doit être compris entre 5 et 300 secondes, incluses.
  - `tool_call_sound` (enum, optional) — Type de son d’appel d’outil prédéfini à diffuser lors de l’exécution de l’outil. S’il n’est pas spécifié, aucun son d’appel d’outil ne sera diffusé.
    - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
  - `tool_call_sound_behavior` (enum, optional, default: auto) — Détermine quand le son d’appel de l’outil doit être joué. 'auto' le joue uniquement lorsqu’une parole précède l’outil, tandis que 'always' le joue pour chaque appel d’outil.
    - Allowed values: `auto`, `always`
  - `tool_error_handling_mode` (enum, optional, default: auto) — Contrôle le traitement des erreurs d'outil avant leur partage avec l'agent. « auto » détermine le traitement selon le type d'outil, avec un résumé pour les intégrations natives et le masquage pour les autres ; « summarized » envoie un résumé généré par un LLM, « passthrough » envoie l'erreur brute et « hide » ne partage pas l'erreur avec l'agent.
    - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
  - `disable_interruptions` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `interruption_mode`. Si la valeur est true, l'utilisateur ne pourra pas interrompre l'agent pendant l'exécution de cet outil.
  - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `pre_tool_speech`. Si la valeur est true, l'agent parlera avant l'appel de l'outil.

### WidgetTextContentsTranslation

- `source` (map from string to string, optional) — Le texte source dont chaque champ traduit est dérivé
- `text` (map from string to string, optional) — La dernière sortie traduite automatiquement pour chaque champ traduit

### WidgetTermsTranslation

- `source_hash` (string, required)
- `text` (string, required)

### AsrConversationalConfigOverrideConfig

- `keywords` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ keywords.

### TurnConfigOverrideConfig

- `soft_timeout_config` (SoftTimeoutConfigOverrideConfig, optional) — Configure les remplacements pour les champs imbriqués.

### TtsConversationalConfigOverrideConfig

- `model_id` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ model_id.
- `voice_id` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ voice_id.
- `supported_voices` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ supported_voices.
- `stability` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ stability.
- `speed` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ speed.
- `similarity_boost` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ similarity_boost.
- `pronunciation_dictionary_locators` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ pronunciation_dictionary_locators.

### ConversationConfigOverrideConfig

- `text_only` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ text_only.
- `max_duration_seconds` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ max_duration_seconds.

### AgentConfigOverrideConfig

- `first_message` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ first_message.
- `language` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ language.
- `max_conversation_duration_message` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ max_conversation_duration_message.
- `prompt` (PromptAgentApiModelOverrideConfig, optional) — Configure les remplacements pour les champs imbriqués.

### ConversationInitiationClientDataWebhookRequestHeadersValue

- string
- Conv AI Secret Locator: ConvAiSecretLocator

### 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?".) — Retour personnalisé à injecter dans l'agent lors d'une nouvelle tentative après le déclenchement d'une règle de sécurité.

### CustomGuardrailsConfigInput

Conteneur de configuration pour la liste de garde-fous personnalisés

- `configs` (list of CustomGuardrailConfig, optional)

### AstNodeInput

- `type`: `add_operator`
  - `left` (AstNodeInput, required) — Opérande gauche de l'opérateur binaire.
  - `right` (AstNodeInput, required) — Opérande droit de l’opérateur binaire.
- `type`: `and_operator`
  - `children` (list of AstNodeInput, required) — Nœuds enfants de l'opérateur logique.
- `type`: `boolean_literal`
  - `value` (boolean, required) — Valeur de ce littéral.
- `type`: `conditional_operator`
  - `condition` (AstNodeInput, required) — Condition déterminant l'expression à sélectionner.
  - `falseExpression` (AstNodeInput, required) — Expression sélectionnée si la condition est false.
  - `trueExpression` (AstNodeInput, required) — Expression sélectionnée si la condition est true.
- `type`: `div_operator`
  - `left` (AstNodeInput, required) — Opérande gauche de l'opérateur binaire.
  - `right` (AstNodeInput, required) — Opérande droit de l’opérateur binaire.
- `type`: `dynamic_variable`
  - `name` (string, required) — Le nom de la variable dynamique.
- `type`: `eq_operator`
  - `left` (AstNodeInput, required) — Opérande gauche de l'opérateur binaire.
  - `right` (AstNodeInput, required) — Opérande droit de l’opérateur binaire.
- `type`: `gt_operator`
  - `left` (AstNodeInput, required) — Opérande gauche de l'opérateur binaire.
  - `right` (AstNodeInput, required) — Opérande droit de l’opérateur binaire.
- `type`: `gte_operator`
  - `left` (AstNodeInput, required) — Opérande gauche de l'opérateur binaire.
  - `right` (AstNodeInput, required) — Opérande droit de l’opérateur binaire.
- `type`: `llm`
  - `value_schema` (LlmLiteralJsonSchemaProperty, optional) — Schéma JSON décrivant la valeur que le LLM doit extraire.
  - `prompt` (string, optional, deprecated) — Le prompt à évaluer en valeur booléenne. Obsolète. Utilisez plutôt un schéma booléen.
- `type`: `lt_operator`
  - `left` (AstNodeInput, required) — Opérande gauche de l'opérateur binaire.
  - `right` (AstNodeInput, required) — Opérande droit de l’opérateur binaire.
- `type`: `lte_operator`
  - `left` (AstNodeInput, required) — Opérande gauche de l'opérateur binaire.
  - `right` (AstNodeInput, required) — Opérande droit de l’opérateur binaire.
- `type`: `mul_operator`
  - `left` (AstNodeInput, required) — Opérande gauche de l'opérateur binaire.
  - `right` (AstNodeInput, required) — Opérande droit de l’opérateur binaire.
- `type`: `neq_operator`
  - `left` (AstNodeInput, required) — Opérande gauche de l'opérateur binaire.
  - `right` (AstNodeInput, required) — Opérande droit de l’opérateur binaire.
- `type`: `null_literal`
- `type`: `number_literal`
  - `value` (AstNumberNodeInputValue, required) — Valeur de ce littéral.
- `type`: `or_operator`
  - `children` (list of AstNodeInput, required) — Nœuds enfants de l'opérateur logique.
- `type`: `string_literal`
  - `value` (string, required) — Valeur de ce littéral.
- `type`: `sub_operator`
  - `left` (AstNodeInput, required) — Opérande gauche de l'opérateur binaire.
  - `right` (AstNodeInput, required) — Opérande droit de l’opérateur binaire.

### AsrConversationalConfigWorkflowOverride

- `quality` ("high", optional) — La qualité de la transcription
- `provider` (enum, optional, default: scribe_realtime) — Le fournisseur du service de transcription
  - Allowed values: `elevenlabs`, `scribe_realtime`, `scribe_v2_turbo`
- `user_input_audio_format` (enum, optional, default: pcm_16000) — Le format de l’audio à transcrire
  - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000`
- `keywords` (list of string, optional) — Mots-clés dont la probabilité de prédiction doit être augmentée

### TurnConfigWorkflowOverride

- `turn_timeout` (double, optional) — Temps d’attente maximal de la réponse de l’utilisateur avant de le solliciter à nouveau
- `initial_wait_time` (double, optional) — How long the agent will wait for the user to start the conversation if the first message is empty. If not set, uses the regular turn_timeout.
- `silence_end_call_timeout` (double, optional) — Temps d’attente maximal depuis la dernière intervention de l’utilisateur avant de mettre fin à l’appel
- `turn_eagerness` (enum, optional, default: normal) — Contrôle la réactivité de l'agent. Faible = moins réactif (attend davantage), Standard = réactivité par défaut, Élevé = plus réactif (répond plus rapidement)
  - Allowed values: `patient`, `normal`, `eager`
- `spelling_patience` (enum, optional, default: auto) — Détermine si l'agent doit attendre davantage lorsque l'utilisateur épelle des nombres et des entités nommées. Auto = selon le modèle, Off = ne jamais attendre davantage
  - Allowed values: `auto`, `off`
- `speculative_turn` (boolean, optional) — Lorsque cette option est activée, la génération des réponses du LLM commence pendant le silence, avant que la confiance totale du tour de parole soit atteinte, afin de réduire la latence perçue. Peut augmenter les coûts du LLM.
- `retranscribe_on_turn_timeout` (boolean, optional) — Lorsqu’elle est activée, si la VAD ne détecte aucune parole, tente de retranscrire l’audio accumulé à l’expiration du délai du tour. Désactive la facturation avec réduction pour les silences tant qu’elle est activée pour l’agent ou le nœud de workflow actif.
- `turn_model` (enum, optional, default: turn_v3) — Version du modèle de détection des tours de parole à utiliser.
  - Allowed values: `turn_v2`, `turn_v3`
- `interruption_ignore_terms` (list of string, optional) — Liste des termes qui ne doivent pas déclencher d'interruption lorsqu'ils sont prononcés par l'utilisateur, par exemple « gotcha » ou « understood ». Utilise une correspondance exacte insensible à la casse.
- `interruption_ignore_term_languages` (list of string, optional) — Codes de langue pour lesquels des catégories prédéfinies de termes à ignorer ont été activées. Ils sont stockés explicitement afin que l'affichage ne soit pas déduit du chevauchement des termes.
- `merge_with_default_ignore_terms` (boolean, optional) — Lorsque cette option est activée, les termes par défaut sélectionnés pour interruption_ignore_term_languages sont utilisés en plus de interruption_ignore_terms.
- `transcribe_on_disabled_interruptions` (boolean, optional) — Lorsque les interruptions sont désactivées, transcrit tout de même ce que dit l’utilisateur afin de le reporter au tour suivant. Lorsque cette option est désactivée, la parole de l’utilisateur pendant un tour non interruptible est ignorée et ne déclenche pas de tour de parole.
- `soft_timeout_config` (SoftTimeoutConfigWorkflowOverride, optional) — Configuration de la fonctionnalité de délai d'expiration souple. Fournit un retour immédiat pendant les réponses plus longues des LLM.

### TtsConversationalConfigWorkflowOverrideInput

- `model_id` (enum, optional, default: eleven_v4_turbo) — Le modèle à utiliser pour le TTS
  - 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) — L’ID de voix à utiliser pour le TTS
- `supported_voices` (list of SupportedVoice, optional) — Voix supplémentaires prises en charge pour l'agent
- `expressive_mode` (boolean, optional) — Lorsque cette option est activée, applique le prompt de balises audio expressives. Elle est automatiquement désactivée pour les modèles autres que v3.
- `suggested_audio_tags` (list of SuggestedAudioTag, optional) — Suggested audio tags to boost expressive speech (for eleven_v3 and eleven_v3_conversational models). The agent can still use other tags not listed here.
- `agent_output_audio_format` (enum, optional, default: pcm_16000) — Format audio à utiliser pour le TTS
  - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000`
- `optimize_streaming_latency` (integer, optional) — Obsolète : ce champ n'a aucun effet et est ignoré.
- `stability` (double, optional) — La stabilité de la parole générée
- `speed` (double, optional) — La vitesse de la parole générée
- `similarity_boost` (double, optional) — L'amélioration de similarité pour la parole générée
- `text_normalisation_type` (enum, optional, default: system_prompt) — Méthode de conversion des nombres en mots avant la synthèse vocale. Si elle est définie sur SYSTEM_PROMPT, le prompt système est mis à jour pour inclure des instructions de normalisation. Si elle est définie sur ELEVENLABS, le texte est normalisé après la génération, ce qui entraîne une légère latence supplémentaire.
  - Allowed values: `system_prompt`, `elevenlabs`
- `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional) — Les localisateurs de dictionnaires de prononciation
- `enable_phoneme_tags` (boolean, optional) — Active la gestion des balises de phonèmes SSML pour les modèles V3. Lorsqu'elle est activée, les balises de phonèmes, en ligne et issues des dictionnaires de prononciation, sont analysées en API en ligne avant d'être envoyées au modèle.
- `audio_effects` (EffectsSpecInput, optional) — Spécification facultative des effets TTS : préréglage de filtre, distance (égalisation de proximité) et environnement (réverbération par convolution).

### ConversationConfigWorkflowOverrideInput

- `text_only` (boolean, optional) — Si cette option est activée, l’audio ne sera pas traité et seul le texte sera utilisé, afin d’éviter la tarification audio.
- `max_duration_seconds` (integer, optional) — La durée maximale d’une conversation, en secondes
- `client_events` (list of enum, optional) — Les événements qui seront envoyés au client
  - 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) — Configuration des entrées de fichiers (chargements d'images/PDF) pendant les conversations.
- `monitoring_enabled` (boolean, optional) — Active la surveillance des conversations en temps réel via WebSocket
- `monitoring_events` (list of enum, optional) — Les événements qui seront envoyés aux connexions de surveillance.
  - 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) — Configurez la collecte de saisies DTMF (clavier téléphonique) pendant les appels
- `background_sound` (BackgroundSoundConfigWorkflowOverride, optional) — Configuration du son d'arrière-plan durant les conversations.
- `source_attribution` (boolean, optional) — Lorsque cette option est activée et que la base de connaissances contient du contenu, le LLM reçoit l’instruction d’indiquer les sources qu’il a utilisées.

### LanguagePresetInput

- `overrides` (ConversationConfigClientOverrideInput, required) — Les remplacements du préréglage linguistique
- `first_message_translation` (LanguagePresetTranslation, optional) — La traduction du premier message.
- `soft_timeout_translation` (LanguagePresetTranslation, optional) — La traduction du message de délai d’expiration souple.

### VadConfigWorkflowOverride

### AgentConfigApiModelWorkflowOverrideInput

- `first_message` (string, optional) — S’il n’est pas vide, premier message que l’agent prononcera. S’il est vide, l’agent attend que l’utilisateur commence la discussion.
- `language` (string, optional) — Langue de l'agent, utilisée pour l'ASR et le TTS
- `hinglish_mode` (boolean, optional) — Lorsqu’elle est activée, l’agent intègre des mots et des expressions en anglais dans les réponses en hindi, en malayalam, en télougou ou en kannada.
- `dynamic_variables` (DynamicVariablesConfigWorkflowOverride, optional) — Configuration des variables dynamiques
- `disable_first_message_interruptions` (boolean, optional) — Si true, l’utilisateur ne pourra pas interrompre l’agent pendant la diffusion du premier message.
- `max_conversation_duration_message` (string, optional) — S’il n’est pas vide, message que l’agent enverra lorsque la durée maximale de la conversation sera atteinte.
- `text_behavior_overrides` (map from string to BehaviorOverride, optional) — Remplacements du comportement de réponse par canal pour les conversations textuelles. Les valeurs par défaut intégrées au canal s’appliquent lorsqu’aucune valeur n’est définie.
- `prompt` (PromptAgentApiModelWorkflowOverrideInput, optional) — Le prompt de l’agent

### WorkflowToolLocatorSchemaOverridesValue

- `source`: `constant`
  - `constant_value` (ConstantSchemaOverrideConstantValue, optional) — Valeur constante à utiliser
- `source`: `dynamic_variable`
  - `dynamic_variable` (string, required) — Le nom de la variable dynamique à utiliser
- `source`: `llm`
  - `prompt` (string, optional) — Remplacement du prompt pour le LLM. S’il n’est pas fourni, la description du schéma d’origine est utilisée.
- `source`: `omit`

### TranslatedString

- `value` (string, required)

### SoftTimeoutConfigOverride

- `message` (string, optional) — Message à afficher lorsque le premier délai d’expiration souple est atteint pendant l’attente d’une réponse LLM. Prend en charge les variables dynamiques, par exemple \{\{system\_\_time}} et \{\{custom\_variable}}.
- `additional_soft_timeout_messages` (list of string, optional) — Messages statiques de remplissage supplémentaires pour les délais d'attente souples suivants dans la même génération LLM. Le premier délai utilise `message`. Si moins de messages sont configurés que `max_soft_timeouts_per_generation`, le dernier message configuré est répété ; sinon, un message de remplissage intégré est utilisé.

### PromptAgentApiModelOverrideOutput

- `prompt` (string, optional) — Le prompt de l’agent
- `llm` (enum, optional) — Le LLM à interroger avec le prompt et l’historique de discussion. En cas de résidence des données européenne, le LLM doit être pris en charge dans l’environnement de résidence des données.
  - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`
- `tool_ids` (list of string, optional) — Liste des ID des outils utilisés par l’agent.
- `tool_ids_strict` (boolean, optional) — Only applies as a conversation override, allowed whenever tool_ids may be overridden. When true, the overridden tool_ids is the full list of tools allowed in the conversation, including tools on workflow nodes. Ignored when set on the agent.
- `native_mcp_server_ids` (list of string, optional) — Liste des identifiants de serveurs MCP natifs à utiliser par l'agent
- `knowledge_base` (list of KnowledgeBaseLocator, optional) — Liste des bases de connaissances à utiliser par l'agent

### SystemToolConfigOutput

Un outil système permet d'appeler une méthode système sur le serveur

- `name` (string, required)
- `params` (SystemToolConfigOutputParams, required)
- `type` ("system", optional) — Le type d’outil.
- `description` (string, optional, default: ) — Description des situations dans lesquelles l’outil doit être utilisé et de ce qu’il fait. Laissez ce champ vide pour utiliser la description par défaut, optimisée pour le type d’outil concerné.
- `response_timeout_secs` (integer, optional, default: 20) — Le délai maximal, en secondes, avant la fin de l’appel d’outil.
- `interruption_mode` (enum, optional, default: allow) — Détermine si l'utilisateur peut interrompre l'agent lors de cet appel d'outil. « allow » (valeur par défaut) permet à l'utilisateur d'interrompre à tout moment, « disable_during_tool » bloque les interruptions uniquement pendant l'exécution de l'outil et « disable_during_tool_and_turn » les bloque pendant l'exécution de l'outil et pour la réponse suivante de l'agent.
  - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
- `pre_tool_speech` (enum, optional, default: auto) — Détermine si l'agent parle avant l'appel de cet outil. « auto » (valeur par défaut) décide selon la latence récente de l'outil, « force » demande toujours à l'agent de parler et « off » désactive entièrement cette fonction, quelle que soit la latence.
  - Allowed values: `auto`, `force`, `off`
- `assignments` (list of DynamicVariableAssignment, optional) — Configuration permettant d'extraire des valeurs des réponses d'outils et de les attribuer à des variables dynamiques
- `tool_call_sound` (enum, optional) — Type de son d’appel d’outil prédéfini à diffuser lors de l’exécution de l’outil. S’il n’est pas spécifié, aucun son d’appel d’outil ne sera diffusé.
  - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
- `tool_call_sound_behavior` (enum, optional, default: auto) — Détermine quand le son d’appel de l’outil doit être joué. 'auto' le joue uniquement lorsqu’une parole précède l’outil, tandis que 'always' le joue pour chaque appel d’outil.
  - Allowed values: `auto`, `always`
- `tool_error_handling_mode` (enum, optional, default: auto) — Contrôle le traitement des erreurs d'outil avant leur partage avec l'agent. « auto » détermine le traitement selon le type d'outil, avec un résumé pour les intégrations natives et le masquage pour les autres ; « summarized » envoie un résumé généré par un LLM, « passthrough » envoie l'erreur brute et « hide » ne partage pas l'erreur avec l'agent.
  - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
- `disable_interruptions` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `interruption_mode`. Si la valeur est true, l'utilisateur ne pourra pas interrompre l'agent pendant l'exécution de cet outil.
- `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `pre_tool_speech`. Si la valeur est true, l'agent parlera avant l'appel de l'outil.

### CustomLlmApiKey

Clé API utilisée pour l’authentification. Il peut s’agir d’une référence à un secret du Workspace \{'secret\_id': '...'} ou d’une référence à une variable d’environnement \{'env\_var\_label': '...'}.

- Conv AI Secret Locator: ConvAiSecretLocator
- Conv AI Env Var Locator: ConvAiEnvVarLocator

### CustomLlmAuthConnection

Connexion d'authentification facultative du Workspace. Seules les connexions d'authentification produisant un jeton Authorization Bearer sont prises en charge ; les connexions d'authentification Basic, mTLS, par en-tête personnalisé et par secret d'URL ne sont pas prises en charge.

- Auth Connection Locator: AuthConnectionLocator
- Environment Auth Connection Locator: EnvironmentAuthConnectionLocator

### CustomLlmRequestHeadersValue

- string
- Conv AI Secret Locator: ConvAiSecretLocator
- Conv AI Dynamic Variable: ConvAiDynamicVariable
- Conv AI Env Var Locator: ConvAiEnvVarLocator

### KnowledgeBaseToolInfo

- `enabled_strategies` (list of enum, optional) — Stratégies de recherche exposées au modèle. Ne peut pas être vide.
  - Allowed values: `cat`, `keyword`, `semantic`, `ls`

### DynamicVariableAssignment

Configuration permettant d'extraire des valeurs des réponses d'outils et de les attribuer à des variables dynamiques.

- `dynamic_variable` (string, required) — Le nom de la variable dynamique à laquelle attribuer la valeur extraite
- `value_path` (string, required) — Chemin en notation pointée permettant d’extraire la valeur de la source, par exemple 'user.name' ou 'data.0.id'.
- `source` ("response", optional) — La source dont extraire la valeur. Seul « response » est actuellement pris en charge.
- `sanitize` (boolean, optional, default: false) — Si true, la valeur de cette affectation sera retirée de la réponse de l’outil avant son envoi au LLM et à la transcription, mais restera traitée pour l’affectation de variables.
- `preserve_native_type` (boolean, optional, default: false) — Si true, les valeurs non scalaires, comme les listes et objets, extraites de la réponse de l’outil sont stockées dans leur type natif au lieu d’être converties en chaînes JSON. Activez cette option pour utiliser directement les tableaux extraits comme variables dynamiques de liste.

### DynamicVariablesConfig

- `dynamic_variable_placeholders` (map from string to any, optional) — Dictionnaire des espaces réservés de variables dynamiques et de leurs valeurs.

### ApiIntegrationWebhookOverrides

- `schema_overrides` (map from string to ApiIntegrationWebhookOverridesSchemaOverridesValue, optional)
- `response_filter_mode` (enum, optional, default: all) — Contrôle le filtrage des réponses d'outil avant qu'elles ne soient visibles par l'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: ) — Lorsqu’il est défini, l’intégralité du paramètre est renseignée à partir de cette variable dynamique à l’exécution. S’exclut mutuellement avec description (valeur fournie par le LLM), constant_value et is_omitted.
- `constant_value` (map from string to any, optional) — Lorsqu’elle est définie, l’intégralité de l’objet utilise cette valeur JSON constante à l’exécution. S’exclut mutuellement avec description (objet fourni par le LLM), dynamic_variable et is_omitted.
- `is_omitted` (boolean, optional, default: false) — Si true, ce paramètre sera entièrement omis de la requête. Valide uniquement pour les paramètres facultatifs. Mutuellement exclusif avec description, dynamic_variable et constant_value.
- `type` ("object", optional)
- `required` (list of string, optional)
- `properties` (map from string to ObjectJsonSchemaPropertyOutputPropertiesValue, optional)
- `required_constraints` (RequiredConstraints, optional) — Conteneur pour les contraintes de composition anyOf/allOf limitées aux champs obligatoires.

### 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) — Si aucun changement de langue ne se produit lors des 2 premiers tours de l’utilisateur, les tentatives ultérieures échouent et la conversation reste dans la langue actuelle. Si la langue change pendant ces tours, les changements ultérieurs restent possibles. Activez cette option pour réduire le risque de changement erroné.
- `system_tool_type`: `play_keypad_touch_tone`
  - `suppress_turn_after_dtmf` (boolean, optional, default: false) — Si true, l’agent ne générera plus de parole après avoir émis des tonalités DTMF. Cela empêche la parole de l’agent d’interférer avec les systèmes IVR.
  - `use_out_of_band_dtmf` (boolean, optional, default: true) — Envoie les tonalités DTMF comme événements RTP hors bande (RFC 4733) plutôt que comme audio dans la bande. Fonctionne uniquement pour les numéros importés depuis un trunk SIP.
- `system_tool_type`: `skip_turn`
  - `wait_timeout_secs` (double, optional, default: -1) — Secondes à attendre après skip_turn avant que l’agent ne génère une relance contextuelle. Le minuteur « Terminer la conversation après un silence » est suspendu pendant l’attente. La valeur -1 désactive l’attente : après skip_turn, l’agent reste silencieux jusqu’à ce que l’appelant parle, et ce minuteur continue de s’écouler. S’applique uniquement aux conversations vocales.
- `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) — Indique s'il faut diffuser un message au client pendant qu'il attend le transfert. La valeur par défaut est true pour assurer la rétrocompatibilité.
- `system_tool_type`: `voicemail_detection`
  - `voicemail_message` (string, optional) — Message facultatif à laisser sur la messagerie vocale lorsqu'elle est détectée. Si aucun message n'est fourni, l'appel se termine immédiatement lors de la détection de la messagerie vocale. Prend en charge les variables dynamiques, par exemple \{\{system\_\_time}}, \{\{system\_\_call\_duration\_secs}}, \{\{custom\_variable}}.

### WebhookToolApiSchemaConfigOutput

- `url` (string, required) — L’URL à laquelle le webhook sera envoyé. Peut inclure des paramètres de chemin, par exemple [https://example.com/agents/\{agent\_id}](https://example.com/agents/\{agent_id})
- `request_headers` (map from string to WebhookToolApiSchemaConfigOutputRequestHeadersValue, optional) — En-têtes à inclure dans la requête.
- `method` (enum, optional, default: GET) — La méthode HTTP à utiliser pour le webhook
  - Allowed values: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`
- `path_params_schema` (map from string to LiteralJsonSchemaProperty, optional) — Schéma des paramètres de chemin, le cas échéant. Les clés doivent correspondre aux espaces réservés dans l’URL.
- `query_params_schema` (QueryParamsJsonSchemaOutput, optional) — Schéma des paramètres de requête, le cas échéant. Ils sont ajoutés à la fin de l’URL comme paramètres de requête. Remarque : les propriétés d’un paramètre de requête doivent toutes être de types littéraux.
- `request_body_schema` (ObjectJsonSchemaPropertyOutput, optional) — Schéma des paramètres du corps, le cas échéant. Utilisé pour les requêtes POST/PATCH/PUT. Le schéma doit être un objet envoyé comme corps JSON.
- `response_body_schema` (ObjectJsonSchemaPropertyOutput, optional) — Schéma décrivant la structure attendue du corps de réponse. À des fins de documentation uniquement ; non exposé au LLM.
- `response_filter` (ResponseFilter, optional) — Filtre de liste blanche facultatif appliqué à la réponse avant que le LLM ne la voie, afin que les réponses volumineuses ne polluent pas le contexte. Par défaut, la réponse complète est utilisée.
- `content_type` (enum, optional, default: application/json) — Type de contenu du corps de la requête. S'applique uniquement aux requêtes POST/PUT/PATCH.
  - Allowed values: `application/json`, `application/x-www-form-urlencoded`
- `auth_resolved_params` (list of string, optional) — Espaces réservés de l’URL résolus depuis la connexion d’authentification, par exemple les secrets injectés via UrlSecretAuthConnection, plutôt que depuis path_params_schema.
- `auth_connection` (WebhookToolApiSchemaConfigOutputAuthConnection, optional) — Connexion d'authentification facultative à utiliser avec ce webhook

### SoftTimeoutConfigOverrideConfig

- `message` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ message.
- `additional_soft_timeout_messages` (boolean, optional, default: false) — Indique s’il faut autoriser le remplacement du champ additional_soft_timeout_messages.

### PromptAgentApiModelOverrideConfig

- `prompt` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ prompt.
- `llm` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ llm.
- `tool_ids` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ tool_ids.
- `tool_ids_strict` (boolean, optional, default: false) — Indique s’il faut autoriser le remplacement du champ tool_ids_strict.
- `native_mcp_server_ids` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ native_mcp_server_ids.
- `knowledge_base` (boolean, optional, default: false) — Indique s'il est possible de remplacer le champ knowledge_base.

### ConvAiSecretLocator

Utilisé pour référencer un secret du stockage de secrets de l’agent.

- `secret_id` (string, required)

### ContentThresholdGuardrail

- `is_enabled` (boolean, optional, default: false)
- `threshold` (ContentThresholdGuardrailThreshold, optional)

### CustomGuardrailConfig

Configuration d’un seul garde-fou personnalisé

- `name` (string, required) — Nom destiné aux utilisateurs pour cette règle de sécurité
- `prompt` (string, required) — Instruction décrivant ce qu’il faut bloquer, par exemple : « ne parlez pas de politique »
- `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) — Modèle LLM à utiliser pour l’évaluation des garde-fous personnalisés
  - 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) — Quantité d’historique récent que le garde-fou consulte avant la réponse qu’il évalue, comptée en messages utilisateur, les réponses intermédiaires de l’agent étant également incluses. Le garde-fou reçoit toujours une seule transcription \<conversation\_history> se terminant par la réponse évaluée, marquée « AGENT \[current reply]: ». 0, valeur par défaut, n’ajoute aucun historique antérieur, seulement cette ligne ; 1 ajoute le dernier message utilisateur et les suivants.
- `trigger_action` (CustomGuardrailConfigTriggerAction, optional)
- `evaluate_full_response_only` (boolean, optional, default: false) — Évalue une fois la réponse complète hors TTS, au lieu des réponses partielles cumulées. Nécessite le mode bloquant.

### LlmLiteralJsonSchemaProperty

- `type` (LlmLiteralJsonSchemaPropertyType, required)
- `description` (string, required)
- `enum` (list of string, optional) — List of allowed string values for string type parameters

### AstNumberNodeInputValue

Valeur de ce littéral.

- double
- integer

### SoftTimeoutConfigWorkflowOverride

- `timeout_seconds` (double, optional) — Délai, en secondes, avant l’affichage du message prédéfini pendant l’attente de la réponse du LLM. Définissez -1 pour désactiver cette option.
- `message` (string, optional) — Message à afficher lorsque le premier délai d’expiration souple est atteint pendant l’attente d’une réponse LLM. Prend en charge les variables dynamiques, par exemple \{\{system\_\_time}} et \{\{custom\_variable}}.
- `additional_soft_timeout_messages` (list of string, optional) — Messages statiques de remplissage supplémentaires pour les délais d'attente souples suivants dans la même génération LLM. Le premier délai utilise `message`. Si moins de messages sont configurés que `max_soft_timeouts_per_generation`, le dernier message configuré est répété ; sinon, un message de remplissage intégré est utilisé.
- `use_llm_generated_message` (boolean, optional) — Si cette option est activée, le message de délai d’inactivité sera généré dynamiquement au lieu d’utiliser le message statique.
- `randomize_fillers` (boolean, optional) — Si cette option est activée, mélangez une fois l’ordre des messages statiques de délai d’inactivité au début de chaque tour. S’applique uniquement lorsque use_llm_generated_message est false.
- `max_soft_timeouts_per_generation` (integer, optional) — Maximum filler messages while waiting for a single LLM response. Fires every timeout_seconds until the LLM streams content or this limit is reached.
- `llm_generated_message_prompt_override` (string, optional) — Prompt personnalisé pour générer le message de remplissage lors d'un délai d'attente souple lorsque use\_llm\_generated\_message est activé. Le contexte récent de la conversation est fourni dans un message utilisateur distinct. S'il n'est pas défini, le prompt par défaut est utilisé. Prend en charge les variables dynamiques (par exemple, \{\{system\_\_time}}, \{\{custom\_variable}}).
- `disable_until_first_user_message` (boolean, optional) — Lorsque la valeur est true, les fillers de délai d’expiration souple sont supprimés jusqu’à ce que la conversation comporte au moins un véritable message utilisateur. Empêche les fillers pendant le tour d’ouverture de l’agent, par exemple avec le workflow generate-immediately ou des appels d’outils avant que l’utilisateur ne parle.

### EffectsSpecInput

Effets audio appliqués à la parole générée : un préréglage de filtre, une distance perçue, un environnement de réverbération, un fond sonore et un panoramique stéréo. Laissez chaque champ à sa valeur par défaut pour obtenir un audio non traité.

- `filter_preset_id` (string, optional) — ID d’un préréglage de filtre qui colore la voix, tel que `phone` ou `old_radio`. Répertoriez les ID valides avec `GET /v1/audio-effects/catalog`.
- `distance` (double, optional, default: 0) — Distance à laquelle le locuteur semble se trouver du microphone, de 0 (proche, inchangée) à 1 (loin). Des valeurs plus élevées atténuent les basses et hautes fréquences et, lorsqu’un environnement est défini, déplacent l’équilibre de la voix sèche vers la réverbération.
- `environment_id` (string, optional) — ID d’un environnement de réverbération qui place la voix dans un espace, tel que `small_room` ou `hall`. Répertoriez les ID valides avec `GET /v1/audio-effects/catalog`. La réverbération est produite en stéréo et ajoute une traîne pouvant durer plusieurs secondes après la fin de la parole.
- `background_noise_id` (string, optional) — ID d’un fond sonore diffusé en boucle sous la voix, tel que `cafe` ou `keyboard`. Répertoriez les ID valides avec `GET /v1/audio-effects/catalog`.
- `send_level` (double, optional, default: 1) — Quantité de voix envoyée vers la réverbération, de 0 (aucune) à 1 (totale). S’applique uniquement lorsque `environment_id` est défini ; 0 désactive la réverbération.
- `pan` (double, optional, default: 0) — Position stéréo de la voix, de -1 (complètement à gauche) à 1 (complètement à droite), en passant par 0 (au centre). Seule la voix est panoramiquée ; la réverbération et le bruit de fond restent centrés.

### FileInputConfigWorkflowOverride

- `enabled` (boolean, optional) — Lorsque cette option est activée, les utilisateurs peuvent joindre des images, des fichiers PDF ou des fichiers texte dans le chat si le LLM prend en charge les entrées multimodales.
- `max_files_in_memory` (integer, optional) — Nombre de fichiers les plus récents conservés en mémoire au cours d’une conversation. Les fichiers plus anciens sont résumés et leur mémoire est libérée.
- `max_files_per_conversation` (integer, optional) — Nombre total de fichiers qu’un utilisateur peut importer au cours d’une conversation. Les importations sont facturées par fichier. Utilisez -1 pour aucune limite, ou une valeur >= max_files_in_memory.

### BackgroundSoundConfigWorkflowOverride

- `source_type` ("preset", optional) — Le type de source sonore d’arrière-plan.
- `source_id` (enum, optional) — Identifiant de la source sonore.
  - Allowed values: `office2`, `office1`, `restaurant`, `city`, `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
- `volume` (double, optional) — Niveau de volume du son d’arrière-plan (de 0,01 à 1,0).
- `crossfade_loop` (boolean, optional) — Applique un fondu enchaîné à la jonction de la boucle afin d'éviter les clics audibles lors de la répétition du son.

### ConversationConfigClientOverrideInput

- `asr` (AsrConversationalConfigOverride, optional) — Configuration de la transcription conversationnelle
- `turn` (TurnConfigOverride, optional) — Configuration de la détection des tours de parole
- `tts` (TtsConversationalConfigOverride, optional) — Configuration de la synthèse vocale conversationnelle
- `conversation` (ConversationConfigOverride, optional) — Configuration des événements conversationnels
- `agent` (AgentConfigOverrideInput, optional) — Configuration spécifique à l'agent

### DynamicVariablesConfigWorkflowOverride

- `dynamic_variable_placeholders` (map from string to any, optional) — Dictionnaire des espaces réservés de variables dynamiques et de leurs valeurs.

### PromptAgentApiModelWorkflowOverrideInput

- `prompt` (string, optional) — Le prompt de l’agent
- `llm` (enum, optional) — Le LLM à interroger avec le prompt et l’historique de discussion. En cas de résidence des données européenne, le LLM doit être pris en charge dans l’environnement de résidence des données.
  - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`
- `reasoning_effort` (enum, optional) — Effort de raisonnement du modèle. Disponible uniquement pour certains modèles.
  - Allowed values: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`
- `thinking_budget` (integer, optional) — Nombre maximal de jetons utilisés pour le raisonnement. Utilisez 0 pour le désactiver si le modèle le prend en charge.
- `enable_reasoning_summary` (boolean, optional) — Activez les résumés du raisonnement du modèle. Lorsqu’ils sont désactivés, nous ne demandons pas de résumés au fournisseur lorsque cela est possible, afin de réduire le TTFB. Non compatible avec ZRM.
- `temperature` (double, optional) — La température du LLM. La valeur par défaut est 0. Définissez-la sur null pour omettre entièrement le paramètre de la requête au LLM, ce qui est utile pour les LLM personnalisés qui refusent le champ de température.
- `max_tokens` (integer, optional) — S’il est supérieur à 0, nombre maximal de jetons que le LLM peut prédire
- `tool_ids` (list of string, optional) — Liste des ID des outils utilisés par l’agent.
- `tool_ids_strict` (boolean, optional) — Only applies as a conversation override, allowed whenever tool_ids may be overridden. When true, the overridden tool_ids is the full list of tools allowed in the conversation, including tools on workflow nodes. Ignored when set on the agent.
- `built_in_tools` (BuiltInToolsWorkflowOverrideInput, optional) — Outils système intégrés à utiliser par l'agent
- `enable_parallel_tool_calls` (boolean, optional) — Activez les appels d’outils parallèles. Lorsqu’ils sont activés, l’agent peut exécuter plusieurs outils en parallèle au cours d’un même tour. Cette option n’est pas prise en charge par tous les modèles.
- `mcp_server_ids` (list of string, optional) — Liste des identifiants de serveurs MCP à utiliser par l'agent
- `native_mcp_server_ids` (list of string, optional) — Liste des identifiants de serveurs MCP natifs à utiliser par l'agent
- `knowledge_base` (list of KnowledgeBaseLocator, optional) — Liste des bases de connaissances à utiliser par l'agent
- `custom_llm` (CustomLlm, optional) — Définition d'un LLM personnalisé si le champ LLM est défini sur « CUSTOM_LLM »
- `ignore_default_personality` (boolean, optional) — Indique s'il faut supprimer les lignes de personnalité par défaut du prompt système.
- `rag` (RagConfigWorkflowOverrideInput, optional) — Configuration pour RAG
- `timezone` (string, optional) — Fuseau horaire utilisé pour afficher l’heure actuelle dans le prompt système. S’il est défini, l’heure actuelle sera incluse dans le prompt système à l’aide de ce fuseau horaire. Doit être un nom de fuseau horaire valide, par exemple « America/New_York », « Europe/London » ou « UTC ». Recommandé pour des réponses tenant compte de l’heure avec précision. Sans cela, l’agent ne connaît ni la date ni l’heure actuelles, sauf si vous les fournissez via des variables dynamiques ou des outils, ce qui peut entraîner des références temporelles incorrectes ou inventées.
- `backup_llm_config` (PromptAgentApiModelWorkflowOverrideInputBackupLlmConfig, optional) — Configuration du basculement en cascade des LLM de secours. Peut être désactivée, utiliser les valeurs par défaut du système ou spécifier un ordre personnalisé.
- `cascade_timeout_seconds` (double, optional) — Délai, en secondes, avant le basculement vers le LLM de secours. Doit être compris entre 2 et 15 secondes.
- `tools` (list of PromptAgentApiModelWorkflowOverrideInputToolsItem, optional) — Liste des outils que l'agent peut utiliser au cours de la conversation, utilisez plutôt tool_ids.

### ConstantSchemaOverrideConstantValue

Valeur constante à utiliser

- string
- integer
- double
- boolean
- list of any
- map from string to any

### ConvAiEnvVarLocator

Utilisé pour référencer une variable d’environnement par son libellé.

- `env_var_label` (string, required)

### AuthConnectionLocator

Utilisé pour référencer une connexion d’authentification depuis le stockage de connexions d’authentification du Workspace.

- `auth_connection_id` (string, required)

### EnvironmentAuthConnectionLocator

Référence, par son libellé, une variable d’environnement de type « auth_connection ». Lors de l’exécution, elle est résolue en connexion d’authentification pour l’environnement actuel, avec repli sur l’environnement par défaut.

- `env_var_label` (string, required)

### ConvAiDynamicVariable

Utilisé pour référencer une variable dynamique.

- `variable_name` (string, required)

### ApiIntegrationWebhookOverridesSchemaOverridesValue

- `source`: `constant`
  - `constant_value` (ConstantSchemaOverrideConstantValue, optional) — Valeur constante à utiliser
- `source`: `dynamic_variable`
  - `dynamic_variable` (string, required) — Le nom de la variable dynamique à utiliser
- `source`: `llm`
  - `prompt` (string, optional) — Remplacement du prompt pour le LLM. S’il n’est pas fourni, la description du schéma d’origine est utilisée.
- `source`: `omit`

### ApiIntegrationWebhookOverridesRequestHeadersValue

- string
- Conv AI Dynamic Variable: ConvAiDynamicVariable

### ObjectJsonSchemaPropertyOutputPropertiesValue

- Literal JSON Schema Property: LiteralJsonSchemaProperty
- Object JSON Schema Property Output: ObjectJsonSchemaPropertyOutput
- Array JSON Schema Property Output: ArrayJsonSchemaPropertyOutput

### RequiredConstraints

Conteneur pour les contraintes de composition anyOf/allOf limitées aux champs obligatoires.

- `any_of` (list of RequiredConstraint, optional)
- `all_of` (list of RequiredConstraint, optional)

### EndProcedureToolConfigProceduresValue

- Procedure Version Ref: ProcedureVersionRef
- Procedure Draft Ref: ProcedureDraftRef

### StartProcedureToolConfigProceduresValue

- Procedure Version Ref: ProcedureVersionRef
- Procedure Draft Ref: ProcedureDraftRef

### 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) — Définit si les remplacements côté client du TTS doivent être transférés vers l'agent cible.
- `preserve_voice_settings` (boolean, optional, default: false) — Définit si la voix de base, le modèle TTS et les paramètres vocaux doivent être transférés vers l'agent cible.

### PhoneNumberTransfer

- `transfer_destination` (PhoneNumberTransferTransferDestination, required)
- `condition` (string, required)
- `custom_sip_headers` (list of PhoneNumberTransferCustomSipHeadersItem, optional) — En-têtes SIP personnalisés à inclure lors du transfert de l'appel. Chaque en-tête peut être une valeur statique ou une référence de variable dynamique.
- `transfer_type` (enum, optional, default: conference)
  - Allowed values: `blind`, `conference`, `sip_refer`
- `sip_refer_play_dialtone` (boolean, optional, default: true) — Lorsque la valeur est True, une tonalité est diffusée sur la branche d’appel d’origine pendant l’exécution d’un transfert SIP REFER. La tonalité est transmise via RTP au pair SIP exécutant le REFER ; désactivez cette option si le système destinataire, par exemple un SBC ou un centre de contact, ne doit pas l’entendre. Lorsqu’elle est désactivée, l’appelant entend le silence jusqu’à la fin du transfert. Uniquement pour les transferts SIP REFER.
- `uui` (UuiTransferConfig, optional) — Informations d’utilisateur à utilisateur (RFC 7433) à joindre aux transferts SIP REFER. Transmet le contexte de l’appel, tel que les identifiants CRM ou le motif d’escalade, lors du transfert.
- `post_dial_digits` (PhoneNumberTransferPostDialDigits, optional) — Chiffres DTMF à envoyer après la connexion de l’appel, par exemple 'ww1234' pour un poste. Peut correspondre à une valeur statique ou à une référence de variable dynamique. Utilisez 'w' pour une pause de 0,5 s. Pris en charge uniquement pour les transferts Twilio.
- `phone_number` (string, optional, deprecated)

### WebhookToolApiSchemaConfigOutputRequestHeadersValue

- string
- Conv AI Secret Locator: ConvAiSecretLocator
- Conv AI Dynamic Variable: ConvAiDynamicVariable
- Conv AI Env Var Locator: ConvAiEnvVarLocator

### LiteralJsonSchemaProperty

Propriété de schéma pour les types JSON littéraux. IMPORTANT : UN SEUL des champs suivants peut être défini : description (le LLM fournit la valeur), dynamic_variable (valeur issue d’une variable), is_system_provided (le système fournit la valeur), constant_value (valeur fixe) ou is_omitted (le paramètre est omis). Ils sont mutuellement exclusifs.

- `type` (LiteralJsonSchemaPropertyType, required)
- `description` (string, optional, default: ) — La description de la propriété. Lorsqu’elle est définie, le LLM fournit la valeur à partir de cette description. S’exclut mutuellement avec dynamic_variable, is_system_provided, constant_value et is_omitted.
- `enum` (list of string, optional) — List of allowed string values for string type parameters
- `is_system_provided` (boolean, optional, default: false) — Si true, la valeur sera renseignée par le système au moment de l’exécution. Utilisé par les outils Webhook d’intégration API pour le templating. Mutuellement exclusif avec description, dynamic_variable, constant_value et is_omitted.
- `dynamic_variable` (string, optional, default: ) — Le nom de la variable dynamique à utiliser pour la valeur de cette propriété. S’exclut mutuellement avec description, is_system_provided, constant_value et is_omitted.
- `allowed_values` (AllowedValues, optional) — Garde-fou de rejet côté serveur pour une valeur fournie par un LLM : l’environnement d’exécution rejette toute valeur en dehors de l’ensemble autorisé désigné par cet objet, et cet ensemble n’est pas communiqué au LLM comme une énumération. Pris en charge uniquement lorsque la source de la valeur est `description` ; toute combinaison avec dynamic_variable, is_system_provided, constant_value ou is_omitted est rejetée.
- `constant_value` (LiteralJsonSchemaPropertyConstantValue, optional) — Valeur constante à utiliser pour cette propriété. S’exclut mutuellement avec description, dynamic_variable, is_system_provided et is_omitted.
- `is_omitted` (boolean, optional, default: false) — Si true, ce paramètre sera entièrement omis de la requête. Valide uniquement pour les paramètres facultatifs. Mutuellement exclusif avec description, dynamic_variable, is_system_provided et constant_value.
- `allowed_values_dynamic_variable` (string, optional, default: , deprecated) — OBSOLÈTE : utilisez plutôt `allowed_values`. Lorsqu'il est défini, le LLM fournit la valeur, mais l'environnement d'exécution rejette toute valeur absente de la liste contenue dans cette variable dynamique (doit être un tableau JSON tel que ["ws_alpha", "ws_beta"]). Utilisez-le pour permettre au LLM de choisir dans un ensemble vérifié par le serveur, par exemple les ID auxquels l'utilisateur actuel est autorisé à accéder. Requiert description ; mutuellement exclusif avec dynamic_variable, is_system_provided, constant_value et is_omitted.

### QueryParamsJsonSchemaOutput

- `properties` (map from string to LiteralJsonSchemaProperty, required)
- `required` (list of string, optional)

### ResponseFilter

Configuration permettant de filtrer les réponses d'outils avant qu'elles ne soient visibles par l'agent.

- `mode` (enum, optional, default: all) — Contrôle le filtrage des réponses d'outil. « all » renvoie l'intégralité de la réponse, « allow » renvoie uniquement les chemins spécifiés et « hide_all » masque toute la réponse.
  - Allowed values: `all`, `allow`, `hide_all`
- `filters` (list of string, optional) — Chemins en notation pointée à inclure lorsque le mode est 'allow', par exemple ['ticket.id', 'ticket.status'].
- `content_type` ("application/json", optional) — Type de contenu pour le filtrage des réponses. Seules les réponses « application/json » sont filtrées.

### WebhookToolApiSchemaConfigOutputAuthConnection

Connexion d'authentification facultative à utiliser avec ce webhook

- Auth Connection Locator: AuthConnectionLocator
- Environment Auth Connection Locator: EnvironmentAuthConnectionLocator

### ContentThresholdGuardrailThreshold

- double
- "low"
- "medium"
- "high"

### 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?".) — Retour personnalisé à injecter dans l'agent lors d'une nouvelle tentative après le déclenchement d'une règle de sécurité.

### LlmLiteralJsonSchemaPropertyType

- "boolean"
- "string"
- "integer"
- "number"
- list of string

### AgentConfigOverrideInput

- `first_message` (string, optional) — S’il n’est pas vide, premier message que l’agent prononcera. S’il est vide, l’agent attend que l’utilisateur commence la discussion.
- `language` (string, optional) — Langue de l'agent, utilisée pour l'ASR et le TTS
- `max_conversation_duration_message` (string, optional) — S’il n’est pas vide, message que l’agent enverra lorsque la durée maximale de la conversation sera atteinte.
- `prompt` (PromptAgentApiModelOverrideInput, optional) — Le prompt de l’agent

### BuiltInToolsWorkflowOverrideInput

- `transfer_to_agent` (SystemToolConfigInput, optional) — L’outil de transfert vers un agent.
- `end_call` (SystemToolConfigInput, optional) — L’outil de fin d’appel
- `language_detection` (SystemToolConfigInput, optional) — L’outil de détection de langue
- `transfer_to_number` (SystemToolConfigInput, optional) — L’outil de transfert vers un numéro.
- `skip_turn` (SystemToolConfigInput, optional) — L'outil d'ignorance de tour
- `play_keypad_touch_tone` (SystemToolConfigInput, optional) — L’outil de lecture DTMF
- `voicemail_detection` (SystemToolConfigInput, optional) — L’outil de détection de messagerie vocale

### 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) — Distance vectorielle maximale des fragments récupérés.
- `max_documents_length` (integer, optional) — Longueur totale maximale des fragments de document récupérés depuis RAG.
- `max_retrieved_rag_chunks_count` (integer, optional) — Nombre maximal de fragments de document RAG à récupérer initialement depuis la base vectorielle. Ils sont ensuite filtrés selon la distance vectorielle et la longueur totale.
- `num_candidates` (integer, optional) — Nombre de candidats évalués dans la recherche vectorielle ANN. Une valeur plus élevée améliore les résultats, mais augmente la latence. La valeur minimale recommandée est 100. Si cette option est désactivée, la valeur par défaut est utilisée.
- `query_rewrite_prompt_override` (string, optional) — Prompt personnalisé pour reformuler les requêtes utilisateur avant la récupération RAG. L'historique de la conversation est automatiquement ajouté à la fin. S'il n'est pas défini, le prompt par défaut est utilisé.
- `knowledge_base_tool_info` (KnowledgeBaseToolInfo, optional) — Lorsqu’il est défini, l’agent utilise l’outil knowledge_base au lieu de l’ancien outil knowledge_base_rag. None signifie que l’agent n’y a pas adhéré.

### PromptAgentApiModelWorkflowOverrideInputBackupLlmConfig

Configuration du basculement en cascade des LLM de secours. Peut être désactivée, utiliser les valeurs par défaut du système ou spécifier un ordre personnalisé.

- Backup Llm Default: BackupLlmDefault
- Backup Llm Disabled: BackupLlmDisabled
- Backup Llm Override: BackupLlmOverride

### PromptAgentApiModelWorkflowOverrideInputToolsItem

Le type d’outil.

- `type`: `api_integration_webhook`
  - `api_integration_connection_id` (string, required)
  - `api_integration_id` (string, required)
  - `description` (string, required) — Description des situations dans lesquelles l’outil doit être utilisé et de ce qu’il fait.
  - `name` (string, required)
  - `api_schema_overrides` (ApiIntegrationWebhookOverrides, optional) — Substitutions utilisateur appliquées en complément du api_schema de base
  - `assignments` (list of DynamicVariableAssignment, optional) — Configuration permettant d'extraire des valeurs des réponses d'outils et de les attribuer à des variables dynamiques
  - `dynamic_variables` (DynamicVariablesConfig, optional) — Configuration des variables dynamiques
  - `execution_mode` (enum, optional, default: immediate) — Détermine quand et comment l’outil s’exécute : 'immediate' exécute l’outil immédiatement lorsqu’il est demandé par le LLM, 'post_tool_speech' attend que l’agent ait fini de parler avant de l’exécuter, et 'async' exécute l’outil en arrière-plan sans bloquer, idéal pour les opérations longues.
    - Allowed values: `immediate`, `post_tool_speech`, `async`
  - `interruption_mode` (enum, optional, default: allow) — Détermine si l'utilisateur peut interrompre l'agent lors de cet appel d'outil. « allow » (valeur par défaut) permet à l'utilisateur d'interrompre à tout moment, « disable_during_tool » bloque les interruptions uniquement pendant l'exécution de l'outil et « disable_during_tool_and_turn » les bloque pendant l'exécution de l'outil et pour la réponse suivante de l'agent.
    - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
  - `pre_tool_speech` (enum, optional, default: auto) — Détermine si l'agent parle avant l'appel de cet outil. « auto » (valeur par défaut) décide selon la latence récente de l'outil, « force » demande toujours à l'agent de parler et « off » désactive entièrement cette fonction, quelle que soit la latence.
    - Allowed values: `auto`, `force`, `off`
  - `response_timeout_secs` (integer, optional, default: 20) — Le délai maximal, en secondes, avant la fin de l’appel d’outil. Doit être compris entre 5 et 300 secondes, incluses.
  - `tool_call_sound` (enum, optional) — Type de son d’appel d’outil prédéfini à diffuser lors de l’exécution de l’outil. S’il n’est pas spécifié, aucun son d’appel d’outil ne sera diffusé.
    - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
  - `tool_call_sound_behavior` (enum, optional, default: auto) — Détermine quand le son d’appel de l’outil doit être joué. 'auto' le joue uniquement lorsqu’une parole précède l’outil, tandis que 'always' le joue pour chaque appel d’outil.
    - Allowed values: `auto`, `always`
  - `tool_error_handling_mode` (enum, optional, default: auto) — Contrôle le traitement des erreurs d'outil avant leur partage avec l'agent. « auto » détermine le traitement selon le type d'outil, avec un résumé pour les intégrations natives et le masquage pour les autres ; « summarized » envoie un résumé généré par un LLM, « passthrough » envoie l'erreur brute et « hide » ne partage pas l'erreur avec l'agent.
    - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
  - `tool_version` (string, optional, default: 1.0.0) — La version de l’outil d’intégration API
  - `disable_interruptions` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `interruption_mode`. Si la valeur est true, l'utilisateur ne pourra pas interrompre l'agent pendant l'exécution de cet outil.
  - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `pre_tool_speech`. Si la valeur est true, l'agent parlera avant l'appel de l'outil.
- `type`: `client`
  - `description` (string, required) — Description des situations dans lesquelles l’outil doit être utilisé et de ce qu’il fait.
  - `name` (string, required)
  - `assignments` (list of DynamicVariableAssignment, optional) — Configuration permettant d'extraire des valeurs des réponses d'outils et de les attribuer à des variables dynamiques
  - `dynamic_variables` (DynamicVariablesConfig, optional) — Configuration des variables dynamiques
  - `execution_mode` (enum, optional, default: immediate) — Détermine quand et comment l’outil s’exécute : 'immediate' exécute l’outil immédiatement lorsqu’il est demandé par le LLM, 'post_tool_speech' attend que l’agent ait fini de parler avant de l’exécuter, et 'async' exécute l’outil en arrière-plan sans bloquer, idéal pour les opérations longues.
    - Allowed values: `immediate`, `post_tool_speech`, `async`
  - `expects_response` (boolean, optional, default: false) — Si true, l’appel de cet outil doit bloquer la conversation jusqu’à ce que le client fournisse une réponse, qui est transmise au LLM. Si false, la conversation se poursuit sans attendre la réponse du client. Cela permet d’afficher du contenu à un utilisateur sans bloquer la conversation.
  - `interruption_mode` (enum, optional, default: allow) — Détermine si l'utilisateur peut interrompre l'agent lors de cet appel d'outil. « allow » (valeur par défaut) permet à l'utilisateur d'interrompre à tout moment, « disable_during_tool » bloque les interruptions uniquement pendant l'exécution de l'outil et « disable_during_tool_and_turn » les bloque pendant l'exécution de l'outil et pour la réponse suivante de l'agent.
    - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
  - `parameters` (ObjectJsonSchemaPropertyInput, optional) — Schéma des paramètres à transmettre au client
  - `pre_tool_speech` (enum, optional, default: auto) — Détermine si l'agent parle avant l'appel de cet outil. « auto » (valeur par défaut) décide selon la latence récente de l'outil, « force » demande toujours à l'agent de parler et « off » désactive entièrement cette fonction, quelle que soit la latence.
    - Allowed values: `auto`, `force`, `off`
  - `response_timeout_secs` (integer, optional, default: 20) — Durée maximale, en secondes, d’attente de la fin de l’appel d’outil. Doit être comprise entre 1 et 120 secondes (incluses), ou égale à -1 pour attendre indéfiniment la réponse du client (nécessite expects_response).
  - `tool_call_sound` (enum, optional) — Type de son d’appel d’outil prédéfini à diffuser lors de l’exécution de l’outil. S’il n’est pas spécifié, aucun son d’appel d’outil ne sera diffusé.
    - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
  - `tool_call_sound_behavior` (enum, optional, default: auto) — Détermine quand le son d’appel de l’outil doit être joué. 'auto' le joue uniquement lorsqu’une parole précède l’outil, tandis que 'always' le joue pour chaque appel d’outil.
    - Allowed values: `auto`, `always`
  - `tool_error_handling_mode` (enum, optional, default: auto) — Contrôle le traitement des erreurs d'outil avant leur partage avec l'agent. « auto » détermine le traitement selon le type d'outil, avec un résumé pour les intégrations natives et le masquage pour les autres ; « summarized » envoie un résumé généré par un LLM, « passthrough » envoie l'erreur brute et « hide » ne partage pas l'erreur avec l'agent.
    - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
  - `disable_interruptions` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `interruption_mode`. Si la valeur est true, l'utilisateur ne pourra pas interrompre l'agent pendant l'exécution de cet outil.
  - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `pre_tool_speech`. Si la valeur est true, l'agent parlera avant l'appel de l'outil.
- `type`: `mcp`
  - `value` (any, required)
- `type`: `smb`
  - `value` (any, required)
- `type`: `system`
  - `name` (string, required)
  - `params` (SystemToolConfigInputParams, required)
  - `assignments` (list of DynamicVariableAssignment, optional) — Configuration permettant d'extraire des valeurs des réponses d'outils et de les attribuer à des variables dynamiques
  - `description` (string, optional, default: ) — Description des situations dans lesquelles l’outil doit être utilisé et de ce qu’il fait. Laissez ce champ vide pour utiliser la description par défaut, optimisée pour le type d’outil concerné.
  - `interruption_mode` (enum, optional, default: allow) — Détermine si l'utilisateur peut interrompre l'agent lors de cet appel d'outil. « allow » (valeur par défaut) permet à l'utilisateur d'interrompre à tout moment, « disable_during_tool » bloque les interruptions uniquement pendant l'exécution de l'outil et « disable_during_tool_and_turn » les bloque pendant l'exécution de l'outil et pour la réponse suivante de l'agent.
    - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
  - `pre_tool_speech` (enum, optional, default: auto) — Détermine si l'agent parle avant l'appel de cet outil. « auto » (valeur par défaut) décide selon la latence récente de l'outil, « force » demande toujours à l'agent de parler et « off » désactive entièrement cette fonction, quelle que soit la latence.
    - Allowed values: `auto`, `force`, `off`
  - `response_timeout_secs` (integer, optional, default: 20) — Le délai maximal, en secondes, avant la fin de l’appel d’outil.
  - `tool_call_sound` (enum, optional) — Type de son d’appel d’outil prédéfini à diffuser lors de l’exécution de l’outil. S’il n’est pas spécifié, aucun son d’appel d’outil ne sera diffusé.
    - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
  - `tool_call_sound_behavior` (enum, optional, default: auto) — Détermine quand le son d’appel de l’outil doit être joué. 'auto' le joue uniquement lorsqu’une parole précède l’outil, tandis que 'always' le joue pour chaque appel d’outil.
    - Allowed values: `auto`, `always`
  - `tool_error_handling_mode` (enum, optional, default: auto) — Contrôle le traitement des erreurs d'outil avant leur partage avec l'agent. « auto » détermine le traitement selon le type d'outil, avec un résumé pour les intégrations natives et le masquage pour les autres ; « summarized » envoie un résumé généré par un LLM, « passthrough » envoie l'erreur brute et « hide » ne partage pas l'erreur avec l'agent.
    - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
  - `disable_interruptions` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `interruption_mode`. Si la valeur est true, l'utilisateur ne pourra pas interrompre l'agent pendant l'exécution de cet outil.
  - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `pre_tool_speech`. Si la valeur est true, l'agent parlera avant l'appel de l'outil.
- `type`: `webhook`
  - `api_schema` (WebhookToolApiSchemaConfigInput, required) — Le schéma du webhook sortant, y compris les paramètres et la spécification de l'URL
  - `description` (string, required) — Description des situations dans lesquelles l’outil doit être utilisé et de ce qu’il fait.
  - `name` (string, required)
  - `assignments` (list of DynamicVariableAssignment, optional) — Configuration permettant d'extraire des valeurs des réponses d'outils et de les attribuer à des variables dynamiques
  - `dynamic_variables` (DynamicVariablesConfig, optional) — Configuration des variables dynamiques
  - `execution_mode` (enum, optional, default: immediate) — Détermine quand et comment l’outil s’exécute : 'immediate' exécute l’outil immédiatement lorsqu’il est demandé par le LLM, 'post_tool_speech' attend que l’agent ait fini de parler avant de l’exécuter, et 'async' exécute l’outil en arrière-plan sans bloquer, idéal pour les opérations longues.
    - Allowed values: `immediate`, `post_tool_speech`, `async`
  - `follow_redirects` (boolean, optional, default: false) — Indique s'il faut suivre une redirection depuis le point de terminaison et renvoyer la réponse finale. Une seule redirection est suivie, sous la forme d'une requête GET sans corps de requête ; aucun élément configuré sur cet outil, comme les en-têtes, l'authentification ou le certificat client, n'est envoyé à la cible de redirection. Le point de terminaison et la cible de redirection doivent tous deux utiliser HTTPS. Non pris en charge pour les outils d'intégration d'API.
  - `follow_redirects_allowed_domains` (list of string, optional) — Domaines vers lesquels une redirection peut pointer, par exemple 'test.example.com'. Requis pour suivre les redirections, toute cible hors de cette liste étant refusée.
  - `interruption_mode` (enum, optional, default: allow) — Détermine si l'utilisateur peut interrompre l'agent lors de cet appel d'outil. « allow » (valeur par défaut) permet à l'utilisateur d'interrompre à tout moment, « disable_during_tool » bloque les interruptions uniquement pendant l'exécution de l'outil et « disable_during_tool_and_turn » les bloque pendant l'exécution de l'outil et pour la réponse suivante de l'agent.
    - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
  - `pre_tool_speech` (enum, optional, default: auto) — Détermine si l'agent parle avant l'appel de cet outil. « auto » (valeur par défaut) décide selon la latence récente de l'outil, « force » demande toujours à l'agent de parler et « off » désactive entièrement cette fonction, quelle que soit la latence.
    - Allowed values: `auto`, `force`, `off`
  - `response_timeout_secs` (integer, optional, default: 20) — Le délai maximal, en secondes, avant la fin de l’appel d’outil. Doit être compris entre 5 et 300 secondes, incluses.
  - `tool_call_sound` (enum, optional) — Type de son d’appel d’outil prédéfini à diffuser lors de l’exécution de l’outil. S’il n’est pas spécifié, aucun son d’appel d’outil ne sera diffusé.
    - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
  - `tool_call_sound_behavior` (enum, optional, default: auto) — Détermine quand le son d’appel de l’outil doit être joué. 'auto' le joue uniquement lorsqu’une parole précède l’outil, tandis que 'always' le joue pour chaque appel d’outil.
    - Allowed values: `auto`, `always`
  - `tool_error_handling_mode` (enum, optional, default: auto) — Contrôle le traitement des erreurs d'outil avant leur partage avec l'agent. « auto » détermine le traitement selon le type d'outil, avec un résumé pour les intégrations natives et le masquage pour les autres ; « summarized » envoie un résumé généré par un LLM, « passthrough » envoie l'erreur brute et « hide » ne partage pas l'erreur avec l'agent.
    - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
  - `disable_interruptions` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `interruption_mode`. Si la valeur est true, l'utilisateur ne pourra pas interrompre l'agent pendant l'exécution de cet outil.
  - `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `pre_tool_speech`. Si la valeur est true, l'agent parlera avant l'appel de l'outil.

### ArrayJsonSchemaPropertyOutput

- `description` (string, optional, default: )
- `dynamic_variable` (string, optional, default: ) — Lorsqu’il est défini, l’intégralité du paramètre est renseignée à partir de cette variable dynamique à l’exécution. S’exclut mutuellement avec description (valeur fournie par le LLM), constant_value et is_omitted.
- `constant_value` (list of any, optional) — Lorsqu’elle est définie, l’intégralité du tableau utilise cette valeur constante à l’exécution. S’exclut mutuellement avec description (tableau fourni par le LLM), dynamic_variable et is_omitted.
- `is_omitted` (boolean, optional, default: false) — Si true, ce paramètre sera entièrement omis de la requête. Valide uniquement pour les paramètres facultatifs. Mutuellement exclusif avec description, dynamic_variable et constant_value.
- `type` ("array", optional)
- `items` (ArrayJsonSchemaPropertyOutputItems, optional) — Schéma des éléments du tableau.

### RequiredConstraint

Un ensemble de champs qui doivent tous être présents pour satisfaire cette contrainte.

- `required` (list of string, required)

### ProcedureVersionRef

- `procedure_id` (string, required) — ID de la procédure
- `version_id` (string, required) — ID de version de la version de la procédure.

### ProcedureDraftRef

- `procedure_id` (string, required) — ID de la procédure
- `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) — Le nom de l'en-tête SIP (par exemple, « X-Customer-ID »)
  - `value` (string, required) — Le nom de la variable dynamique à résoudre
- `type`: `static`
  - `key` (string, required) — Le nom de l'en-tête SIP (par exemple, « X-Customer-ID »)
  - `value` (string, required) — La valeur de l’en-tête

### PhoneNumberTransferPostDialDigits

- `type`: `dynamic`
  - `value` (string, required) — Le nom de la variable dynamique à résoudre
- `type`: `static`
  - `value` (string, required) — Chiffres DTMF à envoyer après la connexion de l’appel, par exemple 'ww1234' pour un poste.

### LiteralJsonSchemaPropertyType

- "boolean"
- "string"
- "integer"
- "number"
- list of string

### LiteralJsonSchemaPropertyConstantValue

Valeur constante à utiliser pour cette propriété. S’exclut mutuellement avec description, dynamic_variable, is_system_provided et is_omitted.

- string
- integer
- double
- boolean

### PromptAgentApiModelOverrideInput

- `prompt` (string, optional) — Le prompt de l’agent
- `llm` (enum, optional) — Le LLM à interroger avec le prompt et l’historique de discussion. En cas de résidence des données européenne, le LLM doit être pris en charge dans l’environnement de résidence des données.
  - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`
- `tool_ids` (list of string, optional) — Liste des ID des outils utilisés par l’agent.
- `tool_ids_strict` (boolean, optional) — Only applies as a conversation override, allowed whenever tool_ids may be overridden. When true, the overridden tool_ids is the full list of tools allowed in the conversation, including tools on workflow nodes. Ignored when set on the agent.
- `native_mcp_server_ids` (list of string, optional) — Liste des identifiants de serveurs MCP natifs à utiliser par l'agent
- `knowledge_base` (list of KnowledgeBaseLocator, optional) — Liste des bases de connaissances à utiliser par l'agent

### SystemToolConfigInput

Un outil système permet d'appeler une méthode système sur le serveur

- `name` (string, required)
- `params` (SystemToolConfigInputParams, required)
- `type` ("system", optional) — Le type d’outil.
- `description` (string, optional, default: ) — Description des situations dans lesquelles l’outil doit être utilisé et de ce qu’il fait. Laissez ce champ vide pour utiliser la description par défaut, optimisée pour le type d’outil concerné.
- `response_timeout_secs` (integer, optional, default: 20) — Le délai maximal, en secondes, avant la fin de l’appel d’outil.
- `interruption_mode` (enum, optional, default: allow) — Détermine si l'utilisateur peut interrompre l'agent lors de cet appel d'outil. « allow » (valeur par défaut) permet à l'utilisateur d'interrompre à tout moment, « disable_during_tool » bloque les interruptions uniquement pendant l'exécution de l'outil et « disable_during_tool_and_turn » les bloque pendant l'exécution de l'outil et pour la réponse suivante de l'agent.
  - Allowed values: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`
- `pre_tool_speech` (enum, optional, default: auto) — Détermine si l'agent parle avant l'appel de cet outil. « auto » (valeur par défaut) décide selon la latence récente de l'outil, « force » demande toujours à l'agent de parler et « off » désactive entièrement cette fonction, quelle que soit la latence.
  - Allowed values: `auto`, `force`, `off`
- `assignments` (list of DynamicVariableAssignment, optional) — Configuration permettant d'extraire des valeurs des réponses d'outils et de les attribuer à des variables dynamiques
- `tool_call_sound` (enum, optional) — Type de son d’appel d’outil prédéfini à diffuser lors de l’exécution de l’outil. S’il n’est pas spécifié, aucun son d’appel d’outil ne sera diffusé.
  - Allowed values: `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
- `tool_call_sound_behavior` (enum, optional, default: auto) — Détermine quand le son d’appel de l’outil doit être joué. 'auto' le joue uniquement lorsqu’une parole précède l’outil, tandis que 'always' le joue pour chaque appel d’outil.
  - Allowed values: `auto`, `always`
- `tool_error_handling_mode` (enum, optional, default: auto) — Contrôle le traitement des erreurs d'outil avant leur partage avec l'agent. « auto » détermine le traitement selon le type d'outil, avec un résumé pour les intégrations natives et le masquage pour les autres ; « summarized » envoie un résumé généré par un LLM, « passthrough » envoie l'erreur brute et « hide » ne partage pas l'erreur avec l'agent.
  - Allowed values: `auto`, `summarized`, `passthrough`, `hide`
- `disable_interruptions` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `interruption_mode`. Si la valeur est true, l'utilisateur ne pourra pas interrompre l'agent pendant l'exécution de cet outil.
- `force_pre_tool_speech` (boolean, optional, default: false, deprecated) — OBSOLÈTE : utilisez plutôt `pre_tool_speech`. Si la valeur est true, l'agent parlera avant l'appel de l'outil.

### 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`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`
- `preference` ("override", optional)

### ObjectJsonSchemaPropertyInput

- `property_kind` (enum, optional, default: object)
  - Allowed values: `array`, `object`
- `description` (string, optional, default: )
- `dynamic_variable` (string, optional, default: ) — Lorsqu’il est défini, l’intégralité du paramètre est renseignée à partir de cette variable dynamique à l’exécution. S’exclut mutuellement avec description (valeur fournie par le LLM), constant_value et is_omitted.
- `constant_value` (map from string to any, optional) — Lorsqu’elle est définie, l’intégralité de l’objet utilise cette valeur JSON constante à l’exécution. S’exclut mutuellement avec description (objet fourni par le LLM), dynamic_variable et is_omitted.
- `is_omitted` (boolean, optional, default: false) — Si true, ce paramètre sera entièrement omis de la requête. Valide uniquement pour les paramètres facultatifs. Mutuellement exclusif avec description, dynamic_variable et constant_value.
- `type` ("object", optional)
- `required` (list of string, optional)
- `properties` (map from string to ObjectJsonSchemaPropertyInputPropertiesValue, optional)
- `required_constraints` (RequiredConstraints, optional) — Conteneur pour les contraintes de composition anyOf/allOf limitées aux champs obligatoires.

### 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) — Si aucun changement de langue ne se produit lors des 2 premiers tours de l’utilisateur, les tentatives ultérieures échouent et la conversation reste dans la langue actuelle. Si la langue change pendant ces tours, les changements ultérieurs restent possibles. Activez cette option pour réduire le risque de changement erroné.
- `system_tool_type`: `play_keypad_touch_tone`
  - `suppress_turn_after_dtmf` (boolean, optional, default: false) — Si true, l’agent ne générera plus de parole après avoir émis des tonalités DTMF. Cela empêche la parole de l’agent d’interférer avec les systèmes IVR.
  - `use_out_of_band_dtmf` (boolean, optional, default: true) — Envoie les tonalités DTMF comme événements RTP hors bande (RFC 4733) plutôt que comme audio dans la bande. Fonctionne uniquement pour les numéros importés depuis un trunk SIP.
- `system_tool_type`: `skip_turn`
  - `wait_timeout_secs` (double, optional, default: -1) — Secondes à attendre après skip_turn avant que l’agent ne génère une relance contextuelle. Le minuteur « Terminer la conversation après un silence » est suspendu pendant l’attente. La valeur -1 désactive l’attente : après skip_turn, l’agent reste silencieux jusqu’à ce que l’appelant parle, et ce minuteur continue de s’écouler. S’applique uniquement aux conversations vocales.
- `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) — Indique s'il faut diffuser un message au client pendant qu'il attend le transfert. La valeur par défaut est true pour assurer la rétrocompatibilité.
- `system_tool_type`: `voicemail_detection`
  - `voicemail_message` (string, optional) — Message facultatif à laisser sur la messagerie vocale lorsqu'elle est détectée. Si aucun message n'est fourni, l'appel se termine immédiatement lors de la détection de la messagerie vocale. Prend en charge les variables dynamiques, par exemple \{\{system\_\_time}}, \{\{system\_\_call\_duration\_secs}}, \{\{custom\_variable}}.

### WebhookToolApiSchemaConfigInput

- `url` (string, required) — L’URL à laquelle le webhook sera envoyé. Peut inclure des paramètres de chemin, par exemple [https://example.com/agents/\{agent\_id}](https://example.com/agents/\{agent_id})
- `request_headers` (map from string to WebhookToolApiSchemaConfigInputRequestHeadersValue, optional) — En-têtes à inclure dans la requête.
- `method` (enum, optional, default: GET) — La méthode HTTP à utiliser pour le webhook
  - Allowed values: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`
- `path_params_schema` (map from string to LiteralJsonSchemaProperty, optional) — Schéma des paramètres de chemin, le cas échéant. Les clés doivent correspondre aux espaces réservés dans l’URL.
- `query_params_schema` (QueryParamsJsonSchemaInput, optional) — Schéma des paramètres de requête, le cas échéant. Ils sont ajoutés à la fin de l’URL comme paramètres de requête. Remarque : les propriétés d’un paramètre de requête doivent toutes être de types littéraux.
- `request_body_schema` (ObjectJsonSchemaPropertyInput, optional) — Schéma des paramètres du corps, le cas échéant. Utilisé pour les requêtes POST/PATCH/PUT. Le schéma doit être un objet envoyé comme corps JSON.
- `response_body_schema` (ObjectJsonSchemaPropertyInput, optional) — Schéma décrivant la structure attendue du corps de réponse. À des fins de documentation uniquement ; non exposé au LLM.
- `response_filter` (ResponseFilter, optional) — Filtre de liste blanche facultatif appliqué à la réponse avant que le LLM ne la voie, afin que les réponses volumineuses ne polluent pas le contexte. Par défaut, la réponse complète est utilisée.
- `content_type` (enum, optional, default: application/json) — Type de contenu du corps de la requête. S'applique uniquement aux requêtes POST/PUT/PATCH.
  - Allowed values: `application/json`, `application/x-www-form-urlencoded`
- `auth_resolved_params` (list of string, optional) — Espaces réservés de l’URL résolus depuis la connexion d’authentification, par exemple les secrets injectés via UrlSecretAuthConnection, plutôt que depuis path_params_schema.
- `auth_connection` (WebhookToolApiSchemaConfigInputAuthConnection, optional) — Connexion d'authentification facultative à utiliser avec ce webhook

### ArrayJsonSchemaPropertyOutputItems

Schéma des éléments du tableau.

- Literal JSON Schema Property: LiteralJsonSchemaProperty
- Object JSON Schema Property Output: ObjectJsonSchemaPropertyOutput
- Array JSON Schema Property Output: ArrayJsonSchemaPropertyOutput

### ObjectJsonSchemaPropertyInputPropertiesValue

- Literal JSON Schema Property: LiteralJsonSchemaProperty
- Object JSON Schema Property Input: ObjectJsonSchemaPropertyInput
- Array JSON Schema Property Input: ArrayJsonSchemaPropertyInput

### 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) — Définit si les remplacements côté client du TTS doivent être transférés vers l'agent cible.
- `preserve_voice_settings` (boolean, optional, default: false) — Définit si la voix de base, le modèle TTS et les paramètres vocaux doivent être transférés vers l'agent cible.

### WebhookToolApiSchemaConfigInputRequestHeadersValue

- string
- Conv AI Secret Locator: ConvAiSecretLocator
- Conv AI Dynamic Variable: ConvAiDynamicVariable
- Conv AI Env Var Locator: ConvAiEnvVarLocator

### QueryParamsJsonSchemaInput

- `properties` (map from string to LiteralJsonSchemaProperty, required)
- `required` (list of string, optional)

### WebhookToolApiSchemaConfigInputAuthConnection

Connexion d'authentification facultative à utiliser avec ce webhook

- Auth Connection Locator: AuthConnectionLocator
- Environment Auth Connection Locator: EnvironmentAuthConnectionLocator

### ArrayJsonSchemaPropertyInput

- `property_kind` (enum, optional, default: array)
  - Allowed values: `array`, `object`
- `description` (string, optional, default: )
- `dynamic_variable` (string, optional, default: ) — Lorsqu’il est défini, l’intégralité du paramètre est renseignée à partir de cette variable dynamique à l’exécution. S’exclut mutuellement avec description (valeur fournie par le LLM), constant_value et is_omitted.
- `constant_value` (list of any, optional) — Lorsqu’elle est définie, l’intégralité du tableau utilise cette valeur constante à l’exécution. S’exclut mutuellement avec description (tableau fourni par le LLM), dynamic_variable et is_omitted.
- `is_omitted` (boolean, optional, default: false) — Si true, ce paramètre sera entièrement omis de la requête. Valide uniquement pour les paramètres facultatifs. Mutuellement exclusif avec description, dynamic_variable et constant_value.
- `type` ("array", optional)
- `items` (ArrayJsonSchemaPropertyInputItems, optional) — Schéma des éléments du tableau.

### ArrayJsonSchemaPropertyInputItems

Schéma des éléments du tableau.

- Literal JSON Schema Property: LiteralJsonSchemaProperty
- Object JSON Schema Property Input: ObjectJsonSchemaPropertyInput
- Array JSON Schema Property Input: ArrayJsonSchemaPropertyInput

## Examples

**Request**

```json
{}
```

**Response**

```json
{
  "agent_id": "J3Pbu5gP6NNKBscdCdwB"
}
```

**SDK Code**

```python
import requests

url = "https://api.elevenlabs.io/v1/convai/agents/create"

querystring = {"enable_versioning":"true"}

payload = {}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers, params=querystring)

print(response.json())
```

```javascript
const url = 'https://api.elevenlabs.io/v1/convai/agents/create?enable_versioning=true';
const options = {method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{}'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.elevenlabs.io/v1/convai/agents/create?enable_versioning=true"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.elevenlabs.io/v1/convai/agents/create?enable_versioning=true")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.elevenlabs.io/v1/convai/agents/create?enable_versioning=true")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.elevenlabs.io/v1/convai/agents/create?enable_versioning=true', [
  'body' => '{}',
  'headers' => [
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.elevenlabs.io/v1/convai/agents/create?enable_versioning=true");
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Content-Type": "application/json"]
let parameters = [] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/convai/agents/create?enable_versioning=true")! 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()
```