Tutorial: Parte 1 – Criar recursos para criar um aplicativo de chat personalizado com o SDK de prompt flow

  • Artigo

Neste tutorial, você usará o SDK de prompt flow (e outras bibliotecas) para criar, configurar, avaliar e implantar um aplicativo de chat para a sua empresa de varejo chamada Contoso Trek. Sua empresa de varejo é especializada em equipamentos e roupas de acampamento ao ar livre. O aplicativo de chat deve responder perguntas sobre seus produtos e serviços. Por exemplo, o aplicativo de chat pode responder a perguntas como "qual é a barraca mais impermeável?" ou "qual é o melhor saco de dormir para o frio?".

Este tutorial é a parte um de um tutorial de três partes. Esta parte um mostra como um administrador de uma assinatura do Azure cria e configura os recursos necessários para as partes dois e três da série de tutoriais. As partes dois e três mostram como um desenvolvedor usa os recursos. Em muitas organizações, a mesma pessoa pode assumir ambas as funções. Nesta parte 1, você vai aprender como fazer o seguinte:

  • Criar um hub do Estúdio de IA do Azure
  • Criar um projeto
  • Criar um índice da Pesquisa de IA do Azure
  • Configurar o acesso para os recursos do Estúdio de IA do Azure e da Pesquisa de IA do Azure

Se você concluiu outros tutoriais ou guias de início rápido, talvez já tenha criado alguns dos recursos necessários para este tutorial. Se você tiver feito isso, fique à vontade para ignorar as presentes etapas.

Este tutorial é a parte um de um tutorial de três partes.

Pré-requisitos

Importante

Você deve ter as permissões necessárias para adicionar atribuições de funções à sua assinatura do Azure. A concessão de permissões por atribuição de funções só é permitida pelo Proprietário dos recursos específicos do Azure. Talvez seja necessário pedir ao proprietário da assinatura do Azure (que pode ser o seu administrador de TI) para concluir este tutorial para você.

Estúdio de IA do Azure e portal do Azure

Neste tutorial, você usará os recursos do Azure para criar o aplicativo de chat. Você usará o Estúdio de IA do Azure e o portal do Azure para criar e configurar esses recursos.

  • Como administrador, você usa o portal do Azure para configurar o acesso aos recursos.
  • Como desenvolvedor, você usa o Estúdio de IA do Azure para agrupar os recursos necessários para criar, avaliar e implantar o aplicativo de chat. Você também pode interagir com seus modelos e implantações no Estúdio de IA.

Criar um hub do Estúdio de IA do Azure

Para criar um hub no Estúdio de IA do Azure, siga estas etapas:

  1. Vá para a Página Inicial no Estúdio de IA do Azure e entre com sua conta do Azure.

  2. Selecione Todos os hubs no painel esquerdo e selecione + Novo hub.

    Captura de tela do botão para criar um novo hub.

  3. Na caixa de diálogo Criar um novo hub, insira um nome para o hub (como hub contoso) e selecione Próximo. Deixe a opção padrão Conectar Serviços de IA do Azure selecionada. Uma nova conexão de serviços de IA será criada para o hub.

    Captura de tela da caixa de diálogo para conectar serviços durante a criação de um novo hub.

  4. Examine as informações e selecione Criar.

    Captura de tela da caixa de diálogo para revisar as configurações do novo hub.

  5. Você pode exibir o progresso da criação do hub no assistente.

    Captura de tela da caixa de diálogo para revisar o progresso da criação de recursos do hub.

Criar um projeto

Para criar um projeto no Estúdio de IA do Azure, siga estas etapas:

  1. Acesse a página Início do Estúdio de IA do Azure.
  2. Selecione + New project.
  3. Insira um nome para o projeto.
  4. Selecione o hub que você criou na etapa anterior.

Após um projeto ter sido criado, você poderá acessar o playground, as ferramentas e outros ativos no painel de navegação do lado esquerdo.

Criar um índice da Pesquisa de IA do Azure

A meta com este aplicativo é fundamentar as respostas do modelo em seus dados personalizados. O índice de pesquisa é usado para recuperar documentos relevantes com base na pergunta do usuário.

Para criar um índice de pesquisa, você precisa de um serviço e de uma conexão da Pesquisa de IA do Azure.

Observação

Exitem custos associados à criação de um serviço Pesquisa de IA do Azure e dos índices de pesquisa subsequentes. Você pode ver os detalhes sobre preços e tipos de preço do serviço de Pesquisa de IA do Azure na página da criação para confirmar os custos antes de criar o recurso.

Criar um serviço de Pesquisa de IA do Azure

Se você já tiver um serviço Pesquisa de IA do Azure, poderá pular para a próxima seção.

Caso contrário, você poderá criar um serviço Pesquisa de IA do Azure usando o portal do Azure.

  1. Criar um serviço de Pesquisa de IA do Azure no portal do Azure.
  2. Selecione seu grupo de recursos e os detalhes da instância. Você pode conferir os detalhes de preços e tipos de preços nessa página.
  3. Continue por meio do assistente e selecione Revisar + atribuir para criar o recurso.
  4. Confirme os detalhes do seu serviço de Pesquisa de IA do Azure, incluindo os custos estimados.
  5. Selecione Criar para criar o serviço Pesquisa de IA do Azure.

Conectar a Pesquisa de IA do Azure ao seu projeto

Se já tiver uma conexão da Pesquisa de IA do Azure no seu projeto, você poderá prosseguir para configurar o acesso para o serviço de Pesquisa de IA do Azure.

