检查与导入技能包¶
预检本地技能 .zip 包的清单信息、内容摘要与校验警告,确认无误后将技能包导入目标工作区并获取技能 ID 与版本号。
任务流程¶
读取本地技能 ZIP 归档字节
│
▼
调用检查接口查看名称、摘要与警告
│
▼
导入技能包并记录返回的技能 ID 与版本
准备¶
已完成 使用 SDK 中的服务地址、个人访问令牌与工作区配置。
准备本地技能
.zip归档文件(由技能提供方交付,或从包含SKILL.md的技能目录打包生成),并在终端设置文件路径:
export SKILL_ARCHIVE='./skill-package.zip'
检查技能包¶
调用 inspect_skill_package(Go 为 InspectSkillPackage)对本地 .zip 包执行只读预检,读取返回的技能名称、归档摘要(archive_digest)与检查警告列表,此步骤不会在工作区中创建技能资源。
import os
from pathlib import Path
import moi_product_sdk as sdk
client = sdk.new_with_personal_access_token(
os.environ["PRODUCT_API_BASE_URL"],
os.environ["PRODUCT_API_KEY"],
)
service = client.workspace(os.environ["WORKSPACE_ID"]).agents()
archive = Path(os.environ["SKILL_ARCHIVE"])
data = archive.read_bytes()
inspection = service.inspect_skill_package(archive.name, data)
print("Skill name:", inspection.get("name"))
print("Archive digest:", inspection.get("archive_digest"))
print("Warnings:", inspection.get("warnings"))
package main
import (
"bytes"
"context"
"fmt"
"log"
"os"
"path/filepath"
sdk "github.com/matrixorigin/matrixflow/sdk/go-sdk"
)
func main() {
ctx := context.Background()
client, err := sdk.NewWithPersonalAccessToken(
os.Getenv("PRODUCT_API_BASE_URL"),
os.Getenv("PRODUCT_API_KEY"),
)
if err != nil {
log.Fatal(err)
}
defer client.Close()
workspace, err := client.Workspace(os.Getenv("WORKSPACE_ID"))
if err != nil {
log.Fatal(err)
}
archivePath := os.Getenv("SKILL_ARCHIVE")
data, err := os.ReadFile(archivePath)
if err != nil {
log.Fatal(err)
}
service := workspace.Agents()
inspection, err := service.InspectSkillPackage(ctx, filepath.Base(archivePath), bytes.NewReader(data))
if err != nil {
log.Fatal(err)
}
values, ok := inspection.AsMap()
if !ok {
log.Fatal("expected an object response from InspectSkillPackage")
}
fmt.Println("Skill name:", values["name"])
fmt.Println("Archive digest:", values["archive_digest"])
fmt.Println("Warnings:", values["warnings"])
}
导入技能包¶
核对预检输出的技能名称、摘要与警告信息后,接续上一步的 service 和归档数据调用 import_skill_package(Go 为 ImportSkillPackage)完成导入,并记录返回的技能 id、name 与 version:
result = service.import_skill_package(archive.name, data)
skill = result.get("skill") or {}
print("Skill ID:", skill.get("id"))
print("Name:", skill.get("name"), "Version:", skill.get("version"))
imported, err := service.ImportSkillPackage(ctx, filepath.Base(archivePath), bytes.NewReader(data))
if err != nil {
log.Fatal(err)
}
result, ok := imported.AsMap()
if !ok {
log.Fatal("expected an object response from ImportSkillPackage")
}
skill, ok := result["skill"].(map[string]any)
if !ok {
log.Fatal("import response missing skill object")
}
fmt.Println("Skill ID:", skill["id"])
fmt.Println("Name:", skill["name"], "Version:", skill["version"])
导入成功后,可在控制台将技能绑定到目标智能体,或在单次调用请求中按需附加该技能名称。
下一步¶
最后更新于