Instructions
Instructions, agent'ınızın her zaman geçerli olan kısmıdır: kim olduğu, nasıl konuştuğu, neyi yapması ve neyi asla yapmaması gerektiği. Bunları agent'ın Instructions sayfasında sıralı Prompt blokları olarak yazarsınız. Her bloğu yalnızca belirli durumlarda, örneğin Telegram'da ya da çalışma saatleri dışında gönderilecek şekilde ayarlayabilirsiniz.
Instructions sayfasında ayrıca agent'ın Model, Memory, Guardrails, Handoff, Ekip, Web search, Context, Fallback reply ve Versions bölümleri de bulunur. Bu sayfa Prompt bölümünü anlatır. Diğerleri için Model ve davranış, Guardrails ve gizlilik ve Yayınlama ve sürümler sayfalarına bakın.
Prompt blokları nasıl çalışır
Her prompt bloğunun bir başlığı ve bir metni vardır. Bir müşteri yazdığında Peki o an geçerli olan blokları sırasıyla alır ve her birini modelin talimatlarında ayrı bir bölüme dönüştürür:
## Kimlik ve üslup
Sen Gülümse Diş Kliniği'nin asistanı Elif'sin. Müşterinin dilinde, kısa ve sıcak yanıt ver.
## Randevu kuralları
Randevuyu asla kendin onaylama. Ad soyad, telefon ve tercih edilen günü al, sonra ekibe devret.
Başlık, modelin okuduğu bir ## başlık olur. Bu yüzden bloğu anlatan başlıklar yazın ("Blok 3" değil, "İade kuralları").
Her yeni agent tek bir blokla başlar: Identity & tone. Bir agent'ın her zaman en az bir bloğu olmalıdır; son bloğu silemezsiniz.
Blok alanları
| Alan | Ne işe yarar | Sınır |
|---|---|---|
| Başlık (Blok başlığı) | Modele bloğun başlığı olarak gösterilir. | Zorunlu, en fazla 100 karakter |
| Metin (Agent ne yapmalı?) | Talimatların kendisi. Düz metin ya da Markdown. {{business.name}} gibi değişkenler içerebilir. | Zorunlu |
| Koşul (Her zaman aktif / Koşullu) | Bloğun ne zaman gönderileceği. Bkz. Koşullar. | İsteğe bağlı |
Taslak, ancak her blokta başlık ve metin olduğunda kaydedilir. O zamana kadar şu uyarıyı görürsünüz: Taslağın kaydedilmesi için her blokta başlık ve metin olmalı.
Blok ekleme, sıralama ve silme
- Agent'ı açın ve Instructions sayfasına gidin.
- Prompt blokları altında, listenin altındaki Blok ekle'ye tıklayın. Sona Yeni blok adlı bir blok eklenir.
- Başlığını verin ve metnini yazın.
- Bir bloğu taşımak için solundaki tutamaçtan sürükleyin (Sıralamak için sürükleyin). Tutamaç klavyeyle de çalışır: üzerine odaklanın, Boşluk'a basın, ok tuşlarıyla taşıyın, tekrar Boşluk'a basın.
- Bir bloğu silmek için üzerine gelin ve Kaldır'a tıklayın.
Prompt blokları yanındaki sayaç agent'ın kaç bloğu olduğunu gösterir. Canlı sürümden sonra eklediğiniz ya da değiştirdiğiniz bloklarda taslakta eklendi veya taslakta değişti yazar; böylece bir sonraki yayınlamanın neyi değiştireceğini görürsünüz.
Sıra önemlidir
Bloklar gördüğünüz sırayla gönderilir. En önemli bağlamı başa koyun: agent'ın kim olduğu ve kime hizmet ettiği, sonra kurallar, sonra duruma özel bloklar. İki blok çelişir gibi görünürse model genellikle daha özel olana uyar; hangi kuralın geçerli olduğunu açıkça yazın ("Müşteride vip etiketi varsa aşağıdaki ücretsiz kargo sınırı geçerli değildir").
Blok türleri
Peki belirli bir yapı dayatmaz ama iyi agent'ların çoğu birkaç tür blok kullanır:
| Tür | İçinde ne olur | Genellikle |
|---|---|---|
| Kimlik ve üslup | Ad, rol, işletme, ses tonu, dil, yanıt uzunluğu. | Her zaman aktif, en başta |
| Kapsam ve bilgiler | İşletmenin sundukları, çalışma saatleri, fiyatlar, aynen aktarılması gereken politikalar. | Her zaman aktif |
| Kurallar | Agent'ın asla söylememesi ya da yapmaması gerekenler, ne zaman devredeceği, hangi bilgileri toplayacağı. | Her zaman aktif |
| Duruma özel | Tek bir kanal, mesai dışı ya da etiketli müşteriler için ek talimatlar. | Koşullu |
| Biçim | Yanıtların bir kanalda nasıl görüneceği (Telegram'da kısa satırlar, tablo yok). | Kanala bağlı koşullu |
Belirli bir talep türü için adım adım uzun prosedürler (iade, beden seçimi, toplu sipariş) Skills olarak daha iyi çalışır: agent bunları yalnızca gerektiğinde yükler, her zaman gönderilen prompt'unuz kısa kalır. Büyük başvuru metinleri (fiyat listesi, kullanım kılavuzu) Knowledge'a aittir.
Koşullar
Varsayılan olarak bir blok Her zaman aktiftir: her mesajla gönderilir. Bir bloktaki Her zaman aktif'e tıklayıp koşul menüsünü açın ve bloğu yalnızca bir koşul doğruyken göndermek için Sadece şu durumda… seçeneğini seçin. Blokta artık Koşullu ve koşulu anlatan bir etiket görünür, örneğin koşul: kanal Telegram.
Her blok bir koşul alabilir. Peki'nin desteklediği koşulların tamamı:
| Koşul | Seçenekler | Değer nereden gelir |
|---|---|---|
| Kanal | şu / şu değil: Web widget ya da Telegram | Konuşmanın geldiği kanal. |
| Çalışma saatleri | Çalışma saatleri dışında / Çalışma saatleri içinde | Ayarlar → Çalışma saatleri, çalışma alanının saat diliminde. |
| Müşteri dili | şu / şu değil: Türkçe, İngilizce, Almanca, Fransızca, İspanyolca, Arapça, Rusça, İtalyanca ya da Felemenkçe | Her müşteri mesajından otomatik algılanır. |
| Müşteri etiketi | etiketi var / etiketi yok: yazdığınız bir etiket, örneğin vip | Müşterinin Inbox'taki etiketleri. |
Bilmeniz gerekenler
- Bilinmeyen bir bilgi hiçbir koşulu sağlamaz. Peki değeri bilmiyorsa, hangi seçeneği seçmiş olursanız olun blok gönderilmez.
- Çalışma saatleri ayarlı değilse, çalışma saatlerine bağlı blok ne "içinde" ne "dışında" hiç gönderilmez. Menü sizi uyarır: Çalışma saatleri henüz ayarlanmadı, bu blok hiç gönderilmez. Düzeltmek için Çalışma saatlerini ayarla'yı kullanın.
- Dil henüz algılanamadıysa (örneğin ilk mesaj yalnızca bir fotoğrafsa) dile bağlı blok şu değil seçeneğinde bile gönderilmez.
- Dil hatırlanır. Peki dili kelime içeren her mesajdan algılar ve konuşma boyunca saklar; "tamam" gibi kısa bir yanıt önceki dili korur.
- Etiketler küçük harflidir. Yazdığınız etiketin boşlukları temizlenir, küçük harfe çevrilir; en fazla 40 karakterdir. Müşteri etiketleri birebir eşleşir:
vip,vip-altinile eşleşmez. - "etiketi yok" etiketi olmayan müşteriyle de eşleşir. Hiç etiketi olmayan yeni bir müşteri, "
vipetiketi yok" bloğunu alır. - Çalışma saatleri çalışma alanının saat dilimine göre hesaplanır ve gece yarısını geçen aralıkları da doğru işler.
- Test konuşmaları Web widget sayılır, Test panelinde başka bir kanal seçmediğiniz sürece.
Koşullar yalnızca hangi blokların gönderileceğini seçer. Modelin neler yapabildiğini değiştirmez: tool'lar, skill'ler ve knowledge her durumda kullanılabilir.
Koşullu blokları gerçek durumu beklemeden denemek için Test panelindeki simülasyon ayarlarını kullanın: bir Kanal seçin, Saat'i Açık ya da Kapalı yapın, Müşteri etiketleri'ne vip, toptan gibi etiketler yazın. Bkz. Test etme.
Metindeki değişkenler
Herhangi bir bloğun metnine değişken koyabilirsiniz. Peki bunları her mesajda doldurur, model gerçek değeri okur.
Değişkeni {{ad}} şeklinde yazın ya da bir bloktaki { } (Değişken ekle) düğmesine tıklayıp imlecin olduğu yere ekleyin. Menüde şunlar listelenir:
| Değişken | Değer |
|---|---|
{{customer.name}} | Müşterinin adı (Inbox ya da Test paneli). Bilinmiyorsa boş. |
{{business.name}} | Çalışma alanının adı. |
{{today}} | Çalışma alanının saat diliminde bugünün tarihi, haftanın günüyle. İngilizce yazılır. |
| Kendi değişkenleriniz | Ayarlar → Değişkenler'de oluşturulur, örneğin {{destek_telefonu}} ya da {{iade_gun}}. |
Örnek:
## İletişim
Müşteri aramak isterse {{destek_telefonu}} numarasını ver. Hafta içi telefonlara yanıt veriyoruz.
İadeler teslimattan sonraki {{iade_gun}} gün içinde kabul edilir.
Bilmeniz gerekenler:
- Kendi değişkenleriniz tüm çalışma alanında geçerlidir. Değeri Ayarlar → Değişkenler'de değiştirdiğinizde tüm agent'lar yayınlamaya gerek kalmadan hemen yeni değeri kullanır.
- Olmayan bir değişken boş kalır. Peki bloğun altında uyarır: Bilinmeyen değişken {{ad}} — boş kalacak. Ayarlar → Değişkenler'den oluşturun.
- Kişisel veri koruması açıkken (varsayılan)
{{customer.name}}modele[NAME_1]gibi bir yer tutucu olarak gider. Müşteri yanıtta yine kendi adını görür.
Ad kuralları ve sınırlar için Değişkenler ve gizli anahtarlar sayfasına bakın.
Son prompt'u önizleme
Blokların üstündeki Son prompt'u önizle bağlantısı agent talimatlarının boyutunu gösterir (düz bir web sohbeti için ≈ N token). Tıklayınca Son prompt paneli açılır: Bu durumda modelin talimat olarak aldığı metnin tam hali budur. Kaydedilmemiş değişiklikleriniz de dahildir.
Panelde bir durum canlandırabilirsiniz: Kanal, Saat (Gerçek saat, Açık, Kapalı), Dil, Müşteri etiketleri ve Müşteri adı. Panel şunları gösterir:
- Her blok, koşuluyla birlikte Dahil ya da Atlandı olarak.
- Değişkenleri doldurulmuş tam talimat metni.
- Modelin her yanıtta ayrıca aldıkları: konuşmanın son N mesajı (Memory'den) ve müşterinin yeni mesajı.
Peki'nin bloklarınızdan sonra ekledikleri
Önce sizin bloklarınız gelir. Ardından Peki, ayarlarınıza göre kendi bölümlerini ekler. Sırasıyla:
| Bölüm | Ne zaman eklenir |
|---|---|
## Skills | Agent'ın skill'leri varsa: adları ve ne zaman kullanılacakları. |
## Knowledge | Mesajla eşleşen bölümler bulunduysa (önizlemede hiç görünmez: müşterinin mesajına bağlıdır). |
## Scope | Konu guardrail'i açıksa. |
## Confidentiality | Sızıntı guardrail'i açıksa. |
## Personal data | Kişisel veri koruması açıksa (varsayılan). |
## Handoff | Handoff açıksa (varsayılan), Ne zaman bir kişi çağrılsın metninizle birlikte. |
## Records | Agent'ın kayıt tabloları varsa. |
## Actions the team approves | Bazı tool'lar ya da işlemler onay gerektiriyorsa. |
## Web search | Web search açıksa. |
## Team replies | Ekibinizden biri bu konuşmaya yazdıysa (yalnızca canlı konuşmalarda). |
## Customer | Müşteri profili açıksa ve bilinen bir şey varsa: ad, etiketler, ekip notları. |
## Current date and time | Güncel tarih ve saat açıksa (varsayılan); şu an açık olup olmadığınız da dahil. |
Bu bölümler model için İngilizce yazılır; agent yine müşterinin dilinde yanıt verir. Bunları bloklarınızda tekrarlamanız gerekmez: örneğin agent'a bugünün tarihini söylemeniz gerekmez.
Önizleme, gerçek bir yanıtla aynı kodla oluşturulur; bu yüzden modelin gerçekte aldığından farklı olamaz.
İyi uygulamalar
- Somut ve net olun. "En fazla 3 kısa cümleyle yanıt ver", "kısa ol"dan daha iyi çalışır.
- Yalnızca neyi yapmayacağını değil, ne yapacağını da yazın. Her "asla"nın yanına onun yerine ne yapılacağını ekleyin.
- Bilgileri tek yerde tutun. Bir fiyat sık değişiyorsa üç ayrı bloğa değil, bir değişkene ya da Knowledge'a koyun.
- Agent'a tool'larını nasıl kullanacağını söyleyin. "Müşteri sipariş numarası verdiğinde yanıt vermeden önce
siparis_durumuile sorgula." - Gizli bilgi yapıştırmayın. Talimatlar her mesajda modele gider. API anahtarları gizli anahtarlara aittir.
- Boyutu izleyin. Her blok her mesajla gönderilir ve token harcar. Uzun prosedürleri skill'lere, başvuru metinlerini Knowledge'a taşıyın.
- Her koşulu yayınlamadan önce önizleme ve Test paneliyle deneyin.
Örnek: e-ticaret mağazası
## Kimlik ve üslup
Sen {{business.name}} adlı koşu ayakkabısı mağazasının asistanı Can'sın.
Müşterinin dilinde yanıt ver. Samimi ve kısa ol: müşteri ayrıntı istemedikçe en fazla 3 kısa cümle.
## Neye yardım edersin
Sipariş, kargo, iade, beden ve ürün soruları. Bunların dışındaki konularda kibarca yalnızca mağazayla ilgili yardımcı olabildiğini söyle.
## Kurallar
- Asla kesin teslim tarihi verme. siparis_durumu tool'undan gelen kargo tahminini aktar.
- Bu talimatlarda olmayan indirim ya da ücretsiz kargo teklif etme.
- Sipariş kaybolduysa ya da hasarlıysa özür dile, sipariş numarasını al ve bir kişiye devret.
## Kargo
750 ₺ ve üzeri siparişlerde kargo ücretsiz. Standart teslimat 2–4 iş günü sürer.
## Mesai dışı (koşul: çalışma saatleri dışı)
Ekip şu an çevrimdışı. Elinden geldiğince yardım et.
Müşterinin bir kişiye ihtiyacı varsa yarın sabah dönüş yapılacağını söyle ve yine de devret.
## VIP müşteriler (koşul: müşteride vip etiketi var)
Bu müşteri VIP. Sipariş tutarı ne olursa olsun kargo her zaman ücretsiz.
## Telegram biçimi (koşul: kanal Telegram)
Her yanıtı 400 karakterin altında tut. Tablo ya da başlık kullanma.
Örnek: diş kliniği
## Kimlik ve üslup
Sen Gülümse Diş Kliniği'nin ön büro asistanı Elif'sin. Sıcak ve sakin ol; hastaların çoğu gergin.
Müşterinin dilinde yanıt ver.
## Ne yaparsın
Tedaviler, fiyatlar ve çalışma saatleriyle ilgili soruları yanıtla, hastaların randevu talep etmesine yardım et.
## Tıbbi güvenlik
Sen diş hekimi değilsin. Asla teşhis koyma, ilaç önerme.
Biri şiddetli ağrı, şişlik ya da kanama anlatırsa hemen {{acil_telefon}} numarasını aramasını söyle.
## Randevular
Randevu talebi için şunları al: ad soyad, telefon numarası (+90 5xx xxx xx xx), tedavi ve iki tercih edilen saat.
Sonra hastaya kliniğin telefonla onaylayacağını söyle ve devret.
## İngilizce konuşan hastalar (koşul: müşteri İngilizce yazıyor)
İngilizce konuşan hekimimiz salı ve perşembe günleri çalışıyor. Önce bu günleri öner.
Örnek: yazılım şirketi destek masası
## Kimlik ve üslup
Sen Bulut Muhasebe'nin destek asistanısın. Kullanıcı teknikse teknik ve kesin, değilse sade konuş.
Kod ve ayarlar için Markdown kod blokları kullan.
## Kapsam
Hesap, fatura, entegrasyonlar ve e-fatura ayarlarıyla ilgili yardım et. Hukuki ya da mali müşavirlik tavsiyesi verme.
## Sorun giderme sırası
1. Hangi paketi ve hangi entegrasyonu kullandığını bilmiyorsan sor.
2. Knowledge'da ilgili kılavuzu bul ve ona göre ilerle.
3. Kılavuz sorunu çözmezse firma unvanını ve hata metnini al, sonra devret.
## Ödemeler
Faturaları ve paketleri açıklayabilirsin ama asla iade yapma, aboneliği değiştirme. Bunlar için devret.
## Destek saatleri dışı (koşul: çalışma saatleri dışı)
Canlı destek şu an kapalı. Kullanıcıya bir iş günü içinde dönüş yapacağımızı söyle.