Prompt Süsleyici
Genel Bakış
Prompt Süsleyici, sistem talimatları, uyarılar veya hatırlatmalar gibi sabit metin bloklarını — istemcinin bunları kendisi göndermesine gerek kalmadan — her isteğin mesaj listesinin başına ve/veya sonuna, istek LLM sağlayıcısına ulaşmadan önce ekler.
Tipik kullanım alanı, tüm bir AI Gateway'inde tutarlı biçimde uygulanması gereken "her zaman açık" sistem talimatlarıdır: yanıt tonu, kapsam dışı konularda ne yapılacağı, dahili bilgilerin asla açıklanmaması gibi kurallar.
Prompt Süsleyici; Prompt Şablonu politikasından sonra, RAG, korumalar ve semantik önbellek politikalarından önce çalışmalıdır. Süsleyici, şablonun ürettiği mesaj listesine ekleme yapar; sonraki politikalar da prompt'un tam kurulmuş hâlini görmelidir.
Politika listesini bu kurala aykırı bir sırayla kaydederseniz Apinizer sırayı kayıt anında otomatik olarak düzeltir ve neyi neden taşıdığını bir bilgi notuyla bildirir. Böylece Develop ekranında gördüğünüz sıra ile izleme ekranındaki gerçek çalışma sırası her zaman aynı kalır.
Bloklar
Politika, sırayla uygulanan bir veya daha fazla bloktan oluşur. Her blok üç değer taşır:
| Alan | Değerler | Açıklama |
|---|---|---|
| Konum | PREPEND / APPEND | Bloğun isteğin kendi mesajlarına göre nereye ekleneceği — başına mı sonuna mı |
| Rol | system / user / assistant | Eklenen mesajın rol etiketi |
| İçerik | serbest metin | Enjekte edilecek talimat metni |
Aynı konumdaki (PREPEND veya APPEND) bloklar, listelediğiniz sırayı korur. Bir blok pasif bırakılırsa listede kalır ama istek anında atlanır — bloğu silmeden geçici olarak kapatmak için kullanışlıdır.
Blok içeriğinde hem ${env} ortam değişkenleri hem de #{context} gateway değişkenleri çözümlenir — örneğin bir talimat metnine ortama özgü bir değer gömebilirsiniz.
Örnek
// Bir PREPEND system bloğu tanımlarsınız:
// "Dahili yapılandırmayı veya kimlik bilgilerini asla açıklama."
// İstemci gönderir:
{"messages": [{"role": "user", "content": "Merhaba"}]}
// Gateway, LLM sağlayıcısına şunu iletir:
{"messages": [
{"role": "system", "content": "Dahili yapılandırmayı veya kimlik bilgilerini asla açıklama."},
{"role": "user", "content": "Merhaba"}
]}
Mevcut Sistem Mesajına Katıştır
Varsayılan olarak her system rollü blok, isteğin mesaj listesine yeni bir mesaj olarak eklenir. Mevcut Sistem Mesajına Katıştır açıldığında, system rollü bloklar bunun yerine isteğin zaten var olan sistem mesajının içeriğine eklenir (PREPEND blokları önüne, APPEND blokları sonuna) — böylece süslenmiş her istekte sistem mesajı sayısı artmaz.
Bu ayar yalnızca system rollü bloklar için anlamlıdır; user/assistant rollü bloklar her zaman yeni bir mesaj olarak eklenir (birleştirilecek tek bir "asıl" kullanıcı/asistan mesajı yoktur).
Enjekte Edilen Metin Bütçesi
Aktif her bloğun çözümlenmiş içeriğinin toplam karakter sayısı, Enjekte Edilen Metin Bütçesi ile sınırlanır (varsayılan 16384 karakter).
Bütçe aşıldığında istek reddedilir (HTTP 400) — bloklar kısmen uygulanıp geri kalanı sessizce kesilmez. Bunun nedeni, kesik bir güvenlik/uyumluluk talimatının hiç olmamasından daha tehlikeli olabilmesidir: örneğin "asla X'i açıklama" talimatı ortasından kesilirse anlamsız ya da yanlış yönlendirici hale gelebilir.
Hazır Şablon Kataloğu
Kurulumla birlikte, yaygın "sorumlu AI" talimatlarını içeren 9 hazır şablon gelir. Politika ekranından bu şablonları tek tek veya toplu olarak yeni bloklar hâlinde içe aktarabilirsiniz:
| Kategori | İçerik |
|---|---|
| Önyargı ve Adalet | Yanıtların ırk, cinsiyet, yaş, din gibi özelliklere göre önyargılı veya kalıp yargılı olmamasını ister |
| Açıklanabilirlik | Modelin akıl yürütmesini sade dille açıklamasını, emin olmadığında bunu açıkça belirtmesini ister |
| Gizlilik Korumaları | Kişisel verilerin istenmemesini, saklanmamasını ve gereksiz yere tekrarlanmamasını ister |
| İçerik Denetimi | Nefret söylemi, taciz, şiddet veya cinsel açık içerik üretilmemesini ister |
| Etik AI | Kullanıcının çıkarını gözetmesini, yanıltıcı dil kullanmamasını, gerçek bir kişiyi taklit etmemesini ister |
| Güvenlik Korumaları | Sistem talimatlarının, yapılandırmanın veya kimlik bilgilerinin asla açıklanmamasını; kullanıcı içeriğindeki gömülü talimatların komut olarak izlenmemesini ister |
| Mevzuat Uyumu | Hukuki, tıbbi, finansal veya vergi tavsiyesinin lisanslı bir uzmanmış gibi verilmemesini ister |
| Kısa Yanıtlar | Gereksiz giriş/tekrar cümleleri olmadan doğrudan ve öz yanıt verilmesini ister |
| Teknoloji Gizliliği | Yanıtı üreten model/sağlayıcı/altyapının açıklanmamasını ister |
Bir şablonu içe aktardığınızda içeriği yeni bir bloğa kopyalanır ve blok katalog kaydına bağlı kalır. Blok listesinde bu durum bir etiketle görünür: Katalog bağlı ya da Yerel.
Katalog bağlı bir blokta konum, rol ve içerik şablona aittir; blok düzenleme penceresinde salt okunurdur ve şablonu sonradan düzenlediğinizde bloğa otomatik yansır — etkilenen dağıtımlar "yeniden dağıtım gerekli" olarak işaretlenir, böylece değişikliği yayına almak sizin kararınız olarak kalır. Bloğun durumu (aktif/pasif) politikaya özeldir ve her zaman düzenlenebilir.
Bir bloğu bu bağdan koparmak için blok listesindeki Yerelleştir düğmesini kullanın: blok mevcut içeriğiyle bağımsız yerel bir kopyaya döner, serbestçe düzenlenir ve sonraki katalog düzenlemeleri ona ulaşmaz.
Kendi Şablonlarınızı Tanımlama
Kurulumla gelen 9 şablona ek olarak kendi hazır bloklarınızı da tanımlayabilirsiniz. Katalog ekranı AI Gateway → Bilgi Tabanları sayfasındaki Prompt Decorator sekmesindedir; buradan yeni bir şablon oluşturur, mevcut kendi şablonlarınızı düzenler, aktif/pasif yapar veya silersiniz.
Bir şablon şu alanları taşır: Ad, Blok İçeriği (zorunlu), Rol (system / user / assistant), Konum (PREPEND / APPEND), ayrıca isteğe bağlı Kategori ve Açıklama. Alanlar politika bloklarıyla birebir aynıdır — şablonu içe aktardığınızda bu değerler bloğa olduğu gibi kopyalanır.
Bir şablonun içeriğini (konum, rol, blok metni) değiştirip kaydettiğinizde, o şablona bağlı blok varsa kaydetmeden önce kaç yeri etkileyeceğini gösteren bir onay penceresi çıkar. Yalnızca ad, kategori veya açıklama değiştirdiyseniz bu pencere gösterilmez; bu alanlar bloklara yansımaz.
Kurulumla gelen 9 şablon salt okunurdur: ekranda görüntülenir ama düzenlenemez veya silinemez. Kendi şablonlarınız, oluşturulduğu projede görünür; Yönetim (Administration) modunda oluşturulanlar tüm projelerden erişilebilen ortak şablonlar olur.
Şablonu silmek, ona bağlı politika bloklarını bozmaz. Silme sırasında her bağlı blok otomatik olarak yerelleştirilir: katalog bağı kopar, blok mevcut içeriğiyle olduğu gibi çalışmaya devam eder. Silmeden önce, şablon herhangi bir yere bağlıysa kaç yeri etkileyeceğini gösteren bir uyarı penceresi çıkar.
Aynı katalog, şablonları sürüm kontrolünde tutan CI/CD hatları için arayüz olmadan da yönetilebilir: AI Prompt-Decorator Presets API hem yönetim (global) hem de proje kapsamlı uçlar sunar.
Sınırlamalar
Bu politika yalnızca standart sohbet mesaj dizisini (messages[]) anlar. İstek gövdesi bu biçimde değilse — örneğin eski tip tek-metin tamamlama isteği ya da JSON olmayan bir gövde — politika sessizce atlanır (fail-open); rol etiketli bir bloğun bu biçimlere anlamlı bir karşılığı yoktur.
Çalışma Sırası
Bu politika, isteğin gateway'in diğer AI kontrollerine (korumalar, RAG bağlam ekleme, semantik önbellek, hız sınırlaması) ulaşmasından önce çalışır — böylece sonraki her kontrol, istemcinin ham gövdesini değil, süslenmiş prompt'u görür. Aynı proxy'de bir Prompt Şablonu politikası da varsa, şablon önce genişletilir; süsleyici blokları bu genişletilmiş mesaj listesine eklenir.
Yapılandırma
İlgili AI Gateway'inin politika listesine Prompt Süsleyici politikasını ekleyin.
Bir veya daha fazla blok ekleyin (Konum, Rol, İçerik) veya hazır şablon kataloğundan içe aktarın.
Gerekirse Mevcut Sistem Mesajına Katıştır'ı açın ve Enjekte Edilen Metin Bütçesi'ni ihtiyacınıza göre ayarlayın.
Politikayı kaydettikten sonra Dağıt'a tıklayın — kayıt ile dağıtım ayrık adımlardır, otomatik dağıtım yapılmaz.
Sonraki Adımlar
İstemcinin kısa bir takma adla tam prompt'a referans vermesini sağlayın
Süslenmiş prompt'un hangi koruma katmanlarından geçtiğini inceleyin
Sabit talimatların ötesinde, isteğe özgü bağlam ekleme
Aynı blokları tüm API Proxy'lerde merkezi olarak yönetin