--- schema_version: "1" id: ddfd30740ded7f43048cba021190b49ffc6322afc8160cf88391e23afdbfbaf4 title: A2A Connector 0.1.0-BETA Reference collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/a2a-connector/0.1/a2a-connector-reference.md canonical_url: https://docs.mulesoft.com/a2a-connector/0.1/a2a-connector-reference source_site: docs.mulesoft.com content_type: documentation content_hash: fb965c80cb5257c8691d45be8ac9b64383efd311871fa3f0f6557d45d35321a7 description: MuleSoft Documentation Site release: "0.1" latest: false --- --- product: A2A Connector version: 0.1 --- # A2A Connector 0.1.0-BETA Reference > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Anypoint Connector for Agent2Agent (A2A) (A2A Connector) provides A2A protocol support for LLM agents, enabling your agents to talk to other agents. > [!NOTE] Anypoint Connector for Agent2Agent (A2A) is a beta connector that is subject to the Beta > Services Terms at [Agreements - Salesforce.com](https://www.salesforce.com/company/legal/) or a > written Unified Pilot Agreement if executed by Customer, and the Non-GA Gen AI and Non-GA Credit > Consumption terms in the > [Product Terms Directory](https://ptd.salesforce.com/?_ga=2.247987783.1372150065.1709219475-629000709.1639001992). > Use of this beta connector with external systems or services consumes > [Mule messages](https://docs.mulesoft.com/general/usage-metrics) and is at the Customer’s sole discretion. ## Configurations ### Client The application or AI system that initiates requests and consumes services offered by A2A servers. This allows Mule apps to act as A2A brokers between non A2A “head” agents and A2A “node” agents. #### Parameters

Name	Type	Description	Required
Name	String	Name for this configuration. Connectors reference the configuration with this name.	x
Connection	Client Connection	The connection types to provide to this configuration.	x
Name	String	ID used to reference this configuration.	x
Expiration Policy	Expiration Policy	Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.

#### Connection Types ##### Client Connection ###### Parameters

Name	Type	Description	Default Value	Required
Server Url	String	Base URL of the target A2A server.		x
Request Timeout	Number	Sets the duration to wait for server responses before timing out requests.	30
Request Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit for the Request Timeout field.	SECONDS
Authentication	HttpRequestAuthentication
Tls Context	TLS
Reconnection	Reconnection	When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

--- ### Server The A2A server acts as a remote agent that exposes an HTTP(S) endpoint and implements the A2A protocol methods for interacting with other AI agents. This allows Mule-based agents to receive and respond to A2A protocol-compliant requests. #### Parameters

Name	Type	Description	Default Value	Required
Name	String	Name for this configuration. Connectors reference the configuration with this name.		x
Connection	Connection	The connection types to provide to this configuration.		x
Card	Agent Card			x
Name	String	ID used to reference this configuration.		x
Task History Enabled	Boolean	Set to `true` to enable retrieval of task history. Task history is stored as message objects.	false
Default Max History Length	Number	Maximum number of task history objects to store.
Task History Object Store	ObjectStore

#### Connection Types ##### Server Connection ###### Parameters

Name	Type	Description	Required
Listener Config	String	Reference to the `<http:listener-config>` used to expose the inbound endpoint.	x
Agent Path	String	URL where the Agent Card is located.	x
Reconnection	Reconnection	When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

#### Associated Sources - [Task Listener](#TaskListener) ## Supported Operations - [Cancel Task](#CancelTask) - [Get Task](#GetTask) - [Send Task](#SendTask) ## Cancel Task `` Cancels the task specified by its unique identifier. It’s used to stop a previously initiated task. ### Parameters

Name	Type	Description	Default Value	Required
Configuration	String	Name of the configuration to use.		x
Task Id	Any	Unique identifier for the task.	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.		x
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.	#[payload]
Error Mappings	Array of Error Mapping	Set of error mappings.
Reconnection Strategy	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.

### Output

Type	Any
Attributes Type	Response Attributes

### For Configurations - [Client](#Client) ### Throws - A2A:CONNECTIVITY - A2A:INTERNAL\_ERROR - A2A:INVALID\_PARAMS - A2A:INVALID\_REQUEST - A2A:JSON\_RPC\_ERROR - A2A:METHOD\_NOT\_FOUND - A2A:PARSE\_ERROR - A2A:REQUEST\_TIMEOUT - A2A:RETRY\_EXHAUSTED - A2A:SERVER\_ERROR - A2A:UNAUTHORIZED ## Get Task `` Retrieves information about a task based on a provided query. This enables you to fetch the status or details of a task from another agent. ### Parameters

Name	Type	Description	Default Value	Required
Configuration	String	Name of the configuration to use.		x
Task Query	Any		#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.		x
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.	#[payload]
Error Mappings	Array of Error Mapping	Set of error mappings.
Reconnection Strategy	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.

### Output

Type	Any
Attributes Type	Response Attributes

