Dosyalar ve ekler

Müşteriler konuşmada fotoğraf ve belge gönderebilir, agent bunları okur, ekibiniz de dosya gönderebilir. Bir müşteri hasarlı gelen kolisinin fotoğrafını gönderip bununla ilgili bir yanıt alabilir ya da bir PDF fatura gönderip sorusunun yanıtını faturanın metninden alabilir.

Dosyalar nereden gönderilir

Kim	Nerede	Nasıl
Müşteriler	Web sitesi sohbeti	Mesaj kutusunun yanındaki ataş simgesiyle; hem balon hem sohbet kutusu görünümünde.
Müşteriler	Telegram	Fotoğraf ya da belge olarak. Açıklama (caption) mesaj metni olur.
Müşteriler	Kendi uygulamanız	Sessions API ile: dosyayı oturuma yükleyin, sonra kimliğiyle birlikte bir mesaj gönderin. Bkz. API'ye genel bakış.
Ekibiniz	Inbox	Konuşmayı Devraldıktan sonra yazma alanındaki ataş simgesiyle ya da sürükleyip bırakarak. Bkz. Bir kişiye devretme.
Siz, test ederken	Test paneli	Müşteriyi canlandırırken aynı ataş simgesiyle. Düzenleyici ve üstü. Bkz. Test.

bilgi

Agent'ın kendisi dosya oluşturmaz ya da göndermez. Müşterilerin gönderdiklerini okur ve metinle yanıt verir. Müşterilere dosya yalnızca ekibinizden biri eklediğinde gider.

Desteklenen dosyalar

Tür	Biçimler
Görseller	JPEG, PNG, WebP, GIF
Belgeler	PDF, düz metin (TXT), Markdown (MD), CSV

Peki bir dosyanın türüne adına ya da tarayıcının iddiasına göre değil, ilk baytlarına bakarak karar verir. Adı .pdf yapılmış bir PNG, PNG olarak saklanır; yukarıdaki türlerden biri olmayan bir dosya adı ne olursa olsun reddedilir. SVG ve HTML hiçbir zaman kabul edilmez; içinde web sayfası işaretlemesi ya da betik olan bir metin dosyası da kabul edilmez.

Saklanan ad her zaman gerçek türün uzantısıyla biter. Örneğin düz metin olduğu anlaşılan fatura.html, fatura.txt olarak saklanır.

Sesli mesajlar, ses dosyaları, videolar, çıkartmalar ve animasyonlar desteklenmez. Telegram'da müşteri, botun bu tür dosyaları henüz açamadığını söyleyen kısa bir yanıt alır; hiçbir şey saklanmaz.

Sınırlar

Sınır	Değer
Dosya başına boyut	10 MB
Mesaj başına dosya	5
Konuşma başına dosya	30
Web sitesi sohbetinde ziyaretçi başına yükleme	Saatte 20 dosya
Bir belgeden okunan metin	20.000 karakter
Dosyaları modele giden son müşteri mesajı sayısı	6
Yüklenen bir dosyayı gönderme süresi	24 saat

Bir konuşma 30 dosyaya ulaştığında müşterinin daha fazlasını göndermek için yeni bir konuşma başlatması gerekir: web sitesi sohbetinde Yeni konuşma, Telegram'da /new.

Yüklemeler iki kez denetlenir: tarayıcıda, hiçbir bayt çıkmadan önce (boyut ve sayı, sonra ilk baytlardan tür), sonra da sunucuda.

Müşterilerin görebileceği hatalar

Web sitesi sohbeti, Inbox ve Test paneli bunları görüntüleyenin dilinde gösterir. API'den ise code alanı olan bir hata olarak gelir.

