Beceri Ekleme

Önceki sayfada araçların, aracıların işlevleri çağırmasına, API'leri sorgulamasına ve web'de arama yapmasına nasıl izin verdiği gösterildi. Ancak siz daha fazla aracı derledikçe bir desen ortaya çıkar: aynı araç kümesi, yönergeler ve başvuru malzemeleri birlikte görünmeye devam eder. "Gider raporu oluşturma" özelliği yalnızca bir araç değildir; bu bir doğrulama betiği, bir dizi ilke belgesi, formun nasıl doldurulacağıyla ilgili adım adım yönergeler ve harcama limitleri hakkında bilgidir. Bu demeti aracıdan aracıya kopyalayıp yapıştırırken, sonunda eşitliği bozulur.

Beceriler bu sorunu çözer. Beceri, yönergeleri, başvuru malzemelerini ve isteğe bağlı betikleri herhangi bir aracının isteğe bağlı olarak bulup yükleyebileceği tek bir ünitede paketleyen taşınabilir bir pakettir. Beceriler açık bir spesifikasyon'u takip ederek aracılar, ekipler ve hatta ürünler arasında yeniden kullanılabilir.

Bunu kullanmanız gereken durum

Temsilcinize şu durumlarda beceriler ekleyin:

  • Mantıksal olarak birlikte değerlendirilen yönergeler, başvuru belgeleri ve betiklerden oluşan bir ilgili bilgi kümeniz (örn., "gider raporlaması" veya "kod gözden geçirme yönergeleri") bulunuyor.
  • Birden çok aracı aynı etki alanı uzmanlığına ihtiyaç duyar ve yinelenen yönergeler yerine tek bir gerçek kaynağı istiyorsunuz.
  • Aracı özelliklerini ekipler, projeler veya kuruluşlar arasında bağımsız paketler olarak paylaşmak ve dağıtmak istiyorsunuz.
  • Bağlamı verimli bir şekilde yönetmeniz gerekir; beceriler aşamalı açıklamayı kullanır, böylece aracılar ihtiyaç duyduklarında yalnızca ihtiyaç duydukları ayrıntıları yükler.

Değerlendirmeler

Değerlendirme Ayrıntılar
Yeniden Kullanılabilirlik Beceri, bağımsız bir pakettir. Oluşturulduktan sonra, herhangi bir acente kopyalama, yapıştırma veya kopyalar arasında kayma olmadan bunu alabilir.
Bağlam verimliliği Beceriler aşamalı açıklamayı kullanır: Aracı kısa bir açıklamayı (yaklaşık 100 belirteç) önceden görür ve yalnızca ilgili olduğunda tam yönergeleri yükler. Bu, beceri gerekli olmadığında bağlam penceresinin sade ve hafif kalmasını sağlar.
Soyutlama maliyeti Beceriler, araçların üzerine bir soyutlama katmanı ekler. Tek başına bir işlev aracı için beceri sarmalayıcı eklemek gereksiz bir yük oluşturur.
Tasarım eforu Beceri sınırlarını önceden düşünmeniz gerekir: hangi unsurların beceri kapsamında olduğunu ve hangilerinin dışında kaldığını. Zayıf sınırlar, çok geniş (bağlamı boşa harcayan) veya çok dar (paketleme avantajını kaybetme) becerilere yol açar.

Becerilerin araçlardan farkı

Araçlar ve beceriler tamamlayıcıdır, rekabet değildir. Ayrımı anlamak, her birine ne zaman ulaşabileceğinize karar vermenize yardımcı olur.

Araç, ad, açıklama ve parametre şeması içeren tek bir işlev olan çağrılabilen tek bir eylemdir. Model bir aracın gerekli olduğuna karar verince yapılandırılmış bir çağrı oluşturur, Agent Framework bunu yürütür ve sonuç modele geri döner. Araçlar, aracı davranışının atomlarıdır.

Beceri, etki alanı uzmanlığı paketidir. Şunları içerebilir:

  • Yönergeler : Aracıya bir etki alanına nasıl yaklaşacaklarını açıklayan adım adım rehberlik, karar kuralları ve örnekler.
  • Başvuru malzemeleri — ilke belgeleri, SSS' ler, şablonlar ve aracının isteğe bağlı olarak başvurabileceği diğer bilgiler.
  • Betikler — aracının belirli işlemleri gerçekleştirmek için çalıştırabileceği yürütülebilir kod (örneğin, gider verilerini ilke kurallarına göre denetleyan bir doğrulama betiği).

Temel fark kapsamlardan biridir: araç aracıya tek bir eylem gerçekleştirme olanağı verir; bir beceri, aracıya etki alanının tamamını işlemek için bilgi ve kaynaklar verir.

