# Choose an Integration Pattern

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

---
title: Choose an Integration Pattern
latest-operator-version: v26.2.1
latest-console-tag: v3.10.0
latest-connect-version: 4.104.0
latest-redpanda-tag: v26.2.1
docname: integration-overview
page-component-name: agentic-data-plane
page-version: master
page-component-version: master
page-component-title: Agentic Data Plane
page-relative-src-path: integration-overview.adoc
page-edit-url: https://github.com/redpanda-data/adp-docs/edit/main/modules/connect/pages/integration-overview.adoc
description: Choose the right integration pattern for connecting agents, pipelines, and external applications.
page-topic-type: best-practices
personas: agent_builder, platform_engineer
learning-objective-1: Choose the integration pattern that fits your use case
learning-objective-2: Apply appropriate authentication for internal versus external integration
learning-objective-3: Select the right communication protocol for your integration scenario
page-git-created-date: "2026-05-28"
page-git-modified-date: "2026-08-06"
---

<!-- Source: https://docs.redpanda.com/agentic-data-plane/connect/integration-overview.md -->

Choose the right integration pattern for how your agents, pipelines, and external applications communicate. The pattern you pick determines who initiates the call, how data flows, and whether the interaction is synchronous or event-driven.

After reading this page, you will be able to:

-   Choose the integration pattern that fits your use case

-   Apply appropriate authentication for internal versus external integration

-   Select the right communication protocol for your integration scenario


## [](#integration-scenarios)Integration scenarios

Agentic Data Plane supports three primary integration scenarios based on who initiates the call and where the caller is located:

| Scenario | Description | When to Use | Guide |
| --- | --- | --- | --- |
| Agent needs capabilities | Your agent invokes MCP tools to fetch data, call APIs, or access external systems on-demand | Agent-initiated, synchronous, interactive workflows | How MCP Servers Work |
| Pipeline processes events | Your Redpanda Connect pipeline invokes agents for each event in a stream using the a2a_message processor | Event-driven, automated, high-volume stream processing | Integrate with Redpanda Pipelines |
| External system calls agent | Your application or agent (hosted outside Agentic Data Plane) calls Agentic Data Plane agents using the A2A protocol | Backend services, CLI tools, custom UIs, multi-platform agent workflows | Connect Agents with A2A |

## [](#common-use-cases-by-pattern)Common use cases by pattern

Each integration pattern serves different scenarios based on how data flows and who initiates the interaction.

### [](#agent-needs-capabilities)Agent needs capabilities (MCP tools)

Use MCP tools when your agent needs on-demand access to data or capabilities.

The agent decides when to invoke tools as part of its reasoning process. It waits for responses before continuing.

This pattern works well for interactive workflows: customer support lookups, approval flows, or context-aware chatbots.

Avoid MCP tools for high-volume stream processing or automated workflows without user interaction. Use pipeline-initiated integration instead.

For implementation details, see [How MCP Servers Work](https://docs.redpanda.com/agentic-data-plane/connect/mcp-overview/).

### [](#pipeline-processes-events)Pipeline processes events (`a2a_message`)

Use the `a2a_message` processor when your pipeline needs to invoke agents for every event in a stream.

The pipeline controls when agents execute. This pattern is ideal for automated, high-volume processing where each event requires AI reasoning.

Common scenarios include real-time fraud detection, sentiment scoring for customer reviews, and content moderation that classifies and routes content.

For implementation details, see [Integrate with Redpanda Pipelines](https://docs.redpanda.com/agentic-data-plane/connect/pipeline-integration-patterns/).

### [](#external-system-calls-agent)External system calls agent

Use external integration when your applications, services, or agents hosted outside Agentic Data Plane need to call Agentic Data Plane agents.

External systems send requests using the A2A protocol and receive responses synchronously. This works for backend services, CLI tools, custom UIs, and agents hosted on other platforms.

Common scenarios include backend services analyzing data as part of workflows, CLI tools invoking agents for batch tasks, custom UIs displaying agent responses, CRM agents coordinating with Redpanda agents, and multi-platform workflows spanning different infrastructure.

To learn how the A2A protocol enables this integration, see [Connect Agents with A2A](https://docs.redpanda.com/agentic-data-plane/connect/a2a-concepts/).

## [](#pattern-comparison)Pattern comparison

The following table compares the two primary internal integration patterns:

| Criterion | Agents Invoking MCP Tools | Pipelines Calling Agents |
| --- | --- | --- |
| Trigger | User question or agent decision | Event arrival in topic |
| Frequency | Ad-hoc, irregular, as needed | Continuous, every event |
| Latency | Low (agent waits for response) | Higher (async acceptable) |
| Control Flow | Agent decides when to invoke | Pipeline decides when to invoke |
| Use Case | "Fetch me data", "Run this query" | "Process this stream", "Enrich all events" |
| Human in Loop | Often yes (user-driven) | Often no (automated) |

## [](#security-considerations-for-external-integration)Security considerations for external integration

When integrating external applications with Agentic Data Plane agents, protect credentials and tokens.

### [](#protect-service-account-credentials)Protect service account credentials

Store the client ID and secret in secure credential stores, not in code. Use environment variables or your organization’s secrets manager. Rotate credentials if compromised and restrict access based on the principle of least privilege.

### [](#protect-access-tokens)Protect access tokens

Access tokens grant full access to the agent. Anyone with a valid token can send requests, receive responses, and consume agent resources (subject to rate limits). Treat access tokens like passwords and never log them or include them in error messages.

## [](#next-steps)Next steps

-   [Connect Agents with A2A](https://docs.redpanda.com/agentic-data-plane/connect/a2a-concepts/)

-   [How MCP Servers Work](https://docs.redpanda.com/agentic-data-plane/connect/mcp-overview/)

-   [Integrate with Redpanda Pipelines](https://docs.redpanda.com/agentic-data-plane/connect/pipeline-integration-patterns/)