Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Note
Azure AI Vyhledávač je k dispozici prostřednictvím portálu Azure, rozhraní REST API a Sady Azure SDK. Podporuje také Foundry IQ, spravovanou znalostní vrstvu, která transformuje podnikový obsah na opakovaně použitelné znalostní báze s podporou oprávnění pro agenty na portálu Microsoft Foundry.
Tento kurz vytvoří web, který prohledá katalog knih a nasadí web do Azure Container Apps. Nasazení používá Azure Developer CLI (azd) a spravovanou identitu jako výchozí metodu ověřování pro Azure AI Vyhledávač.
V tomto kurzu se naučíte:
- Nasaďte Azure AI Vyhledávač a automaticky nasaďte index pomocí rozhraní příkazového řádku pro vývojáře Azure.
- Integrujte vyhledávací dotazy, návrhy, omezující vlastnosti, stránkování a vyhledávání dokumentů v aplikaci C#.
- Nasaďte aplikaci do Azure Container Apps se spravovanou identitou jako výchozí metodu ověřování.
Co dělá ukázka?
Tento ukázkový web poskytuje přístup k katalogu 10 000 knih. Katalog můžete prohledávat zadáním textu na panelu hledání. Při zadávání textu používá web funkci návrhu indexu vyhledávání k automatickému dokončování textu.
Po dokončení dotazu se na webu zobrazí seznam knih s částí jejich podrobností. Můžete vybrat knihu, abyste viděli její úplné podrobnosti, které jsou uložené v indexu vyhledávání.
Vyhledávací prostředí zahrnuje:
- Vyhledávání – poskytuje funkci vyhledávání pro aplikaci.
- Navrhnout – poskytuje návrhy jako typy uživatelů na panelu hledání.
- Omezující vlastnosti a filtry – Poskytuje fasetovou navigační strukturu, která filtruje podle autora nebo jazyka.
- Stránkované výsledky – poskytuje ovládací prvky stránkování pro posouvání výsledků.
- Vyhledávání dokumentu – vyhledá dokument podle ID a načte veškerý jeho obsah stránky podrobností.
Jak je vzorek uspořádán?
Vzorový kód obsahuje následující komponenty:
| Aplikace | Účel | umístění úložiště GitHub |
|---|---|---|
client |
Aplikace React (prezentační vrstva) k zobrazení knih s hledáním Volá rozhraní API. | /azure-search-static-web-app/client |
api |
Rozhraní API Azure Functions jazyka C# hostované v kontejneru v Azure Container Apps, které volá rozhraní API Azure AI Vyhledávač se sadou .NET SDK. | /azure-search-static-web-app/api |
bulk-insert |
.NET projektu, který vytvoří index a načte dokumenty. Nasazení azd se spustí automaticky prostřednictvím háku postprovision . |
/azure-search-static-web-app/bulk-insert |
infra |
Bicep infrastrukturu azd používanou k nasazení Azure AI Vyhledávač, Azure Container Apps a podpůrných prostředků. |
Azure-Samples/azure-search-static-web-app |
Nastavení vývojového prostředí
Nainstalujte následující software pro místní vývojové prostředí. Příkaz azd up zřídí všechny Azure prostředky, včetně Azure AI Vyhledávač, takže je nemusíte vytvářet předem.
- .NET 9 nebo novější
- Git
- Visual Studio Code
- Rozšíření C# Dev Tools pro Visual Studio Code
-
rozhraní příkazového řádku pro vývojáře Azure (
azd) - Docker Desktop nebo jiný modul runtime kontejneru kompatibilní s Dockerem
Tento kurz nespouští rozhraní API Azure Functions místně. Pokud ho chcete spustit místně, nainstalujte Azure Functions Core Tools.
Naklonování ukázky vyhledávání pomocí Gitu
Ukázku můžete nasadit z místního klonu. Příkaz azd up přečte soubory aplikace a infrastruktury z místního úložiště, sestaví kontejnery, zřídí Azure prostředky a nasadí klienta a rozhraní API do Azure Container Apps.
V terminálu Bash naklonujte ukázkovou aplikaci do místního počítače.
git clone https://github.com/Azure-Samples/azure-search-static-web-app.gitVe stejném terminálu Bash přejděte do adresáře úložiště pro tento příklad hledání.
cd azure-search-static-web-appK otevření úložiště použijte příkaz
code .Visual Studio Code. Pokud neurčíte jinak, dokončíte zbývající úkoly v Visual Studio Code.code .