SuperAPI AI 工具集

jfrog-ai-catalog

智能体与模型

查看项目

更新于 10-16 09:10

技能介绍

JFrog AI Catalog 技能用于发现、安装和管理托管在 JFrog AI Catalog(Artifactory 的 skills/plugins 仓库)中的智能体技能与智能体插件,并可把自己构建的技能或插件发布回该目录,全部通过 JFrog CLI(jf skills、jf agent plugins)以及 JFrog Agent Guard 完成。

【用途】 按用户意图选择对应的参考文件并执行相应操作,主要覆盖:浏览目录、列出技能及其版本、按名称搜索技能;安装或更新技能(最新版或固定版本);查看已安装技能、移除已安装技能;将技能发布/上传/发布到目录;以及针对插件的同类操作:浏览插件目录、列出插件版本、搜索插件、安装或更新插件、查看与移除已安装插件、发布插件。

【前置条件】 先阅读基础 jfrog 技能(../jfrog/SKILL.md),它定义了本技能依赖的共享约束,本技能不再重复:

  1. 环境检查:首次调用 jf 前确认 jf 已安装,若缺失则安装。
  2. 服务器选择规则:只解析一次默认服务器,之后复用;每次 jf 调用都在子命令后传 --server-id <SID>,且每个请求只用一个服务器。解析方式为运行 jf config show 2>/dev/null | awk '/^Server ID:/{id=$NF} /^Default:[[:space:]]*true/{print id; exit}',若输出为空则停止并询问使用哪个服务器。
  3. 遇错即停规则:任何 jf 失败时停止,绝不切换服务器。 本技能额外要求:绝不 cat 或解析 ~/.jfrog/jfrog-cli.conf.v6(可能含访问令牌),只通过 jf config show 列出服务器(会脱敏)。

【Agent Guard 与注册表】 目录发现与仓库初始化通过 npx --yes @jfrog/agent-guard 执行。<REGISTRY_URL> 是提供 @jfrog/agent-guard 包本身的 npm 注册表:若设置了 JFROG_AGENT_GUARD_REPO 则用它,否则用 https://releases.jfrog.io/artifactory/api/npm/coding-agents-npm/。传给 Agent Guard 的 <SID> 需与 jf 调用一致(--server "<SID>")。Agent Guard 也会直接读取 JFROG_URL / JF_URL,因此需确保解析出的 <SID> 指向同一主机。

【项目解析】 仅在需要时解析项目 <PROJECT>,例如 --list-skills、--list-skill-versions、--provision-skills-repository、--list-agent-plugins、--list-agent-plugin-versions、--provision-agent-plugins-repository。按优先级解析:先读 ~/.jfrog/setup.json 中 .servers["<SID>"].currentActiveProject;再回退到 $JF_PROJECT;仍为空则询问用户,不得猜测。解析命令:PROJECT=$(jq -r --arg sid "<SID>" '.servers[$sid].currentActiveProject // empty' ~/.jfrog/setup.json 2>/dev/null),为空时 PROJECT="${JF_PROJECT:-}"。因为 /access/api/v1/projects 列表端点需要管理员权限,非管理员无法查询或校验项目键,所以无法静默地把显示名纠正为键;若值看起来像显示名(含空格、大小写混合)而非短 slug,需让用户明确确认项目键,绝不假定 default,也绝不编造。安装、更新、移除以及发布到显式 --repo 时,是以技能/插件名和/或仓库为键,而不是项目。

【包结构差异】 技能包要求根目录含 SKILL.md;插件包要求含 plugin.json。安装或发布前需校验对应文件。

【工作流概览】 用户请求 → 判断 jf 是否已安装(未安装则请用户安装后继续)→ 判断意图:列出全部技能/版本用 npx @jfrog/agent-guard --list-skills;安装/更新技能时解析 slug 与版本后 jf skills install/update;查看已安装或移除技能用 jf skills list / rm -rf 安装目录;发布技能时解析或初始化仓库、校验包、jf skills publish;列出全部插件/版本用 npx @jfrog/agent-guard --list-agent-plugins;安装/更新插件解析 slug 与版本后 jf agent plugins install/update;查看已安装或移除插件用 jf agent plugins list / rm -rf 安装目录;发布插件时解析或初始化仓库、校验包、jf agent plugins publish。

【注意事项】 仅涵盖目录相关规则,共享的 jf 约束(单请求单服务器、遇错即停、谨慎变更)在基础 jfrog 技能中。哪些操作会变更状态:安装与列表基本为只读;移除、注册表删除、发布属于变更,适用谨慎变更规则。会话生效:安装、更新、移除通常要到下一次智能体会话启动才生效,需提示用户重启。不要泄露内部细节:向用户只呈现技能/版本/仓库,不展示 npx 或 Agent Guard 命令、--registry、标志或游标;后续操作自行执行。回复模板需逐字使用:参考文件给出“使用此精确模板回复”时,填入占位符并按原措辞发送,不加前言或额外评论。插件不支持 Xray:执行任何 jf agent plugins 操作时跳过所有 Xray 相关处理(下载不因 403 门禁、发布不做内联扫描、无 --skip-scan 标志)。

【限制与暂未提供】 关于具体收费、价格、平台支持范围、效果指标等事实资料中暂未提供。