Membuat pangkalan pengetahuan untuk alur kerja agenik yang akan digunakan dalam Azure Logic Apps (pratinjau)

Berlaku untuk: Azure Logic Apps (Standard)

Note

Fitur pratinjau ini tunduk pada Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.

Organisasi Anda menghasilkan data yang tidak terstruktur dari dokumen, spreadsheet, API, dan sistem internal. Dengan menggunakan kemampuan Knowledge Base-as-a-Service (KBaaS) di Azure Logic Apps, Anda dapat mengonversi konten ini menjadi basis pengetahuan yang terstruktur dan lebih mudah ditelusuri, yang dapat digunakan oleh loop agen dalam alur kerja agentik untuk menyelesaikan tugas. Pangkalan pengetahuan adalah kontainer logis yang mengatur sumber pengetahuan terkait seperti dokumen atau file yang terkait dengan domain tertentu.

Misalnya, Anda dapat membuat pangkalan pengetahuan yang berisi semua dokumen yang terkait dengan kebijakan dan prosedur SDM. Saat Anda membuat pangkalan pengetahuan, KBaaS secara otomatis menyiapkan database, kontainer, dan kebijakan pengindeksan Azure Cosmos DB yang diperlukan. Untuk informasi selengkapnya, lihat database, kontainer, dan item Azure Cosmos DB.

Panduan ini menunjukkan cara membuat pangkalan pengetahuan, mengunggah sumber pengetahuan, dan menambahkan pangkalan pengetahuan sebagai alat yang dapat digunakan perulangan agen dalam alur kerja agen Standar.

Keterbatasan

Rilis pratinjau ini memiliki batasan berikut:

• Pratinjau ini mendukung fitur berikut:

  • Mengunggah file sebagai jenis sumber untuk artefak pengetahuan.
  • File dengan format berikut: DOC, DOCX, HTML, MD, PDF, PPT, PPTX, TXT, XLS, XLSX.
  • Penguraian konten berbasis teks dalam dokumen, bukan gambar.
  • Pengaturan pemenggalan default, bukan pemenggalan kustom.

• Setelah membuat koneksi pangkalan pengetahuan, Anda hanya dapat mengedit nama tampilan untuk koneksi dan Azure model OpenAI. Anda tidak dapat mengedit nilai lain seperti jenis autentikasi atau informasi titik akhir.

• Hanya portal Azure yang saat ini didukung untuk kemampuan ini.

Cara kerja pangkalan pengetahuan

KBaaS menyederhanakan transformasi data dan menyediakan lapisan abstraksi atas Azure Cosmos DB dan Azure OpenAI sehingga alur kerja Anda dapat lebih mudah menggunakan, memproses, dan mengambil pengetahuan terstruktur tanpa membangun alur Retrieval-Augmented Generation (RAG) kustom.

KBaaS memiliki alur berikut:

• Alur penyerapan: Saat Anda mengunggah dokumen, atau sumber pengetahuan, ke pangkalan pengetahuan Anda, layanan secara otomatis mengurai, memotong, meringkas, dan mem-vektorisasi konten. Layanan kemudian menyimpan hasilnya dalam Azure Cosmos DB.

• Retrieval pipeline: Ketika perulangan agen mengkueri pangkalan pengetahuan Anda, layanan menulis ulang kueri jika diperlukan, menghasilkan representasi vektor, melakukan pencarian semantik terhadap Azure Cosmos DB, dan mengembalikan gugus yang paling relevan ke model bahasa besar (LLM) untuk pembuatan respons.

Prasyarat

• Akun dan langganan Azure. Dapatkan akun Azure gratis.

• Layanan Azure OpenAI. Untuk informasi selengkapnya, lihat Buat dan sebarkan sumber daya Azure OpenAI Service.

  • Sumber daya Anda memerlukan model yang disebarkan berikut:

    • Model penyelesaian, seperti gpt-4o.
    • Model penyematan, seperti teks-penyematan-3-kecil.

