Struct UpdateAgentRequest 

#[non_exhaustive]
pub struct UpdateAgentRequest {
    pub version: u32,
    pub name: Option<String>,
    pub model: Option<AgentModel>,
    pub description: Option<String>,
    pub system: Option<String>,
    pub mcp_servers: Option<Vec<AgentMcpServer>>,
    pub skills: Option<Vec<Skill>>,
    pub tools: Option<Vec<AgentTool>>,
    pub metadata: Option<MetadataPatch>,
    pub callable_agents: Option<Vec<CallableAgent>>,
}

Available on crate feature managed-agents-preview only.

Request body for POST /v1/agents/{id} (update).

Optimistic concurrency: pass the agent’s current version. The request is rejected if the server’s stored version no longer matches.

Field semantics:

• Option::None → omit the field → preserve the existing value.
• Option::Some with empty string / empty array / null → clear, except for name and model which cannot be cleared.
• For metadata, see MetadataPatch for per-key delete semantics.

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.

version: u32

Current version, used for optimistic concurrency. Required.

name: Option<String>

New name (cannot be cleared).

model: Option<AgentModel>

New model (cannot be cleared).

description: Option<String>

New description. Some("") clears.

system: Option<String>

New system prompt. Some("") clears.

mcp_servers: Option<Vec<AgentMcpServer>>

Replacement MCP-servers list. Some(vec![]) clears.

skills: Option<Vec<Skill>>

Replacement skills list. Some(vec![]) clears.

tools: Option<Vec<AgentTool>>

Replacement tools list. Some(vec![]) clears.

metadata: Option<MetadataPatch>

Per-key metadata patch. See MetadataPatch.

callable_agents: Option<Vec<CallableAgent>>

Replacement callable-agents list. Some(vec![]) clears (turns the agent back into a non-coordinator).

Implementations

impl UpdateAgentRequest

pub fn at_version(version: u32) -> Self

Build a minimal update request (pass version, then chain setters).

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

Set the name.

pub fn model(self, model: impl Into<AgentModel>) -> Self

Set the model.

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

Set or clear (Some("")) the description.

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

Set or clear (Some("")) the system prompt.

pub fn mcp_servers(self, servers: Vec<AgentMcpServer>) -> Self

Replace the MCP servers list. Pass an empty Vec to clear.

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

Replace the skills list. Pass an empty Vec to clear.

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

Replace the tools list. Pass an empty Vec to clear.

pub fn metadata(self, patch: MetadataPatch) -> Self

Apply a metadata patch.

pub fn callable_agents(self, callable: Vec<CallableAgent>) -> Self

Replace the callable-agents list. Pass an empty Vec to clear.

Trait Implementations

impl Clone for UpdateAgentRequest

fn clone(&self) -> UpdateAgentRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UpdateAgentRequest

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

Formats the value using the given formatter.

impl Default for UpdateAgentRequest

fn default() -> UpdateAgentRequest

Returns the “default value” for a type.

impl Serialize for UpdateAgentRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.