Struct AgentDefinition 

pub struct AgentDefinition {
    pub name: String,
    pub description: String,
    pub instructions: Instructions,
    pub model: String,
    pub tools: ToolPolicy,
    pub output_schema: Option<Value>,
    pub completion: Option<CompletionRequirement>,
    pub max_steps: usize,
    pub enabled: bool,
    pub capability: Option<CapabilityMode>,
    pub source: Option<AgentSource>,
}

Versionable agent definition (data only).

Fields

name: String

Unique name (slug).

description: String

Human description.

instructions: Instructions

Instructions / system prompt body.

model: String

Default model id.

tools: ToolPolicy

Tool policy (resolved at build time — definition-level allowed_tools).

output_schema: Option<Value>

Optional structured output schema (JSON Schema object).

completion: Option<CompletionRequirement>

Optional completion gate.

max_steps: usize

Default max steps for turns using this agent.

enabled: bool

When false, definition is invisible and not callable.

capability: Option<CapabilityMode>

Preferred capability mode (intersected with spawn request).

source: Option<AgentSource>

Discovery source (not required in markdown; set by resolver).

Implementations

impl AgentDefinition

pub fn new(name: impl Into<String>) -> Self

Minimal named definition with defaults.

pub fn validate(&self) -> Result<(), MachiError>

Validate required fields.

Errors

Returns machi_types::MachiError when name/model empty or max_steps is zero.

Trait Implementations

impl Clone for AgentDefinition

fn clone(&self) -> AgentDefinition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentDefinition

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentDefinition

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentDefinition

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.