Temel kavramlar
Bu sayfa Peki'nin her yerinde karşınıza çıkan fikirleri ve bunların nasıl bir araya geldiğini anlatır. Bir kez okuyun, dokümanların geri kalanı kolayca yerine oturur. Her terimin kısa tanımı için Sözlük sayfasına bakın.
Büyük resim
Bir çalışma alanı ekibinizi ve agent'larınızı tutar. Her agent'ın düzenlediğiniz bir taslağı ve müşterilerin konuştuğu yayınlanmış sürümleri vardır. Müşteriler yayınlanmış sürüme kanallar üzerinden ulaşır. Her görüşme bir müşteriyle yapılan bir konuşmadır ve ekibiniz tüm konuşmaları Inbox'tan takip eder.
Çalışma alanı
Çalışma alanı kendi agent'ları, kanalları, ekibi, anahtarları ve kredileri olan ayrı bir alandır. Çalışma alanları arasında hiçbir şey paylaşılmaz. Çoğu kişiye bir tane yeter; birden çok müşteriye hizmet veren bir ajans her müşteri için ayrı bir tane kullanabilir.
Bir çalışma alanında şunlar bulunur:
- Bir ad, bir varsayılan dil (Türkçe ya da İngilizce) ve bir para birimi (USD, EUR ya da TRY).
- Bir saat dilimi ve çalışma saatleri. Bunlar otomasyonlarda, "çalışma saatlerinde" ya da "çalışma saatleri dışında" geçerli talimat bloklarında ve agent'ın güncel tarih ve saat bilgisinde kullanılır.
- Her birinin bir rolü olan üyeler.
- Peki'yi kendi sistemlerinizden çağırmak için API anahtarları.
- Bir plan ve bir kredi bakiyesi.
Birden çok çalışma alanına üye olup aralarında geçiş yapabilirsiniz. Bkz. Hesaplar ve çalışma alanları.
Üyeler ve roller
Bir çalışma alanındaki herkesin bir rolü vardır. Her rol, kendinden önceki rollerin yapabildiği her şeyi yapabilir.
| Rol | Neler yapabilir |
|---|---|
| İzleyici | Yalnızca okur. |
| Operatör | Inbox'ta müşterilere yanıt verir: devralır, yanıtlar, geri verir, çözer. |
| Düzenleyici | Agent kurar: taslağı düzenler, Copilot'u kullanır, test eder, yayınlar. |
| Yönetici | Üyeler, API anahtarları, gizli anahtarlar ve çalışma alanı ayarları. |
| Sahip | Diğer sahipleri eklemek, çıkarmak ve çalışma alanını silmek dahil her şey. |
Tam liste için Üyeler ve roller sayfasına bakın.
Agent
Agent, tek bir işi olan bir AI asistanıdır; örneğin "Moda Diş ön büro" ya da "ShopX sipariş desteği". Kendi talimatları, tool'ları, Knowledge kaynakları, kanalları, konuşmaları ve analizleri vardır. Bir çalışma alanında birçok agent olabilir ve agent'lar bir agent ekibi olarak birbirinden yardım isteyebilir.
Bir agent şunlardan oluşur:
- Instructions: her zaman uyduğu sıralı prompt blokları. Bir blok Her zaman aktif ya da Koşullu olabilir: yalnızca bir kanalda, yalnızca çalışma saatlerinde ya da dışında, yalnızca belirli bir etiketi olan müşteriler için ya da yalnızca müşteri belirli bir dilde yazdığında.
- Tools: her biri agent'ın yapabileceği tek bir API çağrısı olan HTTP tool'lar.
- Fonksiyonlar: kilitli bir alanda çalışan küçük TypeScript programları.
- Skills: yalnızca belirli bir soru türü için yüklenen adım adım yöntemler.
- Knowledge: agent'ın aradığı belgeler, web sayfaları ve metinler.
- Ayarlar: model ve yedek model, sıcaklık, hafıza, oturumlar, bağlam, yedek yanıt, guardrails, devretme, web araması ve ekip.
- Records tabloları: topladığı verinin alanları.
- Automations: kendi kendine yaptığı işler.
- Channels: müşterilerin ona ulaştığı yerler.
Agent'larınızda arama yapıp birine geçmek için Peki panelinin her yerinde ⌘K (Windows ve Linux'ta Ctrl+K) kullanın.
Taslak ve yayınlanmış sürümler
Her agent'ın tam olarak bir taslağı ve istediği kadar yayınlanmış sürümü vardır.
- Taslak, sizin ve Copilot'un düzenlediği kopyadır. Siz çalıştıkça kaydedilir. Test paneli her zaman taslağı kullanır.
- Yayınlamak taslağı bir sonraki numaralı sürüm (v1, v2, v3…) yapar ve bağlı tüm kanallarda aynı anda canlıya alır. Neyin değiştiğine dair kısa bir not ekleyebilirsiniz.
- Canlı sürüm, müşterilerin konuştuğu sürümdür. Aynı anda yalnızca bir tane olur.
- Geri yüklemek önceki bir sürümü taslağa kopyalar. Geçmiş olduğu gibi kalır ve siz yeniden yayınlayana kadar hiçbir şey canlıya çıkmaz.
Instructions başlığında taslak numarası ve yayınlanmamış değişiklik sayısı görünür. Instructions → Versions her sürümü, kimin yayınladığıyla birlikte listeler ve herhangi bir sürümü canlı sürümle karşılaştırabilir.
Bazı şeyler sürümlenmez ve hemen uygulanır:
| Hemen uygulanır | Yayınlamayı bekler |
|---|---|
| Kanal ayarları (web sitesi sohbetinin görünümü, izin verilen siteler, Telegram açık ya da kapalı) | Talimatlar, tool'lar, Fonksiyonlar, skill'ler |
| Knowledge kaynakları | Model, hafıza, guardrails, devretme, web araması, ekip |
| Çalışma alanı değişkenleri | Records tablo ayarları |
| Çalışma saatleri | Örnek sorular |
Kayıtlarınız hiçbir zaman sürümlenmez: eski bir sürümü geri yüklemek hiçbir potansiyel müşteriyi ya da randevuyu silmez. Bkz. Yayınlama ve sürümler.
Yayınlamak için paket gerekir. Ücretsiz planda kurabilir, test edebilir ve kanalları bağlayabilirsiniz, ama Yayınla kilitlidir. Bkz. Planlar ve krediler.
Copilot
Copilot, Peki panelinin içinde agent'ı sizinle birlikte kuran bir AI asistanıdır. Ne istediğinizi sade bir dille söylersiniz; taslağı düzenler, API'leri araştırır, tool ve Fonksiyon yazar, her şeyi gerçek çağrılarla ve deneme sohbetleriyle test eder ve size rapor verir.
- Her agent için bir sohbet. Her agent'ın, tüm kurulum geçmişini tutan tek bir Copilot sohbeti vardır.
- Kartlar. Copilot size ihtiyaç duyduğunda durur ve bir kart gösterir: bir seçim için seçenek kartları, bir API anahtarı için güvenli bir alan, bir bot token'ı için Telegram kartı ve yayınlamak gibi gerçek etkisi olan her şey için onay kartları.
- Geri alma. Copilot'un her turu Bu turu geri al ile geri alınabilir.
- Maliyet. Her yanıtın altında maliyeti yazar. Copilot kredi kullanır.
- Model. Copilot'un modelini mesaj kutusunun hemen üstünden seçersiniz. Bu, agent'ınızın müşterilere yanıt verirken kullandığı modelden ayrıdır.
Bkz. Copilot'a genel bakış.
Agent belgesi
Belge sayfası agent'ı sade bir dille, on bölümde anlatır: işletme, görev, neler yapabildiği, neleri aldığı, neleri verdiği, sınırlar, devretme, üslup ve diller, kanallar ve açık konular. Copilot belgeyi kurulum sırasında yazar ve agent'ı değiştirdikçe güncel tutar.
Herhangi bir bölümü düzenleyebilirsiniz. Copilot sizin yazdığınız bir bölümün üzerine asla yazmaz: önerisini sizinkinin yanında gösterir, kararı siz verirsiniz. Bir bölümü düzenledikten sonra Ajana uygula düğmesi Copilot'tan uygun değişiklikleri yapmasını ister. Belgeyi Markdown ya da PDF olarak indirebilirsiniz. Bkz. Agent belgesi.
Kanallar
Kanal, müşterilerin agent'a ulaştığı yerdir:
- Web sitesi sohbeti: web sitenizde tek satır kodla eklenen bir sohbet balonu ya da sayfa içi bir sohbet kutusu.
- Telegram: agent'ın yanıt verdiği kendi Telegram botunuz.
- Sessions API: kendi uygulamanız ya da sohbet ekranınız için, akışlı yanıtlarla.
Müşteriler her kanalda her zaman yayınlanmış sürümle konuşur. Bkz. Kanallara genel bakış.
Konuşmalar ve oturumlar
Konuşma (ya da oturum), bir müşteriyle bir agent arasındaki tek bir görüşmedir. Mesajları, varsa dosyaları, her yanıtın trace kaydını, devretme olaylarını ve müşterinin değerlendirmesini tutar.
Yeni bir konuşma şöyle başlar:
- Web sitesi sohbetinde müşteri yeni konuşma düğmesine tıklayabilir. Telegram'da
/newgönderebilir. Sessions API'de uygulamanız bir oturum başlatır. - Aksi halde müşterinin mesajı son konuşmasının devamı olur; o konuşma çözülmüşse ya da çok uzun süre sessiz kalmışsa yeni bir konuşma başlar. Varsayılan süre 24 saattir; agent'ın Memory ayarlarından 1 saat, 7 gün ya da hiçbir zaman (yalnızca çözülünce) olarak değiştirebilirsiniz.
İki tür konuşma vardır:
- Canlı konuşmalar gerçek müşterilerle ve yayınlanmış sürümle yapılır. Analytics'te sayılır.
- Test konuşmaları Test panelinden gelir ve taslağı kullanır. Inbox'ta "Test paneli" olarak görünür ve Analytics'te asla sayılmaz.
Her yanıt bir trace kaydı tutar: model, kullanılan prompt blokları, tool'lar, skill'ler ve Knowledge, token ve süre. Görmek için Inbox'ta yanıtın altındaki Neden? bağlantısına tıklayın.
Müşteriler
Müşteri, agent'ınızla konuşan kişidir. Biri bir kanaldan ilk kez yazdığında Peki onu otomatik olarak oluşturur. Bir müşterinin adı (biliniyorsa), etiketleri, notları, kullandığı kanal ve kullanıcı adı, dili, ilk görülme zamanı ve konuşmaları vardır.
Müşterinin adını, etiketlerini ve notlarını Inbox'ta Müşteri bilgileri bölümünden düzenleyebilirsiniz. Müşteri profili ayarı açıkken agent müşterinin adını ve etiketlerini görür; böylece "vip etiketli müşteriler için" gibi bir blok devreye girebilir. Bkz. Müşteriler.
Devretme ve Inbox
Devretme (handoff), müşterinin bir kişiye ulaşma yoludur. Müşteri bir kişi istediğinde ya da devretme kuralınız gerektirdiğinde konuşma Inbox'ta Sizi bekliyor altında görünür. Bir ekip arkadaşı Devral düğmesine basana kadar agent yardım etmeye devam eder. Konuşma bir ekip arkadaşındayken agent sessiz kalır. AI'a geri ver konuşmayı agent'a geri verir, Çözüldü konuşmayı kapatır. Bkz. Bir kişiye devretme.
Records ve onaylar
Records, agent'ın topladığı potansiyel müşteriler, randevular, siparişler ve destek talepleri gibi verilerin tutulduğu kendi tablolarınızdır. Agent müşterinin anlattıklarını kaydeder; konuşma sessizleştikten sonra bir doldurma işlemi tabloyu tamamlayabilir. Bkz. Records.
Onaylar, ekibinizin bir işlemi gerçekleşmeden önce kontrol etmesini sağlar: bir tool çağrısı, bir Fonksiyon, bir tablo kaydı ya da bir otomasyon mesajı. İşlem biri onaylayana, düzenleyip onaylayana ya da reddedene kadar Inbox → Onaylar bölümünde bekler. İstekler 24 saat sonra sona erer. Bkz. Onaylar.
Automations
Otomasyonlar agent'ın kendi kendine çalışmasını sağlar: bir zamanlamayla, başka bir sistem webhook'unu çağırdığında ya da Peki içinde bir şey olduğunda (bir Peki olayı). Tipik bir otomasyon bir şeyi bir Fonksiyon ile ucuzca kontrol eder, yalnızca bir şey değiştiyse devam eder, ardından agent'ın bir mesaj yazmasına izin verir ve bunu Telegram'a gönderir. Bkz. Automations ve Tetikleyiciler.
Krediler ve planlar
Yapay zekâ kullanan her şey kredi harcar: Copilot ile kurmak, test sohbetleri, agent'larınızın yanıtları, otomasyonlar, kayıt doldurma, analiz ve Knowledge kaynaklarının okunması. 1 kredi 0,01 $ değerindedir.
- Yeni bir kullanıcının ilk çalışma alanı bir kez 500 ücretsiz kredi alır.
- Ücretsiz plan ile kurabilir, test edebilir ve kanalları bağlayabilirsiniz. Yayınlamak için paket gerekir. Paketler yakında geliyor.
- Kredi bitince Copilot, testler, otomasyonlar ve yeni Knowledge kaynakları bir mesajla durur. Kurduğunuz hiçbir şey kaybolmaz. Ücretli çalışma alanlarındaki yayında agent'lar müşterilere yanıt vermeye devam eder.
Ayarlar → Plan ve kredi planınızı, bakiyenizi, bu ay kullandığınızı ve her değişikliğin geçmişini gösterir. Bkz. Planlar ve krediler ve Kullanım.
Varsayılan olarak gizlilik
Peki'nin her yerinde geçerli birkaç kural:
- Kişisel veriler maskelenir. Adlar (isteğe bağlı), telefon numaraları, e-postalar, TC kimlik numaraları, kart numaraları ve IBAN'lar model görmeden önce
[PHONE_1]gibi yer tutuculara dönüşür. Tool'larınız yine gerçek değerleri alır. - Anahtarlar modele asla ulaşmaz. Şifreli saklanır, tek bir agent'a aittir ve yalnızca izin verdiğiniz sitelere gönderilir.
- Model çağrıları yalnızca veri saklamayan sağlayıcılara gider ve verileriniz asla model eğitiminde kullanılmaz.
- Gerçek etkisi olan her şey bir kişinin onayını ister: yayınlamak, geri yüklemek, Copilot'un widget değişiklikleri, Copilot testleri sırasındaki yazma işlemleri ve otomasyonların yazma işlemleri.
Bkz. Veri ve gizlilik ve Güvenlik modeli.