Struct AgentSpec 

pub struct AgentSpec {
    pub name: String,
    pub description: String,
    pub model: String,
    pub reasoning_effort: Option<ReasoningEffort>,
    pub model_settings: ModelSettings,
    pub context_window: Option<u32>,
    pub prompts: Vec<Prompt>,
    pub provider_connections: ProviderConnectionOverrides,
    pub mcp: McpConfig,
    pub exposure: AgentSpecExposure,
    pub tools: ToolFilter,
}

A resolved agent specification ready for runtime use.

This type is produced by validating and resolving authored agent configuration. All validation happens before constructing these runtime types.

Fields

name: String

The canonical lookup key for this agent.

description: String

Human-readable description of this agent’s purpose.

model: String

The validated model spec to use for this agent.

This is stored as a canonical string so authored settings can represent both single models (provider:model) and alloy specs (provider1:model1,provider2:model2).

reasoning_effort: Option<ReasoningEffort>

Optional reasoning effort level for models that support it.

model_settings: ModelSettings

Sampling controls applied to this agent’s model calls.

context_window: Option<u32>

Effective context window in tokens for this agent.

prompts: Vec<Prompt>

The prompt stack for this agent.

provider_connections: ProviderConnectionOverrides

Provider connection overrides keyed by model provider name.

mcp: McpConfig

MCP servers this agent connects to

exposure: AgentSpecExposure

How this agent can be invoked.

tools: ToolFilter

Tool filter for restricting which MCP tools this agent can use.

Implementations

impl AgentSpec

pub fn bare( model: &LlmModel, reasoning_effort: Option<ReasoningEffort>, prompts: Vec<Prompt>, ) -> Self

Create a bare no-mode spec without catalog defaults or runtime policy. Production callers should prefer their catalog’s default_spec API.

Trait Implementations

impl Clone for AgentSpec

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AgentSpec

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.