NeboAI
NeboAI
Começar

Skills

Uma skill ensina um funcionário a fazer bem um tipo de trabalho. Escreve-a como uma pasta com um ficheiro SKILL.md: uma descrição curta que o funcionário usa para escolher a skill e instruções que segue depois de a carregar. As skills não precisam de código, e todos os funcionários de um bot as podem usar.

O que é uma skill

Uma skill é uma pasta cujo nome corresponde ao name da skill. A pasta contém um ficheiro SKILL.md e, opcionalmente, quaisquer outros ficheiros a que as instruções se refiram: documentos de referência, modelos ou scripts.

O SKILL.md tem duas partes. O frontmatter YAML entre linhas --- contém o nome e uma descrição. O corpo em Markdown que se segue contém as instruções.

Como os funcionários usam as skills

Um funcionário trabalha com uma skill em três passos.

  1. Escolher. Em cada turno, o funcionário vê uma lista das skills de que dispõe: o nome de cada skill, a sua descrição e até três dos seus acionadores. A descrição é o que o funcionário lê para decidir, por isso escreva-a de forma a dizer o que a skill faz e quando a usar.
  2. Carregar. O funcionário chama a ferramenta use_skill com o nome da skill. A ferramenta devolve as instruções, o caminho da pasta da skill e os nomes dos seus ficheiros. É a única forma de um funcionário ler uma skill.
  3. Trabalhar. O funcionário segue as instruções. Lê os ficheiros de apoio com read_skill_file e executa os scripts incluídos com execute.

Os acionadores nunca carregam uma skill por si só. A escolha é sempre do funcionário. Quando a lista fica longa, o funcionário pode pesquisá-la com find_skills.

Escreva a sua primeira skill

Crie uma pasta com o nome da skill e um ficheiro lá dentro.

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".

Coloque a pasta na pasta de skills do utilizador de um bot (consulte Onde ficam as skills). O Nebo deteta a nova pasta em cerca de um segundo, e todos os funcionários desse bot podem usar a skill.

Um funcionário também pode escrever uma skill por si. Peça-lhe que guarde uma e ele chama save_skill, que escreve a pasta na mesma pasta de skills do utilizador.

Regras que o carregador impõe

Uma skill que viole uma destas regras não é carregada. O Nebo regista um aviso e ignora-a.

RegraPormenor
O ficheiro começa por ---O frontmatter tem de ser a primeira coisa no ficheiro. O ficheiro tem de estar em UTF-8.
name é obrigatórioSó letras minúsculas, dígitos e hífenes; sem hífen inicial ou final; sem hífen duplo; no máximo 64 bytes.
description é obrigatórioNo máximo 1024 bytes.
Os campos têm o tipo certoUm campo com o tipo YAML errado faz falhar o ficheiro inteiro. Ponha as versões entre aspas, como "1.0.0".
platform correspondeSe existir, a skill só é carregada nos sistemas operativos indicados.

As chaves do frontmatter que o Nebo não reconhece são ignoradas. O corpo não tem limite de tamanho, mas instruções mais curtas deixam mais espaço para o trabalho. Passe o material longo para ficheiros que o funcionário lê quando precisar.

Acrescentar ficheiros

Qualquer ficheiro da pasta além do SKILL.md e dos ficheiros ocultos fica disponível para o funcionário. Os nomes das pastas ficam ao seu critério; o Nebo não dá nenhum significado especial a references/ nem a assets/. Os ficheiros em scripts/ ou bin/ podem ser executados.

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

Refira-se aos ficheiros pelo caminho dentro da pasta, como references/policy.md. O funcionário lê-os com read_skill_file, que rejeita qualquer caminho que saia da pasta. Os scripts correm com a ferramenta execute numa sandbox. A referência do SKILL.md aborda runtimes, variáveis de ambiente, segredos e acesso à rede.

Onde ficam as skills

Um bot reúne skills de vários sítios. Quando duas fontes disponibilizam uma skill com o mesmo nome, prevalece a fonte que aparece mais abaixo nesta lista.

FonteLocalizaçãoQuem a pode usar
IncorporadaCompilada no NeboTodos os funcionários
Loja<data>/nebo/skills/<slug>/<version>/Todos os funcionários
PluginA pasta skills/ de um plugin instaladoTodos os funcionários
Utilizador<data>/user/skills/<name>/Todos os funcionários
Pacote de funcionárioskills/ dentro de um pacote de funcionário instaladoSó esse funcionário
Aprendida<data>/learned/skills/<employee>/<name>/Só esse funcionário

<data> é ~/Library/Application Support/Nebo no macOS, %APPDATA%\Nebo no Windows e ~/.local/share/nebo no Linux. A variável de ambiente NEBO_HOME substitui-o. Quando um funcionário tem uma skill própria e uma skill partilhada com o mesmo nome, prevalece a sua.

O Nebo vigia estas pastas e recarrega uma skill alterada ao fim de um segundo. Para desligar uma skill sem a eliminar, mude o nome do ficheiro para SKILL.md.disabled.

As skills descrevem trabalho, não ferramentas. Escreva uma skill em torno de uma responsabilidade, como reconciliar recibos, e deixe o funcionário usar a ligação que o proprietário disponibilizou. Quando uma skill precisa mesmo de um plugin, declare-o com o campo plugins.

A seguir