用途：通过 airbyte-agent CLI 管理 Airbyte 连接器、工作区与组织，并对连接器数据执行 list/get/search/create/update 等操作。命令形式为 airbyte-agent <resource> <operation>，所有命令接收 JSON 载荷并返回 JSON。
安装：需将 airbyte-agent CLI 放入 PATH，可用 brew install airbytehq/tap/airbyte-agent-cli 或 curl -fsSL https://airbyte.ai/install.sh | bash，其他方式见项目 README。
主要能力：连接器执行、检查元数据与就绪状态、列出与搜索技能文档、读取指定文档章节、创建/更新/删除连接器、列出工作区与组织、设置默认工作区或组织、打印合并后的 CLI 与 OpenAPI schema。
使用方式：参数统一用 --json '{...}' 传入，不要混用逐参数标志；workspace 省略时默认 default，可用 workspaces use 设置会话默认。--fields 在客户端裁剪响应，列表响应包裹在 {"data": [...]} 中并自动广播行级路径。@filename 可从文件加载 JSON。执行连接器时必须在载荷内提供 select_fields 或 exclude_fields。首次使用陌生连接器应先 connectors inspect，再用返回的 docs_skill_id 调用 skills docs 阅读文档，不要猜测实体、动作或参数。
限制与注意：认证错误退出码 2，需运行 airbyte-agent login 后重试；退出码 3 为未找到，4 为校验错误。不要在对话中接受凭据，凭据通过 airbyte-agent login 或 connectors create 的浏览器流程处理。connectors describe 仅为兼容保留。删除连接器为破坏性操作，需先确认。每个命令的语法、必填参数、响应结构与错误恢复应查阅对应 references/<command>.md。