bootstrapping-agent

name	bootstrapping-agent
description	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.
metadata	{"category":"development","source":{"repository":"https://github.com/airbytehq/airbyte-agent-sdk","path":".codex/skills/bootstrapping-agent","license_path":"LICENSE","commit":"f20dbf71efa4f63cf57e2209049fd53c4c0f0614"}}

Bootstrapping an Agent with an Airbyte Connector

Install the SDK

uv pip install airbyte-agent-sdk

The single airbyte-agent-sdk package ships every typed connector. Import them from airbyte_agent_sdk.connectors.{slug}. tool_utils, list_entities(), and entity_schema() are only available on typed connectors.

Core Pattern (PydanticAI)

import os
from pydantic_ai import Agent
from airbyte_agent_sdk import AirbyteAuthConfig
from airbyte_agent_sdk.connectors.stripe import StripeConnector

connector = StripeConnector(
    auth_config=AirbyteAuthConfig(
        airbyte_client_id=os.getenv("AIRBYTE_CLIENT_ID"),
        airbyte_client_secret=os.getenv("AIRBYTE_CLIENT_SECRET"),
        workspace_name=os.getenv("AIRBYTE_WORKSPACE_NAME", ),
    )
)

agent = Agent(
    ,
    system_prompt=(
        
        
        
    ),
)



  ():
      connector.execute(entity, action, params  {})