> For the complete documentation index, see [llms.txt](https://docs.useoly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.useoly.com/otomasyon/rules/actions.md). # Kural adımları ve etkileri Alan, AI, görsel, doğrulama ve akış adımlarının seçenekleri ve güvenli kullanımı. Adımlar eşleşen her kayıtta yukarıdan aşağı çalışır. Bir adımın çıktısı sonraki adıma girdi olabilir. Sıra tutamacıyla taşıyın; çöp kutusuyla kaldırın. Altın kredi simgesi, adımın çalışırken kredi harcayabileceğini gösterir. ![Adım ekle menüsünde AI, alan ve gelişmiş adımlar](https://67517283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP8oDDPbGr8omZPaaGYZf%2Fuploads%2Fgit-blob-694f5ae0c342eec1a758b1af6121dfed98f67219%2Frule-action-selection.png?alt=media) *Menü, seçilen olayla uyumlu adımları kısa açıklamalarıyla sunar.* ## Alan adımları | Adım | Alanlar ve seçenekler | Etki | | ------------------------ | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Sabit değer yaz** | **Hedef Alan** ve alan tipine uygun **Değer**. | Her eşleşmede aynı değeri yazar. Hazır örnekte Bakım Talimatı belirli bir metin olur. Mevcut değeri değiştirebilir. | | **Alanı temizle** | Hedef alan. | İçeriği kaldırır; zorunlu veya tamlığa dahil alanı eksik bırakabilir. | | **Değeri kopyala** | Kaynak, hedef ve **Boş ise / Her zaman / Sadece import'ta** modu. | Kaynak değeri hedefe taşır. **Boş ise** dolu hedefi korur; **Her zaman** üzerine yazar. | | **Değeri eşle** | İsteğe bağlı kaynak, hedef, kaynak→hedef satırları ve eşleşmeyen davranışı. | Gelen seçenekleri kontrollü sözlüğe çevirir. Eşleşmeyende **Orijinali Koru**, **Boş Bırak** veya **Atla** seçilir. **Hedef alanda yoksa seçenek olarak ekle** kontrollü sözlüğü genişletebilir. | | **Metni dönüştür** | Hedef ve Küçük Harf, Büyük Harf, Başlık Harfi, Boşluk Temizle, Slug, Değiştir veya Kırp. | Metnin biçimini değiştirir. Seçenek alanlarında kullanılamaz; Değiştir bul/değiştir, Kırp uzunluk ve son ek ister. | | **Şablondan metin üret** | Hedef, `{{ alan }}` belirteçli şablon ve eksik bilgi davranışı. | Birden çok alandan cümle kurar. Bilgi eksikse **Hiç yazma** yarım cümleyi engeller; **Boş bırak ve devam et** şablonu yine işler. | | **Hesapla** | Hedef ve izinli fonksiyonları kullanan **İfade**. | Alan değerlerinden hesap yapar. Tanınmayan alan veya ifade kaydı engeller. | Hedef seçicide ürün alanı, çevrilebilir ürün metni ve adı; olaya göre varyant alanları, görsel alt metni, etiketleri veya metadata görülebilir. Çevrilebilir alanda **Dil** seçimi hangi dil değerine yazılacağını belirler. ## Doğrulama ve akış * **Zorunlu alan kontrolü**, seçilen alanlar boşsa uyarı üretir; ürünü değiştirmez. Her alan için isteğe bağlı alt koşul eklenebilir. * **Zinciri durdur**, bu kayıtta kalan adımları hata oluşturmadan atlar. Altındaki adımlar çalışmaz. * **Koşullu dallanma**, bir koşula göre **Evet ise** veya **Hayır ise** adım dizisini çalıştırır. Boş olmayan derlenmiş “Hayır” kolu salt okunur görünse bile kaydederken korunur. Dallanma en fazla üç kat iç içe olabilir. ## AI metin adımları | Adım | Kullanıcı seçimi | Sonuç | | -------------------------- | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | **AI ile metin üret** | Bir veya daha fazla metin alanı ve isteğe bağlı dil. | Ürün bağlamından metin önerileri üretir; sonuçlar kullanıcı değerlendirmesine düşer. | | **AI ile alanları doldur** | Ek parametre yoktur. | Ürün ve varyantlardaki uygun boş alanlar için bütünsel çıkarım çalıştırır; uygun alan ve AI politikaları kapsamı belirler. | | **AI ile çevir** | Bir veya daha fazla hedef dil. | Çevrilebilir ürün metinleri için çeviri önerileri üretir. | Bu adımların kredi maliyeti dinamiktir. Adım menüsü sabit bir sayı değil kredi simgesi gösterir; koşu geçmişi gerçekleşen kullanımı gösterir. **Koşu başına kredi** ve **Gün başına kredi** sınırı koyun. İlgili AI özelliği çalışma alanında kapalıysa adım çalışmaz ve koşu sonucu nedenini bildirir. ## Görsel adımları Kırpma, döndürme ve arka plan gibi doğrudan bir görseli değiştiren adımlar yalnız görsel olaylarıyla sunulur. **Modelli görsel oluştur** ise ürün tamlığı olayıyla çalışan ayrı bir adımdır; ayrıntısı [aşağıda](#modelli-görsel-oluştur). | Adım | Önemli seçenekler | Etki | | ------------------------------- | ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Görseli kırp** | Sol/üst kenar, genişlik, yükseklik yüzdesi ve dışarı taşarsa arka plan rengi. | Seçilen alanı korur; sınır dışına taşan bölüm renkli kanvasla dolar. | | **Görseli döndür** | 90° sağa, 180° veya 90° sola. | Görsel yönünü değiştirir. | | **Görseli çevir** | Yatay veya Dikey. | Görseli ayna gibi çevirir. | | **Orana göre boşluk ekle** | En-boy oranı ve arka plan rengi. | Kırpmadan kenar ekler; AI kullanmaz. | | **Kanvası orana genişlet (AI)** | En-boy oranı ve isteğe bağlı ek yönerge. | Boş alanı ürün piksellerini koruyarak üretmeye çalışır; kredi harcar. | | **Kanal ölçüsüne uydur** | Orana göre boşluk ve arka plan; zorunlu kanal çıktı hedefi. | Orijinali değiştirmeden seçilen kanal için kopya üretir. | | **Arka planı temizle** | Şeffaf veya görünür arka plan değeri. | Ürünü zeminden ayırmaya çalışır; ilgili özellik açık olmalı ve kredi harcar. | | **Çözünürlüğü artır** | 2 kat veya 4 kat; isteğe bağlı yüz iyileştirme. | Görseli büyütür ve netleştirir; kredi harcar. | | **Görseli AI ile düzenle** | Yönerge ve en-boy oranı. | Mevcut görseli tarifle düzenler; kredi harcar. | | **Görsel şablonu uygula** | Şablon, sonuç davranışı ve hedef galeri/kanallar. | Ayrı çıktı üretir veya seçilen hedefte görselin yerine geçirir. **Kendi uygula** kapalıysa sonuç onay bekler. Aynı görselde birden fazla şablon kuralı eşleşirse yalnız en yüksek öncelikli olan uygulanır. Bazı görsellerde zemin ayırma kredi gerektirebilir. | | **Görsele etiket ekle** | Virgülle etiketler ve **Ekle / Değiştir** modu. | Ekle mevcutları korur; Değiştir listeyi baştan yazar. | | **Görseli başa al** | Çekim türü/açı/kişi, güven eşiği ve varsayılan, güncel veya kanal seti. | Uyan görseli kendi galeri grubunda ilk sıraya taşır. | ### Modelli görsel oluştur **Modelli görsel oluştur** adımı, ürünün tamlığı yükseldiğinde seçtiğiniz preset ve modelle ürünün seçtiğiniz varyant değerleri (ör. renkler) için modelli görseller hazırlar. Sonuçlar galeriye doğrudan yazılmaz; her zaman [Visual Studio Onaylar](/visual-studio/visual-studio/approvals.md) ekranında kullanıcı kararı bekler. Aynı işi ürün seçerek başlatmak için [Toplu Studio](/visual-studio/visual-studio/bulk-studio.md) rehberine bakın. **Ne zaman çalışır?** Adım yalnız **Ürün doluluğu değiştiğinde** olayıyla kaydedilebilir. Bu olay, bir ürünün tamlığı aşağıdan yukarı bir eşiği geçtiğinde oluşur. Eşikler **%25, %50, %75 ve %100**'dür; bunlara ek olarak, olayı dinleyen etkin kuralların koşullarına yazdığınız tamlık değerleri de eşik sayılır. Örneğin **Tamlık (%)** **buyuktur** 80 koşullu bir kural, ürün %80'i geçtiği anda (ör. %76'dan %85'e çıkınca) değerlendirilir. Tamlık düştüğünde olay oluşmaz. Elle toplu çalıştırma (**Şimdi Çalıştır**), zamanlama, ürün kaydetme veya farklı bir olay bu adımı başlatmaz. Adım kartının üstündeki bilgi notu bu kuralları kısaca hatırlatır. | Alan | Ne işe yarar | Önemli notlar | | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Çekim preset'i** (zorunlu) | Hangi sahne ve çekim dizisiyle üretileceğini seçer. Liste yalnız aktif ve sürümü olan preset'leri sayfa sayfa gösterir. | Preset'in güncel sürümündeki bütün çekimler kapsama girer. Daha önce kaydedilmiş ama artık pasif olan preset adının yanında **pasif** yazar; pasif preset'le kural kaydedilemez. Aktif preset yoksa önce Visual Studio'da bir preset oluşturun. Preset'i değiştirmek seçili modeli temizler. Seçili preset'in ya da preset'in sabit modelinin ayrıntısı yüklenemezse alanın altında hata ve **Tekrar dene** çıkar. | | **Model** | Preset'in model seçimi **otomatik** ise hangi kütüphane modelinin kullanılacağını seçer. | Otomatik preset'te zorunludur. Preset kendi modelini taşıyorsa bu alan görünmez; yerine “Bu preset kendi modelini kullanır: …” notu çıkar. Preset sonradan kendi modelini taşıyan bir sürümle yayımlandıysa ve adımda eski bir model kayıtlıysa uyarı çıkar; **Modeli kaldır** ile temizleyin, aksi hâlde kural kaydedilemez. | | **Eksen** (zorunlu) | Görsellerin hangi varyant eksenine göre ayrışacağını seçer (ör. Renk). | Ürün tiplerinizdeki varyant eksenleri listelenir. Çok seçimli alanlar, ürün tiplerinde farklı tipte tanımlanan eksenler ve anahtarı çok uzun eksenler sunulmaz; bunlar alanın altında “Kullanılamayan eksenler” notunda adlarıyla listelenir. Ekseni olmayan bir ürün çalışmada “Eksen bu ürüne uymuyor” kararıyla atlanır. Ekseni değiştirmek seçili değerleri temizler. | | **Eksen değerleri** (zorunlu) | Hangi değerler için görsel üretileceğini seçer. | Seçenekli eksende listeden işaretlenir; liste aranabilir. Farklı ürün tiplerinin aynı adlı ama ayrı tanımlanmış seçenekleri ürün tipi adıyla ayrılır (ör. “Kırmızı (Tişört)”, “Kırmızı (Gömlek)”); her ürün tipi için ilgili seçeneği işaretleyin. Ürün tipinden kaldırılmış ama kuralda kayıtlı kalan bir seçenek “Seçili kayıt (şu an yüklenemedi)” notuyla işaretli görünür; işaretini kaldırarak kuraldan çıkarın. Ürün tipleri yüklenemezse eksenin tipi bilinmez; bu sırada yeni değer eklenemez, kayıtlı değerler kaldırılabilir. Seçeneksiz eksende değerleri tek tek ekleyin: değeri yazıp Enter'a basın ya da **Ekle**'ye tıklayın. Değer eksenin tipine çevrilir (sayı ekseninde sayı); tipe uymayan değer eklenmez ve uyarı çıkar. Evet/hayır ekseninde değer yazılmaz; **Evet** ve **Hayır** düğmelerinden birini ya da ikisini seçin. Değerdeki virgül değerin parçası sayılır (ör. “Kırmızı, Beyaz” tek değerdir). Eklenen değer çip olarak görünür; çipteki çarpı ile kaldırılır. Değer sayısı ve “değer × çekim” kalem sayısı sınırlıdır; aşıldığında alanın altında uyarı çıkar ve kural kaydedilemez. | | **Onayda nereye teslim edilsin** (zorunlu) | Onaylanan görselin **Varsayılan galeri**ye ve/veya seçtiğiniz kanallara teslim edileceğini belirler. | En az bir hedef seçin. Bir kural en fazla 10 kanala teslim edebilir. Pasif ya da silinmiş kanal işaretli kalır ve uyarıyla gösterilir. | | **Eski görselleri arşivle** | Açıksa onay sırasında o eksen değerinin eski görselleri arşivlenir. | Varsayılan kapalıdır. Arşivlenen görseller ürünün görsel arşivinden geri getirilebilir. | Daha önce üretilmiş veya üretimi süren aynı kalemler tekrar başlatılmaz ve ücretlenmez. **Kredi:** Adım altın kredi simgesiyle işaretlidir. Tutar preset'e, çekim sayısına ve güncel fiyatlara göre değişir; formda sabit bir sayı gösterilmez. Kuralı kaydettikten sonra kurucudaki **Maliyet tahmini** kartı ve çalışma kayıtlarındaki kararlar en fazla krediyi gösterir (bkz. [Kural önizleme, benzetim ve çalıştırmalar](/otomasyon/rules/simulation-and-runs.md)). **Benzetim** üretilecek ve atlanacak kalemleri ve en fazla krediyi raporlar; görsel üretmez, kredi harcamaz. **Kayıtta reddedilen durumlar:** Aşağıdaki durumlarda **Kaydet** bir hata bildirimi gösterir. Bildirim sorunun hangi adımda olduğunu yazar (ör. “2. adım: …”): * Adım, ürün alanına yazan adımlarla (**Sabit değer yaz**, **Değeri kopyala** gibi) aynı kuralda kullanılamaz. Alan yazımını ayrı bir kurala taşıyın. * Kural **Ürün doluluğu değiştiğinde** dışında bir olay da içeriyorsa kayıt reddedilir. * Seçilen preset ya da model bulunamıyor veya pasifse kayıt reddedilir. * Preset kendi modelini taşıyorken başka bir model seçilmişse kayıt reddedilir. * Otomatik preset'te model seçilmemişse kayıt reddedilir. * Eksen değeri × çekim sayısı izin verilen kalem sayısını aşıyorsa kayıt reddedilir. **Kendi uygula** seçeneği bu adımda yoktur: sonuçlar her zaman onay bekler. ### Sonuç nereye yazılsın Destekleyen adımlarda: * **Görselin kendisini değiştir**, mevcut görselin görünen sonucunu günceller. * **Kanal için kopya üret (orijinale dokunma)**, seçilen kanal galerisine ayrı sonuç yazar; kanal seçmek zorunludur. **Kanal ölçüsüne uydur** yalnız kanal kopyasıyla çalışır. Görsel şablonunda hedef seçilmezse yalnız ayrı çıktı oluşur; **Görselin yerine geçsin** seçimi varsayılan galeri veya kanalda görünür sonucu değiştirir. Şablon sonucu özel olarak **Şablonu geri al** ile kaldırılabilir; bu, kuralın diğer alan veya görsel değişikliklerini geri almaz. ## Hata davranışı ve geri alınabilirlik Her adım için **Sonraki adımlara devam et** veya **Zinciri durdur** seçin. Görsel ve AI adımları arka planda tamamlanabilir; sonuç koşu kapanmadan önce bekleyen durumda kalabilir. **Şimdi Çalıştır** teyidi değişiklikleri geri alınamaz diye uyarır ve Rules arayüzünde genel geri alma düğmesi sunmaz. Bu nedenle önce [Toplu Önizleme](/otomasyon/rules/simulation-and-runs.md) kullanın, geniş kapsamlı kuralları Benzetim'de gözleyin ve alan temizleme/üzerine yazma adımlarında dar koşul kurun. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.useoly.com/otomasyon/rules/actions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.