用途:列出某个工作区中已存在的连接器,便于在调用 describe 或 execute 前确认连接器是否存在、获取准确名称或查看状态。
主要能力:通过 airbyte-agent connectors list 命令查询工作区内的连接器列表,返回结果包裹在 {"data": [...]} 中。
使用方式:需先在 PATH 中安装 airbyte-agent CLI,可用 brew install airbytehq/tap/airbyte-agent 或参考项目 README。参数建议统一以 --json '{...}' 传入,例如:airbyte-agent connectors list --json '{"workspace": "my-workspace"}'。workspace 可选,省略时回退到名为 default 的工作区,并在 stderr 打印 JSON 提示,API 调用仍会继续。
字段过滤:已知所需字段时应使用全局 --fields 以减少上下文浪费,支持短形式(如 --fields id,name)和长形式(如 --fields data.id,data.name);若混用顶层与行级路径,行级字段需用长形式,例如 --fields data.id,next。
相关命令:connectors list-available 列出可安装模板;connectors describe 查看具体连接器的实体与动作;connectors create 从模板安装新连接器。
提示:返回的名称可在后续命令中按连接器实例名、模板显示名或模板 slug 匹配,均不区分大小写;若两个连接器同名,execute/describe/delete 会返回校验错误,此时应改传 "id": "<uuid>"。
限制:需依赖 airbyte-agent CLI 环境;具体可用工作区、连接器类型及返回字段以实际环境为准,资料未提供更多细节。