Adicione classificação semântica a consultas no IA do Azure Search

O Gerenciador de Pesquisa inclui opções de classificação semântica.

1. Entre no portal do Azure.

2. Abra o índice de pesquisa e selecione Gerenciador de pesquisa.

3. Selecione Opções de Consulta. Se você já definiu uma configuração semântica, ela será selecionada por padrão. Se você não tiver uma, crie uma configuração semântica para o índice.

   

4. Insira uma consulta, como "hotel histórico com boa comida" e selecione Pesquisar.

5. Como alternativa, selecione o modo de exibição JSON e cole as definições no editor de consultas:

   

   Aqui está um texto JSON que você pode colar na exibição:

    {
        "queryType": "semantic",
        "search": "historic hotel with good food",
        "semanticConfiguration": "my-semantic-config",
        "answers": "extractive|count-3",
        "captions": "extractive|highlight-true",
        "highlightPreTag": "<strong>",
        "highlightPostTag": "</strong>",
        "select": "HotelId,HotelName,Description,Category",
        "count": true
    }
   

Use Documentos de Pesquisa para formular a solicitação.

A resposta inclui um @search.rerankerScore automaticamente. Se você quiser legendas ou respostas na resposta, adicione legendas e respostas à solicitação.

O exemplo a seguir nesta seção usa o hotels-sample-index para demonstrar a classificação semântica com respostas semânticas e legendas.

1. Cole a solicitação a seguir em um cliente Web como um modelo. Substitua o nome do serviço e o nome do índice por valores válidos.

   POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/search?api-version=2024-07-01      
   {
       "queryType": "semantic",
       "search": "newer hotel near the water with a great restaurant",
       "semanticConfiguration": "my-semantic-config",
       "answers": "extractive|count-3",
       "captions": "extractive|highlight-true",
       "highlightPreTag": "<strong>",
       "highlightPostTag": "</strong>",
       "select": "HotelId,HotelName,Description,Category",
       "count": true
   }
   

2. Defina "queryType" como "semantic".

3. Defina "pesquisa" como uma consulta de pesquisa de texto completo. Sua cadeia de caracteres de pesquisa pode dar suporte à sintaxe simples ou sintaxe Lucene completa. A classificação semântica é uma extensão da pesquisa de texto completo, portanto, embora a "pesquisa" não seja necessária, você não obterá um resultado esperado se for uma pesquisa vazia ("search": "*").

4. Defina "semanticConfiguration" como uma configuração semântica predefinida inserida no índice.

5. Defina "answers" para especificar se as respostas semânticas são incluídas no resultado. Atualmente, o único valor válido para esse parâmetro é extractive. É possível configurar o retorno de no máximo 10 respostas. O padrão é um. Este exemplo mostra uma contagem de três respostas: extractive|count-3.

   As respostas não são garantidas em todas as solicitações. Para obter uma resposta, a consulta deve ser semelhante a uma pergunta e o conteúdo deve incluir um texto parecido com uma resposta.

6. Defina "captions" para especificar se as legendas semânticas são incluídas no resultado. Atualmente, o único valor válido para esse parâmetro é extractive. As legendas podem ser configuradas para retornar resultados com ou sem realces. O padrão é que os realces sejam retornados. Este exemplo retorna legendas sem realces: extractive|highlight-false.

   A base para legendas e respostas são os campos referenciados no "semanticConfiguration". Esses campos estão em um limite combinado no intervalo de 2.000 tokens ou aproximadamente 20.000 caracteres. Se você previr uma contagem de tokens que exceda esse limite, considere uma etapa de agrupamento de dados usando a habilidade Divisão de texto. Essa abordagem introduz uma dependência de um pipeline de enriquecimento de IA e indexadores.

7. Defina "highlightPreTag" e "highlightPostTag" se quiser substituir a formatação de realce padrão aplicada às legendas.

   As legendas aplicam formatação de realce sobre as passagens relevantes no documento que resumem a resposta. O padrão é <em>. Se desejar especificar o tipo de formatação (por exemplo, plano de fundo amarelo), defina as highlightPreTag e highlightPostTag.

8. Defina "select" para especificar quais campos são retornados na resposta e "count" para retornar o número de correspondências no índice. Esses parâmetros melhoram a qualidade da solicitação e a legibilidade da resposta.

9. Envie a solicitação para executar a consulta e retornar os resultados.

Use QueryType ou SemanticQuery para invocar classificação semântica em uma consulta semântica. O exemplo a seguir é da equipe do SDK do Azure.

SearchResults<Hotel> response = await searchClient.SearchAsync<Hotel>(
    "Is there any hotel located on the main commercial artery of the city in the heart of New York?",
    new SearchOptions
    {
        SemanticSearch = new()
        {
            SemanticConfigurationName = "my-semantic-config",
            QueryCaption = new(QueryCaptionType.Extractive),
            QueryAnswer = new(QueryAnswerType.Extractive)
        },
        QueryLanguage = QueryLanguage.EnUs,
        QueryType = SearchQueryType.Semantic
    });

int count = 0;
Console.WriteLine($"Semantic Search Results:");

Console.WriteLine($"\nQuery Answer:");
foreach (QueryAnswerResult result in response.SemanticSearch.Answers)
{
    Console.WriteLine($"Answer Highlights: {result.Highlights}");
    Console.WriteLine($"Answer Text: {result.Text}");
}

await foreach (SearchResult<Hotel> result in response.GetResultsAsync())
{
    count++;
    Hotel doc = result.Document;
    Console.WriteLine($"{doc.HotelId}: {doc.HotelName}");

    if (result.SemanticSearch.Captions != null)
    {
        var caption = result.SemanticSearch.Captions.FirstOrDefault();
        if (caption.Highlights != null && caption.Highlights != "")
        {
            Console.WriteLine($"Caption Highlights: {caption.Highlights}");
        }
        else
        {
            Console.WriteLine($"Caption Text: {caption.Text}");
        }
    }
}
Console.WriteLine($"Total number of search results:{count}");