1 - Python ile web sitesine arama eklemeye genel bakış
Bu öğretici, kitap kataloğunda arama yapmak için bir web sitesi oluşturur ve ardından web sitesini bir Azure Statik Web Uygulamasına dağıtır.
Örnek ne yapar?
Bu örnek web sitesi 10.000 kitaplık bir kataloğa erişim sağlar. Kullanıcı, arama çubuğuna metin girerek katalogda arama yapabilir. Kullanıcı metin girerken web sitesi, metni tamamlamak için arama dizininin öneri özelliğini kullanır. Sorgu tamamlandıktan sonra, kitap listesi ayrıntıların bir bölümüyle birlikte görüntülenir. Kullanıcı, kitabın arama dizininde depolanan tüm ayrıntıları görmek için bir kitap seçebilir.
Arama deneyimi şunları içerir:
- Arama – uygulama için arama işlevi sağlar.
- Öneri – kullanıcı arama çubuğuna yazarken öneriler sağlar.
- Modeller ve filtreler : Yazara veya dile göre filtreleyen modelli bir gezinti yapısı sağlar.
- Sayfalandırılmış sonuçlar - Sonuçlar arasında gezinmek için sayfalama denetimleri sağlar.
- Belge Arama – Ayrıntılar sayfasının tüm içeriğini almak için bir belgeyi kimlikle arar.
Örnek nasıl düzenlenmiştir?
Örnek kod aşağıdakileri içerir:
| Uygulama | Amaç | GitHub Depo Konum |
|---|---|---|
| İstemci | Arama ile kitapları görüntülemek için React uygulaması (sunu katmanı). Azure İşlevi uygulamasını çağırır. | /search-website-functions-v4/client |
| Sunucu | Azure İşlevi uygulaması (iş katmanı) - Python SDK'sını kullanarak Azure AI Arama API'sini çağırır | /search-website-functions-v4/api |
| Toplu ekleme | Dizini oluşturmak ve buna belge eklemek için Python dosyası. | /search-website-functions-v4/bulk-upload |
Geliştirme ortamınızı ayarlama
Yerel geliştirme ortamınız için aşağıdakileri yükleyin.
- Python 3.9
- Git
- Visual Studio Code ve aşağıdaki uzantılar
- Azure Statik Web Uygulaması
- Komut satırı işlemleri için tümleşik terminali kullanın.
- Isteğe bağlı:
- Bu öğretici, Azure İşlevi API'sini yerel olarak çalıştırmaz, ancak yerel olarak çalıştırmak istiyorsanız azure-functions-core-tools yüklemeniz gerekir.
Git ile arama örneğini çatallama ve kopyalama
Örnek deponun çatalını oluşturma, statik web uygulamasını dağıtabilmek için kritik öneme sahiptir. Web uygulamaları, kendi GitHub çatal konumunuza göre derleme eylemlerini ve dağıtım içeriğini belirler. Statik Web Uygulamasında kod yürütme uzaktır ve Azure statik web uygulamaları çatallanmış örneğinizdeki koddan okur.
GitHub'da örnek deponun çatalını oluşturun.
GitHub hesabınızla web tarayıcınızda çatal işlemini tamamlayın. Bu öğreticide, azure statik web uygulamasına dağıtımın bir parçası olarak çatalınız kullanılır.
Bash terminalinde örnek uygulamayı yerel bilgisayarınıza indirin.
değerini GitHub diğer adınızla değiştirin
YOUR-GITHUB-ALIAS.git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-python-samples.gitVisual Studio Code'da kopyalanan deponun yerel klasörünüzü açın. Kalan görevler belirtilmediği sürece Visual Studio Code'dan gerçekleştirilir.
Azure kaynaklarınız için kaynak grubu oluşturma
Visual Studio Code'da Etkinlik çubuğunu açın ve Azure simgesini seçin.
Henüz oturum açmadıysanız Azure'da oturum açın.
Kaynaklar bölümünde Ekle ()+ öğesini ve ardından Kaynak Grubu Oluştur'u seçin.
Gibi
cognitive-search-demo-rgbir kaynak grubu adı girin.Bir bölge girin:
- Node.js için öğesini seçin
West US 2. Bu, Azure İşlevi programlama modeli (PM) v4 önizlemesi için önerilen bölgedir. - C# ve Python için azure static web apps tarafından desteklenen şu bölgeleri öneririz:
West US 2, ,East US 2,West Europe,Central US,East Asia
- Node.js için öğesini seçin
Bu öğretici sırasında oluşturulan tüm kaynaklar için bu kaynak grubunu kullanın. Kaynak grubu, işiniz bittiğinde kaynakları silmek de dahil olmak üzere kaynakları yönetmeniz için bir mantıksal birim sağlar.