Mulai menggunakan 'Obrolan menggunakan sampel data Anda sendiri' untuk .NET

Artikel ini memperlihatkan kepada Anda cara menyebarkan dan menjalankan Chat dengan sampel data Anda sendiri untuk .NET. Sampel ini mengimplementasikan aplikasi obrolan menggunakan C#, Azure OpenAI Service, dan Retrieval Augmented Generation (RAG) di Pencarian Azure AI untuk mendapatkan jawaban tentang manfaat karyawan di perusahaan fiktif. Aplikasi obrolan manfaat karyawan dilengkapi dengan file PDF termasuk buku pegangan karyawan, dokumen manfaat, dan daftar peran dan harapan dalam perusahaan.

• Video demo

Dalam artikel ini, Anda:

• Sebarkan aplikasi obrolan ke Azure.
• Dapatkan jawaban tentang tunjangan karyawan.
• Ubah pengaturan untuk mengubah perilaku respons.

Setelah Anda menyelesaikan prosedur ini, mulai ubah proyek baru dengan kode kustom Anda.

Artikel ini adalah bagian dari kumpulan artikel yang menunjukkan kepada Anda cara membuat aplikasi obrolan menggunakan layanan Azure OpenAI dan Pencarian Azure AI.

Artikel lain dalam koleksi meliputi:

• Python
• JavaScript
• Java

Ikhtisar arsitektur

Dalam aplikasi sampel ini, perusahaan fiktif bernama Contoso Electronics memberikan pengalaman aplikasi obrolan kepada karyawannya untuk mengajukan pertanyaan tentang manfaat, kebijakan internal, dan deskripsi dan peran pekerjaan.

Arsitektur aplikasi obrolan ditampilkan dalam diagram berikut:

• Antarmuka pengguna - Antarmuka obrolan aplikasi adalah aplikasi Blazor WebAssembly . Antarmuka inilah yang menerima kueri pengguna, merutekan permintaan ke backend aplikasi, dan menampilkan respons yang dihasilkan.
• Backend - Backend aplikasi adalah ASP.NET Core Minimal API. Backend menghosting aplikasi web statis Blazor dan merupakan apa yang mengatur interaksi di antara berbagai layanan. Layanan yang digunakan dalam aplikasi ini meliputi:
  • Pencarian Azure AI – Mengindeks dokumen dari data yang disimpan di Akun Azure Storage. Ini membuat dokumen dapat dicari menggunakan kemampuan pencarian vektor.
  • Azure OpenAI Service – Menyediakan Model Bahasa Besar (LLM) untuk menghasilkan respons. Microsoft Agent Framework digunakan bersama dengan Azure OpenAI Service untuk mengatur alur kerja AI yang lebih kompleks.

Biaya

Sebagian besar sumber daya dalam arsitektur ini menggunakan tingkat harga dasar atau konsumsi. Harga konsumsi didasarkan pada penggunaan, yang berarti Anda hanya membayar apa yang Anda gunakan. Untuk menyelesaikan artikel ini, ada biaya, tetapi minimal. Setelah selesai dengan artikel, hapus sumber daya untuk berhenti dikenakan biaya.

Untuk informasi selengkapnya, lihat Azure Samples: Biaya di repositori sampel.

Prasyarat

Lingkungan kontainer pengembangan tersedia dengan semua dependensi yang diperlukan untuk menyelesaikan artikel ini. Anda dapat menjalankan kontainer pengembangan di GitHub Codespaces (di browser) atau secara lokal menggunakan Visual Studio Code.

Untuk mengikuti artikel ini, Anda memerlukan prasyarat berikut:

Codespace (disarankan)

• Langganan Azure - Buat langganan secara gratis
• Izin akun Azure - Akun Azure Anda harus memiliki izin Microsoft.Authorization/roleAssignments/write, seperti Pengguna Access Administrator atau Pemilik.
• akun GitHub

Visual Studio Code

