Değişkenler ve gizli anahtarlar

Değişkenler ve gizli anahtarlar, agent'larınızın kullandığı iki tür kayıtlı değerdir. Değişken, destek hattınız ya da iade süreniz gibi düz bir değerdir: bir kez yazarsınız, prompt bloklarında {{ad}} olarak kullanırsınız. Gizli anahtar ise tool ve Fonksiyonlarınızın kendi sistemlerinize gönderdiği bir API anahtarı ya da token'dır. Şifreli saklanır ve kaydettikten sonra ne siz ne de yapay zekâ değerini geri okuyabilir.

	Değişkenler	Gizli anahtarlar
Ne tutar	Agent'ın okuyup tekrarlayabileceği metin	API anahtarları ve token'lar
Nerede kullanılır	Prompt bloklarında, {{ad}} olarak	Tool'larda (API anahtarı ayarı) ve Fonksiyonlarda (Anahtarlar)
Kime ait	Tüm çalışma alanına; her agent ortak kullanır	Tek bir agent'a
Tekrar okunabilir mi?	Evet	Hayır, yalnızca son dört karakteri görünür
Yapay zekâ görür mü?	Evet, talimatlara yerleştirilir	Asla
Agent sürümüyle birlikte mi saklanır?	Hayır, değişiklik hemen geçerli olur	Hayır, değişiklik hemen geçerli olur
Nereden yönetilir	Ayarlar → Değişkenler	Ayarlar → Gizli anahtarlar ya da tool veya Fonksiyon kurarken

Değişkenler

Ne zaman değişken kullanmalı

Birden fazla blokta ya da birden fazla agent'ta geçen ve ileride değişebilecek bilgiler için değişken kullanın. Örneğin:

• {{destek_hatti}}: devir bloğunda ve kapanış bloğunda yazdığınız 0850 123 45 67 gibi bir destek hattı.
• {{iade_gun}}: bir e-ticaret mağazasının iade süresi.
• {{klinik_adres}}: bir diş kliniğinin adresi; hem randevu agent'ı hem SSS agent'ı kullanır.

Değer değiştiğinde Ayarlar → Değişkenler'den bir kez düzenlersiniz. Tüm agent'lar bir sonraki yanıtlarından itibaren yeni değeri kullanır. Yayınlamanız gerekmez.

ipucu

Elle bul-değiştir yapacağınız her şey değişken olmaya uygundur. Değer uzunsa, yapılandırılmışsa ya da yalnızca tek bir konuyu ilgilendiriyorsa onu Knowledge'a koyun.

Yerleşik değişkenler

Üç değişkeni Peki her mesajda kendisi doldurur. Bunları oluşturamaz, yeniden adlandıramaz ya da değiştiremezsiniz.

Değişken	Ne tutar
{{customer.name}}	Müşterinin adı: Inbox'taki müşteri profilinden ya da Test panelinde girdiğiniz Müşteri adı'ndan gelir. Ad bilinmiyorsa boş kalır.
{{business.name}}	Çalışma alanınızın adı.
{{today}}	Çalışma alanınızın saat diliminde bugünün tarihi. İngilizce yazılır, örneğin Monday 26 October 2026.

not

Kişisel verileri koru ve Müşterinin adını da yapay zekâdan gizle açıkken (ikisi de varsayılan olarak açık), {{customer.name}} yapay zekâya [NAME_1] gibi bir yer tutucu olarak gider. Müşteri yanıtlarda yine kendi adını görür. Bkz. Guardrails ve gizlilik.

Değişken oluşturma

Düzenleyici ya da daha üst bir rolünüz olmalı. İzleyiciler listeyi görür ama değiştiremez.

1. Ayarlar → Değişkenler'e gidin.
2. Değişkenleriniz listesinin altındaki ekleme satırını doldurun:
   • Ad: süslü parantezlerin arasına yazacağınız ad, örneğin destek_hatti.
   • Değer: agent'ın onun yerine okuyacağı metin.
   • Açıklama (isteğe bağlı): ekibiniz için bir not.
3. Değişken ekle'ye tıklayın.

Alan	Kurallar
Ad	Küçük harf, rakam ve _. Bir harfle başlamalı. En fazla 40 karakter. Çalışma alanında benzersiz olmalı. Siz yazdıkça büyük harfler küçülür, diğer karakterler _ olur; ç, ş gibi Türkçe harfler de _ olur, bu yüzden destek_hatti gibi yazın.
Değer	En fazla 1.000 karakter. Boş olabilir.
Açıklama (isteğe bağlı)	En fazla 200 karakter. Yalnızca ekibiniz görür.