Kod	Mesaj (Türkçe)	Ne yapmalı
file_type	Fotoğraf (JPEG, PNG, WebP, GIF), PDF ya da metin dosyası (TXT, MD, CSV) gönderebilirsiniz.	Dosyayı dönüştürün; örneğin bir Word dosyasını PDF olarak dışa aktarın.
file_size	Dosyalar en fazla 10 MB olabilir.	Dosyayı sıkıştırın ya da bölün.
file_count	Bir mesajda en fazla 5 dosya.	Gerisini başka bir mesajda gönderin.
conversation_full	Bu konuşma 30 dosya sınırına ulaştı. Daha fazlası için yeni bir konuşma başlatın.	Yeni bir konuşma başlatın.
file_rate	Aynı anda çok fazla dosya. Lütfen daha sonra tekrar deneyin.	Biraz bekleyip tekrar deneyin.
file_taken	Bu dosya zaten gönderildi. Lütfen yeniden ekleyin.	Dosyayı yeniden ekleyin.
file_missing	Bu dosyaya artık ulaşılamıyor. Lütfen yeniden ekleyin.	Dosyayı yeniden ekleyin.

Telegram'da ise bot müşterinin dilinde yanıt verir; örneğin "Bu dosya çok büyük: dosyalar en fazla 10 MB olabilir." ya da "Bu konuşmada zaten 30 dosya var. Yeni bir konuşma başlatmak için /new yazın."

Agent ekleri nasıl okur

Agent her yanıtta, dosya içeren son 6 müşteri mesajının dosyalarını eskiden yeniye, talimat olarak değil veri olarak işaretlenmiş halde alır. Daha önce gönderilen dosyalar konuşmada yalnızca adlarıyla kalır; böylece uzun bir sohbet her fotoğrafı yeniden göndermez.

Görseller

Görseller modele resim olarak gider, ama yalnızca model görsel okuyabiliyorsa. Model seçicide bu modellerin yanında Görsel okur yazar. Başka bir modelde agent yalnızca adıyla birlikte bir görsel gönderildiğine dair bir not alır ve içinde ne olduğunu göremez.

Bir görsel modele gitmeden önce Peki ilk karesini alır (GIF için), dik çevirir, 1568 × 1568 piksele sığacak şekilde küçültür ve JPEG'e dönüştürür. Inbox'ta gördüğünüz dosya orijinalidir.

ipucu

Müşterileriniz fotoğraf gönderecekse (hasarlı ürünler, bir diş fotoğrafı, kırık bir parça) agent'ın ilk modeli olarak Görsel okur işaretli bir model seçin. Bkz. Model ve davranış.

Belgeler

PDF, TXT, Markdown ve CSV dosyalarında Peki metni yükleme anında bir kez çıkarır ve agent'a verir:

• dosya başına en fazla 20.000 karakter; daha uzun bir metin kesilir ve agent'a nerede kesildiği söylenir;
• talimat değil veri olan dosya içeriği olarak işaretlenmiş halde; böylece bir belge agent'ınızın davranışını değiştiremez;
• kişisel veri guardrail'i açıkken, mesajlarda olduğu gibi kişisel bilgiler yer tutuculara dönüştürülmüş halde.

PDF'ler arka planda okunur. Müşterinin mesajı okuma bitmeden gelirse yanıt bunun için en fazla 20 saniye bekler. Sonra agent'a dosyanın hâlâ okunmakta olduğu söylenir.

Yalnızca sayfa resimleri içeren taranmış bir PDF'te okunacak metin yoktur. Agent'a dosyada okunabilir metin olmadığı söylenir.

not

Görseller metin gibi maskelenemez. Bir kimlik kartı fotoğrafı modele olduğu gibi ulaşır. Bkz. Veri ve gizlilik.

Agent'ın ne aldığını görmek

Inbox'ta ya da Test panelinde bir agent yanıtının altındaki Neden?'i açın. Dosyalar satırı her dosyayı ve modele nasıl verildiğini listeler: görsel olarak, okunan metin olarak ya da yalnızca not olarak (örneğin "bu model görmedi"). Bkz. Inbox.

Ekibinizin gönderdiği dosyalar

Inbox'ta bir konuşmayı devraldıktan sonra:

1. Ataş simgesine tıklayın ya da dosyaları konuşmanın üzerine sürükleyin. Her dosyanın yüklemesi hemen başlar.
2. Dosyaların yüklenmesini bekleyin, isterseniz bir mesaj yazın. Bir yanıt yalnızca dosyalardan da oluşabilir.
3. Gönderin.

Müşteri bunları şöyle alır:

