Share via

Memformat panduan untuk dokumen dan URL yang diimpor

  • Artikel

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

Product Manual example for a knowledge base

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:

Azure Blob storage semi-structured Doc

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:

Unstructured document example for a knowledge base

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:

Structured QnA document example for a knowledge base

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:

Structured QnA excel example for a knowledge base

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:

Example of alternate questions for single answer in Excel file

Setelah file diimpor, pasangan tanya jawab berada di Pangkalan Pengetahuan seperti yang ditunjukkan di bawah ini:

Screenshot of alternate questions for single answer imported into knowledge base

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:

Plain FAQ page example for a knowledge base

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:

Section Link FAQ page example for a knowledge base

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.

Deep link FAQ page example for a knowledge base

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.

QnA Maker supports extraction from semi-structured web pages where a clear structure is presented with hierarchical headings

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