Building a Multi-Connector Agent

Use this when an agent needs two or more Airbyte connectors.

Going from Single to Multi

The bootstrapping-agent skill shows the single-connector pattern: direct class construction with AirbyteAuthConfig + @Connector.tool_utils decorator. Multi-connector agents use the same pattern, just repeated:

1. Build a single AirbyteAuthConfig(...) so credentials are shared across connectors.
2. Construct one typed connector per service (e.g. JiraConnector(auth_config=auth)).
3. Define one tool function per connector, each with its own @Connector.tool_utils decorator.

There are no new APIs — same install, same constructor, same classmethod decorator.

Install the SDK

bash
1uv pip install airbyte-agent-sdk

The single airbyte-agent-sdk package bundles every typed connector, so tool_utils, list_entities(), and entity_schema() are available on each one without per-connector installs.

Core Pattern (PydanticAI)

python
1import os
2from pydantic_ai import Agent
3from airbyte_agent_sdk import AirbyteAuthConfig
4from airbyte_agent_sdk.connectors.jira import JiraConnector
5from airbyte_agent_sdk.connectors.slack import SlackConnector
6
7# Shared credentials — all connectors reuse the same AirbyteAuthConfig
8auth = AirbyteAuthConfig(
9    airbyte_client_id=os.getenv("AIRBYTE_CLIENT_ID"),
10    airbyte_client_secret=os.getenv("AIRBYTE_CLIENT_SECRET"),
11    workspace_name=os.getenv("AIRBYTE_WORKSPACE_NAME", "default"),
12)
13
14jira = JiraConnector(auth_config=auth)
15slack = SlackConnector(auth_config=auth)

If the workspace contains multiple connectors of the same type, pin one by passing connector_id=os.getenv("JIRA_CONNECTOR_ID") to the constructor.

One Tool Per Connector

Each connector gets its own tool function — don't combine them into a mega-tool. Separate tools give the LLM clear, independent tool descriptions.

tool_utils is a @classmethod — decorate with @JiraConnector.tool_utils, not @jira.tool_utils.

python
1agent = Agent(
2    "openai:gpt-4o",
3    system_prompt="You monitor Jira issues and post summaries to Slack.",
4)
5
6@agent.tool_plain
7@JiraConnector.tool_utils
8async def jira_execute(entity: str, action: str, params: dict | None = None):
9    return await jira.execute(entity, action, params or {})
10
11@agent.tool_plain
12@SlackConnector.tool_utils
13async def slack_execute(entity: str, action: str, params: dict | None = None):
14    return await slack.execute(entity, action, params or {})

System Prompt

Describe the agent's purpose and what each connector does:

python
1agent = Agent(
2    "openai:gpt-4o",
3    system_prompt=(
4        "You are a customer support assistant. "
5        "Use the stripe tool to look up customer billing data. "
6        "Use the jira tool to create and track support tickets. "
7        "Use the slack tool to notify the support team."
8    ),
9)

Run Loop

PydanticAI

python
1import asyncio
2
3async def main():
4    result = await agent.run("Find open P0 bugs and post a summary to #engineering")
5    print(result.output)
6    await jira.close()
7    await slack.close()
8
9asyncio.run(main())

Claude SDK (Anthropic Python)

See Claude SDK patterns for the full message loop with tool handling.

Project Structure

For a new agent project:

my-agent/
├── pyproject.toml       # dependencies: airbyte-agent-sdk, pydantic-ai or anthropic
├── .env                 # AIRBYTE_CLIENT_ID, AIRBYTE_CLIENT_SECRET, AIRBYTE_WORKSPACE_NAME
├── agent.py             # Entry point: auth config, connectors, agent + tools, run loop
└── README.md

pyproject.toml

toml
1[project]
2name = "my-agent"
3requires-python = ">=3.11"
4dependencies = [
5    "airbyte-agent-sdk",
6    "pydantic-ai",
7    "python-dotenv",
8]

Environment Variables

AIRBYTE_CLIENT_ID=your_client_id
AIRBYTE_CLIENT_SECRET=your_client_secret
AIRBYTE_WORKSPACE_NAME=your_workspace_name

References

• SDK API reference — AirbyteAuthConfig, typed connector constructors, tool_utils
• PydanticAI patterns — multi-connector example
• Claude SDK patterns — multi-connector example
• Connector discovery — finding available connectors