用途：把 Airbyte 连接器接入智能体框架，生成认证配置、连接器初始化与预置连接器工具，让模型能查询连接器数据。
主要能力：安装 uv pip install airbyte-agent-sdk，所有类型化连接器从 airbyte_agent_sdk.connectors.{slug} 导入。首选 build_connector_tools 生成工具，支持 framework="pydantic_ai"、"langchain"、"openai_agents"、"mcp"，并自动把可重试错误转换为对应框架的重试信号。需要自定义工具体时用 agent_tool 装饰 execute、inspect、docs 三个函数，角色由签名推断，歧义时显式传角色。
使用方式：始终使用托管模式，通过 AirbyteAuthConfig 传入 airbyte_client_id、airbyte_client_secret、workspace_name，不要生成本地认证代码。环境变量为 AIRBYTE_CLIENT_ID、AIRBYTE_CLIENT_SECRET、AIRBYTE_WORKSPACE_NAME。可用 connector.check() 验证连接状态。框架可从现有导入判断，如 from pydantic_ai import Agent 或 from anthropic import Anthropic。
限制：tool_utils 已弃用，仅保留给旧集成，新工具不要生成。不支持的原生框架需省略 framework= 并自行注册三个函数，失败默认抛 AirbyteToolError。连接器 slug 中的连字符在子模块路径中改为下划线。示例 demo_agent.py 为模拟数据，无需凭据。