• Azure Cosmos DB untuk akun NoSQL.

  • Sebelum Anda membuat pangkalan pengetahuan, aktifkan pencarian vektor di akun Cosmos DB Anda. Operasi ini mungkin memakan waktu hingga 15 menit sebelum selesai.

    Untuk informasi selengkapnya, lihat:

    • Quickstart: Buat Azure Cosmos DB untuk akun NoSQL menggunakan portal Azure
    • Pencarian vektor di Azure Cosmos DB untuk NoSQL

• Aplikasi logika Standar dan alur kerja agenik.

  Untuk informasi selengkapnya, lihat:

  • Buat alur kerja agenik otonom tanpa interaksi manusia di Azure Logic Apps
  • Buat alur kerja agenik percakapan dengan interaksi obrolan di Azure Logic Apps

• Jika Anda berencana menggunakan autentikasi identitas terkelola, buka sumber daya yang sesuai, dan tetapkan peran berikut pada identitas terkelola:

  • Kontributor Data Bawaan Cosmos DB dan Operator Cosmos DB di akun Azure Cosmos DB Anda.

    • Tinjau dan ikuti praktik terbaik keamanan seputar peran kontributor dan pahami hubungannya dengan identitas yang dikelola.
    • Untuk menetapkan Kontributor Data Bawaan Cosmos DB, yang tidak tersedia di portal Azure, gunakan perintah berikut: az cosmosdb sql role assignment create.

  • Cognitive Services OpenAI Pengguna di sumber daya Azure OpenAI Anda.

  Jika tidak, Anda mungkin mengalami masalah seperti membuat grup dan menambahkan file di basis pengetahuan Anda.

  Untuk informasi selengkapnya, lihat:

  • Menetapkan peran Azure ke identitas terkelola
  • Tetapkan peran Azure menggunakan Azure portal

Authentication

Kemampuan KBaaS mendukung autentikasi dengan menggunakan Microsoft Entra ID dengan identitas managed atau kunci API. Jika memungkinkan, siapkan dan gunakan identitas terkelola untuk keamanan yang optimal dan unggul. Anda tidak perlu memberikan dan mengelola kredensial, rahasia, atau kunci akses secara manual.

Jika Anda menggunakan kunci API, mengamankan dan melindungi data sensitif dan pribadi, seperti kredensial, rahasia, kunci akses, string koneksi, sertifikat, thumbprint, dan informasi serupa dengan tingkat keamanan tertinggi yang tersedia atau didukung. Simpan informasi tersebut dengan aman menggunakan Microsoft Entra ID dan Azure Key Vault. Jangan hardcode informasi ini, bagikan dengan pengguna lain, atau simpan dalam teks biasa di mana pun orang lain dapat mengakses. Siapkan rencana untuk memutar atau mencabut rahasia jika mereka disusupi.

Untuk informasi selengkapnya, lihat sumber daya berikut ini:

• Mengotomatiskan rotasi rahasia di Azure Key Vault
• Praktik terbaik untuk melindungi rahasia
• Rahasia di Azure Key Vault

1: Membuat koneksi pangkalan pengetahuan

Untuk membuat koneksi pangkalan pengetahuan, kaitkan database Cosmos Anda dan Azure model sumber daya OpenAI dengan mengikuti langkah-langkah berikut:

1a: Menyiapkan koneksi database Cosmos

1. Di portal Azure, buka sumber daya aplikasi logika Standard Anda.

2. Pada bilah sisi aplikasi logika, di bawah Agen, pilih Pangkalan pengetahuan.

3. Pada halaman Pangkalan pengetahuan , pilih Siapkan.

