# Skills e conhecimento

> As skills ensinam seus fluxos de trabalho ao Endless e carregam só quando uma tarefa precisa delas. Saiba de onde vêm e como ativar ou desativar cada uma.

Source: https://endless.app/pt/docs/concepts/skills-and-knowledge

Uma **skill** é uma pasta com um `SKILL.md&#x60; dentro: um nome, uma descrição de quando ela
deve ser usada e as instruções que o Endless segue quando a usa. O produto coloca assim —
&#x2A;"Amplie o Endless com seu próprio conhecimento e fluxos de trabalho. Cada skill é carregada
apenas quando uma tarefa precisa dela, então nunca atrapalha."*

Aberta, uma skill é exatamente essa pasta: o `SKILL.md` que o agente lê e as referências
ou scripts que ela leva junto.

<ImageZoom src="/docs/screenshots/skills.webp" alt="Uma skill aberta nas configurações: à esquerda a árvore de pastas, com SKILL.md ao lado de uma pasta de referências e uma pasta de scripts; à direita a descrição da skill — quando o Endless deve usá-la — acima de uma prévia do próprio SKILL.md" width="1280" height="720" />

Pense em uma skill como um recado para um colega muito competente: &#x2A;"quando alguém pedir um
relatório para o cliente, este é o formato que usamos, é daqui que vêm os números, este é o
tom."* Você escreve uma vez; o Endless usa sempre que a hora chega.

## Como uma skill carrega

O motivo de você poder instalar muitas skills sem deixar nada mais lento é que quase nada
de cada skill fica carregado, quase o tempo todo.

<Steps>
  <Step>
    ### Descoberta

    Só o nome e a descrição de cada skill carregam no início — o suficiente para saber quando
    ela é relevante.
  </Step>

  <Step>
    ### Ativação

    Quando uma tarefa combina com uma skill, o Endless lê o `SKILL.md` inteiro para o
    contexto.
  </Step>

  <Step>
    ### Execução

    O Endless segue as instruções, carregando scripts, referências ou outros arquivos incluídos
    conforme a necessidade.
  </Step>
</Steps>

<Callout type="info">
  É por isso que a **descrição** de uma skill importa mais do que qualquer outra
  coisa nela. É a única parte que o Endless vê ao decidir se a skill se aplica —
  escreva-a como *quando usar isto*, não como *o que isto é*.
</Callout>

## De onde vêm as skills

<Cards>
  <Card icon="<PuzzlePiece />" title="Pré-instaladas">
    Seu espaço de trabalho já começa com um conjunto de skills instaladas e
    prontas — coisas como trabalhar com documentos, slides e imagens, ou `clip`,
    que recorta um momento de um vídeo, reenquadra e grava as legendas nele.
  </Card>

  <Card icon="<Link />" title="Adicionadas por você">
    **"Nova skill"** tem três caminhos: **Enviar** (um `.zip` ou um `SKILL.md`),
    **Colar** (o próprio texto do `SKILL.md`) ou **De uma URL** (um link do
    skills.sh ou do GitHub — os arquivos incluídos vêm junto).
  </Card>

  <Card icon="<Folder />" title="O conhecimento de um projeto" href="/pt/docs/concepts/projects">
    Todo projeto tem uma entrada de conhecimento, que por baixo é uma skill. Ela
    fica oculta desta lista e carrega só quando o projeto está anexado ao chat.
  </Card>
</Cards>

## Uma página, duas portas

**Skills** na barra lateral e **Configurações → Skills** são a mesma página. Não são
duas páginas parecidas — é literalmente a mesma, montada em dois lugares, com a mesma lista, o
mesmo contador e os mesmos botões. Use a que você abrir.

<Callout type="info">
  A diferença que as pessoas esperam dessas duas URLs — as *minhas* skills
  contra as do *espaço de trabalho* — existe, mas é um par de abas dentro da
  página, não um par de páginas. Continue lendo.
</Callout>

A chave de cada skill fica na linha dela. Quem pode gerenciar as ferramentas do espaço de
trabalho vê duas abas, **Pessoais** e **Espaço de trabalho**; os demais veem só a própria lista.

## Ligar e desligar skills: dois níveis

Toda skill tem duas chaves, e elas se somam. A do espaço de trabalho define o que é
*possível*; a sua define o que está *ligado*.

<Cards>
  <Card icon="<Globe />" title="Espaço de trabalho — o teto">
    *"Desative uma skill aqui para removê-la para todos no espaço de trabalho.
    Os membros escolhem por si mesmos entre as que continuarem ativas."* Esta
    aba aparece só para quem pode gerenciar as ferramentas do espaço de
    trabalho.
  </Card>

  <Card icon="<Users />" title="Pessoais — sua escolha">
    Seu próprio liga/desliga para as skills que o espaço de trabalho deixou
    disponíveis. Ninguém mais é afetado pelo que você faz aqui.
  </Card>
</Cards>

<Callout type="warn" icon="<Lock />">
  **A chave do espaço de trabalho sempre vence.** Uma skill desligada para o
  espaço de trabalho não pode ser religada por uma pessoa — o botão dela fica
  travado. Ligá-la para o espaço de trabalho também não força ninguém a usá-la;
  só torna a escolha possível.
</Callout>

Existe um terceiro nível, mais estreito: um admin pode definir as skills de uma pessoa
individualmente pelo perfil dela, em **Recursos*&#x2A;. Ali vale a mesma regra, nas palavras do
produto: &#x2A;"Uma skill precisa estar ativada para o espaço de trabalho antes de poder ser ativada
aqui."*

<Cards>
  <Card icon="<Toggle />" title="Quem pode mudar o teto" href="/pt/docs/governance/roles-and-permissions">
    Mudar o que o espaço de trabalho pode rodar é uma permissão de governança,
    que os admins têm por padrão.
  </Card>
</Cards>

## Skills, conhecimento e conectores

Três coisas ampliam o que o Endless pode fazer, e é fácil confundi-las:

| Coisa            | O que acrescenta                                                       | Alcance                                                                                                      |
| ---------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Skill**        | Instruções e arquivos — um fluxo de trabalho que o Endless pode seguir | Quem a tiver compartilhada (no início é privada; as que já vêm instaladas são de todos), onde estiver ligada |
| **Conhecimento** | Fatos e regras duradouros sobre um cliente ou uma campanha             | Só os chats em que o projeto dele está anexado                                                               |
| **Conector**     | Acesso a uma ferramenta externa, com as suas próprias credenciais      | Por pessoa, em cima do teto                                                                                  |

<Cards>
  <Card icon="<Notebook />" title="Conhecimento do projeto" href="/pt/docs/concepts/projects">
    Por que o conhecimento de um projeto fica separado da lista geral de skills
    e como o Endless o mantém atualizado.
  </Card>

  <Card icon="<Plug />" title="Conectores">
    Os conectores seguem o mesmo modelo de dois níveis — um teto do espaço de
    trabalho mais a sua escolha — com um passo a mais: você mesmo entra na
    ferramenta, então um conector ligado, mas não conectado, ainda não faz nada.
  </Card>
</Cards>

<Callout icon="<Bolt />">
  As skills também funcionam em execuções agendadas, não só no chat. Uma skill
  que você desliga fica desligada em todo lugar, inclusive em tarefas que rodam
  enquanto você dorme.
</Callout>