### For Configurations - [Client](#Client) ### Throws - A2A:CONNECTIVITY - A2A:INTERNAL\_ERROR - A2A:INVALID\_PARAMS - A2A:INVALID\_REQUEST - A2A:JSON\_RPC\_ERROR - A2A:METHOD\_NOT\_FOUND - A2A:PARSE\_ERROR - A2A:REQUEST\_TIMEOUT - A2A:RETRY\_EXHAUSTED - A2A:SERVER\_ERROR - A2A:UNAUTHORIZED ## Send Task `` Sends a task to another agent. It initiates a new task request to a remote A2A server. ### Parameters

Name	Type	Description	Default Value	Required
Configuration	String	Name of the configuration to use.		x
Task	Any		#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.		x
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.	#[payload]
Error Mappings	Array of Error Mapping	Set of error mappings.
Reconnection Strategy	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.

### Output

Type	Any
Attributes Type	Response Attributes

### For Configurations - [Client](#Client) ### Throws - A2A:CONNECTIVITY - A2A:INTERNAL\_ERROR - A2A:INVALID\_PARAMS - A2A:INVALID\_REQUEST - A2A:JSON\_RPC\_ERROR - A2A:METHOD\_NOT\_FOUND - A2A:PARSE\_ERROR - A2A:REQUEST\_TIMEOUT - A2A:RETRY\_EXHAUSTED - A2A:SERVER\_ERROR - A2A:UNAUTHORIZED ## Sources ## Task Listener `` Allows a Mule application to listen for and receive incoming A2A protocol-compliant requests from other AI agents, enabling the Mule-based agent to act as an A2A server and respond to tasks. ### Parameters

Name	Type	Description	Default Value	Required
Configuration	String	Name of the configuration to use.		x
Primary Node Only	Boolean	Determines whether to execute this source on only the primary node when running Mule instances in a cluster.
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.		x
Redelivery Policy	Redelivery Policy	Defines a policy for processing the redelivery of the same message.
Reconnection Strategy	Reconnect Reconnect Forever	Retry strategy in case of connectivity errors.
Response	Any		#[payload]
Response Headers	Object	HTTP response header.
Error Status Code	Number	HTTP status code of the response.	500

### Output

Type	Any
Attributes Type	Request Attributes

### For Configurations - [Server](#Server) ## Types ### TLS Configures TLS to provide secure communications for the Mule app.

Field	Type	Description
Enabled Protocols	String	Comma-separated list of protocols enabled for this context.
Enabled Cipher Suites	String	Comma-separated list of cipher suites enabled for this context.
Trust Store	Truststore	Configures the TLS truststore.
Key Store	Keystore	Configures the TLS keystore.
Revocation Check	Standard Revocation Check Custom OCSP Responder CRL File	Configures a revocation checking mechanism.

### Truststore Configures the truststore for TLS.

Field	Type	Description
Path	String	Path to the truststore. Mule resolves the path relative to the current classpath and file system.
Password	String	Password used to protect the truststore.
Type	String	Type of store.
Algorithm	String	Encryption algorithm that the truststore uses.
Insecure	Boolean	If `true`, Mule stops performing certificate validations. Setting this to `true` can make connections vulnerable to attacks.

### Keystore Configures the keystore for the TLS protocol. The keystore you generate contains a private key and a public certificate.

Field	Type	Description
Path	String	Path to the keystore. Mule resolves the path relative to the current classpath and file system.
Type	String	Type of store.
Alias	String	Alias of the key to use when the keystore contains multiple private keys. By default, Mule uses the first key in the file.
Key Password	String	Password used to protect the private key.
Password	String	Password used to protect the keystore.
Algorithm	String	Encryption algorithm that the keystore uses.

### Standard Revocation Check Configures standard revocation checks for TLS certificates.

Field	Type	Description
Only End Entities	Boolean	Which elements to verify in the certificate chain: `true` Verify only the last element in the certificate chain. `false` Verify all elements in the certificate chain.
Prefer Crls	Boolean	How to check certificate validity: `true` Check the Certification Revocation List (CRL) for certificate validity. `false` Use the Online Certificate Status Protocol (OCSP) to check certificate validity.
No Fallback	Boolean	Whether to use the secondary method to check certificate validity: `true` Use the method that wasn’t specified in the Prefer Crls field (the secondary method) to check certificate validity. `false` Don’t use the secondary method to check certificate validity.
Soft Fail	Boolean	What to do if the revocation server can’t be reached or is busy: `true` Avoid verification failure. `false` Allow the verification to fail.

### Custom OCSP Responder Configures a custom OCSP responder for certification revocation checks.

Field	Type	Description	Default Value	Required
Url	String	URL of the OCSP responder.
Cert Alias	String	Alias of the signing certificate for the OCSP response. If specified, the alias must be in the truststore.

### CRL File Specifies the location of the certification revocation list (CRL) file.

