# a2a_message

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [cloud-data-platform-full.txt](https://docs.redpanda.com/cloud-data-platform-full.txt)

---
title: a2a_message
latest-operator-version: v26.1.4
latest-console-tag: v3.7.3
latest-connect-version: 4.93.0
latest-redpanda-tag: v26.1.9
docname: connect/components/processors/a2a_message
page-component-name: cloud-data-platform
page-version: master
page-component-version: master
page-component-title: Cloud
page-relative-src-path: connect/components/processors/a2a_message.adoc
page-edit-url: https://github.com/redpanda-data/cloud-docs/edit/main/modules/develop/pages/connect/components/processors/a2a_message.adoc
description: Sends messages to an A2A (Agent-to-Agent) protocol agent and returns the response.
page-git-created-date: "2026-02-18"
page-git-modified-date: "2026-05-26"
---

<!-- Source: https://docs.redpanda.com/cloud-data-platform/develop/connect/components/processors/a2a_message.md -->

**Available in:** Cloud

Sends messages to an A2A (Agent-to-Agent) protocol agent and returns the response.

This processor enables Redpanda Connect pipelines to communicate with A2A protocol agents. Currently only JSON-RPC transport is supported.

The processor sends a message to the agent and polls for task completion. The agent’s response is returned as the processor output.

For more information about the A2A protocol, see [https://a2a-protocol.org/latest/specification](https://a2a-protocol.org/latest/specification)

#### Common

```yml
processors:
  label: ""
  a2a_message:
    agent_card_url: "" # No default (required)
    prompt: "" # No default (optional)
```

#### Advanced

```yml
processors:
  label: ""
  a2a_message:
    agent_card_url: "" # No default (required)
    prompt: "" # No default (optional)
    final_message_only: true
```

## [](#fields)Fields

### [](#agent_card_url)`agent_card_url`

URL for the A2A agent card. Can be either a base URL (e.g., `[https://example.com](https://example.com)`) or a full path to the agent card (e.g., `[https://example.com/.well-known/agent.json](https://example.com/.well-known/agent.json)`). If no path is provided, defaults to `/.well-known/agent.json`. Authentication uses OAuth2 from environment variables.

**Type**: `string`

### [](#final_message_only)`final_message_only`

If true, returns only the text from the final agent message (concatenated from all text parts). If false, returns the complete Message or Task object as structured data with full history, artifacts, and metadata.

Example with final\_message\_only: true (default):

```none
Here is the answer to your question...
```

Example with final\_message\_only: false:

```json
{
  "id": "task-123",
  "contextId": "ctx-456",
  "status": {
    "state": "completed"
  },
  "history": [
    {"role": "user", "parts": [{"text": "Your question"}]},
    {"role": "agent", "parts": [{"text": "Here is the answer to your question..."}]}
  ],
  "artifacts": []
}
```

**Type**: `bool`

**Default**: `true`

### [](#prompt)`prompt`

The user prompt to send to the agent. By default, the processor submits the entire payload as a string.

This field supports [interpolation functions](https://docs.redpanda.com/cloud-data-platform/develop/connect/configuration/interpolation/#bloblang-queries).

**Type**: `string`