Struct ManagedAgentDef 

#[non_exhaustive]
pub struct ManagedAgentDef {
    pub name: String,
    pub model: ModelRef,
    pub system: Option<String>,
    pub description: Option<String>,
    pub tools: Vec<ToolConfig>,
    pub mcp_servers: Vec<McpServerConfig>,
    pub skills: Vec<SkillRef>,
    pub permission_policy: Option<PermissionPolicy>,
    pub metadata: Option<BTreeMap<String, String>>,
}

Declarative agent definition. Serializes to CANON §3.1/§3.6–§3.9.

This struct fully describes an agent’s configuration: which model to use, system prompt, available tools, MCP servers, skills, and permission policies. The runtime builds a runnable agent from this definition.

Examples

use adk_managed::types::ManagedAgentDef;

// Deserialize from JSON (recommended for external callers)
let json = serde_json::json!({
    "name": "my-assistant",
    "model": "gemini-2.5-flash",
    "system": "You are a helpful assistant."
});
let def: ManagedAgentDef = serde_json::from_value(json).unwrap();
assert_eq!(def.name, "my-assistant");

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

Human-readable agent name.

model: ModelRef

Provider-neutral model reference.

system: Option<String>

System prompt.

description: Option<String>

Agent description.

tools: Vec<ToolConfig>

Tool declarations (built-in + custom).

mcp_servers: Vec<McpServerConfig>

MCP server configurations.

skills: Vec<SkillRef>

Skill references.

permission_policy: Option<PermissionPolicy>

Permission policy for tools.

metadata: Option<BTreeMap<String, String>>

Caller metadata (arbitrary key-value pairs).

Implementations

impl ManagedAgentDef

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

Create a new ManagedAgentDef with required fields and defaults for optional ones.

Arguments

• name - Human-readable agent name
• model - Provider-neutral model reference

Example

use adk_managed::types::{ManagedAgentDef, ModelRef};

let def = ManagedAgentDef::new("my-agent", ModelRef::Shorthand("gemini-2.5-flash".to_string()))
    .with_system("You are a helpful assistant.");

pub fn with_system(self, system: impl Into<String>) -> Self

Set the system prompt.

pub fn with_description(self, description: impl Into<String>) -> Self

Set the agent description.

pub fn with_tools(self, tools: Vec<ToolConfig>) -> Self

Set the tool declarations.

pub fn with_mcp_servers(self, mcp_servers: Vec<McpServerConfig>) -> Self

Set the MCP server configurations.

pub fn with_skills(self, skills: Vec<SkillRef>) -> Self

Set the skill references.

pub fn with_permission_policy(self, policy: PermissionPolicy) -> Self

Set the permission policy.

pub fn with_metadata(self, metadata: BTreeMap<String, String>) -> Self

Set caller metadata.

Trait Implementations

impl Clone for ManagedAgentDef

fn clone(&self) -> ManagedAgentDef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ManagedAgentDef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ManagedAgentDef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ManagedAgentDef

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

where __S: Serializer,

Serialize this value into the given Serde serializer.