SuperAPI AI 工具集

iblai-agent-skills

智能体与模型

查看项目

更新于 10-16 05:55

技能介绍

用途:通过 ibl.ai 平台 API 管理智能体的技能,包括浏览组织技能目录、切换智能体已分配技能,以及维护可复用技能目录(创建/编辑/删除)。适用于为智能体配置可复用的技能指令。

认证与约定:基础地址为 https://api.iblai.app;每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量中 {org} 为 $IBLAI_ORG,{username} 为 $IBLAI_USERNAME,{mentor} 为智能体唯一 id。若尚未连接,先运行 /iblai-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。

读取接口:GET …/mentors/{mentor}/claw-config/ 用于检查门禁(技能需要沙箱);GET …/orgs/{org}/agent-skills/ 获取平台技能目录;GET …/mentors/{mentor}/skills/ 获取该智能体已分配技能。

写入接口:分配切换用 POST …/mentors/{mentor}/skills/,请求体含 skill(uuid,必填)与 enabled(布尔);PATCH …/mentors/{mentor}/skills/{assignmentId}/ 可启用或停用某条分配;DELETE 同路径可取消分配(无请求体)。目录 CRUD:POST …/orgs/{org}/agent-skills/ 创建技能,字段含 name、slug(均必填)、description、version、instruction、metadata、enabled;PATCH …/orgs/{org}/agent-skills/{id}/ 部分更新;DELETE 同路径删除(无请求体,属破坏性操作,需先与用户确认)。

限制与注意:技能需要已连接的沙箱,该功能通过 claw-config/ 端点做门禁;若返回 404 表示智能体未接入沙箱,需先通过 /iblai-agent-sandbox 连接。目录(agent-skills/)按组织范围共享,分配列表(mentors/{mentor}/skills/)按智能体区分;编辑目录技能会影响所有已分配该技能的智能体。将分配项 enabled 切换为关闭会保留分配但使其不生效,如需彻底移除请使用 DELETE。