Kanal	Teslim
Web sitesi sohbeti	Fotoğraflar küçük resim, diğer dosyalar kart olarak. Ziyaretçi dokunarak fotoğrafı açar ya da dosyayı kaydeder.
Telegram	Fotoğraflar Telegram fotoğrafı, diğer dosyalar belge olarak. Telegram'ın boyutu ya da en-boy oranı yüzünden fotoğraf olarak almadığı bir resim belge olarak gider. Tek bir dosyayı kısa bir mesajla (en fazla 1.024 karakter) gönderirseniz mesaj dosyanın açıklaması olur; aksi halde önce mesaj, sonra dosyalar gider.
API	Mesajın attachments alanında kimlik, ad, tür ve boyutla listelenir.

Yalnızca bu konuşmaya kendiniz yüklediğiniz dosyaları ekleyebilirsiniz. Bir müşterinin dosyası sizinmiş gibi geri gönderilemez.

Dosyalar nerede görünür

Peki panelinde ayrı bir dosya kütüphanesi yoktur. Dosyalar gönderildikleri yerde yaşar:

• Inbox'ta ve Test panelinde, geldikleri mesajın üzerinde: fotoğraflar küçük resim, belgeler açıp indirebileceğiniz kartlar olarak.
• Kayıt sayfalarında, bir tabloda file alanı varsa ve agent bir müşterinin dosyasını oraya kaydettiyse ya da bir ekip arkadaşınız bir dosya yüklediyse. Kayıt kendi kopyasını tutar. Bkz. Records.
• Knowledge'da, kaynak olarak eklediğiniz belgeler. Knowledge görsel değil yalnızca belge kabul eder. Bkz. Knowledge.
• Copilot'ta, kurulum sırasında eklediğiniz dosyalar. Bkz. Copilot ile çalışmak.

Bir dosyayı açmak: görseller tarayıcıda açılır; diğer tüm türler indirilir, böylece bir dosyadaki hiçbir şey tarayıcınızda çalışamaz. Çalışma alanının üyeleri ve API anahtarları o alanın dosyalarını okuyabilir; bir web sitesi sohbeti ziyaretçisi yalnızca kendi konuşmalarının dosyalarını okuyabilir.

Saklama süresi

Ne	Ne kadar saklanır
Bir mesajla gönderilen dosya	Konuşma var olduğu sürece.
Yüklenip hiç gönderilmeyen dosya	24 saat sonra silinir ve sonrasında gönderilemez.
Bir kaydın dosya kopyası	Kayıt var olduğu sürece. Konuşmayı silmek onu kaldırmaz.
Bir agent'ın her şeyi	Agent'ı sildiğinizde silinir.
Bir çalışma alanındaki her şey	Çalışma alanını sildiğinizde silinir.

Dosyalar gizli saklanır. Asla herkese açık değildir ve her okuma, kimin istediğini kontrol eden Peki üzerinden geçer. Bkz. Veri ve gizlilik.

Sorun giderme

Sorun	Nedeni ve ne yapmalı
Agent fotoğrafı göremediğini söylüyor	Agent'ın modeli görsel okumuyor. Görsel okur işaretli bir model seçin.
Agent uzun bir PDF'in çoğunu görmezden geliyor	Yalnızca ilk 20.000 karakter okunur. İlgili sayfaları gönderin ya da uzun başvuru belgelerini Knowledge'a koyun.
Agent bir PDF'te okunabilir metin olmadığını söylüyor	Bu bir tarama. Orijinal PDF'i gönderin ya da görsel okuyan bir modelle sayfanın fotoğrafını gönderin.
Telegram'da bir dosya çok büyük diye reddedildi	Dosyalar en fazla 10 MB olabilir.
Telegram'daki sesli mesaja "Bu tür dosyaları henüz açamıyorum" yanıtı geldi	Ses ve video desteklenmez. Müşteriden yazmasını isteyin.
Inbox'ta ataş simgesi yok	Ataş simgeli yazma alanı yalnızca konuşmayı devraldıktan sonra görünür.
Web sitesi sohbetinde ataş simgesi soluk	Sonraki mesaja zaten 5 dosya eklenmiş ya da sohbet kullanılamıyor (agent yayınlanmamış).

İlgili sayfalar

• Inbox
• Bir kişiye devretme
• Web sitesi sohbeti
• Telegram
• Model ve davranış
• Sınırlar