Exemplos de C# para o Azure AI Search

Saiba mais sobre os exemplos de código C# que demonstram a funcionalidade e o fluxo de trabalho de uma solução Azure AI Search. Esses exemplos usam a biblioteca de cliente do Azure AI Search para o SDK do Azure para .NET, que você pode explorar por meio dos links a seguir.

Destino	Ligação
Download do pacote	www.nuget.org/packages/Azure.Search.Documents/
Referência da API	azure.search.documents
Casos de teste de API	github.com/Azure/azure-sdk-for-net/tree/main/sdk/search/Azure.Search.Documents/tests
Código fonte	github.com/Azure/azure-sdk-for-net/tree/main/sdk/search/Azure.Search.Documents/src
Registo de alterações	https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/search/Azure.Search.Documents/CHANGELOG.md

Exemplos de SDK

Exemplos de código da equipe de desenvolvimento do SDK do Azure demonstram o uso da API. Você pode encontrar esses exemplos no GitHub.

Exemplo	Descrição
Olá mundo - síncrono	Demonstra como criar um cliente, autenticar e manipular erros usando métodos síncronos.
Olá mundo - assíncrono	Demonstra como criar um cliente, autenticar e manipular erros usando métodos assíncronos.
Operações de nível de serviço	Demonstra como criar índices, indexadores, fontes de dados, conjuntos de habilidades e mapas de sinônimos. Este exemplo também mostra como obter estatísticas de serviço e como consultar um índice.
Operações de índice	Demonstra como executar uma ação no índice existente, neste caso, obtendo uma contagem de documentos armazenados no índice.
FieldBuilderIgnore	Demonstra uma técnica para trabalhar com tipos de dados sem suporte.
Indexação de documentos (modelo push)	Indexação de modelo push , onde você envia uma carga JSON para um índice em um serviço.
Exemplo de chave de criptografia	Demonstra o uso de uma chave de criptografia gerenciada pelo cliente para adicionar uma camada extra de proteção sobre conteúdo confidencial.
Exemplo de pesquisa vetorial	Mostra como indexar um campo vetorial e executar a pesquisa vetorial usando o SDK do Azure para .NET.
Exemplo de classificação semântica	Mostra como configurar o classificador semântico em um índice e invocar consultas semânticas usando o SDK do Azure para .NET.

Amostras de documentos

Exemplos de código da equipe do Azure AI Search demonstram recursos e fluxos de trabalho. Todos os exemplos a seguir são referenciados em tutoriais, inícios rápidos e artigos de instruções que explicam o código em detalhes. Você pode encontrar esses exemplos em Azure-Samples/azure-search-dotnet-samples e Azure-Samples/search-dotnet-getting-started no GitHub.

Gorjeta

Experimente o navegador de exemplos para procurar exemplos de código da Microsoft no GitHub, filtrados por produto, serviço e idioma.

