Agent Configuration Options

The Agent(...) constructor accepts defaults that apply to every call handled by that worker.

AI components

You can pass defaults for:

• llm
• stt
• tts

These are typically plugin instances (for example openai.LLM()), or config dicts depending on your plugin.

If you don’t pass them, the worker can still run. Components can be injected dynamically per call via metadata.

Instructions and greeting

• system_instructions
  • The agent's main behavior/prompt.
• send_greeting
  • Whether the agent should greet immediately.
• greeting_instructions
  • The greeting text/instructions.

Defaults:

• send_greeting=True

Conversation control

• allow_interruptions
• min_interruption_duration

Defaults:

• allow_interruptions=True
• min_interruption_duration=0.08

Turn-taking / VAD-style parameters

These parameters influence when the agent decides the user stopped speaking:

• min_silence_duration
• activation_threshold
• prefix_padding_duration
• min_endpointing_delay
• max_endpointing_delay

Defaults:

• min_silence_duration=0.25
• activation_threshold=0.55
• prefix_padding_duration=0.25
• min_endpointing_delay=0.45
• max_endpointing_delay=0.9

Tools

• tools
  • A list of tool mixin classes to extend agent behavior.

See: Tools