Field	Type	Description	Default Value	Required
Path	String	Path to the CRL file.

### Reconnection Configures a reconnection strategy for an operation.

Field	Type	Description	Default Value	Required
Fails Deployment	Boolean	When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.
Reconnection Strategy	Reconnect Reconnect Forever	Reconnection strategy to use.

### Reconnect Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector source or operation can make.

Field	Type	Description	Default Value
Frequency	Number	How often to attempt to reconnect, in milliseconds.
Blocking	Boolean	If `false`, the reconnection strategy runs in a separate, non-blocking thread.	true
Count	Number	How many reconnection attempts the Mule app can make.

### Reconnect Forever Configures a forever reconnection strategy by which the connector source or operation attempts to reconnect at a specified frequency for as long as the Mule app runs.

Field	Type	Description	Default Value	Required
Frequency	Number	How often to attempt to reconnect, in milliseconds.
Blocking	Boolean	If `false`, the reconnection strategy runs in a separate, non-blocking thread.	true

### Expiration Policy Configures an expiration policy strategy.

Field	Type	Description	Default Value	Required
Max Idle Time	Number	Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.
Time Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit for the Max Idle Time field.

### Response Attributes

Field	Type	Description	Required
Status Code	Number	HTTP status code of the response.	x
Headers	Object	Map of HTTP headers in the message.	x
Reason Phrase	String	HTTP reason phrase of the response.

### Error Mapping

Field	Type	Description	Default Value	Required
Source	Enumeration, one of: ANY REDELIVERY_EXHAUSTED TRANSFORMATION EXPRESSION SECURITY CLIENT_SECURITY SERVER_SECURITY ROUTING CONNECTIVITY RETRY_EXHAUSTED TIMEOUT
Target	String			x

### Agent Card

Field	Type	Description	Required
Name	String	Name for the agent.	x
Url	String	Base URL endpoint for the agent’s A2A service. Must be an absolute HTTPS URL for production.	x
Version	String	Version for the agent.	x
Description	String	Description for the agent.
Skills	Array of Agent Skill		x
Capabilities	Agent Capabilities
Provider	Agent Provider
Documentation Url	String	URL of the agent’s documentation.
Agent Authentication	Agent Authentication
Default Input Modes	Array of String	Array of MIME types the agent accepts as input across all skills.
Default Output Modes	Array of String	Array of MIME types the agent produces as output across all skills.

### Agent Skill

Field	Type	Description	Required
Id	String	Unique identifier for this skill within the context of this agent.	x
Name	String	Name of the skill.	x
Description	String	Description of what the skill does.
Tags	Array of String	Keywords or categories for discoverability of the agent.
Examples	Array of String	Example prompts, inputs, or use cases. Examples help clients and agents formulate requests for this skill.
Input Modes	Array of String	Overrides Agent Card Default Input Modes for this specific skill.
Output Modes	Array of String	Overrides Agent Card Default Output Modes for this specific skill.

### Agent Capabilities

Field	Type	Description	Default Value
Streaming	Boolean	Set to `true` to support SSE streaming methods.	false
Push Notifications	Boolean	Set to `true` to support push notification methods.	false
State Transition History	Boolean		false

### Agent Provider

Field	Type	Description	Default Value	Required
Organization	String	Name of the organization or entity.		x
Url	String	URL of the provider’s website.

### Agent Authentication

Field	Type	Description	Default Value	Required
Authentication	Array of String			x
Credentials	String

### Request Attributes

Field	Type	Description	Default Value	Required
Query Params	Object			x
Headers	Object	Map of HTTP headers in the message.		x

### Redelivery Policy Configures the redelivery policy for executing requests that generate errors. You can add a redelivery policy to any source in a flow.

Field	Type	Description
Max Redelivery Count	Number	Maximum number of times to process a redelivered request unsuccessfully before returning a REDELIVERY_EXHAUSTED error.
Message Digest Algorithm	String	Secure hashing algorithm to use if the Use Secure Hash field is `true`. If the payload of the message is a Java object, Mule ignores this value and returns the value that the payload’s `hashCode()` returned.
Message Identifier	Redelivery Policy Message Identifier	One or more expressions that determine if a message was redelivered. This property can be set only if the Use Secure Hash field is `false`.
Object Store	ObjectStore	Configures the object store that stores the redelivery counter for each message.

### Redelivery Policy Message Identifier Configures how to identify a redelivered message and how to find out when the message was redelivered.

Field	Type	Description	Default Value	Required
Use Secure Hash	Boolean	If `true`, Mule uses a secure hash algorithm to identify a redelivered message.
Id Expression	String	One or more expressions that determine when a message was redelivered. You can set this property only if the Use Secure Hash field is `false`.

## See Also - [Using Anypoint Code Builder to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-acb) - [Using Studio to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio) - [A2A Connector Overview](https://docs.mulesoft.com/a2a-connector/0.1/) - [Salesforce Help](https://help.salesforce.com)