SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场arkcli-agent

arkcli-agent

智能体与模型

查看项目

更新于 10-16 10:55

技能介绍

用途

arkcli agent 用于管理 ARK Managed Agents，覆盖 Agent / Skill / Env / Session / File / Memory Store / Vault / MCP OAuth 等对象的操作。当用户需要创建、查询、调试或联通 ARK Managed Agent 时使用本 skill。核心原则是先用稳定产品命令，不要直接猜 OpenTOP Action；控制面优先走 ForTop/OpenTOP，Session 运行时资源、事件、线程、Files API 走数据面直联；MCP OAuth 登录先查后端 provider，再用 arkcli agent +mcp-login。

开始前必须（CRITICAL）先读取 ../arkcli-shared/SKILL.md。

主要能力

技能按用户意图提供对应命令路径：

  • 创建 / 更新 / 删除 Managed Agent：arkcli agent agent ...
  • 复制已有 Agent 并改名 / 局部覆盖配置：arkcli +new-agent --fork <agent-id> [--name <new-name>]
  • 为创建 Agent 选择可用模型：arkcli agent model list
  • 创建 Agent 时选择 Skill：默认先查 custom，未命中再查 market；用户明确指定 market 时跳过 custom
  • 查询 / 使用本账号 custom skill、上传本地 custom skill zip、管理版本 / 删除 Skill
  • 创建运行环境 / 会话：arkcli agent env ... / arkcli agent session ...
  • 选择 / 继续 Managed Agent 会话：arkcli +new session
  • 给已有会话发消息或实时看回复、查看 session 诊断 / 导出诊断包
  • 上传文件并挂到已有 session、只上传 / 查询 Files API 文件
  • 管理 memory store / memories
  • 查询可挂载 MCP / 管理 Vault / Credential / MCP OAuth

命令速查覆盖：agent CRUD + 版本、model list、+new-agent、+iterate、skill search/list/get/create/update/delete/versions/download、env CRUD、session CRUD、session resources、session events、session threads、file、memory-store 与 memories、vault 及其 credentials 与 oauth-provider/oauth-flow、+mcp-login、+chat、+tail、+new session、+debug、+export。

使用方式

执行前按“先选路径”读取对应 reference；只读相关 reference，不需要一次性加载全部细节。用户请求如果已经明确是创建、复制、挂文件、聊天、MCP 登录等写操作，完成必要确认 / 消歧后直接执行，不要只给命令建议。

创建 Agent 的最小决策表涉及模型、Skill、本地 Skill zip、工具、环境、创建成功回读、用户期待 Agent 回复等分支。其中模型选择是创建 Agent 的强制停点：只能用用户明确给出的硬约束和产品 eligibility 字段过滤查询结果；相关度、返回顺序、推荐或 Agent 自己的“更适合”判断都不能把多个候选变成唯一候选。过滤后为 N 个（N > 1）时必须把真实 items[].model 交给用户选择；用户选定前不得查询 Agent Skill，也不得执行任何 preview、agent agent create/update、+new-agent 或 +iterate。展示候选后立即结束回合，不再探测上述写命令的 --help，不准备后续参数，也不查询 Skill/MCP 候选。

创建成功必须回读 agent agent get <agent-id> --format json，展示服务端最终的 Model、System、Tools、Skills、McpServers 和扩展配置。

认证方面，业务命令前先 arkcli auth status --format json。当前数据面 Files / Session resources / events / threads 需要可用 ARK API Key，CLI 默认使用 profile / identity 解析出的 Key，也可用全局 --api-key 覆盖；若同时自定义 --base-url，必须显式成对提供二者。线上环境默认走 --env prod。非交互 SSO 登录是两段式：先 arkcli auth login --no-browser 拿 URL；用户贴回 base64 code 后，再跑 arkcli auth login --no-browser --code <code>。

List 分页：支持分页契约的列表可加全局 --page-all，默认每页 100 条，默认最多请求 10 页，可用 --page-limit <N> 调高，--page-delay <ms> 控制页间隔。agent model list、memory-store creators、session resources list 没有可用分页契约。

删除确认：Managed Agent 的破坏性 delete 命令在真实 TTY 且未传 --yes 时会显示不可逆警告并询问 [y/N]；非交互环境（AI Agent、CI、管道）不会读取 stdin，未传 --yes 时返回 type=requires_confirmation，不会调用后端。--dry-run 不是全域能力，只有命令自身 --help 列出该 flag 时才可用。

长流程执行规则：一个 shell/tool 调用只执行一个 arkcli 命令，不要用 &&、;、管道或 heredoc 串联；写操作成功后立即从结构化输出提取并保存 ID，下一次调用使用已确认的字面量 ID；大 JSON 或大文本不要在同一 shell 调用中通过 Python/Node 管道解析。

超时与重试：只对网络超时、连接中断、429 或 5xx 做有限重试；参数校验、鉴权失败、未开通、权限不足和明确业务错误直接抛出。session create 超时后用 session list/get 检查是否已创建；events send 超时后先用 event cursor、发送时间或最近的 user event 查询 events list 确认。

适用场景

适用于通过 arkcli 命令行管理 ARK Managed Agent 全生命周期的场景，包括创建和复制 Agent、选择模型与 Skill、上传 Skill zip、创建 Environment 与 Session、向会话发送消息并实时或轮询查看回复、上传和挂载文件、管理 Memory Store、配置 Vault / Credential / MCP OAuth 以及诊断导出。

参考文档

  • references/agent.md：创建、复制、查找 Agent、默认工具。
  • references/skills.md：Market skill 搜索、custom skill zip 上传、skill ref 组装。
  • references/session-files.md：Env / Session / Files API / Session resources。
  • references/events-chat.md：events send/list/stream、+new session 选择器、+tail。
  • references/mcp-vault.md：Vault、Credential、MCP OAuth、Agent 挂 MCP。
  • references/debug-export.md：+debug、+export、端到端验证模板。
  • references/interfaces-gaps.md：接口链路和当前 gap。

限制

模型选择存在强制停点，多候选时必须交由用户选择。--dry-run 不是全域能力，仅命令自身 --help 列出时才可用；Client Preview 只生成零网络 preview.v1 计划，不代替真实执行前的开通、版本 / 依赖校验或删除确认。Memory get 的 --view 默认按 basic 请求，只返回 metadata 和 ContentSha256。部分 list 命令没有可用分页契约。具体价格、收费方式、平台支持范围等信息暂未提供。