SuperAPI AI 工具集

vs-user-onboarding

通用与其它

查看项目

更新于 10-16 09:30

技能介绍

用途:引导全新的 SearchCLI/vs 用户从首次使用问题走到完成注册、购买 Viking AI Search、配置 AK/SK,并使本地 CLI 处于可用认证状态。当用户下载 SearchCLI 或刚装 vs 不知从何开始、缺少认证导致 CLI 报错、需要购买/接入 Viking AI Search,或使用产品与运行时命令(vs item、vs search run、vs app、vs dataset、vs recommend、vs purchase order wait 等)触发未认证恢复提示时使用。

主要能力:先运行 vs auth status --json 判断本地认证状态,已认证且产品启用(status: ok)并通过 vs doctor --json 时可提前结束,避免让老用户重复注册;根据 unconfigured、invalid、product-not-enabled、network-error 等结构化原因路由到不同步骤。提供入口路径:新用户购买、已购但未配置、缺少认证的 CLI 恢复。支持 vs purchase link --environment-id 获取购买页链接,环境仅限 volcano-cn-beijing、volcano-ap-southeast-1、byteplus-ap-southeast-1。购买完成后可选运行 vs purchase order wait --project-name <project-name> --max-attempts 5 --poll-interval-ms 2000 检查订单可见性。

使用方式:先查 vs auth status --json;需要时让用户从 A/B/C/D 选项中确认自身状态。购买由用户在控制台页面完成,不通过程序下单。用户明确确认购买完成后,询问项目,默认 default,否则使用用户填写的确切项目名。AK/SK 创建需询问是主账号还是子账号:主账号前往 https://console.volcengine.com/iam/keymanage 创建或获取;子账号通常不能创建,需联系企业管理员。配置时仅使用 vs auth import-env(VIKING_AK/VIKING_SK 已在真实 shell 中时)或 vs auth login,非默认项目加 --project-name。区域选择由用户决定:中国大陆客户选 cn-beijing,东南亚客户(印尼、新加坡、马来西亚)选 ap-southeast-1(Johor)。之后运行 vs auth status --json --project-name <project-name> 与 vs doctor --json --project-name <project-name> 验证,通过后移交 vs-item-onboarding 进行数据接入与首次搜索。

限制:注册、实名认证、支付、密钥创建均为人工检查点,代理须等待用户明确确认,不得代为操作控制台,不得程序化创建订单;不得让用户把 AK/SK 等敏感凭据粘贴到聊天中;子账号无权限时只能建议联系管理员,不得提权或绕过;禁止在本地无 AK/SK 时运行 purchase order status 或 purchase order wait;命令执行前应先查阅 vs-product-qa 核对当前命令、参数与取值;购买链接须以 vs purchase link 输出为准,不得硬编码。执行具体 vs 命令前需先确认命令面与参数;其他产品、能力、API、控制台、计费等超出本流程的问题暂交 vs-product-qa 处理。其余细节暂未提供。