Partilhar via


Consuma APIs serverless de um projeto ou hub Microsoft Foundry diferente

Observação

Este documento refere-se ao portal Microsoft Foundry (clássico).

🔍 Consulte a documentação (nova) da Microsoft Foundry para saber mais sobre o novo portal.

Neste artigo, você aprenderá a configurar uma API sem servidor existente em um projeto ou hub diferente daquele que foi usado para criar a implantação.

Importante

Os modelos que estão em pré-visualização são marcados como pré-visualização nos respetivos cartões de modelo no catálogo de modelos.

Certos modelos no catálogo de modelos podem ser implantados como APIs sem servidor. Esse tipo de implantação fornece uma maneira de consumir modelos como uma API sem hospedá-los em sua assinatura, mantendo a segurança e a conformidade corporativas de que as organizações precisam. Essa opção de implantação não exige cota da sua assinatura.

A necessidade de consumir um ponto de extremidade de APIs sem servidor em um projeto ou hub diferente daquele que foi usado para criar a implantação pode surgir em situações como estas:

  • Você deseja centralizar as suas implantações num(a) determinado(a) projeto ou hub e consumi-las a partir de diferentes projetos ou hubs na sua organização.
  • Você precisa implantar um modelo em um hub em uma região específica do Azure onde a implantação sem servidor para esse modelo está disponível. No entanto, você precisa utilizá-lo em outra região, onde a implantação sem servidor não está disponível para esses modelos específicos.

Pré-requisitos

  • Uma subscrição do Azure com um método de pagamento válido. As subscrições gratuitas ou de avaliação do Azure não funcionarão. Se você não tiver uma assinatura do Azure, crie uma conta paga do Azure para começar.

  • Um hub Microsoft Foundry, se estiver a usar um projeto baseado em hub. Um projeto Foundry não utiliza um hub. Para obter mais informações, consulte Tipos de projeto.

  • Se você não tiver um, crie um projeto baseado em hub.

  • Um modelo implantado em APIs sem servidor. Este artigo pressupõe que você implantou anteriormente o modelo Meta-Llama-3-8B-Instruct . Para saber como implantar esse modelo como uma API sem servidor, consulte Implantar modelos como APIs sem servidor.

  • Precisa de instalar o seguinte software para funcionar com o Foundry:

    Pode usar qualquer navegador web compatível para navegar no Foundry.

Criar uma conexão de endpoint de API sem servidor

Siga estas etapas para criar uma conexão:

  1. Conecte-se ao projeto ou ao hub em que o ponto de extremidade está implantado.

    Sugestão

    Como pode personalizar o painel esquerdo no portal Microsoft Foundry, pode ver itens diferentes dos mostrados nestes passos. Se não encontrar o que procura, selecione ... Mais informações na parte inferior do painel esquerdo.

    Vai ao Foundry e navega até ao projeto onde o endpoint ao qual queres ligar-te está implementado.

  2. Obtenha a URL e as credenciais do endpoint ao qual pretende conectar-se. Neste exemplo, obténs os detalhes do nome do endpoint meta-llama3-8b-qwerty.

    1. Na barra lateral esquerda do seu projeto no portal Foundry, vá a Os meus ativos>Modelos + endpoints para ver a lista de desdobramentos no projeto.

    2. Selecione a implantação à qual você deseja se conectar.

    3. Copie os valores para URI de destino e chave.

  3. Agora, conecte-se ao projeto ou hub onde você deseja criar a conexão:

    Vá para o projeto onde a conexão precisa ser criada.

  4. Crie a conexão no projeto:

    1. A partir do seu projeto no portal Foundry, vá para a parte inferior da barra lateral esquerda e selecione Centro de gestão.

    2. Na barra lateral esquerda do centro de gerenciamento, selecione Recursos conectados.

    3. Selecione Nova ligação.

    4. Selecione Modelo sem servidor.

    5. Para o Target URI, cole o valor copiado anteriormente.

    6. Para a chave, cole o valor copiado anteriormente.

    7. Dê um nome à conexão, neste caso meta-llama3-8b-connection.

    8. Selecione Adicionar ligação.

  5. Neste ponto, a conexão está disponível para consumo.

  6. Para validar se a conexão está funcionando:

    1. Volte ao seu projeto no portal Foundry.

    2. Na barra lateral esquerda do seu projeto, vá para Criar e personalizar>o fluxo de prompt.

    3. Selecione Criar para criar um novo fluxo.

    4. Selecione Criar na caixa Fluxo de Chat.

    5. Dê um nome ao fluxo de prompt e selecione Criar.

    6. Selecione o nó de chat no gráfico para ir à secção de chat.

    7. Para Conexão, abra a lista suspensa para selecionar a conexão que acabou de criar, neste caso meta-llama3-8b-connection.

    8. Selecione Iniciar sessão de computação na barra de navegação superior para iniciar automaticamente o tempo de execução de fluxo de prompt.

    9. Selecione a opção Chat . Agora você pode enviar mensagens e obter respostas.