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

  • Artigo

Neste tutorial, você usa o SDK de fluxo de prompt (e outras bibliotecas) para criar, configurar, avaliar e implantar um aplicativo de bate-papo para sua empresa de varejo chamado Contoso Trek. Sua empresa de varejo é especializada em equipamentos e roupas de camping ao ar livre. O aplicativo de bate-papo deve responder a perguntas sobre seus produtos e serviços. Por exemplo, o aplicativo de bate-papo pode responder a perguntas como "qual barraca é a mais à prova d'água?" ou "qual é o melhor saco-cama para o tempo frio?".

Este tutorial é 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 primeira parte, você aprende a:

  • Criar um hub do Azure AI Studio
  • Criar um projeto
  • Criar um índice do Azure AI Search
  • Configurar o acesso para os recursos do Azure AI Studio e do Azure AI Search

Se você concluiu outros tutoriais ou inícios rápidos, talvez já tenha criado alguns dos recursos necessários para este tutorial. Se tiver, sinta-se à vontade para pular essas etapas aqui.

Este tutorial é 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ção em sua assinatura do Azure. A concessão de permissões por atribuição de função 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 seu administrador de TI) para concluir este tutorial para você.

Azure AI Studio e portal do Azure

Neste tutorial, você usa os recursos do Azure para criar o aplicativo de chat. Você usará o Azure AI Studio 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 Azure AI Studio para agrupar os recursos necessários para criar, avaliar e implantar o aplicativo de bate-papo. Você também pode interagir com seus modelos e implantações no AI Studio.

Criar um hub do Azure AI Studio

Nota

Um hub no Azure AI Studio é um balcão único onde você gerencia tudo o que seu projeto de IA precisa, como segurança e recursos, para que possa desenvolver e testar mais rapidamente. Para saber mais sobre como os hubs podem ajudá-lo, consulte o artigo Visão geral de hubs e projetos.

Para criar um hub no Azure AI Studio, siga estas etapas:

  1. Aceda à página inicial no Azure AI Studio e inicie sessão com a sua conta do Azure.

  2. Selecione Todos os recursos no painel esquerdo. Se não conseguir ver esta opção, na barra superior, selecione Todos os recursos e projetos. Em seguida, 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 contoso-hub). Se você não tiver um grupo de recursos, um novo grupo de recursos será criado vinculado à Assinatura fornecida. Deixe a opção padrão Connect Azure AI Services selecionada.

  4. Selecione Seguinte. Se você não reutilizou um grupo de recursos existente, um novo grupo de recursos (rg-contoso) será criado. Além disso, um serviço de IA do Azure (ai-contoso-hub) é criado para o hub.

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

    Nota

    Se você não vir (novo) antes das entradas Grupo de recursos e Conectar Serviços de IA do Azure, um recurso existente está sendo usado. Para os fins deste tutorial, crie uma entidade separada por meio de Criar novo grupo de recursos e Criar novos serviços de IA. Isso permitirá que você evite cobranças inesperadas, excluindo as entidades após o tutorial.

  5. Reveja as informações e selecione Criar.

    Captura de ecrã da caixa de diálogo para rever as definições do novo hub.

  6. Você pode visualizar 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 Azure AI Studio, siga estas etapas:

  1. Vá para a página inicial do Azure AI Studio.
  2. Selecione + Novo projeto.
  3. Introduza um nome para o projeto.
  4. Selecione o hub criado na etapa anterior.

Depois que um projeto é criado, você pode acessar o playground, as ferramentas e outros ativos no painel de navegação esquerdo.

Criar um índice do Azure AI Search

O objetivo 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.

Você precisa de um serviço e conexão do Azure AI Search para criar um índice de pesquisa.

Nota

A criação de um serviço Azure AI Search e índices de pesquisa subsequentes tem custos associados. Você pode ver detalhes sobre preços e níveis de preços para o serviço Azure AI Search na página de criação, para confirmar o custo antes de criar o recurso.

Criar um serviço Azure AI Search

Se você já tiver um serviço Azure AI Search, poderá pular para a próxima seção.

Caso contrário, você pode criar um serviço Azure AI Search usando o portal do Azure.

  1. Crie um serviço Azure AI Search no portal do Azure.
  2. Selecione o grupo de recursos e os detalhes da instância. Você pode ver detalhes sobre preços e níveis de preços nesta página.
  3. Continue pelo assistente e selecione Revisar + atribuir para criar o recurso.
  4. Confirme os detalhes do seu serviço Azure AI Search, incluindo o custo estimado.
  5. Selecione Criar para criar o serviço Azure AI Search.

Conectar a Pesquisa de IA do Azure ao seu projeto

Se você já tiver uma conexão do Azure AI Search em seu projeto, poderá pular para configurar o acesso ao serviço Azure AI Search.

No Azure AI Studio, verifique se há um recurso conectado do Azure AI Search.

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

Configurar o acesso para 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 usar chaves de API. Para usar essa autenticação, você precisa definir os controles de acesso corretos e atribuir as funções certas para seus serviços.

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

Comece no projeto para encontrar o recurso AI Services:

  1. No AI Studio, vá para o seu projeto e selecione Configurações no painel esquerdo.
  2. Selecione Recursos conectados.
  3. Selecione o nome AI Services ou Azure OpenAI 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>atribuição de função.
  2. Procure a função Cognitive Services OpenAI User e selecione-a. Em seguida, selecione Seguinte.
  3. Selecione Usuário, grupo ou entidade de serviço. Em seguida, selecione Selecionar membros.
  4. No painel Selecionar membros que é aberto, procure o nome do usuário ao qual você deseja adicionar a atribuição de função. Selecione o usuário e, em seguida, selecione Selecionar.
  5. Continue pelo assistente e selecione Revisar + atribuir para adicionar a atribuição de função.

Agora volte para AI Studio Settings>Connected Resources. Desta vez, selecione o nome da Pesquisa do Azure AI 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 para seu serviço Azure AI Search, siga estas etapas:

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

  2. Selecione Ambos para garantir que as chaves de API e o controle de acesso baseado em função estejam habilitados para seu serviço Azure AI Search.

    A captura de tela mostra a configuração de controle de acesso à API.

Aviso

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

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

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

  1. Na página à esquerda no portal do Azure, selecione Controle de acesso (IAM)>+ Adicionar>atribuição de função.
  2. Procure a função Colaborador de Dados do Índice de Pesquisa e selecione-a. Em seguida, selecione Seguinte.
  3. Selecione Usuário, grupo ou entidade de serviço. Em seguida, selecione Selecionar membros.
  4. No painel Selecionar membros que é aberto, procure o nome do usuário ao qual você deseja adicionar a atribuição de função. Selecione o usuário e, em seguida, selecione Selecionar.
  5. Continue pelo assistente e selecione Revisar + atribuir para adicionar a atribuição de função.

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

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

Clean up resources (Limpar recursos)

Para evitar incorrer em custos desnecessários do Azure, você deve excluir os recursos criados neste tutorial se eles não forem mais necessários. Para gerenciar recursos, você pode usar o portal do Azure.

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

Próximo passo

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