Tutorial: Menambahkan Pencarian Azure AI ke aplikasi web C# di Azure Container Apps

Note

Pencarian Azure AI tersedia melalui portal Azure, REST API, dan Azure SDK. Ini juga mendukung Foundry IQ, lapisan pengetahuan terkelola yang mengubah konten perusahaan menjadi pangkalan pengetahuan yang dapat digunakan kembali dan sadar izin untuk agen di portal Microsoft Foundry.

Tutorial ini membangun situs web yang mencari melalui katalog buku dan menyebarkan situs web ke Azure Container Apps. Penyebaran menggunakan Azure Developer CLI (azd) dan identitas terkelola sebagai metode autentikasi default untuk Pencarian Azure AI.

Di tutorial ini, Anda akan:

• Terapkan Pencarian Azure AI dan isi indeks secara otomatis dengan Azure Developer CLI.
• Integrasikan kueri pencarian, saran, faset, penomoran halaman, dan pencarian dokumen di aplikasi C#.
• Sebarkan aplikasi untuk Azure Container Apps dengan identitas terkelola sebagai metode autentikasi default.

Apa fungsi sampel?

Contoh situs web ini menyediakan akses ke katalog 10.000 buku. Anda dapat mencari katalog dengan memasukkan teks di bilah pencarian. Saat Anda memasukkan teks, situs web menggunakan fitur saran indeks pencarian untuk melengkapi teks secara otomatis.

Setelah kueri selesai, situs web menampilkan daftar buku dengan sebagian detailnya. Anda dapat memilih buku untuk melihat detail lengkapnya, yang disimpan dalam indeks pencarian.

Pengalaman pencarian meliputi:

• Pencarian - Menyediakan fungsionalitas pencarian untuk aplikasi.
• Suggest - Memberikan saran saat pengguna mengetik di bilah pencarian.
• Faset dan filter - Menyediakan struktur navigasi berfaset yang memfilter berdasarkan penulis atau bahasa.
• Hasil berhalaman - Menyediakan kontrol halaman untuk berpindah antarhalaman hasil.
• Pencarian dokumen - Mencari dokumen menurut ID untuk mengambil semua kontennya untuk halaman detail.

Bagaimana sampel diatur?

Kode sampel mencakup komponen berikut:

Aplikasi	Tujuan	lokasi repositori GitHub
client	Aplikasi React (lapisan presentasi) untuk menampilkan buku dengan pencarian. Memanggil API.	/azure-search-static-web-app/client
api	C# Azure Functions API (lapisan bisnis), dihosting dalam kontainer di Azure Container Apps, yang memanggil API Pencarian Azure AI dengan SDK .NET.	/azure-search-static-web-app/api
bulk-insert	.NET proyek yang membuat indeks dan memuat dokumen. Penyebaran azd menjalankan ini secara otomatis melalui postprovision hook.	/azure-search-static-web-app/bulk-insert
infra	Infrastruktur Bicep yang digunakan oleh azd untuk menerapkan Pencarian Azure AI, Azure Container Apps, serta sumber daya pendukung.	Azure-Samples/azure-search-static-web-app

Menyiapkan lingkungan pengembangan Anda

Instal perangkat lunak berikut untuk lingkungan pengembangan lokal Anda. Perintah ini azd up menyediakan semua sumber daya Azure, termasuk Pencarian Azure AI, sehingga Anda tidak perlu membuatnya sebelumnya.

• .NET 9 atau yang lebih baru
• Git
• Visual Studio Code
• Ekstensi C# Dev Tools untuk Visual Studio Code
• Azure Developer CLI (azd)
• Docker Desktop atau runtime kontainer yang kompatibel dengan Docker lainnya

Tutorial ini tidak menjalankan API Azure Functions secara lokal. Jika Anda ingin menjalankannya secara lokal, instal Azure Functions Core Tools.

Mengkloning sampel pencarian dengan Git

Anda dapat menyebarkan sampel dari klon lokal. Perintah membaca azd up file aplikasi dan infrastruktur dari repositori lokal Anda, membangun kontainer, menyediakan Azure sumber daya, dan menyebarkan klien dan API ke Azure Container Apps.

1. Di terminal Bash, klon aplikasi sampel ke komputer lokal Anda.

   git clone https://github.com/Azure-Samples/azure-search-static-web-app.git
   

2. Di terminal Bash yang sama, buka direktori repositori untuk contoh pencarian ini.

   cd azure-search-static-web-app
   

3. Gunakan perintah Visual Studio Code, code ., untuk membuka repositori. Kecuali ditentukan lain, Anda menyelesaikan tugas yang tersisa di Visual Studio Code.

   code .
   

Langkah selanjutnya

Menyebarkan aplikasi ke Azure Container Apps