@jambonz/sdk
    Preparing search index...

    Interface AgentVerb

    interface AgentVerb {
        verb: "agent";
        id?: string;
        stt?: Recognizer;
        tts?: Synthesizer;
        turnDetection?:
            | "krisp"
            | { mode: "krisp"; threshold?: number; model?: string }
            | "stt";
        bargeIn?: {
            enable?: boolean;
            minSpeechDuration?: number;
            sticky?: boolean;
        };
        llm: AgentLlm;
        actionHook?: ActionHook;
        eventHook?: ActionHook;
        toolHook?: ActionHook;
        toolFiller?: | false
        | {
            type: "audio"
            | "backchannel";
            startDelaySecs?: number;
            url?: string;
            style?: string;
            escalationSecs?: number;
        };
        greeting?: boolean;
        earlyGeneration?: boolean;
        noiseIsolation?: | "krisp"
        | {
            mode: string;
            level?: number;
            direction?: "read"
            | "write";
            model?: string;
        }
        | "rnnoise";
        mcpServers?: McpServerConfig[];
        noResponseTimeout?: number;
        autoLockLanguage?: boolean
        | "always";
        languageConfig?: Record<string, { tts?: Synthesizer }>;
    }
    Index

    Properties

    verb id? stt? tts? turnDetection? bargeIn? llm actionHook? eventHook? toolHook? toolFiller? greeting? earlyGeneration? noiseIsolation? mcpServers? noResponseTimeout? autoLockLanguage? languageConfig?

    Properties

    verb: "agent"
    id?: string
    stt?: Recognizer

    STT configuration. Optional — can be set at the application level.

    tts?: Synthesizer

    TTS configuration. Optional — can be set at the application level.

    turnDetection?:
        | "krisp"
        | { mode: "krisp"; threshold?: number; model?: string }
        | "stt"

    Turn detection strategy. String shorthand ('stt' or 'krisp') or object with tunable params.

    bargeIn?: { enable?: boolean; minSpeechDuration?: number; sticky?: boolean }

    Barge-in configuration — controls user interruption of assistant speech.

    llm: AgentLlm

    LLM configuration.

    actionHook?: ActionHook

    Webhook when agent ends.

    eventHook?: ActionHook

    Webhook for agent events.

    toolHook?: ActionHook

    Webhook when the LLM requests a tool/function call.

    toolFiller?:
        | false
        | {
            type: "audio"
            | "backchannel";
            startDelaySecs?: number;
            url?: string;
            style?: string;
            escalationSecs?: number;
        }

    Configuration for playing filler audio while tool calls are in progress. Prevents silence during long-running tool executions.

    Type Declaration

    • false
    • {
          type: "audio" | "backchannel";
          startDelaySecs?: number;
          url?: string;
          style?: string;
          escalationSecs?: number;
      }
      • type: "audio" | "backchannel"

        Filler mode. 'audio' plays a looping audio file. 'backchannel' uses TTS to speak short phrases.

      • OptionalstartDelaySecs?: number

        Seconds to wait after tool invocation before playing filler. Default: 2.

      • Optionalurl?: string

        Audio file URL (for type='audio'). Should be loopable.

      • Optionalstyle?: string

        Free-form style hint for LLM-generated phrases (for type='backchannel').

      • OptionalescalationSecs?: number

        Seconds from tool invocation before generating a longer explanatory response (for type='backchannel'). Default: 10.

    greeting?: boolean

    Whether the LLM generates an initial greeting before the user speaks. Default: true.

    earlyGeneration?: boolean

    Speculatively prompt the LLM on final transcript before Krisp end-of-turn. Default: false.

    noiseIsolation?:
        | "krisp"
        | {
            mode: string;
            level?: number;
            direction?: "read"
            | "write";
            model?: string;
        }
        | "rnnoise"

    Enable server-side noise isolation to reduce background noise on call audio. Defaults to inbound (caller) audio; set direction to 'write' for outbound.

    mcpServers?: McpServerConfig[]

    External MCP servers that provide tools to the LLM.

    noResponseTimeout?: number

    Seconds to wait after assistant finishes speaking before prompting user to respond. 0 disables. Default: 0.

    autoLockLanguage?: boolean | "always"

    Auto-adjust STT/TTS based on detected language. true=lock on first, 'always'=adapt every turn.

    languageConfig?: Record<string, { tts?: Synthesizer }>

    Per-language TTS overrides. Keys are BCP-47 codes (e.g., 'es', 'fr').

    Settings

    Member Visibility

    On This Page

    Properties