Struct AgentProfile 

pub struct AgentProfile {
    pub profile_id: String,
    pub name: Option<String>,
    pub description: Option<String>,
    pub system_prompt: Option<String>,
    pub thinking_level: Option<ThinkingLevel>,
    pub temperature: Option<f32>,
    pub max_tokens: Option<u32>,
    pub config_id: Option<String>,
    pub skills: Vec<String>,
    pub workspace: Option<PathBuf>,
}

A reusable agent blueprint that defines default configuration for agents.

Multiple agents can share the same profile, inheriting its settings as defaults. Agent-level settings (e.g. system_prompt on BasicAgent) override the profile’s values when both are set.

Resolution order

For fields like thinking_level and temperature, the resolution order is:

1. Session override (if set)
2. Profile value (if set)
3. Crate default (ThinkingLevel::Off, None)

Fields

profile_id: String

Unique identifier for this profile. Auto-generated UUID when using Default.

name: Option<String>

Human-readable name for agents using this profile.

description: Option<String>

Description of the profile’s purpose or capabilities.

system_prompt: Option<String>

Default system prompt for agents using this profile. Can be overridden at the agent level.

thinking_level: Option<ThinkingLevel>

Default thinking level for agents using this profile.

temperature: Option<f32>

Default temperature for agents using this profile.

max_tokens: Option<u32>

Default max tokens for agents using this profile.

config_id: Option<String>

Stable config identity. When set, used as the middle segment of loop_id: loop_id = "{session_id}.{config_id}.{N}"

skills: Vec<String>

Skill names loaded via SkillSet from SKILL.md files. These are NOT tools — they are skill definitions per the AgentSkills standard.

workspace: Option<PathBuf>

Agent workspace directory. File paths in system prompt blocks resolve relative to this directory.

Trait Implementations

impl Clone for AgentProfile

fn clone(&self) -> AgentProfile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentProfile

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

Formats the value using the given formatter.

impl Default for AgentProfile

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AgentProfile

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentProfile

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

where __S: Serializer,

Serialize this value into the given Serde serializer.