Tutorial: Adicionar Pesquisa de IA do Azure  a um aplicativo Web C# no Aplicativos de Contêiner do Azure

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.

Captura de tela do aplicativo de exemplo em uma janela do navegador.

A experiência de pesquisa inclui:

  • Pesquisa – Fornece funcionalidade de pesquisa para o aplicativo.
  • Sugestão – Fornece sugestões como os tipos de usuário 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 GitHub local do repositório
client Aplicativo React (camada de apresentação) para exibir livros com pesquisa. Ele chama a API. /azure-search-static-web-app/client
api C# Azure Functions API (camada de negócios), hospedada em um contêiner no Aplicativos de Contêiner do Azure, que chama a API de 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 azd implantação executa isso automaticamente por meio do postprovision gancho. /azure-search-static-web-app/bulk-insert
infra Bicep infraestrutura usada para azd implantar Pesquisa de IA do Azure , Aplicativos de Contêiner do Azure e 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.

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 implantar o exemplo 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.

  1. Em um terminal bash, clone o aplicativo de exemplo no computador local.

    git clone https://github.com/Azure-Samples/azure-search-static-web-app.git
    
  2. No mesmo terminal bash, vá para o diretório do repositório para este exemplo de pesquisa.

    cd azure-search-static-web-app
    
  3. Use 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 .
    

Próximas etapas