NeboAI
NeboAI
开始使用

技能

技能教员工把某一类工作做好。你把它写成一个包含 SKILL.md 文件的文件夹:一段简短的描述,供员工选择技能时参考;以及加载技能后员工要遵循的指令。技能不需要代码,机器人上的每位员工都可以使用。

什么是技能

技能是一个文件夹,名称与技能的 name 一致。文件夹中有一个 SKILL.md 文件,还可以放指令中提到的其他任何文件:参考文档、模板或脚本。

SKILL.md 由两部分组成。--- 行之间的 YAML 前置信息包含名称和描述。其后的 Markdown 正文包含指令。

员工如何使用技能

员工使用技能分三步。

  1. 选择。每一轮,员工都会看到可用技能的列表:每个技能的名称、描述,以及最多三个触发词。员工靠阅读描述来做决定,所以描述要写清楚技能做什么、何时使用。
  2. 加载。员工用技能名称调用 use_skill 工具。该工具返回指令、技能文件夹的路径以及其中文件的名称。这是员工读取技能的唯一方式。
  3. 工作。员工按照指令工作。它用 read_skill_file 读取辅助文件,用 execute 运行附带的脚本。

触发词永远不会自行加载技能,始终由员工做出选择。当列表变长时,员工可以用 find_skills 搜索。

编写你的第一个技能

创建一个以技能命名的文件夹,在里面放一个文件。

meeting-notes/
└── SKILL.md
---
name: meeting-notes
description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript.
---

# Meeting notes

1. List the decisions that were made.
2. List action items as "owner — task — due date".
3. List open questions that need a follow-up.

Keep each list short. If the transcript names no owner for an item, write "unassigned".

把这个文件夹放进机器人的用户技能目录(参见技能存放位置)。Nebo 会在大约一秒内发现新文件夹,该机器人上的每位员工都可以使用这个技能。

员工也可以替你编写技能。让它保存一个,它就会调用 save_skill,把文件夹写入同一个用户技能目录。

加载器强制执行的规则

违反其中任一规则的技能不会被加载。Nebo 会记录一条警告并跳过它。

规则说明
文件以 --- 开头前置信息必须位于文件最开头。文件必须是 UTF-8 编码。
name 为必填只能使用小写字母、数字和连字符;不能以连字符开头或结尾;不能有连续两个连字符;最多 64 字节。
description 为必填最多 1,024 字节。
字段类型正确任何字段的 YAML 类型不对,整个文件都会失败。版本号要加引号,例如 "1.0.0"。
platform 匹配如果存在,技能只会在列出的操作系统上加载。

Nebo 无法识别的前置信息键会被忽略。正文没有大小限制,但指令越短,留给工作的空间就越多。把较长的内容移到员工需要时才读取的文件中。

添加文件

文件夹中除 SKILL.md 和点文件之外的任何文件,员工都可以使用。文件夹名称由你决定;Nebo 不会赋予 references/ 或 assets/ 特殊含义。scripts/ 或 bin/ 下的文件可以运行。

invoice-check/
├── SKILL.md              # required
├── references/
│   └── policy.md         # read with read_skill_file
└── scripts/
    └── totals.py         # run with execute

用文件在文件夹内的路径来引用它们,例如 references/policy.md。员工用 read_skill_file 读取它们,该工具会拒绝任何超出文件夹的路径。脚本通过 execute 工具在沙盒中运行。SKILL.md 参考介绍了运行时、环境变量、密钥和网络访问。

技能存放位置

机器人会从多个位置收集技能。当两个来源提供同名技能时,此列表中排在后面的来源优先。

来源位置谁可以使用
内置编译在 Nebo 中所有员工
市场<data>/nebo/skills/<slug>/<version>/所有员工
插件已安装插件中的 skills/ 文件夹所有员工
用户<data>/user/skills/<name>/所有员工
员工包已安装员工包中的 skills/仅限该员工
习得<data>/learned/skills/<employee>/<name>/仅限该员工

<data> 在 macOS 上是 ~/Library/Application Support/Nebo,在 Windows 上是 %APPDATA%\Nebo,在 Linux 上是 ~/.local/share/nebo。NEBO_HOME 环境变量可以覆盖它。当员工拥有一个自己的技能和一个同名的共享技能时,以它自己的技能为准。

Nebo 会监视这些文件夹,技能有改动时会在一秒后重新加载。要在不删除的情况下停用某个技能,把它的文件重命名为 SKILL.md.disabled。

技能描述的是工作,而不是工具。围绕一项职责来编写技能,例如核对收据,然后让员工使用所有者提供的任何连接。只有当技能确实需要某个插件时,才用 plugins 字段声明它。

下一步