Joule · informational
Joule skill — sözleşme, ajanın belirsizliği değil
Joule Skills, utterance ile backend action arasında duran deterministik uzantılardır; ajanın çalışma anında dallanan planından bilinçli olarak daha dardır. Bu sayfa skill sözleşmesinin nasıl yazılacağını, action'ın nereye bağlanacağını ve regression seti olmadan üretime çıkılmayacağını kararlaştırır. Ajan tasarımı ayrı bir kümededir.
Sözleşme: niyet, parametre, tek action
İyi bir skill bir cümlelik niyet, kapalı bir parametre listesi ve tek bir birincil action taşır. 'Müşteri hakkında her şey' skill değildir; 'satış siparişi teslimat durumunu getir' skill'dir. Parametre tipi (satış belgesi numarası, şirket kodu) Joule'un halüsinasyonla uydurduğu serbest metinden ayrılır. İkincil action gerekiyorsa ya ikinci skill ya da ajan kararıdır — tek skill içine gizli branş yazılmaz. İstanbul teslimatında sözleşme bir JSON/şablon artefaktıdır, slayt cümlesi değil. Joule Studio classic GA (Aralık 2025) bu sözleşmeyi runtime'a basar. Next-gen hat skill'i iptal etmez; skill, ajan geldiğinde de duracak olan belirleyici katmandır. Clean-core: parametre S/4 anahtarıdır, iç tablo adı değil.
- Skill contract: niyet cümlesi, parametre şeması, tek action
- Yasak örnek: 'her şeyi yap' niyeti veya gizli ikinci action
- Joule Studio classic yayın kaydı (skill adı, sürüm)
Action bağlama: OData, CAP, yetki kesişimi
Action, released OData veya BTP'deki CAP endpoint'idir. Destination adı skill tanımında birebir durur. PFCG veya IAS rolü action'ı görmez, Joule rolü de OData'yı açmaz; kesişim boşsa kullanıcı 'Joule cevap vermiyor' der. $metadata'da action/function import yoksa skill bağlanmaz; GUI transaction'ı skill action'ı değildir. Batch ve deep insert gibi yan etkili çağrılar skill'de açıkça yazılır. Test kullanıcısı üretim rolünü taklit eder; geliştirici key kullanıcısı false green üretir. İstanbul checklist: endpoint, HTTP method, dest, iki rolün kesişimi. Ajan kataloğundaki aynı endpoint, skill'de tek adım olarak kalır; kopya iki davranış doğurmasın diye ad paylaşılmaz.
- Action endpoint: OData/CAP, method, destination adı
- IAS/Joule rolü ∩ OData yetkisi — boş küme tespiti
- $metadata'da action/function varlığı, GUI tcode yok
Utterance regression: üç olumlu, üç olumsuz
Skill, ajan gibi dağılım göstermemelidir. Aynı üç utterance her yayın öncesi aynı action ve aynı parametre çıkarımını üretmeli. Olumsuz set: yetkisiz nesne, yanlış şirket kodu, skill kapsamı dışındaki niyet (ajan veya başka skill'e düşmeli). Studio test harcı bu seti koşturur; koşu kaydı Git'te durur. Prompt'u 'daha samimi' diye değiştirmek regression'ı kırar — o değişiklik prompt management sürümüdür, sessizce skill'e gömülmez. İstanbul AMS: skill başına regression yeşil olmadan transport yok. Ölçüm, ajan eval'indeki zararlı action oranından farklıdır: skill için birebir eşleşme beklenir. Bu katılık skill'in neden varsayılan uzantı tipi olduğunu açıklar.
- Olumlu utterance üçlüsü: beklenen action ve parametre
- Olumsuz üçlü: yetki, yanlış anahtar, kapsam dışı niyet
- Yayın kapısı: regression kaydı yeşil, aksi halde transport yok
Sık sorulanlar
Skill yeterliyken neden ajan konuşuluyor?
Çünkü süreç tek action ile kapanmıyorsa skill zorlanır ve gizli branş birikir. Önce skill sözleşmesi yazılır; kapanmıyorsa ajan. Tersi (her şeyi ajan) test ve denetim maliyetini şişirir.
Skill S/4 GUI işlemini açabilir mi?
Hayır. Action OData/CAP sözleşmesidir. GUI tcode Joule skill action'ı değildir. Clean-core ve Fiori/API yüzeyi şarttır.
Bu konuyu ortamınızda netleştirmek için 48 saatlik ön değerlendirme.
Lisans satmıyoruz. Destination, yetki ve model kararını yazılı notlarız.