SuperAPI AI 工具集

arkcli-onboard

通用与其它

查看项目

更新于 10-16 09:52

技能介绍

用途:把“我想用某模型”这类口语化目标,转成“正式接入需要一个可复用 Endpoint”的完整流程,逐步编排并委派给对应能力技能,最终给出 endpoint-id 与一句话的代码使用说明。触发场景包括“我想在我的 app/服务里用豆包”“怎么把方舟模型接进来”“帮我接入 seedream”“想正式用上某模型”。不触发:语音模型(TTS/ASR/配音/朗读/播客/音色/实时语音交互,或模型名命中 doubao-seed-tts-、doubao-seed-asr-、seedasr-*);已明确说“部署/创建 endpoint/deploy”;只想试用(+chat/+gen);已知模型名只想看示例代码。

主要流程:Step 0 认证与实名闸门;Step 1 用 arkcli-models 选模型,未指定则先帮选并确认;Step 2 必查是否已有可复用 Endpoint(list --mine),仅当存在绑定目标模型/版本且状态可用(如 Running)时才复用并跳到 Step 4,多个匹配时结构化选择,账号下别的模型的 EP 不算匹配;Step 3 无匹配则通过 arkcli-deploy 创建 Endpoint,这是全流程唯一写操作,需只读核对加二次确认,不支持 --dry-run;Step 4 可选,用 arkcli-code-example 生成按 model-version 的调用示例,部分版本可能返回 not found,属预期覆盖缺口,可降级到控制台示例页;Step 5 回执 endpoint-id 与代码使用说明。

使用方式:开始前必须先读取 ../arkcli-shared/SKILL.md,遵守认证闸门、命令选择顺序与写操作安全边界。离线/--help 验证模式下,用户已给模型且禁止远端查询时跳过实际查询;但查看帮助也须保留资源范围语义,如 arkcli infer endpoint list --mine --help。

限制:语音模型不是本向导目标,命中即停,仅说明广场可搜,当前 arkcli 不支持语音模型的调用、部署、示例、用量或费用,且不补替代接入路径;本文只做编排,不重复各命令私有参数细节;示例代码覆盖不全,缺失时降级而非报失败。