Struct AgentCard 

pub struct AgentCard {
    pub name: String,
    pub description: String,
    pub url: String,
    pub version: String,
    pub protocol_version: String,
    pub provider: Option<AgentProvider>,
    pub capabilities: AgentCapabilities,
    pub default_input_modes: Vec<String>,
    pub default_output_modes: Vec<String>,
    pub skills: Vec<AgentSkill>,
}

Capability advertisement document served at /.well-known/agent.json.

AgentCard describes an agent’s identity, endpoint, skills, and protocol capabilities. It is the primary discovery mechanism — callers fetch the card before sending messages.

Prefer constructing cards via AgentCardBuilder to get correct defaults (including the current A2A_PROTOCOL_VERSION).

Examples

use zeph_a2a::AgentCardBuilder;

let card = AgentCardBuilder::new("my-agent", "http://localhost:8080", "0.1.0")
    .description("An AI assistant")
    .streaming(true)
    .build();

assert_eq!(card.name, "my-agent");
assert!(card.capabilities.streaming);

Fields

name: String

Human-readable agent name.

description: String

Short description of the agent’s purpose.

url: String

Base URL of the A2A endpoint (without path suffix).

version: String

Agent software version string (semver recommended).

protocol_version: String

A2A protocol version the agent implements (see A2A_PROTOCOL_VERSION).

provider: Option<AgentProvider>

Optional organization that built or operates the agent.

capabilities: AgentCapabilities

Flags indicating which A2A capabilities the agent supports.

default_input_modes: Vec<String>

MIME types or mode identifiers the agent accepts as input (e.g., "text/plain").

default_output_modes: Vec<String>

MIME types or mode identifiers the agent can produce as output.

skills: Vec<AgentSkill>

Discrete skills the agent exposes, each with its own examples and mode overrides.

Trait Implementations

impl Clone for AgentCard

fn clone(&self) -> AgentCard

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentCard

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentCard

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentCard

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

where __S: Serializer,

Serialize this value into the given Serde serializer.