arkcli resources
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md,其中包含认证闸门、配置排查与命令选择顺序
使用原则
arkcli resources list是 read-only 实时控制面查询,每次都打上游,没有本地缓存- 派发逻辑跟 profile.Type 走:platform →
ListEndpoints,agent-plan / coding-plan → 对应 plan API - 团队版
agent-plan-team/coding-plan-team行为等同对应个人版:agent-plan-team ≈ agent-plan(自带生文/生图/生视频预置模型);coding-plan-team ≈ coding-plan(自带生文模型,--modality image|video借道 platform endpoint 池)。资源派发 / base_url / 模型清单跟个人版完全一致,只是凭证来自团队席位 - 这个 skill 不负责改 default —— 用户要换 default 走
../arkcli-profile/SKILL.md的profile set-default --profile X真切身份(P0-A 修正):用 X 的 token / UserID 打控制面,不是 active=A 的身份打完再展示成 B 的资源
适用场景
- 用户问"当前 profile 下有哪些 endpoint / 模型可用"
- 用户跑
profile set-default时报<id> 不在可用列表,回这里看真实可用 ID - 用户跑
+chat / +gen --model报InvalidEndpointOrModel.NotFound,回这里确认 ID 在 active profile 下可见 - 用户切了 profile,想知道新 profile 下的可用资源跟旧的有什么差异
反唤起信号
- 用户要 找模型 / 挑模型 / "哪个模型最强 / 性价比最高" → 转
../arkcli-models/SKILL.md(带 enrich + 加权排序) - 用户要 创建 endpoint → 转
../arkcli-deploy/SKILL.md(arkcli +deploy) - 用户要 管理 endpoint(start / stop / get / update / list 详情)→ 转
../arkcli-infer-endpoint/SKILL.md
resources vs models 的区别
| 维度 | arkcli resources list |
arkcli models ... |
|---|---|---|
| Scope | 当前 profile 下"我能用什么" | 全平台基础模型 catalog |
| 输出 | endpoint ID(ep-xxx)或 plan 模型名 |
foundation_model 全字段 + ArkModels enrich |
| 派发 | 按 profile.type 切 endpoint / plan / coding API | 通用 ListFoundationModel |
| 缓存 | 无 | 有 cache scope(profile/region/project) |
| 主要用途 | 设 default、验 --model <id> 是否 active |
找模型、对比模型、确认 capability |
简言之:resources list 回答 "我(当前 profile)能用什么",models 回答 "平台上有什么"。
Agent 快速执行顺序
- 不确定当前 profile →
arkcli profile show --format json(看type) - text 资源 →
arkcli resources list --modality text --format json - image / video 资源 →
arkcli resources list --modality image --format json/--modality video - 多 profile 对比 → 分别跑
--profile A --modality text和--profile B --modality text - 输出里
is_default: true标的是当前 profile 的 default,用户切换 default 走arkcli profile set-default
命令一览
| 命令 | 说明 |
|---|---|
arkcli resources list |
列当前/指定 profile 下指定 modality 的可用资源 ID(实时) |
输出形态
{
"profile": "platform_cn-beijing_default",
"type": "platform",
"modality": "text",
"items": [
{"id": "ep-20260424-aaaaa"},
{"id": "ep-20260424-bbbbb", "is_default": true},
{"id": "ep-20260424-ccccc"}
],
"current_default": "ep-20260424-bbbbb",
"item_count": 3
}
is_default 仅在 items[].id == current_default 时出现;如果 default 是空字符串则 items 全无 is_default。
常见错误
- coding-plan profile 下
resources list --modality image|video不再 fail-fast (S10): 会借道 platform 控制面 ListEndpoints, 列出同账号已+deploy的 endpoint id, 用户拿来当+gen --model <ep-id>或profile set-default --modality image <ep-id>. 列表为空 → 用户在 platform 上还没 deploy, 先arkcli +deploy <model> coding-plan resources list: 缺 AccountID (请先 arkcli auth login)→ 仅 text 路径需要 AccountID; SSO 没登录或 token 解析时 claims.Sub 为空, 重新走arkcli auth login volc-ssoListEndpoints: NotLogin / Unauthorized→ 登录态/STS 过期 /--profile X的 X 没在 identity store 里有 token;先auth loginunsupported profile type "X" for resources list→ profile.yaml 被手改成不认识的 type;用profile show看type字段,需要profile create重建
参考
../arkcli-profile/SKILL.md— 看完 resources 后要换 default 时进../arkcli-models/SKILL.md— 找模型 / 对比能力时进../arkcli-deploy/SKILL.md— 没看到想要的 endpoint 时进创建链路