Portal Cloud Skills:Memulai dengan Alibaba Cloud Skills

Langkah 1: Jelajahi Skills Portal dan pilih Keterampilan

1. Buka Portal Skills.

2. Masukkan kata kunci di kotak pencarian di bagian atas halaman, misalnya "resource search", atau telusuri berdasarkan kategori produk.

3. Klik Skill yang dituju untuk membuka halaman detailnya. Halaman detail menampilkan kemampuan Skill, perintah instalasi, dan contoh prompt. Langkah-langkah berikut menggunakan Resource Center global resource search (alibabacloud-resourcecenter-search) sebagai contoh.

Langkah 2: Instal Skill

Di halaman detail Skill, klik Install Guide. Pilih opsi instalasi Anda, salin perintah yang dihasilkan, lalu jalankan di terminal Anda.

npx skills add aliyun/alibabacloud-aiops-skills --skill <skill-name> --agent <client> -y --full-depth

npx clawhub install <skill-name>

npx skills ls

npx skills ls -g

Langkah 3: Gunakan Skill di klien Agent Anda

Setelah instalasi, restart klien Agent untuk memuat Skill. Contoh berikut menggunakan Claude Code, Cursor, dan Qoder:

# ECS Instance Search Results
Found **3** ECS instances.

| Instance ID | Instance Name | Region | Status | Instance Type |
|---------|---------|------|------|------|
| i-bp1abc**** | web-server-01 | cn-hangzhou | Running | ecs.g6.large |
| i-bp2def**** | db-server-01 | cn-hangzhou | Running | ecs.r6.xlarge |
| i-bp3ghi**** | test-instance | cn-shanghai | Stopped | ecs.c6.large |

Langkah 4: Coba operasi lainnya

Setelah Skill berfungsi, coba tugas yang lebih kompleks. Skill Resource Center global resource search mendukung prompt seperti:

Show me all cloud resources in the China East 1 (Hangzhou) region.

Show me the resource count for each product type under my current account.

Mengapa klien Agent saya tidak dapat menemukan Skill yang telah diinstal?

Hal ini biasanya disebabkan oleh ketidaksesuaian direktori, sesi klien yang kedaluwarsa, atau file Skill yang tidak lengkap. Periksa hal berikut:

• Verifikasi bahwa Anda menjalankan perintah instalasi di direktori proyek yang benar. Skill diinstal ke direktori tingkat proyek .<client>/skills/ secara default dan tidak akan berlaku otomatis di proyek lain. Untuk menggunakan Skill di berbagai proyek, tambahkan flag -g untuk instalasi global.

• Setelah instalasi, restart klien Agent atau buka kembali proyek saat ini di klien agar klien memindai ulang direktori skills.

• Jalankan ls .<client>/skills/<skill-name>/ untuk memverifikasi bahwa file SKILL.md ada. Jika file tersebut hilang atau direktorinya kosong, hapus direktori tersebut lalu jalankan kembali perintah instalasi.

• Jika Skill dengan nama yang sama diinstal di cakupan project dan global, direktori project memiliki prioritas lebih tinggi. Jika pembaruan global tidak berlaku, periksa apakah versi lama masih tersisa di direktori project.

Mengapa perintah npx skills add gagal?

Kegagalan instalasi biasanya disebabkan oleh lingkungan Node.js, konektivitas jaringan, atau izin direktori. Periksa hal berikut:

• Jika Anda melihat command not found: npx, jalankan node --version untuk memverifikasi bahwa Node.js telah diinstal dan versinya 18 atau yang lebih baru. Jika Node.js belum diinstal, rujuk ke website resmi Node.js untuk instalasi.

• Jika error berupa timeout jaringan atau unduhan lambat, periksa koneksi jaringan lokal Anda dan coba lagi.

• Jika error berupa kesalahan izin (seperti EACCES atau permission denied), jangan gunakan sudo untuk menjalankan npx. Sebagai gantinya, periksa dan perbaiki izin tulis pengguna saat ini untuk direktori proyek.

• Jika error berupa 404 Not Found atau nama Skill tidak ditemukan, buka Portal Skills dan verifikasi bahwa pengenal Skill dieja dengan benar serta Skill telah dipublikasikan.

Mengapa saya mendapat error saat Agent memanggil Skill?

Error pemanggilan biasanya disebabkan oleh masalah kredensial CLI, izin RAM yang tidak mencukupi, atau layanan Resource Center yang tidak aktif. Periksa hal berikut:

• Jika error berupa kegagalan autentikasi, jalankan aliyun sts get-caller-identity untuk memverifikasi bahwa kredensial CLI saat ini valid dan belum kedaluwarsa. Jika sudah kedaluwarsa, jalankan aliyun configure untuk mengonfigurasi ulang.

• Jika error berupa izin tidak mencukupi (seperti Forbidden.RAM atau NoPermission), buka Konsol RAM dan tambahkan kebijakan izin yang diperlukan untuk Pengguna RAM atau role saat ini. Pencarian Resource Center memerlukan izin AliyunResourceCenterReadOnlyAccess. Lalu minta Agent mencoba lagi.

• Jika error menunjukkan bahwa Resource Center belum diaktifkan (seperti ServiceNotEnabled), jalankan aliyun resourcecenter enable-resource-center untuk mengaktifkan layanan tersebut dan coba lagi.

• Jika error melibatkan API produk cloud tertentu (seperti ECS atau SAS), rujuk ke dokumentasi produk cloud yang sesuai untuk menambahkan izin yang diperlukan bagi Pengguna RAM.