Yerleşik bir değişkenin adını kullanamazsınız; noktalı adlar yerleşik değişkenlere ayrılmıştır.

Bir değişkeni değiştirmek için satırındaki değeri ya da açıklamayı düzenleyip Kaydet'e tıklayın. Silmek için Sil'e tıklayıp onaylayın.

warning

Bir değişkeni silmek, onu kullanan bloklara dokunmaz. {{ad}} nerede geçiyorsa agent bir sonraki yanıttan itibaren orada boş değer alır. Silmeden önce prompt bloklarınızı kontrol edin.

Değişkeni prompt bloğunda kullanma

Bloğun metninde istediğiniz yere {{ad}} yazın ya da değişken seçiciyi kullanın:

1. Instructions sayfasını açın ve değerin geleceği bloğa tıklayın.
2. Bloğun sağ üstündeki { } (Değişken ekle) düğmesine tıklayın.
3. Bir yerleşik değişken ya da kendi değişkenlerinizden birini seçin. İmlecin olduğu yere eklenir.

Seçicide Ayarlar → Değişkenler'e giden bir Değişkenleri yönet bağlantısı da var.

Parantezlerin içinde boşluk olabilir; {{ destek_hatti }} da çalışır. Bir e-ticaret mağazası için örnek blok:

Müşteri bir ürünü iade etmek isterse, iadelerin teslimattan sonraki
{{iade_gun}} gün içinde kabul edildiğini söyle. Diğer her konu için
{{destek_hatti}} numarasını arayabilir.

Blok, yerleşik olmayan ve çalışma alanında da bulunmayan bir ad kullanıyorsa şu uyarıyı gösterir: Bilinmeyen değişken {{ad}} — boş kalacak. Ayarlar → Değişkenler'den oluşturun. Taslak yine de kaydedilir; değişkeni oluşturana kadar o yer boş metin olarak gider.

Değişkenler nerede çalışır

Değişkenler yalnızca prompt bloklarında doldurulur. Başka yerlerdeki metin olduğu gibi gider, yani {{destek_hatti}} şuralarda aynen kalır:

• skill talimatları,
• tool ve Fonksiyon açıklamaları, URL'leri ve header'ları,
• knowledge kaynakları,
• yedek yanıt ve guardrail yanıtları.

Sonucu görmek için Instructions sayfasında Son prompt'u önizle'ye tıklayın. Önizleme her bloğu değişkenleri doldurulmuş hâliyle gösterir. Bkz. Test etme.

Değişkenler ve sürümler

Değişkenler agent sürümünün parçası değildir. Ayarlar'da bir değeri değiştirmek yayındaki agent'ı yayınlamaya gerek kalmadan hemen etkiler; eski bir sürümü geri yüklemek de eski değişken değerlerini geri getirmez. Bir değişikliğin yalnızca yayınla birlikte çıkmasını istiyorsanız değeri doğrudan bloğun içine yazın.

Gizli anahtarlar

Gizli anahtar nedir

Gizli anahtar, bir tool ya da Fonksiyonun sistemlerinizi çağırmak için ihtiyaç duyduğu API anahtarı, bearer token ya da benzeri bir kimlik bilgisidir: mağazanızın sipariş API'si, randevu sisteminiz, CRM'iniz. Peki onu şifreli saklar ve istek çıkmadan hemen önce kendi tarafında isteğe ekler. Yapay zekâ değeri hiç görmez; yalnızca tool'un var olduğunu bilir.

Her gizli anahtarın şu parçaları vardır:

Parça	Anlamı
Ajan	Tool ve Fonksiyonları bu anahtarı kullanabilen tek agent. Aynı çalışma alanında bile olsa başka bir agent'ın tool'ları kullanamaz.
Ad	Sizin seçtiğiniz bir etiket, örneğin ShopX API. En fazla 80 karakter, agent içinde benzersiz. Fonksiyonlar gizli anahtarlara bu adla başvurur.
Değer	Anahtarın kendisi. 4 ile 4.000 karakter arası (Fonksiyonlar en az 8 karakter ister). Kaydettikten sonra yalnızca son dört karakteri ····a1b2 şeklinde görünür.
İzin verilen siteler	Anahtarın gönderilebileceği tek adresler: api.magazaniz.com gibi bir alan adı ya da tüm alt alan adları için *.magazaniz.com. En fazla 10 site.

