Exemplos de C# para o Azure AI Search
Você pode explorar 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 acessar 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 | Description |
|---|---|
| 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 em 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 usando os SDKs do Azure | 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-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 | Description |
|---|---|---|
| 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 | Description |
|---|---|---|
| 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 de Pesquisa de IA do Azure, mas não são referenciados na documentação. Os arquivos readme associados fornecem instruções de uso.
| Exemplos | Repositório | Description |
|---|---|---|
| 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 de acordo com 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 e, no processo, cria 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 demonstrando conexões de indexador e indexação de arquivos e pastas do Azure Data Lake Gen2 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 soluções conquistadas |