Knowledge
Knowledge, agent'ınızın yanıt verirken başvurduğu kaynaklardır: fiyat listeleri, politikalar, kılavuzlar, sık sorulan sorular, web sitenizin sayfaları. Kaynakları agent'ın Knowledge sayfasından eklersiniz. Peki her müşteri mesajında bu kaynaklarda arama yapar ve eşleşen bölümleri modele verir; böylece agent tahmin etmek yerine sizin belgelerinizden yanıt verir.
Buradaki değişiklikler agent'a hemen uygulanır — yayınlamak gerekmez. Knowledge, taslağın ya da sürümlerin parçası değildir.
Kaynak ekleme
Knowledge sayfasında listenin altından üç kaynak türünden birini seçin.
Dosya yükle
Dosya yükle'ye tıklayın ve bir ya da daha fazla dosya seçin.
| Desteklenen | Sınır |
|---|---|
PDF (.pdf) | Dosya başına en fazla 10 MB ve en fazla 300 sayfa. PDF metin içermelidir: metin katmanı olmayan taranmış bir PDF'te okunacak bir şey yoktur. |
Düz metin (.txt) | En fazla 10 MB, UTF-8 olarak okunur. |
Markdown (.md, .markdown) | En fazla 10 MB, UTF-8 olarak okunur. |
CSV (.csv) | En fazla 10 MB, metin olarak okunur. |
Peki yalnızca dosyanın adına değil, içeriğine de bakar: adı .pdf ya da .txt olarak değiştirilmiş bir görsel ya da HTML sayfası reddedilir. Diğer türler (Word, Excel, görseller) desteklenmez. Bunları PDF olarak dışa aktarın ya da metni Metin yaz ile yapıştırın. Başka bir dosya türü Use a PDF, TXT, Markdown or CSV file hatası verir.
Web sayfası ekle
Web sayfası ekle'ye tıklayın, sayfanın http:// ya da https:// adresini girin ve Ekle'ye tıklayın.
- Tek bir sayfa şu anki haliyle okunur. Menüler, betikler ve alt bilgiler dahil edilmez. Peki yalnızca o sayfayı okur, bağlantı verdiği sayfaları okumaz. İhtiyacınız olan her sayfayı ayrı ekleyin.
- Sayfa 20 saniye içinde başarılı bir durum koduyla yanıt vermeli, HTML'i en fazla 1 MB olmalıdır.
- Peki sunucunun gönderdiği HTML'i okur. Sayfanın sonradan JavaScript ile yüklediği metin görülmez. Bir sayfa boş ya da hatalı çıkıyorsa metnini Metin yaz ile yapıştırın.
- Giriş gerektiren sayfalar ile özel ya da yerel adresler okunamaz.
- Sayfa kendiliğinden güncellenmez. Değiştiğinde Yeniden işle'ye tıklayın.
Metin yaz
Metin yaz'a tıklayın, bir başlık verin ("İade politikası" gibi) ve içeriği yapıştırın ya da yazın.
| Alan | Sınır |
|---|---|
| Başlık | En fazla 120 karakter |
| Metin | En fazla 200.000 karakter |
Yazılan metin en güvenilir kaynaktır: metin çıkarma yoktur, agent'ın tam olarak neyi okuyacağını siz belirlersiniz. Eklendikten sonra düzenlenemez; değiştirmek için yeni metni ekleyip eski kaynağı kaldırın.
Bir dosyayı Copilot sohbetine ekleyip "Knowledge'a ekle" diyebilirsiniz. Kartı onayladığınızda kaynağı oluşturur. Otomasyonlar da Knowledge'a not ekleyebilir. Bkz. Automations.
İşleme durumu
Bir kaynak eklediğinizde Peki onu okur, bölümlere ayırır ve arama için dizine ekler. Her kaynak durumunu gösterir:
| Durum | Anlamı |
|---|---|
| İşleniyor | Okunuyor ve dizine ekleniyor… genellikle birkaç saniye sürer. Büyük PDF'ler daha uzun sürebilir. |
| Hazır | Agent bu kaynakta arama yapabilir. Satırda kaç bölümü olduğu görünür. |
| Başarısız | Bu kaynak okunamadı. Nedenini görmek için kaynağı açın. |
Sayfa başlığı toplamları gösterir: kaynak sayısı, hazır kaynaklardaki bölüm sayısı ve son güncelleme zamanı.
Hazır bir kaynağı açtığınızda agent'ın gerçekte okuduğu bölümleri numaralı ve uzunluklarıyla görürsünüz. İlk üçü gösterilir; hepsini görmek için Tümünü göster'e tıklayın. Bir PDF'in ya da web sayfasının doğru okunduğunu kontrol etmenin en iyi yolu budur.
Bir kaynak neden başarısız olur
Hata metinleri sunucudan İngilizce gelir.
| Hata | Neden | Ne yapmalı |
|---|---|---|
No readable text found | Dosyada ya da sayfada metin yok; örneğin taranmış bir PDF ya da JavaScript ile oluşturulan bir sayfa. | Gerçek metin içeren bir PDF kullanın ya da metni Metin yaz ile yapıştırın. |
PDF has 412 pages; the limit is 300 | PDF çok uzun. | Daha küçük dosyalara bölün. |
Reading the PDF took too long | PDF çok karmaşık. | Bölün ya da daha sade bir düzenle yeniden dışa aktarın. |
Could not read the PDF… | PDF bozuk ya da korumalı. | Şifresiz olarak yeniden dışa aktarın. |
The page answered HTTP 404 (ya da başka bir durum) | Sayfa yok ya da isteği reddetti. | Adresi bir tarayıcıda kontrol edin. |
Request timed out after 20000 ms | Sayfa 20 saniyeden uzun sürdü. | Tekrar deneyin ya da metni yapıştırın. |
Response too large (over 1000000 bytes) | Sayfanın HTML'i 1 MB'tan büyük. | Daha küçük bir sayfa kullanın ya da ilgili metni yapıştırın. |
Requests to … are not allowed (private or local network) | Adres özel ya da yerel. | Herkese açık bir sayfa kullanın. |
Agent nasıl arama yapar
Knowledge araması otomatiktir: modelin çağırmayı seçtiği bir tool değildir.
- Metin içeren her müşteri mesajında Peki agent'ın hazır kaynaklarında birebir kelimelerle değil, anlamla arama yapar. "Geri göndermek için ne kadar vaktim var?" sorusu "teslimattan sonra 14 gün içinde iade" geçen bir bölümü bulur.
- En fazla 4 bölüm, kaynağın adıyla birlikte modelin talimatlarına bir
## Knowledgebölümü olarak eklenir. Yeterince benzer olmayan bölümler dışarıda kalır; ilgisiz bir soruya hiç Knowledge bölümü eklenmez. - Modele bu bölümleri genel bilgisinden önce kullanması, kapsamadıkları bir soruda da bilmediğini söylemesi söylenir.
- Arama yalnızca müşterinin son mesajını kullanır. "Peki ayakkabıda?" gibi kısa bir devam sorusu yalnızca bu kelimelerle aranır.
- Yalnızca dosya içeren, metni olmayan bir mesajda arama yapılmaz.
- Kişisel veri koruması açıkken arama, kişisel verileri zaten yer tutucuya çevrilmiş mesajla yapılır.
- Her agent yalnızca kendi kaynaklarında arama yapar. Bir çalışma alanındaki iki agent knowledge paylaşmaz.
Test paneli, bir yanıtın kullandığı bölümleri Knowledge altında kaynak, bölüm numarası ve puanla gösterir. Bkz. Test etme.
Aramayı test et
Agent olmadan sorgu denemek için sayfanın üstündeki Aramayı test et'e tıklayın. Agent'ın her mesajda yaptığı aramanın aynısı. 1'e yakın puanlar daha iyi eşleşmedir. Puanı, kaynağı ve bölüm numarasıyla en fazla 5 sonuç gösterir. İlgili bir şey bulunamadı. Agent burada bilgi olmadan yanıt verirdi. mesajı, yeterince benzer bölüm olmadığı anlamına gelir.
Bir müşteri gibi sorun: "taksitle ödeyebilir miyim?", "taksit politikası" değil.
Yeniden işleme ve kaldırma
İşlemlerini görmek için bir kaynağı açın.
- Yeniden işle kaynağı yeniden okur ve bölümlerini yenileriyle değiştirir. Bir web sayfası değiştiğinde ya da başarısız bir kaynağı yeniden denemek için kullanın. Çalışırken kaynak İşleniyor görünür ve aramaya dahil edilmez; Hazır olunca yeniden aranabilir. Yeniden işleme başarısız olursa kaynak Başarısız görünür ve başarılı olana kadar aranmaz.
- Kaldır kaynağı, bölümlerini ve yüklenen dosyayı siler. Agent bunu hemen kullanmayı bırakır; kaldırılan kaynaklar bundan sonra hiçbir aramada bulunamaz. Bu işlem geri alınamaz.
Bir dosyayı güncellemek için yeni sürümünü yükleyin ve eskisini kaldırın.
Krediler
Bir kaynağı işlemek (okumak ve dizine eklemek) çalışma alanınızın bakiyesinden kredi kullanır; uzun kaynaklar biraz daha fazla kullanır. Yeniden işlemek de kredi kullanır. Arama ayrıca ücretlendirilmez, kaynak kaldırmak ücretsizdir.
Çalışma alanınızın kredisi bittiğinde yeni kaynak ekleyemezsiniz: Copilot, testler, otomasyonlar ve yeni bilgi kaynakları bir mesajla durur; kurduklarınız kaybolmaz. Bkz. Planlar ve krediler ve Kullanım.
Kim ne yapabilir
| İşlem | Gereken rol |
|---|---|
| Kaynakları ve bölümleri görmek | Her üye |
| Aramayı test et | Operatör ya da üstü |
| Ekleme, yeniden işleme, kaldırma | Editör ya da üstü |
Bkz. Üyeler ve roller.
İyi knowledge için ipuçları
- Her bölümde tek konu. Bölümler paragraf ve cümle sınırlarından, yaklaşık 1.200 karakterlik parçalar halinde kesilir. Net bir başlığı ve tek bir konu üzerine birkaç paragrafı olan bir bölüm, aramanın bulabileceği bir parça olur.
- Yanıtı soru kelimelerinin yanına koyun. "İade: ürünleri teslimattan sonra 14 gün içinde iade edebilirsiniz" cümlesini bulmak, yalnızca "14" yazan bir tablo hücresini bulmaktan kolaydır.
- Düzen yerine metni tercih edin. Çok sütunlu PDF'ler, sayı tabloları ve görsel içindeki metinler kötü okunur. Bölümleri kontrol edin; karışık görünüyorsa temiz metni yapıştırın.
- SSS'leri soru-cevap olarak yazın. Müşteriler soru sorar; soruyu içeren bölümler en iyi eşleşir.
- Güncel tutun. Yeni fiyat listesini eskisinin yanına eklemek yerine eskisini kaldırın; yoksa agent ikisini birden aktarabilir.
- Kuralları Knowledge'a koymayın. Bölümler talimat değil bilgidir ve yalnızca eşleştiklerinde modele ulaşır. Agent'ın her zaman yapması gerekenler Instructions'a, adım adım prosedürler Skills'e aittir.
- Canlı veri için tool kullanın. Stok, sipariş durumu ve randevu saatleri dakikalar içinde değişir. Bunları bir tool ile getirin.
- Kişisel veriyi dışarıda tutun. Knowledge müşteri kayıtları için değil, işletme bilgisi içindir.
Örnek: e-ticaret mağazası
| Kaynak | Tür |
|---|---|
| Kargo ve iade politikası | Yazılan metin |
| Beden tablosu | https://magazan.com/beden-tablosu (web sayfası) |
| Ürün bakım talimatları | bakim-kilavuzu.pdf |
| Sık sorulan sorular | sss.md |
İyi bir sss.md:
## Teslimat ne kadar sürer?
Standart teslimat 2–4 iş günü sürer. Saat 14.00'ten önce verilen siparişler aynı gün kargoya verilir.
## Ürün iade edebilir miyim?
Evet, teslimattan sonra 14 gün içinde, ürün kullanılmamış ve orijinal kutusundaysa. Başka bedenle değişim ücretsizdir.
## Kargo ücreti ne kadar?
750 ₺ ve üzeri siparişlerde kargo ücretsiz, altında 89,90 ₺.
Sınırlar
| Sınır | Değer |
|---|---|
| Dosya boyutu | 10 MB |
| Dosya türleri | PDF, TXT, Markdown, CSV |
| PDF sayfası | 300 |
| Web sayfası HTML'i | 1 MB, 20 saniye zaman aşımı |
| Yazılan metin | 200.000 karakter, başlık 120 karakter |
| Bir kaynaktan okunan metin | 2.000.000 karakter; gerisi yok sayılır |
| Bir yanıta eklenen bölüm | En fazla 4 |
| Aramayı test et sonuçları | En fazla 5 |