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. Como a API do WEEGLOO e os padrões recomendados continuam a ser atualizados, é recomendável executar este comando periodicamente para manter as Skills e Rules atualizadas.
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.