1. Model Configuration
AgenticUniverse - Previously Formi
  • Our Technical Note
    • Why Open AI is not Enough
    • How business Outcomes would Change Radically with AgenticUniverse
    • Our Research
      • STT - Nuances and Insights
      • Solving for STT Constraints
  • Generate Token
    • Login/Generate Token
      POST
  • Agent Configuration
    • Model Configuration
      • Configuration Helpers
        • Supported Providers
        • Supported Models
        • Supported Parameters
      • Get Model Configuration
        GET
      • Set Model Configuration
        POST
    • State Machine
      • Edge
        • Legacy
          • Create Edge
          • Edge Details
          • Update Edge
          • Delete Edge
        • Update edge properties
        • Get edge details
        • Delete an edge
        • Create an edge (transition) between two states
      • State
        • Create State from Template
        • Get State Information
        • Update State
        • Delete State
      • Get State Machine Structure
    • Prompt Templates
      • Get All Templates
      • Render Template
    • Tools
      • Get Tools List
      • Add Tool
      • Update Tool
      • Delete Tool
    • Draft
      • Create or replace draft
      • Get current draft
      • Discard draft
      • Merge changes into draft
    • Publish
      • Publish draft
    • Versions
      • List published versions
      • Get version detail
    • Revert
      • Revert to archived version
    • Get All Agents
      GET
    • Single Agent Details
      GET
    • Create Agent
      POST
    • Update Agent Details
      PUT
    • Enable Dashboard For An Outlet
      POST
    • Disable Dashboard For An Outlet
      POST
    • Get Call queue Sheet ID
      GET
  • Interactions
    • Pre-Interaction Context
      • Schedule an Interaction
      • Update an Interaction Id
      • Delete an Interaction Id
      • Clear all interactions
      • Get Summarized Interaction Info
    • Interaction Modalities
      • Video
        • Generation
          • Generate Welcome Video
      • Text
        • Start Interaction
        • Create Response
        • End Interaction
      • Voice
        • Connection Configuration
          • Quickstart
          • Connecting Twilio
          • Connecting Exotel
          • Formi WebSocket Configuration Guide
          • Create a New Connection Vendor
          • Get All Connection Vendors
          • Update a Connection Vendor
          • Delete a Connection Vendor
          • Get Agent's Connection Config
          • Add or Update Agent's Connection Config
    • Post Interaction Configuration
      • Email Destination Configuration
      • Variables CRUD
        • Get all required variables for the outlet with map
        • Modify variable definition for outlet
        • Add a new variable for the outlet
        • DELETE variable for outlet
        • Connect Variable to a destination
      • Destinations CRUD
        • Get all destinations for the outlet
        • Modify Destination for outlet
        • Add a new Destination for the outlet
        • DELETE Destinations for outlet
      • Post Call Email Configuration
        • Check Email Configuration
        • Set Email Configuration
    • Signals
      • Get Signals List
      • Add Signal - LEAD
      • Add Signal - INTERACTION
      • Update Signal
    • Get Interaction Summary
      GET
    • Resolve an Escalated Interaction
      POST
    • Get the Interaction list
      GET
    • Get Information regarding Single Interaction
      GET
    • End Interaction
      POST
  • Agent Utilisation
    • Get Credits Available
    • Interaction Utilisation
    • Model Utilisation
  • Webhooks
    • Get webhook URL
    • Update webhook URL
    • Get webhook metadata
    • Modify webhook metadata
    • Get reservation ingestion metadata
  • Reachout Mechanism
    • Campaign Management
      • Campaigns List
      • Campaign Details
      • Create Campaign
      • Batch Schedule Interaction for Leads
      • Quick Schedule
      • Single Campaign Report
    • Lead Management
      • Upload Leads
      • Upload Leads - Status
      • Get Leads List
  • Untitled Endpoint
    GET
  • Add Signal
    POST
  • Schemas
    • Schemas
      • Schemas
        • CreateEdgeWithTemplateDTO
        • UpdateEdgeWithTemplateDTO
        • EdgeDetails
      • WebhookUrlRequest
      • InteractionSummaryCard
      • InteractionInfo
      • CreateVendorPayload
      • WebhookMetadataRequest
      • InteractionSummaryPayload
      • CustomerDetails
      • Vendor
      • SuccessResponse
      • InteractionSummaryResponse
      • InteractionDetails
      • ConnectionConfig
      • ErrorResponse
      • GenericSuccessResponse
      • SuccessResponseVendorList
      • SuccessResponseSingleVendor
      • SuccessResponseAgentConfig
    • Response
      • Unauthorized
      • NotFound
      • ServerError
    • Add Calls Payload
    • APISuccess
    • APIError
    • APIErrorWithPayload
    • EdgeSnapshot
    • StateSnapshot
    • StateMachineSnapshot
    • ConfigSnapshot
    • ChangeSummary
    • DraftResponse
    • VersionSummary
    • VersionDetail
    • StateMachinePatch
  1. Model Configuration

