Struct Agent 

pub struct Agent {

    pub id: String,
    pub name: String,
    pub version: String,
    pub description: String,
    pub framework: AgentFramework,
    pub mode: AgentMode,
    pub model_provider: String,
    pub model_name: String,
    pub backup_provider: Option<String>,
    pub backup_model: Option<String>,
    pub system_prompt: Option<String>,
    pub max_turns: Option<u32>,
    pub skills: Vec<String>,
    pub guardrails: Vec<Guardrail>,
    pub a2a_endpoint: Option<String>,
    pub ingredients: Vec<Ingredient>,
    pub tags: Vec<String>,
    pub status: AgentStatus,
    pub kitchen_id: Option<String>,
    pub resolved_config: Option<Value>,
    pub created_by: Option<String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub metadata: Option<Value>,
}

An Agent registered in AgentOven — a versioned, deployable AI unit.

Fields

id: String

Unique identifier.

name: String

Human-readable name (must be unique within a kitchen/workspace).

version: String

Semantic version (e.g., “1.0.0”).

description: String

Description of what this agent does.

framework: AgentFramework

The framework used to build this agent.

mode: AgentMode

Agent mode: managed (AgentOven executor) or external (A2A proxy).

model_provider: String

Primary model provider name.

model_name: String

Primary model name.

backup_provider: Option<String>

Backup model provider for failover.

backup_model: Option<String>

Backup model name for failover.

system_prompt: Option<String>

System prompt / instructions.

max_turns: Option<u32>

Maximum turns for managed agentic loop.

skills: Vec<String>

Agent skills/capabilities.

guardrails: Vec<Guardrail>

Guardrails applied to this agent.

a2a_endpoint: Option<String>

A2A endpoint for external agents.

ingredients: Vec<Ingredient>

Ingredients: models, tools, prompts, and data sources.

tags: Vec<String>

Tags for categorization and search.

status: AgentStatus

Current deployment status.

kitchen_id: Option<String>

The kitchen (workspace) this agent belongs to. Accepts both “kitchen” and “kitchen_id” from JSON.

resolved_config: Option<Value>

Resolved configuration (populated by the control plane after baking).

created_by: Option<String>

Who created this agent.

created_at: DateTime<Utc>

When this version was created.

updated_at: DateTime<Utc>

When this version was last updated.

metadata: Option<Value>

Optional metadata.

Implementations

impl Agent

pub fn builder(name: impl Into<String>) -> AgentBuilder

Start building a new agent.

pub fn qualified_name(&self) -> String

Get the fully qualified name: “name@version”.

Trait Implementations

impl Clone for Agent

fn clone(&self) -> Agent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Agent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Agent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Agent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.