Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Note
Pesquisa de IA do Azure está disponível por meio do portal Azure, APIs REST e SDKs do Azure. Ele também sustenta o IQ do Foundry, a camada de conhecimento gerenciado que transforma o conteúdo da empresa em bases de conhecimento reutilizáveis e com reconhecimento de permissão para agentes no portal do Microsoft Foundry.
Este tutorial cria um site que pesquisa um catálogo de livros e implanta o site para Aplicativos de Contêiner do Azure. A implantação usa a CLI do Desenvolvedor do Azure (azd) e a identidade gerenciada como o método de autenticação padrão para Pesquisa de IA do Azure .
Neste tutorial, você:
- Implante Pesquisa de IA do Azure e gere automaticamente um índice com a CLI do Desenvolvedor do Azure.
- Integre consultas de pesquisa, sugestões, facetas, paginação e pesquisa de documentos no aplicativo C#.
- Implante o aplicativo para Aplicativos de Contêiner do Azure com a identidade gerenciada como o método de autenticação padrão.
O que o exemplo faz?
Este site de exemplo fornece acesso a um catálogo de dez mil livros. Você pode pesquisar o catálogo digitando texto na barra de pesquisa. Enquanto você insere texto, o site usa o recurso de sugestão do índice de pesquisa para preenchimento automático do texto.
Quando a consulta é concluída, o site exibe a lista de livros com uma parte de seus detalhes. Você pode selecionar um livro para ver seus detalhes completos, que são armazenados no índice de pesquisa.
A experiência de pesquisa inclui:
- Pesquisa – Fornece funcionalidade de pesquisa para o aplicativo.
- Sugerir - Fornece sugestões à medida que o usuário digita na barra de pesquisa.
- Facetas e filtros – Fornece uma estrutura de navegação facetada que filtra por autor ou idioma.
- Resultados paginados – Fornece controles de paginação para rolar os resultados.
- Pesquisa de documento – pesquisa um documento por ID para recuperar todo o conteúdo da página de detalhes.
Como o exemplo é organizado?
O código de exemplo inclui os seguintes componentes:
| Aplicativo | Finalidade | Localização do repositório no GitHub |
|---|---|---|
client |
Aplicativo React (camada de apresentação) para exibir livros com pesquisa. Ele chama a API. | /azure-search-static-web-app/client |
api |
API do Azure Functions em C# (camada de negócio), hospedada em um contêiner no Aplicativos de Contêiner do Azure, que chama a API do Pesquisa de IA do Azure com o SDK do .NET. | /azure-search-static-web-app/api |
bulk-insert |
.NET projeto que cria o índice e carrega documentos. A implantação azd executa isso automaticamente por meio do hook postprovision. |
/azure-search-static-web-app/bulk-insert |
infra |
Infraestrutura Bicep usada por azd para implantar o Pesquisa de IA do Azure , o Aplicativos de Contêiner do Azure e os recursos de suporte. |
Azure-Samples/azure-search-static-web-app |
Configurar seu ambiente de desenvolvimento
Instale o software a seguir para seu ambiente de desenvolvimento local. O azd up comando provisiona todos os recursos Azure, incluindo Pesquisa de IA do Azure , portanto, você não precisa criá-los com antecedência.
- .NET 9 ou posterior
- Git
- Código do Visual Studio
- Extensão C# Dev Tools para Visual Studio Code
-
CLI do desenvolvedor do Azure (
azd) - Docker Desktop ou outro runtime de contêiner compatível com Docker
Este tutorial não executa a API Azure Functions localmente. Se você quiser executá-lo localmente, instale Azure Functions Core Tools.
Clonar o exemplo de pesquisa com o Git
Você pode fazer o deploy do exemplo a partir de um clone local. O azd up comando lê os arquivos de aplicativo e infraestrutura do repositório local, cria os contêineres, provisiona Azure recursos e implanta o cliente e a API para Aplicativos de Contêiner do Azure.
Em um terminal bash, clone o aplicativo de exemplo no computador local.
git clone https://github.com/Azure-Samples/azure-search-static-web-app.gitNo mesmo terminal do Bash, vá até o diretório do repositório deste exemplo de pesquisa.
cd azure-search-static-web-appUse o comando
code .Visual Studio Code para abrir o repositório. A menos que especificado de outra forma, você concluirá as tarefas restantes em Visual Studio Code.code .