Airbyte Agent Connectors 让 AI 智能体通过强类型、有文档的工具调用第三方 API。每个连接器都是独立的 Python 包,全部遵循同一实体-动作模式:connector.execute(entity, action, params)。
用途与模式:平台模式基于 Airbyte Cloud(app.airbyte.ai),提供托管凭证、UI 可见性和实体缓存,适合生产与多租户场景;开源模式为本地 Python SDK,自行管理凭证、无云依赖,适合快速开发与原型验证。若环境存在 AIRBYTE_CLIENT_ID 与 AIRBYTE_CLIENT_SECRET,或需要 UI 可见,则用平台模式;否则可用开源模式。
主要能力:覆盖 51 个连接器(如 Stripe、HubSpot、GitHub、Salesforce、Gong 等),支持 list、get、create、update、delete、api_search 动作。结果中 result.data 为记录(列表或字典),result.meta 含分页信息。认证支持 API Key、Token、OAuth(需 refresh token)等类型,各连接器提供对应认证配置类。
使用方式:开源模式安装示例为 uv add airbyte-agent-github 或 pip install airbyte-agent-github。平台模式用 StripeConnector.create_hosted 创建连接器,或用已有连接器实例执行操作。分页可借助 result.meta.pagination.cursor 循环获取全部记录。完整连接器清单见 references/connector-index.md,每个连接器参考文档含包名版本、认证细节、可用实体与动作及代码片段。
限制与注意:该技能仅提供文档与设置指导,不应尝试导入 Python 模块、验证安装或运行代码来检查配置,而应按文档步骤引导用户。若连接器不在索引中,说明尚不可用,可指向 GitHub issues。要求 Python 3.11+,推荐 uv 管理包;不要在源码中硬编码凭证,应使用环境变量或 .env,并定期轮换令牌。参考文档由脚本自动生成,可通过 python scripts/generate_skill_references.py --all 重新生成。许可证为 Elastic-2.0,作者 Airbyte,版本 1.2.0。