API envanterinizde becerileri kaydetme ve keşfetme

Bu makalede, API envanterinizin bir parçası olarak aracı becerilerini kaydetmek için Azure API Center'ın nasıl kullanılacağı açıklanmaktadır. Beceriler, yapay zeka aracılarının işlevlerini genişletmek için keşfedebileceği ve kullanabildiği yeniden kullanılabilir özelliklerdir.

API merkezinize beceriler kaydederek, kuruluşunuza yardımcı olacak merkezi bir kayıt defteri oluşturursunuz:

• Kullanılabilir becerileri ve yeteneklerini keşfedin
• Beceriler için kaynak koduna ve belgelere erişme

Önkoşullar

• Bir API merkezi. Henüz bir API merkeziniz yoksa API merkezi oluşturma hızlı başlangıcına bakın.
• Kaydetmek istediğiniz, genellikle GitHub gibi bir kaynak kodu deposunda barındırılan bir veya daha fazla beceri.

Bir beceri kaydet

API merkezinize bir beceri kaydetmek için:

1. Azure portalında oturum açın ve API merkezinize gidin.

2. Kenar çubuğu menüsündeki Stok'un altında Varlıklar'ı seçin.

3. + Varlık Kaydet>Becerisini seçin.

   

4. Beceri kaydetme formunda, aşağıdaki tabloda yer alan bilgileri sağlayın:

   Alan	Açıklama
   Başlık	Beceri için açıklayıcı bir ad girin (örneğin, Kod Gözden Geçirme Becerisi).
   Kimlik	API Center, başlığa göre otomatik olarak bir tanımlayıcı oluşturur (örneğin, kod gözden geçirme-becerisi). Gerekirse bunu düzenleyebilirsiniz.
   Özet	Becerinin ne yaptığına ilişkin kısa bir tek satırlık bir açıklama sağlayın (örneğin, statik analiz kullanarak otomatik kod incelemeleri gerçekleştirir).
   Açıklama	Becerinin özellikleri, kullanım örnekleri ve davranışı hakkında daha ayrıntılı bir açıklama girin.
   Yaşam döngüsü aşaması	Açılan menüden beceri yaşam döngüsünün geçerli aşamasını seçin.
   Kaynak
   Kaynak URL	Beceri kaynak kodu (örneğin, https://github.com/<org>/<repo>/tree/main/skills/<skill-name>) için Git deposu URL'sini girin.
   Uyumluluk	Beceriyi kullanmaya yönelik gereksinimleri, bağımlılıkları ve önkoşulları açıklama (örneğin, gerekli yazılım veya git, docker, programlama dilleri gibi araçlar; sistem gereksinimleri; ağ erişim gereksinimleri; API anahtarları veya kimlik doğrulama gereksinimleri).
   İzin verilen araçlar	Bu becerinin erişebileceği API envanterinizdeki API'leri veya MCP sunucularını belirtmek için + Araç ekle'yi seçin. Bu yaklaşım, becerinin hangi kaynakları kullanabileceğini açıkça tanımlayarak düzgün idare ve güvenlik sağlamaya yardımcı olur.
   Lisans	Lisans bilgilerini sağlamak için + Ekle'yi seçin. Lisans adını (örneğin , MIT, Apache 2.0 veya Özel) girin, isteğe bağlı olarak bir lisans URL'si sağlayın ve lisans koşullarını veya kısıtlamaları netleştirmek için gerekirse bir açıklama ekleyin.
   İletişim bilgileri	Destek veya sorgular için iletişim noktaları eklemek için + Ekle'yi seçin. Bir kişi adı veya rol girin (örneğin API Ekibi veya John Smith), e-posta adresi gibi iletişim bilgilerini sağlayın ve isteğe bağlı olarak bu kişi veya ekiple ne zaman ve neden iletişim kurulacaklarını netleştirmek için bir açıklama ekleyin.

5. Beceriyi API merkezinize kaydetmek için Oluştur'u seçin.

Kayıt sonrasında, beceri Stok>Varlıkları sayfasındaki envanterinizde görünür.

Kayıtlı beceriyi güncelleştirme

Beceri bilgilerini istediğiniz zaman güncelleştirebilirsiniz:

1. API merkezinizde Stok>Varlıkları'na gidin.
2. Güncelleştirmek istediğiniz beceriyi bulun ve seçin.
3. Becerinin özelliklerini değiştirmek için Düzenle'yi seçin.
4. Değişikliklerinizi yapın ve Kaydet'i seçin.

Git deposundaki becerileri eşitleme

Beceri kaydını otomatikleştirmek ve envanterinizi güncel tutmak için bir Git deposunu API merkezinizle tümleştirebilirsiniz. Daha fazla bilgi için bkz. Git deposundan API varlıklarını eşitleme.

API Center portalında becerileri keşfetme

API Center portalınızı, geliştiricilerin ve kuruluşunuzdaki diğer paydaşların API envanterinizdeki becerileri keşfedebilmesi için ayarlayın. KULLANıCıLAR API Center portalından şunları yapabilir:

• Envanterdeki becerilere göz atın ve bunları filtreleyin.
• Her beceri hakkında ayrıntılı bilgileri görüntüleyin.

Yapay zeka varlıklarını değerlendirme

API Center, API merkezinizde kayıtlı beceriler ve aracılar gibi yapay zeka varlıklarının kalitesini değerlendirebilir. API Center, varsayılan değerlendirme ölçütleri kullanıma hazır olarak gelir ve önceden tanımlanmış boyutlardaki varlıkları değerlendirir. Kurumsal platform yöneticileri, kuruluşlarının belirli standartlarına, uyumluluk gereksinimlerine ve idare ilkelerine göre uyarlanmış özel değerlendirme ölçütleri tanımlayarak bu varsayılanları daha da genişletebilir.

Envanterinizdeki yapay zeka varlıklarının otomatik değerlendirmelerini etkinleştirmek için:

1. Azure portalında API merkezinize gidin.

2. Kenar çubuğu menüsünde. İdare>Yapay Zeka Değerlendirmesi'ne gidin.

3. Beceri değerlendirmelerini yapılandırmak için Beceriler sekmesini seçin veya aracılar için değerlendirmeleri yapılandırmak için Aracılar sekmesini seçin.

4. Değerlendirme durumu'ndaEtkin'i seçin.

5. Değerlendirme için bir Açıklama girin.

6. Değerlendirme ölçütlerinde aşağıdakilerden birini yapın:

   • API Center tarafından sağlanan Varsayılan ölçütleri kabul edin. İsteğe bağlı olarak, kuruluşunuzla ilgili olmayan varsayılan ölçütleri kaldırın.

   Aşağıdaki ekran görüntüsünde beceriler için varsayılan ölçütler gösterilmektedir:

   

   • Bir veya daha fazla özel ölçüt ekleyin.
     1. + Ölçüt ekle'yi seçin.
     2. Ölçüt için bir Ad ve isteğe bağlı Değerlendirme yönergesi girin.
     3. Puan için En düşük puan ve En yüksek puan değerlerini girin (örneğin, 1 ve 5).
     4. Ölçüt için kabul edilebilir en düşük puanı gösteren bir Geçiş eşiği değeri (örneğin, 3) girin.
     5. Ölçütün toplam değerlendirmeye katkısını gösteren bir Ağırlık değeri girin (örneğin, ağırlık 0,3 ise bu puanı 0,3 ile çarpar, toplam değerlendirmeye %30 katkıda bulunur).
     6. Gerektiğinde daha fazla ölçüt eklemek için önceki adımları yineleyin.

7. Kaydetseçeneğini seçin.

Ardından API Center portalında değerlendirme sonuçlarını görüntüleyebilirsiniz. Örneğin, beceri ayrıntıları sayfasında her beceri için değerlendirme sonuçlarını görüntüleyin.

İlgili içerik

• Git deposundan API varlıklarını eşitleme
• API envanterinizde MCP sunucularını ve eklentilerinikaydedin ve keşfedin.
• API Center portalınızı ayarlama
• Azure API Center'daki temel kavramlar