Tool Beceri
Ne sağlar? Tek bir çağrılabilen eylem Yönergeler + başvuru malzemesi + isteğe bağlı betikler
Aracı bunu nasıl kullanır? Harekete geçmesi gerektiğinde onu çağırır İlgili bir görevle karşılaştığında yükler, yönergeleri okur ve betikleri çağırabilir veya kaynaklara başvurabilir
Bağlam maliyeti Araç şeması her zaman istem içindedir İstemde yalnızca beceri adı ve açıklaması (yaklaşık 100 belirteç) bulunur; tam içerik isteğe bağlı olarak yüklenir
Taşınabilir -lik Bunu kaydeden ajana bağlı Uyumlu herhangi bir aracı tarafından bulunabilecek bağımsız paket
En uygun Tek tek eylemler (veritabanını sorgulama, e-posta gönderme) Alan uzmanlığı (gider ilkeleri, kod gözden geçirme yönergeleri, işe alıştırma prosedürleri)

Tavsiye

Araçları fiiller (arama, kitap, doğrulama) ve beceriler uzmanlık (seyahat rezervasyonu bilgisi, gider politikası bilgisi) olarak düşünün. Bir ajan, eyleme geçmek için araçlar ve nasıl eyleme geçeceğini bilmek için beceriler kullanır.

Beceriler nasıl çalışır: aşamalı açıklama

Beceriler bağlam açısından verimli olacak şekilde tasarlanmıştır. Her şeyi istemin ön aşamasına eklemek yerine beceriler üç aşamalı bir desen kullanır:

┌──────────────────────────────────────────────────────────────────┐
│  Stage 1: Advertise                                              │
│  Agent sees skill names and descriptions (~100 tokens each)      │
│  in its system prompt at the start of every run.                 │
└──────────────┬───────────────────────────────────────────────────┘
               ▼ (task matches a skill's domain)
┌──────────────────────────────────────────────────────────────────┐
│  Stage 2: Load                                                   │
│  Agent calls load_skill to get the full instructions             │
│  (< 5000 tokens recommended).                                   │
└──────────────┬───────────────────────────────────────────────────┘
               ▼ (agent needs more detail)
┌──────────────────────────────────────────────────────────────────┐
│  Stage 3: Read resources                                         │
│  Agent calls read_skill_resource to fetch supplementary files    │
│  (FAQs, templates, reference docs) only when needed.            │
└──────────────────────────────────────────────────────────────────┘

Bu düzen, 10 kayıtlı beceriye sahip bir aracının, yaklaşık 1.000 bağlam ek yükü ödemesi anlamına gelir — 50.000 değil. Geçerli görev bunu talep ettiğinde, ajan yalnızca bilgisini derinleştirir.

Buna ek olarak, beceriler araç altyapısının üzerine kurulur. Agent Framework, aracının sistem isteminde kullanılabilir becerileri tanıtır, ardından load_skill ve read_skill_resource içerik yüklemeye aşamalı olarak çağrılan araç çağrıları olarak sunar.

Tavsiye

Beceri yapısı, kurulum ve kod örnekleri hakkında ayrıntılı bilgi için Ajan Becerileri başvuru kılavuzuna bakabilirsiniz.

Becerilerin ve diğer desenlerin ne zaman kullanılacağı

Ajansınız daha yetenekli hale geldikçe, davranışını organize etmek için birkaç yol vardır. Becerilerin araçlarla karşılaştırması şöyledir:

Desen En iyi kullanım alanı: Example
Bireysel araçlar Paylaşılan bağlam gerektirmeyen tek seferlik eylemler İşlev get_weather aracı
Beceri Talimatlar, referanslar ve isteğe bağlı komut dosyaları ile alan uzmanlığı İlke belgeleri, doğrulama betikleri ve adım adım dosyalama yönergeleriyle "gider raporu" becerisi

Yaygın tuzaklar

Gizli tehlike Kılavuz
Aşırı geniş beceriler Muhasebe, vergiler, gider raporları ve bordroları karşılamaya çalışan "finansla ilgili her şey" adlı becerinin yönergeleri çok uzun ve odaklanılmamış olacaktır. Becerileri tek bir etki alanına odaklanmış tutun.
Güvenlik gözden geçirmesi atlanıyor Beceri yönergeleri ajanın bağlamına eklenir ve betikler kod çalıştırır. Üçüncü taraf bağımlılıkları gibi becerileri değerlendirin; dağıtmadan önce bunları gözden geçirin. Beceri başvurusunda en iyi güvenlik uygulamalarına bakın.
Aşamalı açıklamayı yoksayma SKILL.md 2.000 satır uzunluğundaysa, aracı beceriyi yüklediğinde yüksek bir bağlam maliyeti öder. Aşamalı açıklamanın tüm avantajlarından yararlanmak için yönergeleri kısa tutun ve ayrıntılı başvuru malzemelerini ayrı kaynak dosyalarına taşıyın.

Sonraki Adımlar

Aracınız gerekli araçlara ve becerilere sahip olduktan sonra, bir sonraki adım, aracınızın temel mantığını değiştirmeden her etkileşimde geçerli olan korumalar, kayıt tutma ve içerik filtreleme gibi kesişen davranışlar sağlayan ara yazılım eklemektir.

Ara Yazılım Ekleme

Daha derine gidin:

  • Last updated on