Memformat panduan untuk dokumen dan URL yang diimpor
Tinjau panduan pemformatan ini untuk mendapatkan hasil terbaik untuk konten Anda.
Pertimbangan pemformatan
Setelah mengimpor file atau URL, QnA Maker mengonversi dan menyimpan konten Anda dalam format markdown. Proses konversi menambahkan baris baru dalam teks, seperti \n\n. Pengetahuan tentang format markdown membantu Anda memahami konten yang dikonversi dan mengelola konten Pangkalan Pengetahuan Anda.
Jika Anda menambahkan atau mengedit konten langsung di Pangkalan Pengetahuan Anda, gunakan pemformatan markdown untuk membuat konten teks kaya atau mengubah konten format markdown yang sudah ada dalam jawabannya. QnA Maker mendukung banyak format markdown untuk menghadirkan kemampuan teks yang kaya ke konten Anda. Namun, aplikasi klien, seperti bot obrolan mungkin tidak mendukung kumpulan format penurunan harga yang sama. Penting untuk menguji tampilan jawaban aplikasi klien.
Lihat daftar lengkap jenis konten dan contoh konten.
Pemformatan dokumen dasar
QnA Maker mengidentifikasi bagian dan subbagian serta hubungan dalam file berdasarkan petunjuk visual seperti:
- ukuran font
- gaya font
- penomoran
- warna
Catatan
Kami tidak mendukung ekstraksi gambar dari dokumen yang diunggah saat ini.
Manual produk
Manual biasanya merupakan bahan panduan yang menyertai produk. Ini membantu pengguna untuk mengatur, menggunakan, memelihara, dan memecahkan masalah produk. Ketika QnA Maker memproses manual, ia mengekstrak judul dan subjudul sebagai pertanyaan dan konten berikutnya sebagai jawaban. Anda dapat melihat contoh di sini.
Di bawah ini adalah contoh manual dengan halaman indeks, dan konten hierarkis
Catatan
Ekstraksi berfungsi paling baik pada manual yang memiliki daftar isi dan/atau halaman indeks, dan struktur yang jelas dengan judul hierarkis.
Brosur, pedoman, makalah, dan file lainnya
Banyak jenis dokumen lain juga dapat diproses untuk menghasilkan pasangan QA, asalkan mereka memiliki struktur dan tata letak yang jelas. Ini termasuk: Brosur, pedoman, laporan, buku putih, makalah ilmiah, kebijakan, buku, dll. Lihat contoh di sini.
Di bawah ini adalah contoh dokumen semi terstruktur, tanpa indeks:
Dukungan dokumen yang tidak terstruktur
Jawaban atas pertanyaan kustom mendukung dokumen yang tidak terstruktur. Sebuah dokumen yang tidak memiliki konten yang diatur dengan cara hierarkis yang ditentukan dengan baik, tidak memiliki struktur yang ditetapkan atau memiliki konten yang mengalir bebas dapat dianggap sebagai dokumen tidak terstruktur.
Di bawah ini adalah contoh dokumen PDF yang tidak terstruktur:
Saat ini fungsi ini hanya tersedia melalui pengunggahan dokumen dan hanya untuk format file PDF dan DOC.
Penting
Dukungan untuk file/konten tidak terstruktur hanya tersedia di Jawaban atas pertanyaan kustom.
Dokumen QnA Terstruktur
Format untuk Question-Answers terstruktur dalam file DOC, adalah dalam bentuk Pertanyaan dan Jawaban bergantian per baris, satu pertanyaan per baris diikuti dengan jawabannya di baris berikut, seperti yang ditunjukkan di bawah ini:
Question1
Answer1
Question2
Answer2
Di bawah ini adalah contoh dokumen word QnA terstruktur:
File TXT. TSV dan XLS terstruktur
QnA dalam bentuk file .txtterstruktur, .tsv atau .xls juga dapat diunggah ke QnA Maker untuk membuat atau menambah Pangkalan Pengetahuan. Ini bisa berupa teks biasa, atau dapat memiliki konten dalam RTF atau HTML. Pasangan tanya jawab memiliki bidang metadata opsional yang dapat digunakan untuk mengelompokkan pasangan tanya jawab ke dalam kategori.
| Pertanyaan | Jawaban | Metadata (1 kunci: 1 nilai) |
|---|---|---|
| Pertanyaan1 | Jawaban1 | Key1:Value1 | Key2:Value2 |
| Pertanyaan2 | Jawaban2 | Key:Value |
Setiap kolom tambahan dalam file sumber diabaikan.
Contoh file Excel terstruktur
Di bawah ini adalah contoh file QnA .xls terstruktur, dengan konten HTML:
Contoh pertanyaan alternatif untuk satu jawaban dalam file Excel
Di bawah ini adalah contoh file QnA .xls terstruktur, dengan beberapa pertanyaan alternatif untuk satu jawaban:
Setelah file diimpor, pasangan tanya jawab berada di Pangkalan Pengetahuan seperti yang ditunjukkan di bawah ini:
Format data terstruktur melalui impor
Mengimpor Pangkalan Pengetahuan menggantikan konten Pangkalan Pengetahuan yang ada. Impor memerlukan file .tsv terstruktur yang berisi informasi sumber data. Informasi ini membantu QnA Maker mengelompokkan pasangan tanya jawab dan mengaitkannya ke sumber data tertentu. Pasangan tanya jawab memiliki bidang metadata opsional yang dapat digunakan untuk mengelompokkan pasangan tanya jawab ke dalam kategori.
| Pertanyaan | Jawaban | Sumber | Metadata (1 kunci: 1 nilai) |
|---|---|---|---|
| Pertanyaan1 | Jawaban1 | Url1 | Key1:Value1 | Key2:Value2 |
| Pertanyaan2 | Jawaban2 | Editorial | Key:Value |
Pemformatan dokumen multi-turn
- Gunakan judul dan sub judul untuk menunjukkan hierarki. Misalnya, Anda dapat h1 untuk menunjukkan QnA induk dan h2 untuk menunjukkan QnA yang harus diambil sebagai perintah. Gunakan ukuran judul kecil untuk menunjukkan hierarki berikutnya. Jangan gunakan gaya, warna, atau mekanisme lain untuk menyiratkan struktur dalam dokumen Anda, QnA Maker tidak akan mengekstrak perintah multi-giliran.
- Karakter pertama dari judul harus dikapitalisasi.
- Jangan mengakhiri judul dengan tanda tanya,
?.
Sampel dokumen:
Surface Pro (docx)
Manfaat Contoso (docx)
Manfaat Contoso (pdf)
URL Tanya Jawab Umum
QnA Maker dapat mendukung halaman web FAQ dalam 3 bentuk berbeda:
- Halaman FAQ biasa
- Halaman FAQ dengan tautan
- Halaman FAQ dengan Beranda Topik
Halaman FAQ biasa
Ini adalah jenis halaman FAQ yang paling umum, di mana jawaban langsung mengikuti pertanyaan di halaman yang sama.
Di bawah ini adalah contoh halaman FAQ biasa:
Halaman FAQ dengan tautan
Di halaman FAQ jenis ini, pertanyaan dikumpulkan bersama dan ditautkan ke jawaban yang ada di bagian berbeda dari halaman yang sama, atau di halaman berbeda.
Di bawah ini adalah contoh halaman FAQ dengan tautan di bagian yang berada di halaman yang sama:
Tautan halaman Topik Induk ke halaman jawaban turunan
Jenis FAQ ini memiliki halaman Topik di mana setiap topik ditautkan ke serangkaian pertanyaan dan jawaban yang sesuai pada halaman yang berbeda. QnA Maker meng-crawl semua halaman tertaut untuk mengekstrak pertanyaan & jawaban yang sesuai.
Di bawah ini adalah contoh halaman Topik dengan tautan ke bagian FAQ di halaman yang berbeda.
URL Pendukung
QnA Maker dapat memproses halaman web dukungan semi-terstruktur, seperti artikel web yang akan menjelaskan cara melakukan tugas tertentu, cara mendiagnosis dan menyelesaikan masalah tertentu, dan praktik terbaik apa untuk proses tertentu. Ekstraksi berfungsi paling baik pada konten yang memiliki struktur yang jelas dengan judul hierarkis.
Catatan
Ekstraksi untuk artikel dukungan adalah fitur baru dan masih dalam tahap awal. Hal ini berfungsi paling baik untuk halaman sederhana, yang terstruktur dengan baik, dan tidak mengandung header/footer yang rumit.
Impor dan ekspor basis pengetahuan
File TSV dan XLS, dari basis pengetahuan yang diekspor, hanya dapat digunakan dengan mengimpor file dari halaman Pengaturan di portal QnA Maker. File tersebut tidak dapat digunakan sebagai sumber data selama pembuatan basis pengetahuan atau dari fitur + Tambahkan file atau + Tambahkan URL di halaman Pengaturan.
Saat Anda mengimpor Basis Pengetahuan melalui file TSV dan XLS ini, pasangan QnA akan ditambahkan ke sumber editorial dan bukan sumber dari tempat QnA diekstraksi di Basis Pengetahuan yang diekspor.
Langkah berikutnya
Lihat daftar lengkap jenis konten dan contoh konten