SuperAPI AI 工具集

enroll

部署与运维

查看项目

更新于 10-15 19:53

技能介绍

用途:enroll 是 airbyte-agent CLI 中的命令,用于验证账户是否已注册(enrolled)以及当前的配置(provisioning)状态。它是任何会话中的第一条命令,若账户未完成配置,其他命令都会失败。

主要能力:命令无参数,返回 JSON 文档,包含 is_enrolled(布尔值)和 provisioning_state(null、IN_PROGRESS、COMPLETED、FAILED 之一),注册完成后还会返回组织元数据。新账户首次调用会自动触发注册,因此命令名为 enroll 而非 enrollment status;重复轮询同一命令可推动账户从配置中走向完成。

使用方式:需先在 PATH 中安装 airbyte-agent CLI,可通过 brew install airbytehq/tap/airbyte-agent 安装,或参见项目 README。执行命令:airbyte-agent enroll。

状态机:null → IN_PROGRESS → COMPLETED,或 IN_PROGRESS → FAILED。配置通常在 10–30 秒内完成。

轮询策略:当 provisioning_state 为 IN_PROGRESS 时,使用指数退避:第 1 次延迟 2 秒,第 2 次 4 秒,第 3 次 8 秒,第 4 次及以后 16 秒。若约 2 分钟后仍为 IN_PROGRESS,应告知用户配置耗时超出预期。

限制与注意事项:不要以快于每 2 秒的频率轮询;配置失败时不要继续;不要在会话之间缓存注册状态,应在每次会话开始时重新验证。若 provisioning_state 为 FAILED,应停止,账户需要人工干预,不要自动重试。在 is_enrolled 为 true 之前,不要执行其他命令。