Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
[Bu makale yayın öncesi belgedir ve değişebilir.]
Kullanıcılar, bir mesaja dosya ekleyebilir, böylece ajan o tur için onları okuyabilir, özetleyebilir veya başka şekilde mantık yürütebilir. Ekler, kullanıcı tarafından her turda sağlanan bir girdidir; kalıcı, geliştirici tarafından yapılandırılmış bir veri kaynağı değildir.
Note
Bu makaledeki özellikler, Copilot kredileri kullanarak kullanıma dayalı faturalandırma kullanan GitHub Copilot demetiyle desteklenmektedir. GitHub Copilot demetiyle çalışan ajanlar için faturalandırma genel bakalımında Copilot Kredileri hakkında daha fazla bilgi edinin.
Kullanıma dayalı faturalandırma, ajanların kullanımı, oluşturulması, test edilmesi ve değerlendirilmesi için geçerlidir. Bu işlemler Copilot Kredileri tüketebilir.
Bağlılıklar vs. bilgi kaynakları
Bağlılıklar ve bilgi kaynakları farklı kavramlardır. Senaryonuzla uyumlu olanı seçin.
| Concept | Kim sağlıyor | Scope | Tipik kullanım |
|---|---|---|---|
| Ek dosya | Son kullanıcı, mesaj başına | Bir konuşma | "Bu sözleşmeyi özetle", "Bu ekran görüntüsünde ne var?" |
| Bilgi kaynağı | Tasarım sırasında oluşturucu | Ajanla yapılan her konuşma | Politika dokümanturaları, ürün katalogları, yardım makaleleri |
Ajanın her zaman aynı içeriğe erişimi olması gerekirken bir bilgi kaynağı ekleyin. Kullanıcılardan, içerik isteklerine özgü olduğunda bir dosya eklemelerini iste.
Desteklenen ek türleri
| Türü | Examples | Notlar |
|---|---|---|
| Görüntü | .png, .jpg, .gif, .webp | Ajan, görüntüyle ilgili soruları tanımlamak veya yanıtlamak için görme yeteneğine sahip modeller kullanır. |
| PDF'ler | Metin, ajanın üzerinde akıl yürütebilmesi için ayıklanır. | |
| Metin belgeler | .txt, .csv, .html, .md | İçerik ajana metin olarak iletiliyor. |
| URLs | Herkese açık erişilebilir herhangi bir HTTP veya HTTPS URL | Ajan, mevcut tur için bağlantılı dosyayı indirir (bu makalenin ilerleyen bölümlerinde URL indirme davranışına bakınız). |
Kullanıcıların dosya ektiği yerler
Kullanıcılar, ajanın çalıştığı herhangi bir yüzeye dosya ekleyebilir:
- Copilot Studio'daki önizleme sekmesi, ajanı test ettiğinizde. Daha fazla bilgi edinin: Bir ajanı Test edin.
- Microsoft Teams, Microsoft 365 Copilot ve web sohbeti gibi ekleri destekleyen herhangi bir yayımlanmış kanal.
Kullanıcı, mesaj oluşturucuda ek simgesini seçer, bir veya daha fazla dosya seçer, isteğe bağlı bir mesaj ekler ve tur gönderir. Ajan, ekleri mesajla birlikte alır.
Ajan ekler nasıl işliyor
- Ajan, mesajı işlerken her eki okur. Ekler, yalnızca gönderildikleri mesajı etkiler; ancak ajan aynı konuşmada daha sonra bunlara yeniden atıfta bulunursa bu durum değişir.
- Bir ek işlenemezse (örneğin, geçersiz bir dosya veya başarısız URL indirilmesi), ajan o eki atlar ve mesajın geri kalanını işler. Mesaj hâlâ gönderiliyor.
- Ekler, bilgi kaynaklarının, belleğin veya aracın çıktılarının yerini almaz. Bunlar ajanın mevcut tur için değerlendirdiği başka bir sinyal.
URL ekleri
Bir kullanıcı bir URL eklediğinde, ajan bu URL’deki dosyayı indirir ve bunu o etkileşim için yüklenmiş bir ek olarak ele alır.
- İndirme işlemi 30 saniye içinde tamamlanmalıdır. Geciken yanıtlar zaman aşımına uğrar ve URL o deneme için atlanır.
- URL, Microsoft'un hizmetinden kamuya açık erişilebilir olmalıdır. Giriş gerektiren veya güvenlik duvarının arkasında duran bağlantılar çalışmaz.
- URL indirme başarısız olsa bile mesaj gönderilmeye devam ediyor.
Bekletme ve sınırlar
Ekler, yalnızca geçerli tur boyunca değil, konuşma süresince saklanır. Bir kullanıcı konuşmanın başında bir dosya eklediyse, ajan daha sonraki bir turda tekrar referans verebilir (örneğin, "bunu daha önce gönderdiğim dosyayla karşılaştırın").
| Ürün | Sınır |
|---|---|
| Ek boyutu (dosya başına) | 16 MiB |
| URL eki indirme zaman aşımı | 30 saniye |
| Bağlanma tutma (konuşma başına) | Konuşmadaki son aktiviteden 28 gün sonra |
| Başarısızlıkta bağlanma davranışı | Ajan, başarısız eki atlar ve mesajı işlemeye devam eder |
Saklama penceresi dolduğunda, depolanan ekler konuşmadan silinir ve ajanın referans alması için artık kullanılabilir değildir. Aynı saklama penceresi, danışmanın konuşma sırasında oluşturduğu tüm dosyalar için de geçerlidir.