Cloud Skills Portal:Get started with Alibaba Cloud Skills

1. Adım: Skills Portal'a gidin ve bir Skill seçin

1. Skills Portal adresine gidin.

2. Sayfanın üst kısmındaki arama kutusuna "resource search" (kaynak araması) gibi bir anahtar kelime girin veya ürün kategorisine göre göz atın.

3. Ayrıntılar sayfasını açmak için hedef Skill'i tıklayın. Ayrıntılar sayfasında Skill yetenekleri, yükleme komutu ve örnek istemler görüntülenir. Aşağıdaki adımlarda örnek olarak Resource Center global kaynak araması (alibabacloud-resourcecenter-search) kullanılmıştır.

2. Adım: Skill'i yükleyin

Skill ayrıntılar sayfasında Install Guide öğesini tıklayın. Yükleme seçeneklerinizi belirleyin, oluşturulan komutu kopyalayın ve terminalinizde çalıştırın.

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

3. Adım: Skill'i Agent istemcinizde kullanın

Yüklemeden sonra, Skill'i yüklemek için Agent istemcisini yeniden başlatın. Aşağıdaki örneklerde Claude Code, Cursor ve Qoder kullanılmaktadır:

# 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 |

4. Adım: Daha fazla işlem deneyin

Skill çalıştıktan sonra daha karmaşık görevler deneyin. Resource Center global kaynak araması Skill'i şu tür istemleri destekler:

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.

The application on ECS instance i-bp1xxxxxxx occasionally times out when accessed from the public network. First, diagnose the health status of this instance. Then, analyze the network reachability from the public network to port 80 of this instance. Finally, check whether Cloud Security Center has any related security alerts in the last 24 hours.

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-resourcecenter-search --full-depth

Agent istemcim neden yüklü Skill'i bulamıyor?

Bu durum genellikle dizin uyuşmazlığı, eski bir istemci oturumu veya eksik Skill dosyalarından kaynaklanır. Aşağıdakileri kontrol edin:

• Yükleme komutunu doğru proje dizininde çalıştırdığınızdan emin olun. Skills varsayılan olarak proje düzeyindeki .<client>/skills/ dizinine yüklenir ve diğer projelerde otomatik olarak etkili olmaz. Bir Skill'i projeler arasında kullanmak için global yükleme amacıyla -g bayrağını ekleyin.

• Yüklemeden sonra, istemcinin skills dizinini yeniden taramasını sağlamak için Agent istemcisini yeniden başlatın veya istemcide mevcut projeyi yeniden açın.

• SKILL.md dosyasının varlığını doğrulamak için ls .<client>/skills/<skill-name>/ komutunu çalıştırın. Dosya eksikse veya dizin boşsa, dizini silin ve yükleme komutunu tekrar çalıştırın.

• Aynı ada sahip bir Skill hem project hem de global kapsamda yüklendiğinde, proje dizini önceliklidir. Global bir güncelleme etkili olmuyorsa, proje dizininde daha eski bir sürümün kalıp kalmadığını kontrol edin.

npx skills add komutu neden başarısız oluyor?

Yükleme hataları genellikle Node.js ortamı, ağ bağlantısı veya dizin izinlerinden kaynaklanır. Aşağıdakileri kontrol edin:

• command not found: npx hatasını görürseniz, Node.js'in yüklü olduğunu ve sürümünün 18 veya üzeri olduğunu doğrulamak için node --version komutunu çalıştırın. Node.js yüklü değilse kurulum için Node.js resmi web sitesine bakın.

• Hata bir ağ zaman aşımı veya yavaş indirme ise yerel ağ bağlantınızı kontrol edin ve tekrar deneyin.

• Hata bir izin hatasıysa (örneğin, EACCES veya permission denied), npx komutunu çalıştırmak için sudo kullanmayın. Bunun yerine, proje dizini için geçerli kullanıcının yazma izinlerini kontrol edin ve düzeltin.

• Hata 404 Not Found ise veya Skill adı yoksa, Skills Portal adresine gidin ve Skill tanımlayıcısının doğru yazıldığından ve Skill'in yayınlandığından emin olun.

Agent bir Skill'i çağırdığında neden hata alıyorum?

Çağrı hataları genellikle CLI kimlik bilgisi sorunları, yetersiz RAM izinleri veya etkin olmayan Resource Center hizmetinden kaynaklanır. Aşağıdakileri kontrol edin:

• Hata bir kimlik doğrulama hatasıysa, geçerli CLI kimlik bilgilerinin geçerli olduğunu ve süresinin dolmadığını doğrulamak için aliyun sts get-caller-identity komutunu çalıştırın. Süreleri dolmuşsa, yeniden yapılandırmak için aliyun configure komutunu çalıştırın.

• Hata yetersiz izinlerle ilgiliyse (örneğin, Forbidden.RAM veya NoPermission), RAM konsoluna gidin ve geçerli RAM kullanıcısı veya rolü için gerekli izin ilkesini ekleyin. Resource Center araması için AliyunResourceCenterReadOnlyAccess izni gereklidir. Ardından Agent'in yeniden denemesini sağlayın.

• Hata Resource Center'ın etkinleştirilmediğini gösteriyorsa (örneğin, ServiceNotEnabled), hizmeti etkinleştirmek için aliyun resourcecenter enable-resource-center komutunu çalıştırın ve tekrar deneyin.

• Hata belirli bir cloud ürün API'siyle (ECS veya SAS gibi) ilgiliyse, RAM kullanıcısı için gerekli izinleri eklemek üzere ilgili cloud ürün belgelerine bakın.