Struct AgentConfig 

pub struct AgentConfig {
    pub agent: AgentMetadata,
    pub handler: HandlerConfig,
    pub runtime: RuntimeConfig,
    pub server: ServerConfig,
    pub skills: Vec<SkillConfig>,
    pub features: FeaturesConfig,
    pub llm: Option<LlmConfig>,
}

Complete agent configuration from TOML

Fields

agent: AgentMetadata

Agent metadata

handler: HandlerConfig

Typed handler selection ([handler]). When omitted, the legacy agent.implementation string is honoured via [handler_type].

runtime: RuntimeConfig

How the platform packages this agent ([runtime]) — a custom image, or nothing, meaning the platform’s base image runs it.

server: ServerConfig

Server configuration

skills: Vec<SkillConfig>

Skills exposed by the agent

features: FeaturesConfig

Features enabled for the agent

llm: Option<LlmConfig>

LLM Configuration

Implementations

impl AgentConfig

pub fn from_file<P: AsRef<Path>>(path: P) -> Result<Self, ConfigError>

Load configuration from a TOML file

pub fn from_toml(content: &str) -> Result<Self, ConfigError>

Parse configuration from TOML string

pub fn check_toml(content: &str) -> Result<(Self, Vec<String>), ConfigError>

Parse for validation, tolerating unset ${VAR} references.

Returns the config alongside the names of variables that had no value and no :-default — they were substituted with a placeholder so the rest of the config could still be checked. Everything else (unknown keys, wrong types, failed validate) errors exactly as in from_toml.

This is what a2a validate uses: a config’s shape should be checkable without the production secrets it will eventually run with.

pub fn check_file<P: AsRef<Path>>( path: P, ) -> Result<(Self, Vec<String>), ConfigError>

check_toml for a file on disk.

pub fn handler_type(&self) -> HandlerType

Resolve the handler selector, preferring [handler].type and falling back to the legacy agent.implementation (so existing configs keep working) and finally HandlerType::Echo.

pub fn image(&self) -> Option<&str>

The image this agent runs from, if it brings its own.

None means the runtime’s base image (or, under a2a run, this binary’s built-in handlers).

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

Validate the configuration

pub fn agent_url(&self) -> String

Build agent card URL from server config

Trait Implementations

impl Clone for AgentConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for AgentConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for AgentConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.