İki tür gizli anahtar vardır:

• Anahtar (olağan tür): tool ve Fonksiyonlar tarafından izin verilen sitelerine gönderilir.
• İmzalama anahtarı: bir webhook imzalama anahtarı. Yalnızca webhook tetikleyicisine gelen isteklerin imzalarını kontrol etmek için kullanılır. Peki onu hiçbir yere göndermez, bu yüzden izin verilen sitesi yoktur. Bkz. Tetikleyiciler.

Tool kurarken gizli anahtar ekleme

En hızlı yol budur, çünkü izin verilen site sizin için doldurulur.

1. Tools sayfasında tool'u açın ve API anahtarı altında anahtarın nasıl gönderileceğini seçin: Bearer token ya da Başlıkta anahtar (sonra Başlık adı'nı yazın). Anahtar yok seçilirse tool anahtar göndermez.
2. Anahtar seçin listesini açın ve + Yeni anahtar ekle'yi seçin.
3. Alanları doldurun:
   • Anahtar adı, ör. ShopX API
   • Anahtarı yapıştırın: yazarken alan maskelenir.
   • İzin verilen siteler: boş bırakırsanız Peki tool'un URL'sindeki alan adını kullanır.
4. Anahtarı kaydet'e tıklayın. Yeni anahtar tool için seçilir.

Fonksiyonlarda aynı seçici Anahtarlar altındadır. Anahtarın gideceği yer'i seçin:

• Header: varsayılan olarak Authorization: Bearer <anahtar>. Başka bir header kullanmak için Header adı yazın.
• Query: anahtar, adını verdiğiniz Query parametresi olarak eklenir.

Fonksiyonun kodu değeri hiç tutmaz. Anahtarı adıyla ister; ağ proxy'si anahtarı yalnızca hem Fonksiyonun hem de anahtarın izin verdiği sitelere giden isteklere ekler. Bkz. Fonksiyonlar.

Ayarlar'dan gizli anahtar ekleme

1. Ayarlar → Gizli anahtarlar'a gidin.
2. Listenin altındaki formda Ajan'ı seçin, anahtar adını yazın, anahtarı yapıştırın ve en az bir izin verilen site girin (birden fazlası için virgülle ayırın).
3. Anahtarı kaydet'e tıklayın.

Önce bir agent'ınız olmalı, çünkü her anahtar tek bir agent'a aittir. Ayarlar → Gizli anahtarlar anahtarları agent'a göre gruplar.

ipucu

Anahtarı Copilot'a API anahtarı kartıyla da verebilirsiniz. Anahtarı doğrudan Copilot sohbetine yapıştırırsanız Peki onu model mesajı görmeden önce siler.

Gizli anahtarlar nasıl görünür

Bir anahtarı kaydettikten sonra değerini kimse tekrar okuyamaz: ne siz, ne bir yönetici, ne de yapay zekâ. Peki yalnızca şunları gösterir:

• adı,
• son dört karakteri (····a1b2),
• izin verilen siteleri (Yalnızca şuraya gönderilir: api.magazaniz.com).

Bir API anahtarı geri yansıtırsa (örneğin bir hata mesajında), Peki onu yanıtta değiştirir; yapay zekâ da tool'un Dene paneli de anahtarı görmez. Uzun bir anahtar ···· ve son dört karakteriyle, 8 karakter ya da daha kısa bir anahtar yalnızca ···· olarak görünür.

İzin verilen siteler

Bir anahtar yalnızca kaydedildiği sitelere gider. Biri tool'un URL'sini başka bir adrese çevirirse anahtar gönderilmez ve çağrı açık bir hatayla başarısız olur. Bir tool'u düzenleyebilen birinin anahtarınızı kendi sunucusuna göndermesini engelleyen şey budur.

• Düz alan adı kullanın: https://api.magazaniz.com/v1 değil, api.magazaniz.com.
• *.magazaniz.com, api.magazaniz.com ve eu.api.magazaniz.com gibi tüm alt alan adlarıyla eşleşir, ama magazaniz.com'un kendisiyle eşleşmez.
• Tool'un adresi anahtarın siteleri arasında değilse tool şunu gösterir: Bu anahtar yalnızca … adresine gönderilebilir, … adresine değil.

