Skills e Rules
Ao conectar o MCP a um agente LLM, o agente passa a poder chamar a API do WEEGLOO diretamente. No entanto, poder chamar a API é diferente de usá-la com exatidão, da forma pretendida pelo WEEGLOO. Por exemplo, em que situação usar a CMA e em que situação usar a CDA, como projetar os campos de um Content Type ou quais permissões vincular a um Delivery Access Token para que seja seguro são coisas que não dá para saber apenas pelo método de chamada.
Skills e Rules são dois tipos de orientação que preenchem essa lacuna. As Skills são guias com o método para executar bem uma tarefa específica, e as Rules são as regras que devem ser seguidas ao longo de todo o trabalho. A ferramenta de instalação (npx weegloo@latest) pode instalar ambas junto com a conexão do MCP.
Diferença entre Skills e Rules
As duas são iguais no sentido de que são informações fornecidas ao agente, mas têm papéis diferentes.
Skills são guias que organizam, em etapas e padrões, como executar uma tarefa específica. Há uma para cada tarefa, e o agente lê e segue a Skill correspondente quando inicia essa tarefa. Por exemplo, há uma Skill para cada tarefa, como projetar um Content Type, escolher a arquitetura do serviço ou emitir um Delivery Access Token. Assim, o agente passa a seguir um método verificado em vez de adivinhar.
Rules são regras que devem ser sempre seguidas, independentemente do tipo de tarefa. Por exemplo, o endereço base da API do WEEGLOO, a forma de obter listas de recursos página a página ou o fato de que é preciso enviar a informação de versão ao modificar um recurso. O agente aplica essas regras como pano de fundo durante todo o trabalho.
Resumindo, as Skills são orientações por tarefa que dizem "esta tarefa se faz assim", e as Rules são regras comuns que dizem "qualquer que seja a tarefa, isto se cumpre".
Instalar
Skills e Rules são instaladas em conjunto pela ferramenta de instalação do MCP. Basta executar o seguinte no terminal.
npx weegloo@latestAo executar, ele pergunta em sequência o ambiente (agente) a conectar e o Personal Access Token e, junto com o servidor MCP, instala as Skills e Rules nesse ambiente. O processo de instalação e a configuração por ambiente são tratados em Conectar.
Ao usar @latest, a versão mais recente é sempre instalada. A forma de se manter atualizado depois de já ter instalado é tratada em Manter atualizado.
Manter atualizado
Skills e Rules não se resumem a instalar uma vez e pronto. Sempre que surge um recurso novo no WEEGLOO e a forma recomendada muda, essas orientações também são atualizadas. Já o que está instalado no seu computador é uma cópia do momento da instalação, e por isso permanece parado ali.
Quando a instalação fica desatualizada, acontecem duas coisas. As Skills e Rules recém-adicionadas simplesmente não existem na sua instalação, então o agente não sabe como lidar com esses recursos. E, se o conteúdo de um item que já existia mudou, o agente segue a orientação antiga do mesmo jeito. Em qualquer dos casos, o agente trabalha tomando como referência o WEEGLOO do momento da instalação, e não o WEEGLOO de agora. A qualidade do resultado que o agente entrega se decide aí, então convém manter as Skills e Rules atualizadas.
O que precisa ser mantido atualizado são as Skills e Rules instaladas no seu computador. O servidor MCP não tem nada a atualizar à parte.
Quando sai uma nova versão, o agente avisa. Ao iniciar um trabalho relacionado ao WEEGLOO, o agente verifica a versão instalada e, se estiver atualizada, não exibe nada. Só quando há algo a atualizar é que ele mostra um aviso como o seguinte, junto com o comando a executar.
Essa atualização não é executada automaticamente. Como é um trabalho que reescreve os arquivos instalados, ela só acontece depois da confirmação do usuário. Quando o aviso aparecer, convém não adiar e executar o comando ali mesmo. Basta executar no terminal, tal como está, o comando exibido no aviso.
Nos lugares de --agent e --location entram o ambiente e o local escolhidos na instalação, então o comando varia conforme o estado da instalação. Se você usar exatamente o comando exibido no aviso, os valores corretos já estarão nele.
Em vez de digitar o comando você mesmo, também pode pedir ao agente: "atualize o weegloo". O agente já sabe qual comando executar, então você não precisa procurar qual comando usar.
O que uma atualização preserva e o que ela muda
A atualização não refaz a instalação do zero. Ela mantém as escolhas feitas na primeira instalação e apenas deixa o conteúdo na versão mais recente.
- A seleção de Skills e Rules feita na instalação é mantida como está. Se você instalou apenas uma parte, ela permanece assim.
- As Skills e Rules adicionadas desde a última instalação são instaladas automaticamente junto. Os itens que você excluiu de propósito na instalação continuam excluídos.
- Os itens removidos do repositório também são removidos do seu computador.
- A versão escolhida na instalação é mantida.
- As configurações do servidor MCP não são alteradas. Por isso, a atualização não exige um Personal Access Token.
Se você apagou à mão um arquivo de Skill ou Rule instalado, a atualização instala esse arquivo de novo. Para remover um item, não apague o arquivo: execute de novo o comando de instalação e desmarque o item na tela de seleção.
O conteúdo atualizado passa a valer a partir de uma nova conversa. Como o agente lê as Skills e Rules ao iniciar a conversa, uma conversa em andamento continua usando o conteúdo anterior.
Consultar diretamente
Skills e Rules estão num repositório público. Para abrir diretamente o conteúdo instalado ou verificar qual orientação existe para cada tarefa, consulte o repositório.
- Repositório: github.com/weeglooapi/weegloo-mcp-plugin
Skills e Rules estão sob plugins/weegloo/ no repositório, respectivamente nos diretórios skills/ e rules/.
- Diretório de Skills: plugins/weegloo/skills
- Diretório de Rules: plugins/weegloo/rules
Mesmo ao fazer a integração diretamente, sem usar a ferramenta de instalação, basta pegar os arquivos do caminho latest acima e usá-los como estão.