SuperAPI AI 工具集

arkcli-models

通用与其它

查看项目

更新于 10-16 09:35

技能介绍

用途:本技能是其他业务链路的依赖型只读助手,主要服务于三类上游目标——为 +chat / +gen 找正确模型、为 +deploy 确认可部署模型、为业务排障核对模型详情与版本。最终任务若不是纯模型查询,应在完成查询后回到原 owning Skill(如 arkcli-deploy、arkcli-chat、arkcli-gen)。

主要能力:

  1. arkcli models search [keyword] [filters]:Agent 首选。做关键词模糊召回加结构化过滤(--modality、--min-context-window、--capability、--cache-type、--multimodal 等),返回 context_window、input_modalities、output_modalities、capabilities、cache_types 等字段,并已内置两阶段重排(先 family 分组、组内按 gen/tier/ctx/update_time 排)。建议加 --strict-filter 只返回完全满足条件者。
  2. arkcli models list:按 modality 全量枚举、翻页统计与公共目录盘点,轻量、不含 enrich;找模型不要用 list。全量盘点用 --page-all。
  3. arkcli models get <id> [version]:单个模型完整详情,聚合多 API,最全。可用 --transform 'primary_version' 取版本号,输出带引号需剥离。
  4. arkcli models activate <name> [--sub-services ...]:用户明确要求开通/激活基础模型服务时使用;CI 加 --yes,本地预览用 --dry-run,但不得称其为服务端校验。激活基础模型 ≠ 创建 Endpoint。
  5. models performance {rank, trend, input-length}:仅 Volc,公共模型性能排名、趋势与输入长度对比。

使用方式:执行任何 models 命令前,应先读取对应 reference 文档;开始前须先读取 ../arkcli-shared/SKILL.md。为上游 Endpoint 创建查模型时,须先完成 owning Skill 交接并保留其约束。查询候选时初始只做一次有界 search(如 --size 10 --format json),成功后回到原任务,不逐候选循环 get。

限制与边界:search/get 只证明公共目录与元数据,不证明 Endpoint 已创建、Key 有效、余额充足或账号有权限。api_support 按目标 API 项的 supported 判断,项缺失属证据不足。context_window 用精确整数,展示时 1K=1024、1M=1048576 tokens。目录 Published 不足以推翻产品下线公告;Retiring 不宜作为新接入推荐,Shutdown 默认被 search 过滤(--include-deprecated 可恢复)。语音模型的目录命中不代表 arkcli 支持其调用或部署,费用询价走 pricing models --modality Audio。认证、profile/region 排障分别转 arkcli-auth、arkcli-config。账号自传/精调资产走 arkcli-custommodel,套餐模型清单走 arkcli-plans。