4. Di panel Siapkan , pada tab Dasar , berikan informasi berikut ini:

   Parameter	Required	Description
   Nama tampilan	Yes	Nama yang mudah dibaca oleh manusia untuk koneksi basis pengetahuan Anda. Gunakan nama yang sama dengan pangkalan pengetahuan yang Anda rencanakan untuk dibuat sehingga tindakan pengambilan dapat mengaitkan koneksi yang benar.
   Jenis autentikasi	Yes	Identitas Layanan Terkelolaatau berbasis kunci
   Subscription	Yes	Langganan Azure Anda.
   Database	Yes	Database Cosmos Anda.
   Titik akhir URL	Yes	Pilihan database Anda secara otomatis mengisi nilai ini.
   Kunci	Yes	Hanya tersedia jika Anda memilih Autentikasi berbasis kunci . Pilihan database Anda secara otomatis mengisi nilai ini.

5. Setelah selesai, pilih Berikutnya.

1b: Menyiapkan koneksi sumber daya OpenAI Azure

1. Pada tab Model , berikan informasi berikut ini:

   Parameter	Required	Description
   Jenis autentikasi	Yes	URL dan autentikasi berbasis kunci atau Identitas Layanan Terkelola
   Subscription	Yes	Langganan Azure Anda.
   Sumber daya Azure OpenAI	Yes	Sumber daya OpenAI Azure Anda.
   Titik akhir API	Yes	Pilihan sumber daya OpenAI Azure Anda secara otomatis mengisi nilai ini.
   Kunci API	Yes	Hanya tersedia jika Anda memilih URL dan autentikasi berbasis kunci. Pilihan sumber daya OpenAI Azure Anda secara otomatis mengisi nilai ini.
   Model penyelesaian	Yes	Masukkan nama tampilan untuk model penyelesaian yang disebarkan untuk sumber daya OpenAI Azure Anda.
   Model penyematan	Yes	Masukkan nama tampilan untuk model embedding yang di-deploy untuk sumber daya Azure OpenAI Anda.

2. Setelah selesai, pilih Buat.

2: Tambahkan artefak pengetahuan

Setelah Anda membuat koneksi pangkalan pengetahuan, tambahkan file informasi sumber untuk digunakan sebagai artefak pengetahuan di pangkalan pengetahuan Anda.

1. Di portal Azure, buka sumber daya aplikasi logika Standard Anda.

2. Pada bilah sisi aplikasi logika, di bawah Agen, pilih Pangkalan pengetahuan.

3. Jika Anda ingin membuat grup sebelum menambahkan file, pada toolbar halaman Pangkalan pengetahuan , pilih Buat Baru>grup baru, lalu ikuti perintah untuk membuat grup.

4. Pada halaman Pangkalan pengetahuan , pilih Tambahkan file. Atau, pada toolbar halaman, pilihTambahkan file>.

5. Pada panel Tambahkan file , selesaikan tugas berikut ini:

   1. Di bagian Grup , masukkan informasi berikut ini:

      Parameter	Required	Description
      Nama	Yes	Nama grup yang mengatur file di pangkalan pengetahuan Anda. Masukkan nama baru atau pilih grup yang sudah ada.
      Description	No	Deskripsi opsional untuk grup.

   2. Di bagian Tambahkan file , pilih telusuri untuk diunggah, atau seret dan letakkan file ke grup Anda. Untuk setiap file, masukkan informasi berikut:

      Parameter	Required	Nilai	Description
      Nama	Yes	< nama sumber>	Nama untuk file sebagai sumber pengetahuan, misalnya, HRPolicyDocument.
      Description	No	< deskripsi sumber>	Deskripsi opsional untuk file sebagai sumber pengetahuan.