• Langganan Azure - Buat langganan secara gratis
• Izin akun Azure - Akun Azure Anda harus memiliki perizinan Microsoft.Authorization/roleAssignments/write, seperti Administrator Akses Pengguna atau Owner.
• Azure Developer CLI
• Docker Desktop - Mulai Docker Desktop jika belum berjalan
• Visual Studio Code
• Ekstensi Kontainer Dev

Membuka lingkungan pengembangan

Mulai sekarang dengan lingkungan pengembangan yang memiliki semua dependensi yang diinstal untuk menyelesaikan artikel ini.

GitHub Codespaces (disarankan)

GitHub Codespaces menjalankan kontainer pengembangan yang dikelola oleh GitHub dengan Visual Studio Code untuk Web sebagai antarmuka pengguna. Untuk lingkungan pengembangan yang paling mudah, gunakan GitHub Codespaces sehingga Anda memiliki alat dan dependensi pengembang yang benar yang telah diinstal sebelumnya untuk menyelesaikan artikel ini.

Penting

Semua akun GitHub dapat menggunakan Codespace hingga 60 jam gratis setiap bulan dengan 2 instans inti. Untuk informasi selengkapnya, lihat penyimpanan dan jam inti bulanan yang disertakan di GitHub Codespaces.

1. Mulai proses untuk membuat codespace GitHub baru di cabang main dari repositori Azure-Samples/azure-search-openai-demo-csharp GitHub.

2. Agar lingkungan pengembangan dan dokumentasi tersedia secara bersamaan, klik kanan pada Buka di GitHub Codespace tombol, dan pilih Buka tautan di windows baru.

   

3. Pada halaman Buat codespace , tinjau pengaturan konfigurasi codespace, lalu pilih Buat codespace baru:

   

4. Tunggu hingga codespace dimulai. Proses startup ini dapat memakan waktu beberapa menit.

5. Di terminal di bagian bawah layar, masuk ke Azure dengan Azure Developer CLI.

   azd auth login
   

6. Salin kode dari terminal lalu tempelkan ke browser. Ikuti petunjuk untuk mengautentikasi dengan akun Azure Anda.

7. Tugas yang tersisa dalam artikel ini berlangsung dalam konteks kontainer pengembangan ini.

Visual Studio Code

Ekstensi Kontainer Dev untuk Visual Studio Code memerlukan Docker untuk diinstal pada komputer lokal Anda. Ekstensi menghosting kontainer pengembangan secara lokal menggunakan host Docker dengan alat pengembang dan dependensi yang benar yang telah diinstal sebelumnya untuk menyelesaikan artikel ini.

1. Buat direktori lokal baru di komputer Anda untuk proyek tersebut.

   mkdir my-intelligent-app && cd my-intelligent-app
   

2. Buka Visual Studio Code di direktori tersebut:

   code .
   

3. Buka terminal baru di Visual Studio Code.

4. Jalankan perintah azd berikut untuk mengkloning repositori GitHub ke komputer lokal Anda.

   azd init -t azure-search-openai-demo-csharp
   

5. Buka Palet Perintah, lalu cari dan pilih Kontainer Dev: Buka Folder di Kontainer untuk membuka proyek dalam kontainer pengembangan. Tunggu hingga kontainer dev terbuka sebelum melanjutkan.

6. Masuk ke Azure dengan Azure Developer CLI.

   azd auth login
   

   Salin kode dari terminal lalu tempelkan ke browser. Ikuti petunjuk untuk mengautentikasi dengan akun Azure Anda.

7. Latihan yang tersisa dalam proyek ini berlangsung dalam konteks kontainer pengembangan ini.

Sebarkan dan jalankan

Repositori sampel berisi semua file kode dan konfigurasi yang Anda butuhkan untuk menyebarkan aplikasi obrolan ke Azure. Langkah-langkah berikut memandu Anda melalui proses penyebaran contoh ke Azure.

Menyebarkan aplikasi obrolan ke Azure

Penting

Sumber daya Azure yang disiapkan di bagian ini dibebankan biaya segera, terutama dari layanan sumber daya Pencarian Azure AI. Sumber daya ini dapat mengumpulkan biaya bahkan jika Anda mengganggu perintah sebelum sepenuhnya dijalankan.

