Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
[Artikel ini adalah dokumentasi prarilis dan dapat berubah.]
Pengguna dapat melampirkan file ke pesan sehingga agen dapat membaca, meringkas, atau mempertimbangkannya untuk giliran tersebut. Lampiran merupakan input pengguna pada setiap giliran, bukan sumber data persisten yang dikonfigurasi oleh pembuat.
Note
Fitur-fitur dalam artikel ini didukung oleh harness GitHub Copilot, yang menggunakan Kredit Copilot untuk penagihan berbasis penggunaan. Pelajari lebih lanjut tentang Kredit Copilot dalam Ikhtisar penagihan untuk agen yang didukung oleh harness GitHub Copilot.
Penagihan berbasis penggunaan berlaku untuk penggunaan, pembuatan, pengujian, dan evaluasi agen. Tindakan-tindakan ini mungkin menghabiskan Kredit Copilot.
Lampiran vs. sumber pengetahuan
Keterikatan dan sumber pengetahuan adalah konsep yang berbeda. Pilih yang sesuai dengan skenario Anda.
| Konsep | Siapa yang menyediakannya | Scope | Kegunaan umum |
|---|---|---|---|
| Lampiran | Pengguna akhir, per pesan | Satu percakapan | "Ringkas kontrak ini", "Apa isi tangkapan layar ini?" |
| Sumber pengetahuan | Pembuat, pada tahap perancangan | Setiap percakapan dengan agen | Dokumen kebijakan, katalog produk, artikel bantuan |
Tambahkan sumber pengetahuan ketika agen seharusnya selalu memiliki akses ke konten yang sama. Minta pengguna untuk melampirkan file ketika konten tersebut unik untuk permintaan mereka.
Jenis lampiran yang didukung
| Jenis | Examples | Notes |
|---|---|---|
| Gambar | .png, .jpg, .gif, .webp | Agen menggunakan model yang mampu melihat untuk mendeskripsikan atau menjawab pertanyaan tentang gambar. |
| Teks diekstrak agar dapat ditelaah oleh agen untuk penalaran. | ||
| Dokumen teks | .txt, .csv, .html, .md | Konten diteruskan ke agen sebagai teks. |
| URL | URL HTTP atau HTTPS yang dapat diakses publik | Agen mengunduh file yang ditautkan untuk giliran saat ini (lihat perilaku unduhan URL di bagian selanjutnya dalam artikel ini). |
Tempat pengguna melampirkan file
Pengguna dapat melampirkan file di permukaan mana pun tempat agen menjalankan:
- Tab Preview di Copilot Studio, saat Anda menguji agen. Pelajari lebih lanjut di Uji agen.
- Setiap saluran yang dipublikasikan yang mendukung lampiran, seperti Microsoft Teams, Microsoft 365 Copilot, dan obrolan web.
Pengguna memilih ikon lampiran di komposer pesan, memilih satu atau lebih file, menambahkan pesan opsional, dan mengirim giliran. Agen menerima lampiran bersama dengan pesan.
Bagaimana agen memproses lampiran
- Agen membaca setiap lampiran saat memproses pesan. Lampiran hanya memengaruhi giliran saat dikirim, kecuali agen merujuknya kembali nanti dalam percakapan yang sama.
- Jika lampiran tidak dapat diproses (misalnya, file tidak valid atau unduhan URL gagal), agen akan melewati lampiran tersebut dan memproses sisa pesan. Pesan masih dikirim.
- Lampiran tidak menggantikan sumber pengetahuan, memori, atau output alat . Mereka adalah sinyal lain yang dipertimbangkan agen untuk giliran saat ini.
Lampiran URL
Ketika pengguna melampirkan URL, agen mengunduh file tersebut di URL tersebut dan memperlakukannya seperti lampiran yang diunggah untuk giliran tersebut.
- Unduhan harus selesai dalam waktu 30 detik. Respons yang lebih lambat habis dan URL dilewati untuk giliran tersebut.
- URL harus dapat diakses secara publik dari layanan Microsoft. Tautan yang memerlukan masuk atau yang berada di balik firewall tidak berfungsi.
- Pesan tetap dikirim meskipun unduhan URL gagal.
Retensi dan batasan
Lampiran disimpan selama percakapan berlangsung, bukan hanya untuk giliran saat ini. Jika pengguna melampirkan file lebih awal dalam percakapan, agen dapat merujuknya lagi di giliran berikutnya (misalnya, "bandingkan ini dengan file yang saya kirim sebelumnya").
| Item | Limit |
|---|---|
| Ukuran lampiran (per berkas) | 16 MiB |
| Batas waktu pengunduhan lampiran URL | 30 detik |
| Retensi lampiran (per percakapan) | 28 hari setelah aktivitas terakhir dalam percakapan |
| Perilaku keterikatan saat gagal | Agen melewati lampiran yang gagal dan melanjutkan pemrosesan pesan |
Setelah jendela retensi habis, lampiran yang tersimpan dihapus dari percakapan dan tidak lagi tersedia untuk dirujuk oleh agen. Jendela retensi yang sama berlaku untuk file apa pun yang dibuat agen selama percakapan.