Peki'ye hoş geldiniz
Peki, müşterilerinizle konuşan, onlar için gerçek işler yapan ve bir kişiye ihtiyaç olduğunda konuşmayı ekibinize devreden AI agent'ları kurduğunuz yerdir. Ne istediğinizi anlatırsınız, Copilot agent'ı sizinle birlikte kurar ve test eder, siz de onu web sitesi sohbetinize, Telegram'a ya da kendi uygulamanıza yayınlarsınız.
Bu dokümanlar Peki'nin her parçasını anlatır: her özelliğin ne yaptığı, her ayar ve sınır, bir şey ters gittiğinde ne yapmanız gerektiği.
Peki kimler için
- İşletmeler: web sitesinde ya da Telegram'da bir agent isteyen herkes. "Siparişim nerede?" sorusunu yanıtlayan bir e-ticaret mağazası, randevu talebi alan bir diş kliniği, yardım merkezinden yanıt veren bir yazılım destek ekibi.
- İçerik üreticileri ve küçük ekipler: içeriğini bilen, potansiyel müşteri toplayan ve kod yazmadan uyarı gönderen bir asistan isteyenler.
- Geliştiriciler: bir agent'ı kendi uygulamasının arkasına koymak, ondan kendi API'lerini çağırmak, küçük TypeScript Fonksiyonları yazmak ya da otomasyonları webhook ile başlatmak isteyenler.
AI modellerinin nasıl çalıştığını bilmeniz gerekmez. Copilot sade sorular sorar ve kurulumu kendisi yapar. Biliyorsanız da her parçayı elle düzenleyebilirsiniz.
Bir agent neler yapabilir
Bir agent müşterilerinize kendi dillerinde, günün her saatinde, ona verdiklerinizle yanıt verir. Nasıl kurduğunuza bağlı olarak şunları yapabilir:
- Belgelerinizden ve web sayfalarınızdan yanıt vermek (Knowledge).
- Sistemlerinizde API üzerinden bilgi aramak ya da bir şeyi değiştirmek (Tools ve Fonksiyonlar).
- Belirli bir soru türü için adım adım bir yöntemi izlemek (Skills).
- Müşterinin söylediklerini potansiyel müşteri, randevu ya da sipariş gibi kendi tablolarınıza kaydetmek (Records).
- Önemli bir işlemden önce ekibinizin onayını beklemek (Onaylar).
- Müşteri istediğinde ya da kurallarınız gerektirdiğinde bir kişiyi konuşmaya çağırmak (Handoff).
- Bir zamanlamayla ya da başka bir sistem çağırdığında kendi kendine çalışmak ve size Telegram mesajı göndermek (Automations).
- Çalışma alanınızdaki diğer agent'lardan yardım isteyip tek bir yanıt yazmak (Ekip).
- Müşterilerin gönderdiği fotoğrafları ve belgeleri okumak (Dosyalar).
Yapı taşlarında kısa bir tur
Her agent aynı parçalardan oluşur. Her birinin kenar çubuğunda kendi sayfası vardır.
| Yapı taşı | Nedir | Ayrıntılar |
|---|---|---|
| Copilot | Peki panelinin içindeki, agent'ı sizinle birlikte kuran ve değiştiren AI asistanı. Taslağı düzenler, her parçayı gerçek çağrılarla test eder ve gerçek etkisi olan her şeyden önce onayınızı bekler. | Copilot'a genel bakış |
| Belge | Agent'ın sade bir dille anlatımı: işletme, görev, neler yapabildiği, sınırlar, devretme, üslup ve kanallar. Copilot güncel tutar. | Agent belgesi |
| Instructions | Agent'ın her zaman uyduğu sıralı prompt blokları: kim olduğu, üslubu, dili, kesin kuralları. Bir blok yalnızca bir kanalda, çalışma saatlerinde ya da etiketli müşteriler için geçerli olabilir. | Instructions |
| Tools | Agent'ın konuşma sırasında yapabileceği işlemler. HTTP tool, bir API'ye yapılan tek bir çağrıdır. | Tools |
| Fonksiyonlar | Kilitli bir alanda çalışan küçük TypeScript programları: birkaç API çağrısı, hesaplamalar, veriyi yeniden biçimlendirme. | Fonksiyonlar |
| Skills | Agent'ın yalnızca uygun bir soru geldiğinde yüklediği adım adım yöntemler; böylece her zaman geçerli talimatlar kısa kalır. | Skills |
| Knowledge | Agent'ın yanıt vermeden önce aradığı belgeler, web sayfaları ve metinler. | Knowledge |
| Değişkenler ve gizli anahtarlar | İşletme adınız gibi tekrar kullanılan değerler ve tool'larınızın kullandığı şifreli API anahtarları. | Değişkenler ve gizli anahtarlar |
| Model ve davranış | Model ve yedek model, hafıza, oturumlar, yedek yanıt ve web araması. | Model ve davranış |
| Guardrails | Her mesajda ve yanıtta yapılan kontroller: prompt injection, konu dışı sorular, talimat sızıntısı, saldırgan mesajlar ve kişisel verilerin maskelenmesi. | Guardrails ve gizlilik |
| Records | Agent'ın topladığı ve sakladığı kendi veri tablolarınız. | Records |
| Onaylar | Ekibinizin bir işlemi çalışmadan önce kontrol ettiği sıra. | Onaylar |
| Automations | Agent'ın kendi kendine yaptığı işler: bir zamanlamayla, bir webhook'tan ya da bir Peki olayında. | Automations |
| Ekip | Bu agent'ın yanıt verirken danışabildiği diğer agent'lar. | Agent ekipleri |
| Channels | Müşterilerin agent'a ulaştığı yerler: web sitesi sohbeti, Telegram ve Sessions API. | Kanallara genel bakış |
| Inbox | Tüm konuşmalar tek yerde. Ekibiniz izler, devralır ve yanıtlar. | Inbox |
| Analytics | Agent'ın ne kadar iyi yanıt verdiği ve ne kazandırdığı. | Analytics |
Taslak ve yayınlanmış sürümler
Her agent'ın sizin ve Copilot'un düzenlediği bir taslağı, müşterilerin konuştuğu yayınlanmış sürümleri vardır. Testler taslağı kullanır. Yayınlamak taslağı bir sonraki canlı sürüm yapar ve bağlı tüm kanallarda aynı anda canlıya alır. Önceki herhangi bir sürümü taslağa geri yükleyebilirsiniz. Bkz. Yayınlama ve sürümler.
Bazı ayarlar yayınlamadan hemen uygulanır: kanal ayarları, Knowledge kaynakları ve çalışma alanı değişkenleri. Agent'taki diğer her şey Yayınla düğmesini bekler.
Bir müşteri konuşması nasıl ilerler
Bir müşteri yazdığında Peki agent'ı hazırlar, kişisel verileri modelden gizler, agent'ın tool'larını kullanmasına izin verir, yanıtı kontrol eder ve her şeyi kaydeder. Her yanıtı oluşurken Inbox'ta izleyebilirsiniz.
Bu akışla ilgili bilmeniz gerekenler:
- Müşteriler her zaman yayınlanmış sürümle konuşur. Taslakta yaptığınız değişiklikler siz yayınlayana kadar onlara ulaşmaz.
- Kişisel veriler modelin dışında kalır. Adlar, telefon numaraları, e-postalar, TC kimlik ve kart numaraları modele yalnızca yer tutucu olarak ulaşır. Tool'larınız yine gerçek değerleri alır.
- Model anahtarlarınızı asla görmez. Anahtarlar bir isteğe yalnızca çıkış anında ve yalnızca izin verdiğiniz siteler için eklenir.
- Müşteri asla boş bir mesaj almaz. Tüm modeller başarısız olursa, belirlediyseniz agent yedek yanıtınızı gönderir.
- Her yanıtın bir trace kaydı vardır. Inbox'ta Neden? bağlantısı, yanıtın hangi prompt bloklarını, skill'leri, tool'ları ve Knowledge kaynaklarını kullandığını, token ve süreyle birlikte gösterir.
Nereden başlamalı
- Peki'de yeni misiniz? Hızlı başlangıç rehberini izleyin: giriş yapın, ilk agent'ınızı Copilot ile kurun, test edin, yayınlayın ve sohbeti sitenize ekleyin.
- Önce kavramları öğrenmek mi istiyorsunuz? Temel kavramlar sayfasını okuyun.
- Ekibinizi mi kuruyorsunuz? Hesaplar ve çalışma alanları ve Üyeler ve roller sayfalarına bakın.
- Kodla mı çalışıyorsunuz? API'ye genel bakış ile başlayın.
- Bir sorunla mı karşılaştınız? Sorun giderme, SSS ve Sınırlar sayfalarına bakın.