Como criar e consumir índices de vetor no Estúdio de IA do Azure

Importante

Os itens marcados (versão prévia) neste artigo estão atualmente em versão prévia pública. Essa versão prévia é fornecida sem um contrato de nível de serviço e não recomendamos isso para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares de Versões Prévias do Microsoft Azure.

Neste artigo, você aprenderá a criar e usar um índice de vetor para executar RAG (Geração Aumentada de Recuperação).

Pré-requisitos

Você deve ter:

  • Um projeto do Estúdio de IA do Azure
  • Um recurso do Azure AI Search

Criar um índice na guia Índices

  1. Entre no Azure AI Studio.

  2. Acesse seu projeto ou crie um projeto novo no Estúdio de IA do Azure.

  3. No menu recolhível à esquerda, selecione Índices em Componentes.

    Captura de tela do menu esquerdo do projeto.

  4. Selecione + Novo Índice

  5. Escolha os seus Dados de origem. Você pode escolher dados de origem em uma lista de suas fontes de dados recentes, um URL de armazenamento na nuvem ou carregar arquivos e pastas do computador local. Você também pode adicionar uma conexão a outra fonte de dados, como o Armazenamento de Blobs do Azure.

    Captura de tela da seleção de dados de origem.

  6. Selecione Próximo depois de escolher os dados de origem

  7. Escolha o Armazenamento de Índice, o local onde você deseja que seu índice seja armazenado

  8. Se você já tiver uma conexão criada para um serviço do Azure AI Search, poderá escolhê-la na lista suspensa.

    Captura de tela da seleção do repositório de índices.

    1. Se você não tiver uma conexão existente, escolha Conectar outro serviço do Azure AI Search
    2. Selecione a assinatura e o serviço que deseja usar.

    Captura de tela da seleção dos detalhes do repositório de índices.

  9. Selecione Próximo depois de escolher o armazenamento de índice

  10. Defina suas Configurações de Pesquisa

    1. As Configurações de vetor são padronizadas como verdadeiras para Adicionar busca em vetores a este recurso de pesquisa. Como observado, isso habilita as opções de pesquisa Híbrida e Híbrida + Semântica. Desabilitar isso limita as opções de busca em vetores para Palavra-chave e Semântica.
    2. Para que a opção híbrida funcione, você precisa de um modelo de inserção. Escolha um modelo de inserção no menu suspenso.
    3. Selecione a confirmação para implantar um modelo de inserção se ele ainda não existir em seu recurso

    Captura de tela da definição de configurações de pesquisa.

    Se um modelo OpenAI não Azure não aparecer no menu suspenso, siga estas etapas:

    1. Navegue até as configurações do projeto no Estúdio de IA do Azure.
    2. Navegue até a seção conexões na guia configurações e selecione Nova conexão.
    3. Selecione Modelo sem servidor.
    4. Digite o nome da implantação do modelo de inserção e selecione Adicionar conexão. Se o modelo não aparecer no menu suspenso, selecione a opção Inserir manualmente.
    5. Insira o ponto de extremidade da API de implantação, o nome do modelo e a chave de API nos campos correspondentes. Em seguida, adicione a conexão.
    6. O modelo de inserção agora deve aparecer no menu suspenso.

    Captura de tela da conexão de um modelo sem servidor.

  11. Selecione Próximo depois de definir as configurações de pesquisa

  12. Nas Configurações de índice

    1. Insira um nome para o índice ou use o nome preenchido automaticamente
    2. Agendar atualizações. Você pode optar por atualizar o índice por hora ou diariamente.
    3. Escolha a computação em que você deseja executar os trabalhos para criar o índice. É possível
      • Selecionar automaticamente para permitir que a IA do Azure escolha um tamanho de VM apropriado disponível
      • Escolher um tamanho de VM em uma lista de opções recomendadas
      • Escolher um tamanho de VM em uma lista de opções possíveis

    Captura de tela da definição de configurações de índice

  13. Selecione Próximo depois de definir as configurações de índice

  14. Reveja os detalhes inseridos e selecione Criar

  15. Você é levado para a página de detalhes do índice em que pode ver o status da criação do índice.

Criar um índice no Playground

  1. Abra o seu projeto do Estúdio de IA do Azure.

  2. Navegue até a guia Playground.

  3. O índice Selecionar o projeto disponível é exibido para os índices existentes no projeto. Se um índice existente não estiver sendo usado, passe para as próximas etapas.

  4. Selecione o menu suspenso Adicionar seus dados.

    Captura de tela do menu suspenso do playground Adicionar seus dados.

  5. Se um novo índice estiver sendo criado, selecione a opção Adicionar seus dados. Em seguida, siga as etapas de Criar um índice na guia Índices para navegar pelo assistente para criar um índice.

    1. Se houver um índice externo sendo usado, selecione a opção Conectar índice externo.

    2. Na Origem do índice

      1. Selecione sua fonte de dados
      2. Selecione seu Serviço de Pesquisa de IA
      3. Selecione o índice a ser usado.

      Captura de tela da página onde você seleciona um índice.

    3. Selecione Avançar depois de definir as configurações de pesquisa.

    4. Nas Configurações de índice

      1. Insira um nome para o índice ou use o nome preenchido automaticamente
      2. Agendar atualizações. Você pode optar por atualizar o índice por hora ou diariamente.
      3. Escolha a computação em que você deseja executar os trabalhos para criar o índice. É possível
        • Selecionar automaticamente para permitir que a IA do Azure escolha um tamanho de VM apropriado disponível
        • Escolher um tamanho de VM em uma lista de opções recomendadas
        • Escolher um tamanho de VM em uma lista de opções possíveis
    5. Examine os detalhes inseridos e selecione Criar.

    6. Agora, o índice está pronto para ser usado no Playground.

Usar um índice no prompt flow

  1. Entre no Estúdio de IA do Azure e selecione seu projeto.

  2. No menu esquerdo recolhível, selecione Prompt flow.

  3. Abra um prompt flow existente ou selecione + Criar para criar um novo fluxo.

  4. No menu superior do designer de fluxo, selecione Mais ferramentas e, em seguida, selecione Pesquisa de índice.

    Captura de tela da Pesquisa de índice vetorial da opção Mais ferramentas.

  5. Forneça um nome para a Ferramenta de Pesquisa de Índice e selecione Adicionar.

  6. Selecione a caixa de valor mlindex_content e selecione o índice. Após concluir essa etapa, insira as consultas e query_types a serem executadas no índice.

    Captura de tela do nó do prompt flow para configurar a pesquisa de índice.