Struct AgentSkill 

pub struct AgentSkill {
    pub id: String,
    pub name: String,
    pub description: String,
    pub tags: Vec<String>,
    pub examples: Option<Vec<String>>,
    pub input_modes: Option<Vec<String>>,
    pub output_modes: Option<Vec<String>>,
    pub security_requirements: Option<Vec<SecurityRequirement>>,
}

A discrete capability offered by an agent.

Fields

id: String

Unique skill identifier within the agent.

name: String

Human-readable skill name.

description: String

Human-readable description of what the skill does.

tags: Vec<String>

Searchable tags for the skill.

ProtoJSON printers omit empty repeated fields — a skill published by an official SDK with no tags arrives without the key. Absence means empty; failing the whole card parse over it is not interoperable.

examples: Option<Vec<String>>

Example prompts illustrating how to invoke the skill.

input_modes: Option<Vec<String>>

MIME types accepted as input by this skill.

output_modes: Option<Vec<String>>

MIME types produced as output by this skill.

security_requirements: Option<Vec<SecurityRequirement>>

Security requirements specific to this skill.

Implementations

impl AgentSkill

pub fn new( id: impl Into<String>, name: impl Into<String>, description: impl Into<String>, ) -> AgentSkill

A new skill with no tags, examples, modes or security requirements.

use a2a_protocol_types::agent_card::AgentSkill;

let skill = AgentSkill::new("echo", "Echo", "Repeats the caller's text");
assert!(skill.tags.is_empty());
assert!(skill.examples.is_none());

pub fn with_tags<I, S>(self, tags: I) -> AgentSkill

where I: IntoIterator<Item = S>, S: Into<String>,

Replaces the skill’s searchable tags.

use a2a_protocol_types::agent_card::AgentSkill;

let skill = AgentSkill::new("analyze", "Analysis", "Counts things")
    .with_tags(["code", "metrics"]);
assert_eq!(skill.tags, ["code", "metrics"]);

pub fn with_examples<I, S>(self, examples: I) -> AgentSkill

where I: IntoIterator<Item = S>, S: Into<String>,

Replaces the skill’s example prompts.

use a2a_protocol_types::agent_card::AgentSkill;

let skill = AgentSkill::new("echo", "Echo", "Repeats").with_examples(["say hello"]);
assert_eq!(skill.examples.as_deref(), Some(&["say hello".to_owned()][..]));

pub fn with_input_modes<I, S>(self, modes: I) -> AgentSkill

where I: IntoIterator<Item = S>, S: Into<String>,

Replaces the MIME types this skill accepts.

use a2a_protocol_types::agent_card::AgentSkill;

let skill = AgentSkill::new("ocr", "OCR", "Reads text").with_input_modes(["image/png"]);
assert_eq!(skill.input_modes.as_deref(), Some(&["image/png".to_owned()][..]));

pub fn with_output_modes<I, S>(self, modes: I) -> AgentSkill

where I: IntoIterator<Item = S>, S: Into<String>,

Replaces the MIME types this skill produces.

use a2a_protocol_types::agent_card::AgentSkill;

let skill = AgentSkill::new("ocr", "OCR", "Reads text").with_output_modes(["text/plain"]);
assert_eq!(skill.output_modes.as_deref(), Some(&["text/plain".to_owned()][..]));

pub fn with_security_requirements( self, reqs: Vec<SecurityRequirement>, ) -> AgentSkill

Replaces the security requirements that apply to this skill alone.

Trait Implementations

impl Clone for AgentSkill

fn clone(&self) -> AgentSkill

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentSkill

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentSkill

fn deserialize<__D>( __deserializer: __D, ) -> Result<AgentSkill, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<AgentSkill> for AgentSkill

fn from(value: AgentSkill) -> AgentSkill

Converts to this type from the input type.

impl From<AgentSkill> for AgentSkill

fn from(value: AgentSkill) -> AgentSkill

Converts to this type from the input type.

impl Serialize for AgentSkill

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

where __S: Serializer,

Serialize this value into the given Serde serializer.