SuperAPI AI 工具集

iblai-api-agent-skill

编程与开发

查看项目

更新于 10-16 05:55

技能介绍

用途:通过 ibl.ai 平台 API 管理智能体(agent)的技能,包括浏览组织技能目录、为智能体分配或取消分配技能,以及维护目录中的可复用技能。

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

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

写入接口:分配方面,POST …/mentors/{mentor}/skills/ 分配技能(body 含 skill 的 uuid 与 enabled 布尔值);PATCH …/mentors/{mentor}/skills/{assignmentId}/ 启用或禁用某条分配;DELETE 同路径取消分配(无 body)。目录 CRUD 方面,POST …/agent-skills/ 创建技能(name、slug 必填,另有 description、version、instruction、metadata、enabled);PATCH …/agent-skills/{id}/ 部分更新;DELETE …/agent-skills/{id}/ 删除(破坏性操作,需先与用户确认)。另有 POST …/agent-skill-resources/ 为技能附加资源文件,POST …/agent-skill-assignments/ 在组织层级为智能体分配技能。

限制与注意:技能功能受沙箱门禁限制,若 claw-config/ 返回 404 说明智能体未接入沙箱,需先通过 /iblai-api-agent-sandbox 连接。目录为组织级、跨智能体共享,编辑目录技能会影响所有已分配该技能的智能体;分配列表为单个智能体级别。将分配设为 enabled=false 仅停用但仍保留分配,DELETE 才会彻底移除。