skills 里列出它即可挂上。
技能属于您的租户,不属于某个工作空间:同一个技能可以挂到您任何工作空间里的任何 Agent 上。
技能如何工作
1
申请上传地址
调用申请技能包上传。它返回一个预签名的
upload_url、上传时要带的 upload_headers,以及标识这次上传的 s3_uri。2
上传 ZIP 压缩包
用一次
PUT 把压缩包作为请求体发到 upload_url,并带上 upload_headers 里的每一个请求头。3
创建技能
调用创建技能,在
package_ref 里传入 s3_uri。技能创建时即带有第一个版本,latest_security_status 为 pending。4
等待安全审核
轮询获取技能,直到
latest_security_status 不再是 pending。5
挂到 Agent 上
在创建 Agent 或创建 Agent 版本时,把技能的
id 放进 skills。安全审核
每个技能包在 Agent 能使用之前都要经过审核。审核结果按版本记录,技能的latest_security_status 给出的是最新版本的结果:
latest_security_status 也可能不出现。此时看 latest_version 判断含义:
latest_version大于0:该部署关闭了安全审核,技能可以被引用。latest_version为0:还没有发布过技能包,技能不能被引用。latest_version也不出现:读不到当前状态,在能读到之前,任何对该技能的引用都会被拒绝。
在 Agent 中引用技能
Agent 用skill_id 引用技能,skill_version 可选。不带 skill_version 时,引用跟随最新版本;带上时,引用固定到该版本,并按该版本自己的审核结果判断。
创建 Agent 或 Agent 版本时,会逐个检查它引用的技能。只要有一个不可用,整个请求就以 400 失败,错误码为 SKILL_NOT_USABLE,消息里会逐个列出不可用的技能及原因。MemoryLake 提供的内置技能按同样的规则检查。
名称与标识符
name 在您的租户内必须唯一,创建后不能修改。id(例如 skill-2b0f5f9f4ea54767822f51f4940c8f24)才是其他所有接口和 Agent 引用使用的标识符。
内置技能
MemoryLake 还提供内置技能。Agent 可以按id 引用它们,但它们不会出现在列出技能的结果里,也不能修改或删除。