用途:该技能用于发现 Airbyte 可用的连接器,并探索每个连接器的实体、动作、schema 与认证要求。适合在需要确认“有哪些连接器”“某个连接器能做什么”“需要什么凭据”时使用。
主要能力:
- 程序化发现:通过 from airbyte_agent_sdk import list_connectors 调用 list_connectors(),返回按字母排序的连接器 slug 列表,例如 ["airtable", "asana", "github", ...]。
- 文档探索:每个连接器的文档位于 https://github.com/airbytehq/airbyte-agent-sdk/tree/main/connectors/{name}。其中 README.md 提供实体/动作表、安装说明与示例问题;AUTH.md 说明凭据要求(OAuth、API key 等)与托管设置;REFERENCE.md 提供完整的实体/动作参数与 schema。建议先读 README 了解能力。
- 运行时内省:安装类型化连接器包后,可用运行时方法获取 schema 细节。示例:from airbyte_agent_sdk import AirbyteAuthConfig;from airbyte_agent_sdk.connectors.stripe import StripeConnector;构造 StripeConnector 并传入 AirbyteAuthConfig(airbyte_client_id、airbyte_client_secret、workspace_name 来自环境变量)。随后 connector.list_entities() 列出所有实体及其可用动作,connector.entity_schema("customers") 获取指定实体的 JSON schema。
认证要求:阅读连接器的 AUTH.md 了解所需凭据。默认托管模式下,API 凭据存储在 Airbyte Cloud,用户提供 Airbyte 客户端凭据即可。
限制:list_entities() 与 entity_schema() 需要类型化连接器(通过 uv pip install airbyte-agent-sdk 安装后可用),在通用 HostedExecutor 上不可用。
参考:SDK API 参考与连接器发现详情见官方文档。