用途:将某个工作区设为默认,持久化到 ~/.airbyte-agent/settings.json。此后任何接受 workspace 参数但未显式传入的命令,都会使用该默认值,替代字面量 "default"。
主要能力:写入前通过 API 校验工作区是否存在;持久化的是 API 返回的规范大小写名称,例如输入 production 会保存为 Production;名称匹配对工作区实际 name 字段不区分大小写。
使用方式:需先确保 airbyte-agent CLI 在 PATH 中,可通过 brew install airbytehq/tap/airbyte-agent 安装或参考项目 README。始终以 --json '{...}' 方式传参,不要使用逐参数标志。命令:airbyte-agent workspaces use --json '{"name": "Production"}'。name 为必填。
适用场景:在 airbyte-agent configure 之后使用,通常是引导流程的第二步;切换项目时先设置一次,避免每条命令都传 --json '{"workspace": "..."}';新建工作区并希望其成为默认时。
输出:成功时返回 status: saved、workspace 与提示信息。
错误与处理:validation_error(退出码 4)表示缺少 name,需传入 --json '{"name": "<workspace>"}';not_found(退出码 3,针对工作区)表示该工作区不在当前账户中,可运行 airbyte-agent workspaces list --json '{}' 查看真实名称;not_found(退出码 3,针对设置文件)表示 ~/.airbyte-agent/settings.json 缺失,需先运行 airbyte-agent configure;auth_error(退出码 2)表示凭据无效,可运行 airbyte-agent enroll 验证,必要时再运行 airbyte-agent configure。
限制与提示:该命令会写入磁盘。若通过 AIRBYTE_* 环境变量而非 settings.json 配置,环境变量在运行时优先,保存值在解除环境变量覆盖前不生效。要清除默认值并回到字面量 "default" 回退,可编辑文件删除 workspace 字段,或将其设为 "default"。