Exemplo de código	Artigo relacionado	Propósito
criar-mvc-app	Tutorial: Adicionar pesquisa a um aplicativo ASP.NET Core (MVC)	Embora a maioria dos exemplos sejam aplicativos de console, esse exemplo de MVC usa uma página da Web para fazer frente ao índice de hotéis de exemplo, demonstrando pesquisa básica, paginação e outros comportamentos do lado do servidor.
início rápido	Guia de início rápido: pesquisa de texto completo	Abrange o fluxo de trabalho básico para criar, carregar e consultar um índice de pesquisa em C# usando dados de exemplo.
Guia de início rápido para recuperação agentic	Início Rápido: Executar a busca agente na Pesquisa de IA do Azure	Cria um agente de conhecimento no Azure AI Search para integrar o raciocínio LLM no planejamento de consultas.
Guia de início rápido-semântica-pesquisa	Guia de início rápido: classificação semântica usando os SDKs do Azure	Mostra o esquema de índice e a solicitação de consulta para invocar o classificador semântico.
pesquisar-site	Tutorial: Adicionar pesquisa a aplicações Web	Demonstra um aplicativo de pesquisa de ponta a ponta que inclui upload em massa usando as APIs de push e um cliente avançado para hospedar o aplicativo e lidar com solicitações de pesquisa.
tutorial-ai-enriquecimento	Tutorial: conteúdo pesquisável gerado por IA a partir de blobs do Azure	Mostra como configurar um indexador e um conjunto de habilidades.
múltiplas fontes de dados	Tutorial: Índice de várias fontes de dados	Mescla conteúdo de duas fontes de dados em um índice de pesquisa.
Otimizar a indexação de dados	Tutorial: Otimizar a indexação com a API push	Demonstra técnicas de otimização para enviar dados por push para um índice de pesquisa.
DotNetHowTo	Como usar a biblioteca de cliente .NET	Percorre o fluxo de trabalho básico, mas com mais detalhes e com discussão sobre o uso da API.
DotNetToIndexers	Tutorial: Indexar dados SQL do Azure	Mostra como configurar um indexador SQL do Azure que tem uma agenda, mapeamentos de campo e parâmetros.
DotNetHowToEncryptionUsingCMK	Como configurar chaves gerenciadas pelo cliente para criptografia de dados	Mostra como criar objetos criptografados com uma Chave do Cliente.
DotNetVectorDemo	Leia-me	Crie, carregue e consulte um índice vetorial.
DotNetIntegratedVectorizationDemo	Leia-me	Estende o fluxo de trabalho vetorial para incluir automação baseada em habilidades para fragmentação e incorporação de dados.

Aceleradores

Um acelerador é uma solução completa que inclui código e documentação que você pode adaptar para sua própria implementação de um cenário específico.

Exemplos	Repositório	Descrição
Pesquisa + QnA Maker Accelerator	pesquisa-qna-maker-accelerator	Uma solução que combina o poder da Pesquisa e do QnA Maker. Veja o site de demonstração ao vivo.
Acelerador de Soluções de Extração de Conhecimentos	azure-search-knowledge-mining	Inclui modelos, arquivos de suporte e relatórios analíticos para ajudá-lo a prototipar uma solução completa de mineração de conhecimento.

Demonstrações

Um repositório de demonstração fornece código-fonte de prova de conceito para exemplos ou cenários mostrados em demonstrações. As soluções de demonstração não são projetadas para adaptação pelos clientes.

Exemplos	Repositório	Descrição
Aplicação de pesquisa Covid-19	COVID19SEARCH	Repositório de código-fonte para o Aplicativo de Pesquisa Covid-19 baseado no Azure AI Search.
Demonstração do JFK	Arquivos JFK do AzureSearch	Saiba mais sobre a solução JFK.

Outras amostras

Os exemplos a seguir também são publicados pela equipe do Azure AI Search, mas não são referenciados na documentação. Os arquivos readme associados fornecem instruções de uso.

Exemplos	Repositório	Descrição
Consultar vários serviços	azure-search-dotnet-scale	Emita uma única consulta em vários serviços de pesquisa e combine os resultados em uma única página.
Verificar armazenamento	azure-search-dotnet-utilities	Invoca uma função do Azure que verifica o armazenamento do serviço de pesquisa em uma agenda.
Exportar um índice	azure-search-dotnet-utilities	Aplicativo de console C# que particiona e exporta um índice grande.
Backup e restauração de um índice	azure-search-dotnet-utilities	Aplicativo de console C# que copia um índice de um serviço para outro, criando arquivos JSON em seu computador com o esquema de índice e documentos.
Index Data Lake Gen2 usando o Microsoft Entra ID	azure-search-dotnet-utilities	Código-fonte que demonstra conexões de indexador e indexação de arquivos e pastas do Azure Data Lake Gen2 que são protegidos por meio da ID do Microsoft Entra e controles de acesso baseados em função.
Agregações de pesquisa	azure-search-dotnet-utilities	Código-fonte de prova de conceito que demonstra como obter agregações de um índice de pesquisa e, em seguida, filtrar por elas.
Competências de Potência	azure-search-power-skills	Código-fonte para habilidades personalizadas consumíveis que você pode incorporar em suas próprias soluções.