Bir anahtarın sitelerini yalnızca yöneticiler, Ayarlar → Gizli anahtarlar'daki Siteleri değiştir ile değiştirebilir. Bir anahtarı yeni bir siteye yöneltmek tam olarak onun okunabileceği yoldur; bu yüzden düzenleyiciler bunu yapamaz.

Kim neyi yapabilir

İşlem	Gereken rol
Anahtar listesini görmek (ad, son dört karakter, siteler)	Düzenleyici
Anahtar eklemek	Düzenleyici
Bir tool ya da Fonksiyon için anahtar seçmek	Düzenleyici
Bir anahtarın izin verilen sitelerini değiştirmek	Yönetici
Atanmamış bir anahtarı bir agent'a atamak	Yönetici
Anahtarı kaldırmak	Yönetici

Bkz. Üyeler ve roller.

Atanmamış anahtarlar

Anahtarlar agent'lara ait olmadan önce kaydedilmiş anahtarlar, Ayarlar → Gizli anahtarlar'da Atanmamış altında görünür. Bir yönetici Ata… ile bir agent seçene kadar hiçbir tool bunları kullanamaz. Bir anahtar bir agent'a atandıktan sonra başka bir agent'a taşınamaz, çünkü bu ilk agent'ın tool'larını sessizce bozar. Diğer agent için yeni bir anahtar ekleyin.

Anahtarı yenileme (rotation)

Kayıtlı bir anahtarın değerini düzenleyemezsiniz. Değiştirmek için yeni bir anahtar ekleyip ona geçersiniz. HTTP tool'ları bir anahtara kimliğiyle, Fonksiyonlar ise adıyla bağlanır; bu yüzden adımlar farklıdır.

HTTP tool'ları için:

1. Yeni anahtarı aynı agent'a yeni bir adla ekleyin, örneğin ShopX API 2026.
2. Eski anahtarı kullanan her tool'da API anahtarı altında yenisini seçin.
3. Yayınla'ya tıklayın. Tool ayarları agent sürümünün parçasıdır; yayınlayana kadar canlı agent eski anahtarı kullanmaya devam eder.
4. Ayarlar → Gizli anahtarlar'da eski anahtarı kaldırın.

Fonksiyonlar için:

1. Ayarlar → Gizli anahtarlar'da eski anahtarı kaldırın.
2. Yeni anahtarı aynı agent'a tam olarak aynı adla ekleyin.

Fonksiyon yeni anahtarı bir sonraki çağrısında, yayınlamaya gerek kalmadan kullanır. İki adım arasında yapılan çağrılar başarısız olur; bu yüzden trafiğin az olduğu bir saatte yapın. Hiç kesinti istemiyorsanız yeni anahtara yeni bir ad verin, Fonksiyonda Anahtarlar altında onu seçin, yayınlayın, sonra eski anahtarı kaldırın.

warning

Bir anahtarı kaldırmak, onu kullanan her tool'u bozar. Başka bir anahtar seçene kadar çağrıları The API key for this tool was deleted hatasıyla başarısız olur. Eski anahtarı kendi sisteminizde iptal etmeyi, geçiş canlıya çıktıktan sonraya bırakın.

Karşılaşabileceğiniz hatalar

Bu hatalar tool sonucunda ve izde İngilizce görünür.

Hata	Anlamı	Ne yapmalı
The API key for this tool was deleted	Seçili anahtar kaldırılmış.	Tool için başka bir anahtar seçin ve yayınlayın.
This API key belongs to another agent	Tool, anahtarıyla birlikte başka bir agent'tan kopyalanmış.	Bu agent için bir anahtar ekleyin.
This API key is not assigned to an agent yet	Anahtar atanmamış.	Bir yöneticiden atamasını isteyin.
This API key may only be sent to …	Tool'un URL'sindeki alan adı, anahtarın izin verilen siteleri arasında değil.	URL'yi düzeltin ya da bir yöneticiden siteyi eklemesini isteyin.
This API key has no allowed sites yet	Anahtarın sitesi yok.	Bir yöneticiden Siteleri değiştir ile site eklemesini isteyin.
This key is a webhook signing key	Giden bir çağrı için imzalama anahtarı seçilmiş.	Normal bir anahtar seçin.

İlgili sayfalar

• Instructions
• Tools
• Fonksiyonlar
• Guardrails ve gizlilik
• Tetikleyiciler
• Üyeler ve roller
• Güvenlik modeli