AI A2AClient

AI A2AClient

Certified

Proxy prompts to a remote A2A agent

Sends the prompt to a remote AI Agent over the A2A protocol and returns its text response. Requires serverUrl; ensure the endpoint is trusted and reachable.

yaml
type: io.kestra.plugin.ai.agent.A2AClient

Call a remote AI agent via the A2A protocol.

yaml
id: a2a_agent
namespace: company.ai

inputs:
  - id: prompt
    type: STRING

tasks:
  - id: agent
    type: io.kestra.plugin.ai.agent.A2AClient
    serverUrl: "http://localhost:10000"
    prompt: "Summarize the following content: {{ inputs.prompt }}"
Properties

Text prompt

Message sent to the remote A2A agent. No default: this property is required.

Server URL

Base URL of the remote agent's A2A server. No default: this property is required.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

Remote agent output

Text the remote A2A agent returned in response to the prompt.