Struct DeepAgentConfig

pub struct DeepAgentConfig {
    pub instructions: String,
    pub planner: Arc<dyn PlannerHandle>,
    pub tools: Vec<ToolBox>,
    pub subagent_configs: Vec<SubAgentConfig>,
    pub summarization: Option<SummarizationConfig>,
    pub tool_interrupts: HashMap<String, HitlPolicy>,
    pub builtin_tools: Option<HashSet<String>>,
    pub auto_general_purpose: bool,
    pub enable_prompt_caching: bool,
    pub checkpointer: Option<Arc<dyn Checkpointer>>,
}

Configuration for building a deep agent instance.

This is the internal configuration used by the builder and runtime.

Fields

instructions: String

planner: Arc<dyn PlannerHandle>

tools: Vec<ToolBox>

subagent_configs: Vec<SubAgentConfig>

summarization: Option<SummarizationConfig>

tool_interrupts: HashMap<String, HitlPolicy>

builtin_tools: Option<HashSet<String>>

auto_general_purpose: bool

enable_prompt_caching: bool

checkpointer: Option<Arc<dyn Checkpointer>>

Implementations

impl DeepAgentConfig

pub fn new( instructions: impl Into<String>, planner: Arc<dyn PlannerHandle>, ) -> Self

pub fn with_tool(self, tool: ToolBox) -> Self

pub fn with_subagent_config(self, config: SubAgentConfig) -> Self

Add a sub-agent configuration

pub fn with_subagent_configs<I>(self, configs: I) -> Self

where I: IntoIterator<Item = SubAgentConfig>,

Add multiple sub-agent configurations

pub fn with_summarization(self, config: SummarizationConfig) -> Self

pub fn with_tool_interrupt( self, tool_name: impl Into<String>, policy: HitlPolicy, ) -> Self

pub fn with_builtin_tools<I, S>(self, names: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Limit which built-in tools are exposed. When omitted, all built-ins are available. Built-ins: write_todos, ls, read_file, write_file, edit_file. The task tool (for subagents) is always available when subagents are registered.

pub fn with_auto_general_purpose(self, enabled: bool) -> Self

Enable or disable automatic registration of a “general-purpose” subagent. Enabled by default; set to false to opt out.

pub fn with_prompt_caching(self, enabled: bool) -> Self

Enable or disable Anthropic prompt caching middleware. Disabled by default; set to true to enable caching for better performance.

pub fn with_checkpointer(self, checkpointer: Arc<dyn Checkpointer>) -> Self

Set the checkpointer for persisting agent state between runs.