1. Jalankan perintah Azure Developer CLI berikut untuk menyediakan sumber daya Azure dan menyebarkan kode sumber:

   azd up
   

2. Saat Anda diminta untuk memasukkan nama lingkungan, tetap pendekkan dan huruf kecil. Contohnya,myenv. Ini digunakan sebagai bagian dari nama grup sumber daya.

3. Saat diminta, pilih langganan untuk membuat sumber daya di dalamnya.

4. Saat Anda diminta untuk memilih lokasi untuk pertama kalinya, pilih lokasi di dekat Anda. Lokasi ini digunakan untuk sebagian besar sumber daya termasuk hosting.

5. Jika Anda dimintai lokasi untuk model OpenAI, pilih lokasi yang ada di dekat Anda. Jika lokasi yang sama tersedia sebagai lokasi pertama Anda, pilih lokasi tersebut.

6. Tunggu hingga aplikasi disebarkan. Penyebaran mungkin membutuhkan waktu hingga 20 menit untuk diselesaikan.

7. Setelah aplikasi berhasil disebarkan, URL muncul di terminal.

8. Pilih URL yang diberi Deploying service web label untuk membuka aplikasi obrolan di browser.

   

Menggunakan aplikasi obrolan untuk mendapatkan jawaban dari file PDF

Aplikasi obrolan telah dimuat sebelumnya dengan informasi manfaat karyawan dari file PDF. Anda dapat menggunakan aplikasi obrolan untuk mengajukan pertanyaan tentang manfaatnya. Langkah-langkah berikut memandu Anda melalui proses penggunaan aplikasi obrolan.

1. Di browser, navigasikan ke halaman Obrolan menggunakan navigasi kiri.

2. Pilih atau masukkan "Apa yang disertakan dalam paket Northwind Health Plus saya yang tidak ada dalam standar?" di kotak teks obrolan. Respons Anda mirip dengan gambar berikut.

   

3. Dari jawaban, pilih kutipan. Jendela pop-up terbuka menampilkan sumber informasi.

   

4. Navigasi antara tab di bagian atas kotak jawaban untuk memahami bagaimana jawaban dihasilkan.

   Tab	Deskripsi
   Proses pemikiran	Ini adalah skrip interaksi dalam obrolan. Anda dapat melihat permintaan sistem (content) dan pertanyaan pengguna Anda (content).
   Konten pendukung	Ini termasuk informasi untuk menjawab pertanyaan Anda dan materi sumber. Jumlah kutipan materi sumber dicatat dalam pengaturan Pengembang. Nilai defaultnya adalah 3.
   Kutipan	Ini menampilkan halaman sumber yang berisi kutipan.

5. Setelah selesai, navigasikan kembali ke tab jawaban.

Menggunakan pengaturan aplikasi obrolan untuk mengubah perilaku respons

Kecerdasan obrolan ditentukan oleh model OpenAI dan pengaturan yang digunakan untuk berinteraksi dengan model.

Pengaturan	Deskripsi
Ambil alih templat perintah	Ini adalah perintah yang digunakan untuk menghasilkan jawaban.
Ambil hasil pencarian sebanyak ini	Ini adalah jumlah hasil pencarian yang digunakan untuk menghasilkan jawabannya. Anda dapat melihat sumber-sumber ini dikembalikan dalam tab Proses Pemikiran dan Konten Pendukung dari kutipan.
Mengecualikan kategori	Ini adalah kategori dokumen yang dikecualikan dari hasil pencarian.
Gunakan pemeringkat semantik untuk memproses pengambilan informasi	Ini adalah fitur Pencarian Azure AI yang menggunakan pembelajaran mesin untuk meningkatkan relevansi hasil pencarian.
Mode pengambilan data	Vektor + Teks berarti bahwa hasil pencarian didasarkan pada teks dokumen dan penyematan dokumen. Vektor berarti bahwa hasil pencarian didasarkan pada penyematan dokumen. Teks berarti bahwa hasil pencarian didasarkan pada teks dokumen.
Menggunakan ringkasan kontekstual kueri alih-alih seluruh dokumen	Ketika keduanya Use semantic ranker dan Use query-contextual summaries diperiksa, LLM menggunakan deskripsi yang diekstrak dari bagian-bagian penting, alih-alih dari semua bagian, dalam dokumen berperingkat tertinggi.
Sarankan pertanyaan tindak lanjut	Minta aplikasi obrolan menyarankan pertanyaan tindak lanjut berdasarkan jawabannya.

