Menyebarkan aplikasi C# Pencarian Azure AI ke 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.

Sebarkan situs web yang mendukung pencarian ke Azure Container Apps dengan menggunakan Azure Developer CLI (azd). Penyebaran ini mencakup klien React, API .NET, Pencarian Azure AI, identitas terkelola, dan mendukung sumber daya Azure.

Penyebaran menggunakan identitas terkelola sebagai metode autentikasi default untuk Pencarian Azure AI. Anda dapat ikut serta dalam autentikasi berbasis kunci dengan mengatur USE_KEYLESS_AUTH ke false sebelum penyebaran.

Masuk ke Azure

  1. Di Visual Studio Code, buka terminal di akar repositori, seperti azure-search-static-web-app.

  2. Masuk ke Azure dengan menggunakan azd.

    azd auth login

  3. Jika diminta oleh browser Anda, selesaikan alur masuk dengan menggunakan akun Azure yang Anda gunakan untuk tutorial ini.

Membuat lingkungan azd

  • Buat azd lingkungan. Ganti YOUR-ENVIRONMENT-NAME dengan nama pendek yang mengidentifikasi penyebaran tutorial ini.

    azd env new YOUR-ENVIRONMENT-NAME

(Opsional) Mengonfigurasi autentikasi berbasis kunci

Metode autentikasi default adalah identitas terkelola, sehingga sebagian besar lingkungan dapat melewati bagian ini. Selesaikan bagian ini hanya jika lingkungan Anda memerlukan kunci API.

Atur USE_KEYLESS_AUTH ke false.

azd env set USE_KEYLESS_AUTH false

Jika Anda tidak mengatur USE_KEYLESS_AUTH, penyebaran menggunakan identitas terkelola. Infrastruktur Bicep memberikan akses identitas aplikasi kontainer ke bidang data Pencarian Azure AI.

Menyebarkan dengan azd up

  1. Dari akar repositori, jalankan azd up.

    azd up

  2. Saat diminta, pilih langganan dan lokasi Azure untuk sumber daya.

  3. Tunggu untuk azd menyediakan infrastruktur, membangun kontainer, mendorong gambar, dan menyebarkan layanan ke Azure Container Apps.

  4. Tinjau output setelah penyebaran. Output mencakup nama domain klien dan server yang sepenuhnya memenuhi syarat (FQDN) untuk penyebaran Azure Container Apps.

    AZURE_CLIENT_URL: <client-container-app-fqdn>
AZURE_SERVER_URL: <server-container-app-fqdn>
SEARCH_SERVICE_NAME: <search-service-name>

    AZURE_CLIENT_URL Gunakan nilai untuk membuka situs web. Aplikasi klien memanggil aplikasi server melalui titik akhir yang dikonfigurasi selama penyebaran.

    Penyebaran juga membuat layanan Pencarian Azure AI dan memuat good-books indeks secara otomatis melalui postprovision kait di repositori sampel.

Menggunakan pencarian di situs web Aplikasi Kontainer Anda

  1. Buka FQDN klien dari azd up output di browser.

  2. Di bilah pencarian situs web, masukkan kueri pencarian, seperti code. Fitur lengkapi otomatis menyarankan judul buku yang cocok.

  3. Pilih saran atau lanjutkan memasukkan kueri Anda. Pilih Enter saat Anda menyelesaikan kueri pencarian Anda.

  4. Tinjau hasilnya, lalu pilih buku untuk melihat detail selengkapnya.

Troubleshooting

Jika aplikasi web tidak disebarkan atau berfungsi, gunakan daftar berikut untuk menentukan dan memperbaiki masalah:

  • Apakah azd up selesai?

    azd up Tinjau output untuk langkah provisi, build, atau penyebaran pertama yang gagal. Jika penyebaran berhenti selama provisi, periksa izin langganan Anda dan wilayah yang dipilih. Jika penyebaran berhenti selama langkah-langkah build atau penyebaran kontainer, jalankan azd up kembali setelah Anda memperbaiki masalah yang dilaporkan.

  • Dapatkah Anda membuka titik akhir klien?

    AZURE_CLIENT_URL Buka nilai dari azd up output. Jika halaman tidak dimuat, buka portal Azure, buka aplikasi kontainer klien dan tinjau status dan log revisinya.

  • Bisakah klien memanggil titik akhir server?

    Buka alat pengembang browser Anda dan tinjau panggilan jaringan dari aplikasi klien. Jika panggilan ke API gagal, konfirmasikan bahwa aplikasi kontainer server sedang berjalan dan bahwa aplikasi klien menerima FQDN server selama penyebaran.

  • Bisakah kueri server Pencarian Azure AI?

    Jika pencarian mengembalikan kesalahan, tinjau log aplikasi kontainer server. Untuk identitas terkelola, konfirmasikan bahwa identitas telah Pencarian Azure AI akses data-plane. Untuk autentikasi berbasis kunci, konfirmasikan bahwa Anda mengatur USE_KEYLESS_AUTH ke false sebelum penyebaran dan bahwa lingkungan kontainer yang dihasilkan berisi konfigurasi layanan pencarian.

Membersihkan sumber daya

Gunakan azd down --purge untuk menghapus sumber daya Azure yang dibuat tutorial ini. Bendera --purge secara permanen menghapus sumber daya yang mendukung penghapusan sementara, alih-alih membiarkannya dalam keadaan dapat dipulihkan untuk periode retensi mereka. Pembersihan menghindari konflik penamaan jika Anda menyebarkan ulang tutorial ini nanti.

  1. Dari akar repositori, jalankan perintah pembersihan.

    azd down --purge

  2. Tinjau sumber daya yang azd mencantumkan.

  3. Konfirmasikan penghapusan saat diminta.

Jika Anda membuat layanan Pencarian Azure AI di luar azd penyebaran, buka layanan pencarian Anda di portal Azure dan pilih Hapus di bagian atas halaman.

Langkah selanjutnya

Menjelajahi kode integrasi pencarian

  • Last updated on