Skills dan Rules

Jika Anda menghubungkan MCP ke agen LLM, agen dapat langsung memanggil WEEGLOO API. Namun, dapat memanggil API tidak sama dengan menggunakan API itu persis seperti cara yang dimaksudkan oleh WEEGLOO. Misalnya, kapan harus memakai CMA dan kapan harus memakai CDA, bagaimana merancang field pada Content Type, atau hak akses apa yang harus diikat ke Delivery Access Token agar aman, tidak dapat diketahui hanya dari cara pemanggilannya.

Skills dan Rules adalah dua jenis panduan yang menjembatani celah ini. Skills adalah panduan yang berisi cara melakukan tugas tertentu dengan baik, sedangkan Rules adalah aturan yang harus dipatuhi di sepanjang pekerjaan. Alat instalasi (npx weegloo@latest) dapat memasang keduanya sekaligus bersama koneksi MCP.

Perbedaan antara Skills dan Rules

Keduanya sama-sama merupakan informasi yang diberikan kepada agen, tetapi perannya berbeda.

Skills adalah panduan yang merangkum cara melakukan tugas tertentu dalam bentuk langkah dan pola. Tersedia satu untuk setiap tugas, dan agen membaca serta mengikuti Skill yang bersangkutan saat memulai tugas tersebut. Misalnya, terdapat Skill masing-masing untuk tugas seperti merancang Content Type, memilih struktur layanan, dan menerbitkan Delivery Access Token. Dengan begitu, agen mengikuti metode yang telah terverifikasi alih-alih menebak.

Rules adalah aturan yang harus selalu dipatuhi terlepas dari jenis tugasnya. Misalnya, alamat dasar WEEGLOO API, cara mengambil daftar resource per halaman, dan keharusan mengirimkan informasi versi saat mengubah resource. Agen menerapkan aturan ini sebagai latar di sepanjang pekerjaan.

Singkatnya, Skills adalah panduan per tugas yang berbunyi "tugas ini dilakukan seperti ini", sedangkan Rules adalah aturan umum yang berbunyi "apa pun tugasnya, ini tetap dipatuhi".

Memasang

Skills dan Rules dipasang bersama oleh alat instalasi MCP. Jalankan perintah berikut di terminal.

npx weegloo@latest

Saat dijalankan, perintah ini menanyakan lingkungan (agen) yang akan dihubungkan dan Personal Access Token secara berurutan, lalu memasang Skills dan Rules ke lingkungan tersebut bersama server MCP. Proses instalasi dan pengaturan per lingkungan dibahas di Menghubungkan.

Menggunakan @latest membuat versi terbaru selalu terpasang. Cara menyelaraskan instalasi yang sudah ada ke kondisi terbaru dibahas di Menjaga tetap terbaru.

Menjaga tetap terbaru

Skills dan Rules bukanlah sesuatu yang selesai begitu dipasang sekali. Setiap kali WEEGLOO mendapat fitur baru dan cara yang direkomendasikan berubah, panduan ini ikut diperbarui. Sebaliknya, yang terpasang di komputer Anda adalah salinan pada saat instalasi, sehingga isinya tetap berhenti di titik itu.

Jika yang terpasang dibiarkan menjadi lama, ada dua hal yang terjadi. Skill dan Rule yang baru ditambahkan sama sekali tidak ada pada yang terpasang, sehingga agen tidak mengetahui cara menangani fitur tersebut. Jika isi item yang sudah ada berubah, agen akan tetap mengikuti panduan yang lama. Dalam kedua kasus itu, agen bekerja berdasarkan WEEGLOO pada saat instalasi, bukan WEEGLOO yang sekarang. Kualitas hasil yang diberikan agen ditentukan di titik ini, jadi sebaiknya Skills dan Rules dijaga tetap terbaru.

