用途:通过 ibl.ai 平台 API 管理智能体的技能,包括浏览组织技能目录、切换智能体已分配技能,以及维护可复用技能目录(创建/编辑/删除)。适用于为智能体配置可复用的技能指令。
认证与约定:基础地址为 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 …/orgs/{org}/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 连接。目录(agent-skills/)为组织级、跨智能体共享;分配列表(mentors/{mentor}/skills/)为单个智能体所有。编辑目录技能会影响所有已分配该技能的智能体。将分配置为 enabled=false 仅停用但保留分配,DELETE 才会彻底移除分配。