Set Model Configuration

Developing
Staging Env
https://staging-api.formi.co.in
Staging Env
https://staging-api.formi.co.in
POST
https://staging-api.formi.co.in
/v2/agents/{agent_id}/config/model
Last modified:2026-06-26 11:06:35
Maintainer:Not configured

Request

Authorization
API Key
Add parameter in header
token
Example:
token: ********************
or
Path Params

Header Params

Body Params application/json

Example
{
        "LLM": {
            "conversation_llm": {
                "provider": "google",
                "model_name": "gemini-3.1-flash-lite",
                "params": {
                    "streaming": true,
                    "temperature": 0.4
                }
            },
            "transition_llm": {
                "provider": "google",
                "model_name": "gemini-3.1-flash-lite",
                "params": {
                    "temperature": 0.1
                }
            }
        },
        "TTS": {
            "tts_model": {
                "provider": "elevenlabs",
                "model_name": "eleven_flash_v2_5",
                "params": {
                    "speed": 0.93,
                    "style": 0, 
                    "encoding": "pcm16",
                    "language": "en-US",
                    "voice_id": "XrExE9yKIg1WjnnlVkGX",
                    "stability": 0.7,
                    "streaming": true, 
                    "similarity_boost": 0.5,
                    "use_speaker_boost": true
                }
            },
            "enhance_pronunciation": true
        },
        "STT": {
            "stt_provider": "deepgram",
            "params": {
                "model": "nova-3",
                "language_code": "hi",
                "max_silence_retries": 0,
                "silence_detection_enabled": false,
                "silence_threshold_seconds": 60
            },
            "gibberish_detection": null,
            "threshold": null,
            "ignore_interruption_loop_words": {
                "words_list": [
                    "okay",
                    "yeah",
                    "yes",
                    "hello hello",
                    "hello",
                    "hello",
                    "hmm",
                    "ok",
                    "hi",
                    "ji",
                    "hi",
                    "yes",
                    "haa",
                    "yes yes",
                    "ok ok",
                    "yes sir",
                    "yes ma'am",
                    "thank you",
                    "yeah",
                    "ok sir",
                    "ok ma'am",
                    "yeah yeah",
                    "haan",
                    "हां",
                    "जी",
                    "हां जी",
                    "हां हां",
                    "जी जी",
                    "बोलिए",
                    "ठीक है",
                    "जी sir",
                    "जी ma'am",
                    "हां बोलिए",
                    "जी जी जी",
                    "हाँ",
                    "ठीक है",
                    "जी",
                    "बोलिये",
                    "क्यों call किया"
                ],
                "max_turns": -1
            }
        },
        "state_machine_runtime": {
            "state_prompt_feeding_enabled": false,
            "state_transition_enabled": false
        },
        "language_profile": {},
        "resolved_language_config": null,
        "voice_runtime": null,
        "campaign_language_context": null,
        "language_resolution_status": null,
        "welcome_message": "Hello! This is Simran from Cholamandalam MS General Insurance. क्या मैं {{ customer_name }} जी से बात कर रही हूं?",
        "allowed_languages": [
            "hi",
            "en"
        ],
        "language_adapter": {
            "enabled": true,
            "fallback": false,
            "logs": "",
            "explicit_switch_enabled": true,
            "lexicons": {},
            "preference_confirmation": {
                "question_cues": [
                    "comfortable",
                    "comfort",
                    "ok",
                    "okay",
                    "fine",
                    "prefer",
                    "preference",
                    "language",
                    "speak",
                    "talk",
                    "reply",
                    "respond",
                    "baat",
                    "bolo",
                    "boliye",
                    "भाषा",
                    "आराम",
                    "सहज",
                    "ठीक",
                    "बात",
                    "बोल",
                    "बोलिए"
                ],
                "affirmative_phrases": [
                    "yes",
                    "yeah",
                    "yep",
                    "ya",
                    "sure",
                    "ok",
                    "okay",
                    "fine",
                    "correct",
                    "right",
                    "comfortable",
                    "i am",
                    "i am comfortable",
                    "haan",
                    "han",
                    "haa",
                    "ha",
                    "haan ji",
                    "han ji",
                    "ji",
                    "theek hai",
                    "thik hai",
                    "teek hai",
                    "bilkul",
                    "हाँ",
                    "हां",
                    "जी",
                    "हाँ जी",
                    "हां जी",
                    "ठीक है",
                    "बिलकुल"
                ],
                "negative_phrases": [
                    "no",
                    "nope",
                    "not comfortable",
                    "i am not",
                    "i am not comfortable",
                    "nahi",
                    "nahin",
                    "nhi",
                    "nai",
                    "na",
                    "नहीं",
                    "नही",
                    "ना"
                ]
            },
            "min_turns_grace_period": 2,
            "history_window_size": 3,
            "switch_threshold": 0.5,
            "revert_threshold": 0.49,
            "w_previous_input": 0.6,
            "w_current_input": 0.4
        },
        "allow_incoming_interactions": true,
        "allow_context_transfer_to_incoming_interactions": true,
        "VAD": {
            "vad_probability_threshold": 0.94,
            "high_probability_window_size": 0.16,
            "high_noise_detector_threshold": 0.3
        },
        "interruption_handling": {
            "substantive_min_tokens": 2,
            "asr_conf_floor": 0.6,
            "vad_veto_threshold": 0.4,
            "min_speech_duration_ms": 120.0,
            "lexicon_overrides": {
                "BACKCHANNEL": {
                    "added": [],
                    "removed": []
                },
                "AFFIRMATION": {
                    "added": [],
                    "removed": []
                },
                "FILLER": {
                    "added": [],
                    "removed": []
                },
                "ATTENTION": {
                    "added": [],
                    "removed": []
                },
                "CLARIFICATION": {
                    "added": [],
                    "removed": []
                },
                "QUESTION": {
                    "added": [],
                    "removed": []
                },
                "CORRECTION": {
                    "added": [],
                    "removed": []
                },
                "STOP_REQUEST": {
                    "added": [],
                    "removed": []
                }
            }
        },
        "background_noise_classification": {
            "enabled": false,
            "model_name": "MIT/ast-finetuned-audioset-10-10-0.4593",
            "chunk_seconds": 5.0,
            "trigger_seconds": 4.0,
            "concurrent_times": 2,
            "max_markers_per_type": 3,
            "cooldown_seconds": 20.0,
            "top_k": 10,
            "min_noise_score": 0.09,
            "speech_noise_score_gap_threshold": 1.0,
            "queue_maxsize": 64,
            "llm_context_enabled": true,
            "direct_message_enabled": true,
            "suppress_llm_marker_turns": true,
            "default_message": "I can hear background noise. Could you please move to a quieter place or speak a little louder?",
            "message_delivery": "llm_marker",
            "context_expiry_seconds": 30.0,
            "context_include_top_k": true,
            "context_max_top_k": 3
        },
        "backchanneling_filler_data": {
            "approval": [
                {
                    "filler": "ठीक है ",
                    "language": "hi",
                    "duration": 0.5
                }
            ],
            "denial": [
                {
                    "filler": "Okay.",
                    "language": "hi",
                    "duration": 0.5
                }
            ],
            "informing": [
                {
                    "filler": "जी",
                    "language": "hi",
                    "duration": 0.5
                }
            ],
            "asking": [
                {
                    "filler": "अच्छा",
                    "language": "hi",
                    "duration": 0.5
                }
            ],
            "others": [
                {
                    "filler": "जी",
                    "language": "hi",
                    "duration": 0.5
                }
            ]
        },
        "max_backchannel_fillers_per_turn": 0,
        "backchanneling_wait_time": 2.0,
        "audio_denoise_config": {
            "denoise_enabled": true,
            "speech_enhancement_enabled": true,
            "params": {
                "denoiser_backend": "rnnoise",
                "attenuation_limit": 6.0,
                "mix_ratio": 0.85,
                "processing_ratio": 0.3
            }
        },
        "z_factor_window_selector": 1.96,
        "enterprise_rag": {
            "enabled": false,
            "mode": "off",
            "enterprise_id": null,
            "kb_version": null,
            "source_format": "markdown",
            "compiled_store": "postgres",
            "top_k": 5,
            "max_context_tokens": 1400,
            "timeout_ms": 1000,
            "skip_generic_turns": true,
            "no_match_guardrail": true,
            "slow_filler_enabled": true,
            "slow_filler_after_ms": 700,
            "slow_filler_repeat_ms": 0,
            "slow_filler_text": "Give me a second, I will get that information for you.",
            "include_families": [
                "objection_handling",
                "faq",
                "branch_location",
                "prompt_rule"
            ]
        },
        "suppress_inbound_to_stt_while_agent_speaking": false,
        "multi_speaker": {
            "multi_speaker_detection_enabled": false,
            "detector_backend": "energy_cv",
            "pyannote_pipeline_id": "pyannote/speaker-diarization-3.1",
            "pyannote_auth_token_env": "HUGGINGFACE_TOKEN",
            "min_distinct_speakers": 2,
            "sustain_duration_sec": 2.0,
            "cooldown_sec": 30.0,
            "energy_cv_threshold": 0.6,
            "secondary_attenuation_factor": 0.0,
            "source_separation_enabled": false,
            "ring_buffer_seconds": 2.0,
            "analyze_interval_sec": 0.5,
            "min_analysis_seconds": 0.5,
            "speaker_profile_enabled": false,
            "speaker_similarity_threshold": 0.75,
            "speaker_profile_ema_alpha": 0.3,
            "speaker_profile_min_enrollment_seconds": 1.0,
            "speaker_profile_min_compare_seconds": 0.8,
            "speaker_profile_enroll_rms_min": 0.1,
            "speaker_profile_enroll_rms_max": 0.25,
            "speaker_profile_enroll_confidence_min": 0.8,
            "inform_prompt_text": "It seems like more than one person is speaking. Could you please move to a quieter place and repeat what you just said?"
        },
        "moss_rag": null
    }

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://staging-api.formi.co.in/v2/agents/125/config/model' \
--header 'token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
        "LLM": {
            "conversation_llm": {
                "provider": "google",
                "model_name": "gemini-3.1-flash-lite",
                "params": {
                    "streaming": true,
                    "temperature": 0.4
                }
            },
            "transition_llm": {
                "provider": "google",
                "model_name": "gemini-3.1-flash-lite",
                "params": {
                    "temperature": 0.1
                }
            }
        },
        "TTS": {
            "tts_model": {
                "provider": "elevenlabs",
                "model_name": "eleven_flash_v2_5",
                "params": {
                    "speed": 0.93,
                    "style": 0, 
                    "encoding": "pcm16",
                    "language": "en-US",
                    "voice_id": "XrExE9yKIg1WjnnlVkGX",
                    "stability": 0.7,
                    "streaming": true, 
                    "similarity_boost": 0.5,
                    "use_speaker_boost": true
                }
            },
            "enhance_pronunciation": true
        },
        "STT": {
            "stt_provider": "deepgram",
            "params": {
                "model": "nova-3",
                "language_code": "hi",
                "max_silence_retries": 0,
                "silence_detection_enabled": false,
                "silence_threshold_seconds": 60
            },
            "gibberish_detection": null,
            "threshold": null,
            "ignore_interruption_loop_words": {
                "words_list": [
                    "okay",
                    "yeah",
                    "yes",
                    "hello hello",
                    "hello",
                    "hello",
                    "hmm",
                    "ok",
                    "hi",
                    "ji",
                    "hi",
                    "yes",
                    "haa",
                    "yes yes",
                    "ok ok",
                    "yes sir",
                    "yes ma'\''am",
                    "thank you",
                    "yeah",
                    "ok sir",
                    "ok ma'\''am",
                    "yeah yeah",
                    "haan",
                    "हां",
                    "जी",
                    "हां जी",
                    "हां हां",
                    "जी जी",
                    "बोलिए",
                    "ठीक है",
                    "जी sir",
                    "जी ma'\''am",
                    "हां बोलिए",
                    "जी जी जी",
                    "हाँ",
                    "ठीक है",
                    "जी",
                    "बोलिये",
                    "क्यों call किया"
                ],
                "max_turns": -1
            }
        },
        "state_machine_runtime": {
            "state_prompt_feeding_enabled": false,
            "state_transition_enabled": false
        },
        "language_profile": {},
        "resolved_language_config": null,
        "voice_runtime": null,
        "campaign_language_context": null,
        "language_resolution_status": null,
        "welcome_message": "Hello! This is Simran from Cholamandalam MS General Insurance. क्या मैं {{ customer_name }} जी से बात कर रही हूं?",
        "allowed_languages": [
            "hi",
            "en"
        ],
        "language_adapter": {
            "enabled": true,
            "fallback": false,
            "logs": "",
            "explicit_switch_enabled": true,
            "lexicons": {},
            "preference_confirmation": {
                "question_cues": [
                    "comfortable",
                    "comfort",
                    "ok",
                    "okay",
                    "fine",
                    "prefer",
                    "preference",
                    "language",
                    "speak",
                    "talk",
                    "reply",
                    "respond",
                    "baat",
                    "bolo",
                    "boliye",
                    "भाषा",
                    "आराम",
                    "सहज",
                    "ठीक",
                    "बात",
                    "बोल",
                    "बोलिए"
                ],
                "affirmative_phrases": [
                    "yes",
                    "yeah",
                    "yep",
                    "ya",
                    "sure",
                    "ok",
                    "okay",
                    "fine",
                    "correct",
                    "right",
                    "comfortable",
                    "i am",
                    "i am comfortable",
                    "haan",
                    "han",
                    "haa",
                    "ha",
                    "haan ji",
                    "han ji",
                    "ji",
                    "theek hai",
                    "thik hai",
                    "teek hai",
                    "bilkul",
                    "हाँ",
                    "हां",
                    "जी",
                    "हाँ जी",
                    "हां जी",
                    "ठीक है",
                    "बिलकुल"
                ],
                "negative_phrases": [
                    "no",
                    "nope",
                    "not comfortable",
                    "i am not",
                    "i am not comfortable",
                    "nahi",
                    "nahin",
                    "nhi",
                    "nai",
                    "na",
                    "नहीं",
                    "नही",
                    "ना"
                ]
            },
            "min_turns_grace_period": 2,
            "history_window_size": 3,
            "switch_threshold": 0.5,
            "revert_threshold": 0.49,
            "w_previous_input": 0.6,
            "w_current_input": 0.4
        },
        "allow_incoming_interactions": true,
        "allow_context_transfer_to_incoming_interactions": true,
        "VAD": {
            "vad_probability_threshold": 0.94,
            "high_probability_window_size": 0.16,
            "high_noise_detector_threshold": 0.3
        },
        "interruption_handling": {
            "substantive_min_tokens": 2,
            "asr_conf_floor": 0.6,
            "vad_veto_threshold": 0.4,
            "min_speech_duration_ms": 120.0,
            "lexicon_overrides": {
                "BACKCHANNEL": {
                    "added": [],
                    "removed": []
                },
                "AFFIRMATION": {
                    "added": [],
                    "removed": []
                },
                "FILLER": {
                    "added": [],
                    "removed": []
                },
                "ATTENTION": {
                    "added": [],
                    "removed": []
                },
                "CLARIFICATION": {
                    "added": [],
                    "removed": []
                },
                "QUESTION": {
                    "added": [],
                    "removed": []
                },
                "CORRECTION": {
                    "added": [],
                    "removed": []
                },
                "STOP_REQUEST": {
                    "added": [],
                    "removed": []
                }
            }
        },
        "background_noise_classification": {
            "enabled": false,
            "model_name": "MIT/ast-finetuned-audioset-10-10-0.4593",
            "chunk_seconds": 5.0,
            "trigger_seconds": 4.0,
            "concurrent_times": 2,
            "max_markers_per_type": 3,
            "cooldown_seconds": 20.0,
            "top_k": 10,
            "min_noise_score": 0.09,
            "speech_noise_score_gap_threshold": 1.0,
            "queue_maxsize": 64,
            "llm_context_enabled": true,
            "direct_message_enabled": true,
            "suppress_llm_marker_turns": true,
            "default_message": "I can hear background noise. Could you please move to a quieter place or speak a little louder?",
            "message_delivery": "llm_marker",
            "context_expiry_seconds": 30.0,
            "context_include_top_k": true,
            "context_max_top_k": 3
        },
        "backchanneling_filler_data": {
            "approval": [
                {
                    "filler": "ठीक है ",
                    "language": "hi",
                    "duration": 0.5
                }
            ],
            "denial": [
                {
                    "filler": "Okay.",
                    "language": "hi",
                    "duration": 0.5
                }
            ],
            "informing": [
                {
                    "filler": "जी",
                    "language": "hi",
                    "duration": 0.5
                }
            ],
            "asking": [
                {
                    "filler": "अच्छा",
                    "language": "hi",
                    "duration": 0.5
                }
            ],
            "others": [
                {
                    "filler": "जी",
                    "language": "hi",
                    "duration": 0.5
                }
            ]
        },
        "max_backchannel_fillers_per_turn": 0,
        "backchanneling_wait_time": 2.0,
        "audio_denoise_config": {
            "denoise_enabled": true,
            "speech_enhancement_enabled": true,
            "params": {
                "denoiser_backend": "rnnoise",
                "attenuation_limit": 6.0,
                "mix_ratio": 0.85,
                "processing_ratio": 0.3
            }
        },
        "z_factor_window_selector": 1.96,
        "enterprise_rag": {
            "enabled": false,
            "mode": "off",
            "enterprise_id": null,
            "kb_version": null,
            "source_format": "markdown",
            "compiled_store": "postgres",
            "top_k": 5,
            "max_context_tokens": 1400,
            "timeout_ms": 1000,
            "skip_generic_turns": true,
            "no_match_guardrail": true,
            "slow_filler_enabled": true,
            "slow_filler_after_ms": 700,
            "slow_filler_repeat_ms": 0,
            "slow_filler_text": "Give me a second, I will get that information for you.",
            "include_families": [
                "objection_handling",
                "faq",
                "branch_location",
                "prompt_rule"
            ]
        },
        "suppress_inbound_to_stt_while_agent_speaking": false,
        "multi_speaker": {
            "multi_speaker_detection_enabled": false,
            "detector_backend": "energy_cv",
            "pyannote_pipeline_id": "pyannote/speaker-diarization-3.1",
            "pyannote_auth_token_env": "HUGGINGFACE_TOKEN",
            "min_distinct_speakers": 2,
            "sustain_duration_sec": 2.0,
            "cooldown_sec": 30.0,
            "energy_cv_threshold": 0.6,
            "secondary_attenuation_factor": 0.0,
            "source_separation_enabled": false,
            "ring_buffer_seconds": 2.0,
            "analyze_interval_sec": 0.5,
            "min_analysis_seconds": 0.5,
            "speaker_profile_enabled": false,
            "speaker_similarity_threshold": 0.75,
            "speaker_profile_ema_alpha": 0.3,
            "speaker_profile_min_enrollment_seconds": 1.0,
            "speaker_profile_min_compare_seconds": 0.8,
            "speaker_profile_enroll_rms_min": 0.1,
            "speaker_profile_enroll_rms_max": 0.25,
            "speaker_profile_enroll_confidence_min": 0.8,
            "inform_prompt_text": "It seems like more than one person is speaking. Could you please move to a quieter place and repeat what you just said?"
        },
        "moss_rag": null
    }'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{}
Modified at 2026-06-26 11:06:35
Previous
Get Model Configuration
Next
Create Edge
Built with