6. Setelah selesai, pilih Tambahkan.

   KBaaS membuat kontainer Cosmos DB berikut:

   Container	Kegunaan
   KnowledgeHubs	Menyimpan metadata pangkalan pengetahuan.
   KnowledgeArtifacts	Menyimpan metadata sumber dan referensi dokumen sumber.
   KnowledgeArtifactChunks	Menyimpan potongan dokumen teks lengkap.
   KnowledgeArtifactChunkSummaries	Menyimpan potongan yang dirangkum dengan penyematan vektor untuk pencarian semantik.

   KBaaS mengembalikan respons 202 Diterima dengan ID operasi untuk melacak kemajuan unggahan.

   Selama proses pengunggahan, KBaaS melakukan operasi untuk mengurai, memotong, meringkas, menyematkan, dan menyimpan konten vektorisasi dalam kontainer Cosmos DB. Ketika proses selesai, status sumber berubah menjadi Selesai atau Gagal, berdasarkan hasilnya.

7. Pantau status unggahan di portal Azure atau dengan menggunakan ID operasi.

8. Setelah KBaaS selesai, lanjutkan ke bagian berikutnya agar Anda dapat menambahkan basis pengetahuan sebagai alat yang dapat digunakan oleh loop agen Anda dalam workflow Standar agentik Anda.

3: Tambahkan pangkalan pengetahuan sebagai alat

Anda sekarang dapat menambahkan basis pengetahuan ke loop agen Anda untuk digunakan sebagai alat dalam alur kerja Standar agentik Anda. Loop agen secara otomatis melakukan kueri ke basis pengetahuan untuk mengambil informasi yang relevan secara semantik dari dokumen yang Anda unggah.

1. Di aplikasi logika Standard yang sama yang menyertakan basis pengetahuan Anda, di perancangnya, buka alur kerja agenik Anda, lalu pilih loop agen yang Anda inginkan.

2. Pada panel informasi agen, di bagian Pangkalan pengetahuan , pilih Buat.

3. Pada panel Buat Koneksi , dari daftar Sumber , pilih pangkalan pengetahuan.

4. Untuk mengunggah lebih banyak file ke pangkalan pengetahuan Anda, pilih + Unggah.

Mengelola pangkalan pengetahuan dan sumber

Untuk mencantumkan, melihat, dan menghapus pangkalan pengetahuan atau sumber, gunakan portal Azure atau REST API.

Mencantumkan semua pangkalan pengetahuan

1. Di portal Azure, buka sumber daya aplikasi logika Standard Anda.

2. Pada bilah sisi aplikasi logika, di bawah Agen, pilih Pangkalan pengetahuan.

Atau, lakukan panggilan REST API berikut:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs

Melihat pangkalan pengetahuan tertentu

Di portal Azure, dari halaman Knowledge base, pilih nama pangkalan pengetahuan.

Atau, lakukan panggilan REST API berikut:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}

Respons mencakup informasi pangkalan pengetahuan, daftar dengan sumber terkait, dan status unggahannya.

Mencantumkan sumber dalam pangkalan pengetahuan

Di portal Azure, pilih pangkalan pengetahuan untuk melihat sumbernya.

Atau, lakukan panggilan REST API berikut:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}/knowledgeArtifacts

Menghapus sumber pengetahuan

Operasi ini menghapus metadata sumber, potongan teks lengkap, dan penyematan vektor dari Cosmos DB. Layanan mengembalikan respons 202 Diterima dengan ID operasi untuk melacak kemajuan penghapusan.

1. Di portal Azure, pilih pangkalan pengetahuan untuk melihat sumbernya.

2. Pilih sumbernya. Di toolbar, pilih Hapus.

Atau, lakukan panggilan REST API berikut:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}/knowledgeArtifacts/{artifactName}

Menghapus pangkalan pengetahuan

Operasi ini menghapus pangkalan pengetahuan dan sumber, gugus, dan ringkasan terkait dari Cosmos DB.

1. Di portal Azure, pilih pangkalan pengetahuan.

2. Di toolbar, pilih Hapus.

Atau, lakukan panggilan REST API berikut:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}

Konten terkait

• Apa itu Azure Logic Apps?
• Azure OpenAI Service
• Azure Cosmos DB Pencarian Vektor
• Penyimpanan vektor terintegrasi - Azure Cosmos DB untuk NoSQL