技能

​

什么是技能

---
name: pdf-report
description: 读取 PDF 文件并生成结构化摘要报告
---

# PDF 摘要报告

当用户要求分析 PDF 文件时：

1. 运行本目录下的 `extract.py` 提取正文文本；
2. 按「背景 / 要点 / 结论」结构整理摘要；
3. 输出为 Markdown 报告并保存到工作目录。

​

官方技能与自定义技能

​

不可变版本与版本冻结

• 创建即不可变：创建技能时生成第一个不可变版本，自定义技能创建后不能再修改内容。
• 智能体冻结精确版本引用：创建或更新智能体时，技能引用的 version 可以省略或填 "latest"，服务端会在写入新版本前解析并冻结为 精确版本引用。
• 会话冻结智能体版本：会话在创建时冻结当时的智能体版本，因此一次会话运行期间技能文件不会变化，中断恢复后也继续使用同一版本。
• 修订等于换新：需要修订技能时，归档旧技能并创建新技能（新技能有新的 ID 和版本线），再更新智能体的引用以生成新的智能体版本。已有的智能体版本和会话继续使用当时冻结的版本，不受影响。

​

挂载到云沙箱

/mnt/agents/skills/<技能名>/

• 每个技能挂载为独立目录，挂载目录名即技能的名称（SKILL.md 中声明的 name）；
• 文件 按需读取，首次访问时才加载，不会一次性全部下载；
• 挂载只读，会话中的任何进程都不能修改技能文件；
• 同一智能体不能重复引用同一个技能；两个技能的名称相同时会占用同一挂载路径，创建或更新智能体会被拒绝。

​

接口一览

​

创建自定义技能

curl -X POST ${API_BASE_URL:-https://api.moonshot.cn}/v1/skills \
  -H "Authorization: Bearer $KIMI_API_KEY" \
  -F "file=@pdf-report.skill"

​

修订自定义技能

​

在智能体中引用技能

{
  "skills": [
    { "skill_id": "skill_01h455vb4pex5vsknk084sn02q", "version": "latest" },
    { "skill_id": "skill_01h455vb4pex5vsknk084sn02r", "version": "1" }
  ]
}

• 引用的技能不可见、已被归档，或指定版本不存在；
• 同一智能体中重复引用同一个 skill_id；
• 两个技能的名称相同（挂载路径冲突）。

​

归档技能

curl -X POST ${API_BASE_URL:-https://api.moonshot.cn}/v1/skills/skill_01h455vb4pex5vsknk084sn02q/archive \
  -H "Authorization: Bearer $KIMI_API_KEY"

​

限制

​

下一步