No Estúdio de IA do Azure, verifique se há um recurso conectado da Pesquisa de IA do Azure.

  1. No AI Studio, acesse seu projeto e selecione Configurações no painel esquerdo.
  2. Na seção Recursos conectados, procure para ver se você tem uma conexão do tipo Pesquisa de IA do Azure.
  3. Se você tiver uma conexão da Pesquisa de IA do Azure, poderá pular para configurar o acesso aos recursos.
  4. Caso contrário, selecione Nova conexão e, em seguida, Pesquisa de IA do Azure.
  5. Localize seu serviço de Pesquisa de IA do Azure nas opções e selecione Adicionar conexão.
  6. Continue usando o assistente para criar a conexão. Para obter mais informações sobre como adicionar conexões, confira esse guia de instruções.

Configurar o acesso aos recursos

Esta seção mostra como configurar os vários controles de acesso necessários para os recursos criados nas seções anteriores.

Recomendamos usar o Microsoft Entra ID em vez de chaves de API. Para usar esta autenticação, você precisa definir os controles de acesso corretos e atribuir as funções corretas para os seus serviços.

Configurar o acesso para os Serviços de IA do Azure

Comece no projeto para localizar o recurso dos Serviços de IA:

  1. No AI Studio, acesse seu projeto e selecione Configurações no painel esquerdo.
  2. Selecione Recursos conectados.
  3. Selecione o nome dos Serviços de IA ou do OpenAI do Azure na lista de recursos conectados para abrir a página de detalhes do recurso. Em seguida, selecione o nome do recurso novamente na página Detalhes da conexão, que abre o recurso no portal do Azure.

Especifique o controle de acesso no portal do Azure:

  1. Na página à esquerda no portal do Azure, selecione Controle de acesso (IAM)>+ Adicionar>Adicionar atribuição de função.
  2. Pesquise a função Usuário do OpenAI dos Serviços Cognitivos e selecione-a. Em seguida, selecione Avançar.
  3. Selecione Usuário, grupo ou entidade de serviço. Em seguida, selecione Selecionar membros.
  4. No painel Selecionar membros que é aberto, pesquise o nome do usuário para o qual você deseja adicionar a atribuição de função. Selecione o usuário e selecione Selecionar.
  5. Continue por meio do assistente e selecione Examinar + atribuir para adicionar a atribuição de função.

Agora volte para Estúdio de IA Configurações>Recursos conectados. Desta vez, selecione o nome da Pesquisa de IA do Azure na lista de recursos conectados para abrir a página de detalhes do recurso. Em seguida, selecione o nome do recurso novamente na página Detalhes da conexão, que abre o recurso no portal do Azure.

Para habilitar o controle de acesso baseado em função no seu serviço de Pesquisa de IA do Azure, siga essas etapas:

  1. No serviço de Pesquisa de IA do Azure, no portal do Azure, selecione Configurações > Chaves no painel do lado esquerdo.

  2. Selecione Ambos para garantir que tanto as chaves de API quanto o controle de acesso baseado em função estejam habilitados para o seu serviço de Pesquisa de IA do Azure.

    Captura de tela mostrando a configuração do controle de Acesso à API.

Aviso

Você pode usar o controle de acesso baseado em função localmente porque az login é executado posteriormente nesta série de tutoriais. Mas quando você implanta o seu aplicativo na parte 3 do tutorial, a implantação é autenticada usando chaves de API do serviço Pesquisa de IA do Azure. O suporte para a autenticação da implantação no Microsoft Entra ID estará disponível em breve. Por enquanto, você precisa habilitar as chaves e os pontos de extremidade.

Em seguida, conceda à sua identidade de usuário (ou à identidade do desenvolvedor que concluirá as partes dois e três) as funções Colaborador de Dados do Índice de Pesquisa e Colaborador do Serviço Pesquisa no serviço Pesquisa de IA do Azure. Essas funções permitem que você chame o serviço Pesquisa de IA do Azure como a identidade de usuário associada.

Ainda no portal do Azure para o serviço Pesquisa de IA do Azure, atribua a função Colaborador de Dados do Índice de Pesquisa ao serviço Pesquisa de IA do Azure. (Estas são as mesmas etapas que você executou anteriormente para o serviço OpenAI do Azure.)

  1. Na página à esquerda no portal do Azure, selecione Controle de acesso (IAM)>+ Adicionar>Adicionar atribuição de função.
  2. Procure a função Colaborador de dados do índice de pesquisa e selecione-a. Em seguida, selecione Avançar.
  3. Selecione Usuário, grupo ou entidade de serviço. Em seguida, selecione Selecionar membros.
  4. No painel Selecionar membros que é aberto, pesquise o nome do usuário para o qual você deseja adicionar a atribuição de função. Selecione o usuário e selecione Selecionar.
  5. Continue por meio do assistente e selecione Examinar + atribuir para adicionar a atribuição de função.

Repita estas etapas para também adicionar a função Colaborador do Serviço Pesquisa ao serviço Pesquisa de IA do Azure.

Agora você está pronto para entregar o projeto a um desenvolvedor para criar o aplicativo de chat. O desenvolvedor usará o SDK de prompt flow para criar, configurar, avaliar e implantar o aplicativo de chat para a sua empresa de varejo chamada Contoso Trek.

Limpar os recursos

Para evitar incorrer em custos desnecessários do Azure, exclua os recursos criados neste tutorial se eles não forem mais necessários. Para gerenciar os recursos, use o portal do Azure.

Mas não os exclua ainda, se você quiser criar um aplicativo de chat na próxima parte desta série de tutoriais.

Próxima etapa

Parte 2: Criar um aplicativo de chat personalizado com o SDK de prompt flow