Langkah-langkah berikut menuntun melalui proses mengubah pengaturan.

1. Di peramban, pilih ikon roda gigi di pojok kanan atas halaman.

2. Jika tidak dipilih, pilih kotak centang Sarankan pertanyaan tindak lanjut dan ajukan pertanyaan yang sama lagi.

   What is included in my Northwind Health Plus plan that is not in standard?
   

   Obrolan mungkin kembali dengan saran pertanyaan tindak lanjut.

3. Di tab Pengaturan, hapus centang Gunakan pemeringkat semantik untuk pengambilan.

4. Ajukan pertanyaan yang sama lagi.

   What is my deductible?
   

5. Apa perbedaan dalam jawabannya?

   Respons yang menggunakan ranker Semantic memberikan satu jawaban. Respons tanpa peringkat semantik mengembalikan jawaban yang kurang langsung.

Membersihkan sumber daya

Untuk menyelesaikannya, bersihkan sumber daya codeSpaces Azure dan GitHub yang Anda gunakan.

Membersihkan sumber daya Azure

Sumber daya Azure yang dibuat dalam artikel ini ditagihkan ke langganan Azure Anda. Jika Anda tidak mengharapkan untuk membutuhkan sumber daya ini di masa mendatang, hapus sumber daya tersebut untuk menghindari dikenakan lebih banyak biaya.

Jalankan perintah Azure Developer CLI berikut untuk menghapus sumber daya Azure dan menghapus kode sumber:

azd down --purge

Membersihkan GitHub Codespace

GitHub Codespace

Menghapus lingkungan GitHub Codespaces memastikan bahwa Anda dapat memaksimalkan jumlah pemberian izin per jam inti gratis yang Anda dapatkan untuk akun Anda.

Penting

Untuk informasi selengkapnya tentang hak istimewa akun GitHub Anda, lihat penyimpanan dan jam inti GitHub Codespaces yang disertakan setiap bulan.

1. Masuk ke dasbor GitHub Codespaces (https://github.com/codespaces).

2. Temukan codespace yang sedang berjalan yang bersumber dari repositori Azure-Samples/azure-search-openai-demo-csharp GitHub.

   

3. Buka menu konteks untuk codespace, lalu pilih Hapus.

   

Visual Studio Code

Anda tidak perlu membersihkan lingkungan lokal, tetapi Anda dapat menghentikan kontainer pengembangan yang sedang berjalan dan kembali berjalan Visual Studio Code secara lokal.

1. Buka Palet Perintah, cari perintah Kontainer Dev, lalu pilih Kontainer Dev: Buka Kembali Folder Secara Lokal.

   

Petunjuk / Saran

Visual Studio Code menghentikan kontainer pengembangan yang sedang berjalan, tetapi kontainer masih ada di Docker dalam status berhenti. Anda juga dapat menghapus instans kontainer, gambar kontainer, dan volume dari Docker untuk mengosongkan lebih banyak ruang di komputer lokal Anda.

Dapatkan bantuan

Repositori sampel ini menawarkan informasi pemecahan masalah.

Jika masalah Anda tidak diatasi, catat masalah Anda ke repositori Issues.

Langkah berikutnya

• Dapatkan kode sumber untuk sampel yang digunakan dalam artikel ini
• Membangun aplikasi obrolan dengan Azure OpenAI arsitektur praktik terbaik solusi
• Kontrol Akses di Aplikasi AI Generatif dengan Pencarian Azure AI
• Bangun solusi OpenAI siap untuk perusahaan dengan Azure API Management
• Mengungguli pencarian vektor dengan kemampuan pengambilan dan peringkat hibrida