Yang perlu dijaga tetap terbaru adalah Skills dan Rules yang terpasang di komputer Anda. Server MCP tidak memiliki hal yang perlu diperbarui secara terpisah.

Agen memberi tahu Anda ketika ada versi baru. Saat memulai pekerjaan terkait WEEGLOO, agen memeriksa versi yang terpasang, dan tidak menampilkan apa pun jika versi itu sudah yang terbaru. Hanya ketika ada yang perlu diperbarui, agen menampilkan pemberitahuan seperti berikut beserta perintah yang harus dijalankan.

Pembaruan ini tidak berjalan dengan sendirinya. Karena pekerjaan ini menulis ulang file yang terpasang, pembaruan dijalankan setelah Anda mengonfirmasinya. Jika pemberitahuan itu muncul, sebaiknya jangan ditunda dan langsung jalankan perintahnya saat itu juga. Jalankan perintah yang ditampilkan pada pemberitahuan di terminal persis seperti yang tertera.

Pada bagian --agent dan --location terisi lingkungan dan lokasi yang Anda pilih saat instalasi, sehingga perintahnya berbeda-beda sesuai kondisi instalasi. Memakai perintah yang ditampilkan pada pemberitahuan apa adanya akan mengisikan nilai yang tepat.

Alih-alih mengetik perintahnya sendiri, Anda juga dapat mengatakan kepada agen "perbarui weegloo". Agen sudah mengetahui perintah yang harus dijalankan, jadi Anda tidak perlu mencari perintah mana yang harus dipakai.

Yang dipertahankan dan yang diubah oleh pembaruan

Pembaruan bukanlah instalasi ulang dari awal. Pembaruan mempertahankan pilihan yang Anda tentukan saat instalasi pertama dan hanya menyelaraskan isinya ke kondisi terbaru.

• Pilihan Skills dan Rules yang Anda tentukan saat instalasi tetap dipertahankan. Jika Anda hanya memasang sebagiannya, kondisi itu tetap seperti semula.
• Skills dan Rules yang baru ditambahkan sejak instalasi terakhir ikut dipasang secara otomatis. Item yang sengaja Anda kecualikan saat instalasi tetap berada dalam kondisi dikecualikan.
• Item yang dihapus dari repositori juga dihapus dari komputer Anda.
• Pembaruan tetap berada pada versi yang Anda pilih saat instalasi.
• Pembaruan tidak menyentuh pengaturan server MCP. Karena itu, saat melakukan pembaruan Anda tidak memerlukan Personal Access Token.

Jika Anda menghapus file Skill atau Rule yang terpasang secara manual, pembaruan akan memasang kembali file tersebut. Untuk mengeluarkan sebuah item, jangan hapus filenya, melainkan jalankan kembali perintah instalasi dan lepas centangnya pada layar pemilihan.

Isi yang telah diperbarui berlaku mulai dari percakapan baru. Agen membaca Skills dan Rules saat percakapan dimulai, sehingga percakapan yang sedang berjalan tetap memakai isi yang sebelumnya.

Memeriksa langsung

Skills dan Rules tersimpan di repositori publik. Untuk membuka langsung isi yang terpasang, atau untuk memeriksa panduan mana yang tersedia untuk tugas mana, rujuk repositori tersebut.

• Repositori: github.com/weeglooapi/weegloo-mcp-plugin

Skills dan Rules tersimpan di bawah plugins/weegloo/ pada repositori, masing-masing dalam direktori skills/ dan rules/.

• Direktori Skills: plugins/weegloo/skills
• Direktori Rules: plugins/weegloo/rules

Saat melakukan integrasi langsung tanpa alat instalasi pun, Anda cukup mengambil file pada jalur latest di atas apa adanya.

Langkah berikutnya

• Menghubungkan: membahas cara memasang server MCP, Skills, dan Rules untuk tiap lingkungan (agen).
• MCP: membahas bagaimana server MCP tersusun, termasuk grup server dan server unggah file.