Struct AgentInterface 

pub struct AgentInterface {
    pub url: String,
    pub protocol_binding: String,
    pub protocol_version: String,
    pub tenant: Option<String>,
}

A transport interface offered by an agent.

Fields

url: String

Base URL of this interface endpoint.

protocol_binding: String

Protocol binding identifier — the spec’s canonical values are "JSONRPC", "GRPC", and "HTTP+JSON" (§5.3); custom bindings such as "WEBSOCKET" are permitted (§12).

protocol_version: String

A2A protocol version string in Major.Minor form (e.g. "1.0").

Spec §3.6: patch version numbers SHOULD NOT be used in Agent Cards.

tenant: Option<String>

Optional tenant identifier for multi-tenancy.

Implementations

impl AgentInterface

pub fn new( url: impl Into<String>, protocol_binding: impl Into<String>, ) -> AgentInterface

A new interface at url speaking protocol_binding, at this crate’s A2A_VERSION.

The spec’s canonical bindings are "JSONRPC", "GRPC" and "HTTP+JSON" (§5.3); "WEBSOCKET" and other custom values are permitted (§12). Prefer Self::jsonrpc, Self::grpc or Self::rest over spelling one out.

use a2a_protocol_types::agent_card::AgentInterface;

let iface = AgentInterface::new("https://agent.example.com/rpc", "JSONRPC");
assert_eq!(iface.protocol_version, a2a_protocol_types::A2A_VERSION);
assert!(iface.tenant.is_none());

pub fn jsonrpc(url: impl Into<String>) -> AgentInterface

A JSONRPC interface at url (spec §9).

use a2a_protocol_types::agent_card::AgentInterface;

assert_eq!(
    AgentInterface::jsonrpc("https://agent.example.com/rpc").protocol_binding,
    "JSONRPC",
);

pub fn grpc(url: impl Into<String>) -> AgentInterface

A GRPC interface at url (spec §10).

use a2a_protocol_types::agent_card::AgentInterface;

assert_eq!(
    AgentInterface::grpc("https://agent.example.com").protocol_binding,
    "GRPC",
);

pub fn rest(url: impl Into<String>) -> AgentInterface

An HTTP+JSON (REST) interface at url (spec §11).

Named for the binding a caller selects, not for the spec’s spelling of it: HTTP+JSON is easy to mistype and a typo here is a card that advertises a binding nothing implements.

use a2a_protocol_types::agent_card::AgentInterface;

assert_eq!(
    AgentInterface::rest("https://agent.example.com").protocol_binding,
    "HTTP+JSON",
);

pub fn with_tenant(self, tenant: impl Into<String>) -> AgentInterface

Scopes this interface to a tenant.

use a2a_protocol_types::agent_card::AgentInterface;

let iface = AgentInterface::jsonrpc("https://a.example.com/rpc").with_tenant("acme");
assert_eq!(iface.tenant.as_deref(), Some("acme"));

Trait Implementations

impl Clone for AgentInterface

fn clone(&self) -> AgentInterface

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentInterface

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentInterface

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<AgentInterface> for AgentInterface

fn from(value: AgentInterface) -> AgentInterface

Converts to this type from the input type.

impl Serialize for AgentInterface

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.

impl TryFrom<AgentInterface> for AgentInterface

type Error = ConvertError

The type returned in the event of a conversion error.

fn try_from( value: AgentInterface, ) -> Result<AgentInterface, <AgentInterface as TryFrom<AgentInterface>>::Error>

Performs the conversion.