building-multi-connector-agent
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:
- Build a single
AirbyteAuthConfig(...)so credentials are shared across connectors. - Construct one typed connector per service (e.g.
JiraConnector(auth_config=auth)). - Define one tool function per connector, each with its own
@Connector.tool_utilsdecorator.
There are no new APIs — same install, same constructor, same classmethod decorator.
Install the SDK
uv pip install airbyte-agent-sdk
More from airbytehq/airbyte-agent-sdk
airbyte-sdk-reference
Reference documentation for the Airbyte per-connector typed SDK packages
4discovering-connectors
Discovers available Airbyte connectors, explores their entities/actions/schemas, and checks auth requirements. Use when asking what connectors exist, what a connector can do, or what fields/entities are available.
3bootstrapping-agent
Wires up an Airbyte connector for use in a PydanticAI or Claude SDK agent. Generates auth config, connector initialization, and tool_utils-decorated tool function. Use when adding a connector to an agent or setting up a new agent with a connector.
3