O que é o SDK do Microsoft Foundry?

  • 5 minutos

O Microsoft Foundry fornece uma API REST que você pode usar para trabalhar com projetos do AI Foundry e os recursos que eles contêm. Além disso, vários SDKs específicos de linguagem estão disponíveis, permitindo que os desenvolvedores escrevam código que usa recursos em um projeto do Microsoft Foundry em sua linguagem de desenvolvimento preferencial. Com o SDK do Microsoft Foundry, os desenvolvedores podem criar aplicativos que se conectam a um projeto, acessar as conexões de recursos e modelos nesse projeto e usá-los para executar operações de IA, como enviar prompts para um modelo de IA gerativo e processar as respostas.

O pacote principal para trabalhar com projetos é a biblioteca de Projetos de IA do Azure , que permite que você se conecte a um projeto do Microsoft Foundry e acesse os recursos definidos dentro dele. Os pacotes específicos do idioma disponíveis para a biblioteca de Projetos de IA do Azure incluem:

Observação

Neste módulo, usaremos exemplos de código python para tarefas comuns que um desenvolvedor pode precisar executar com projetos do Microsoft Foundry. Você pode consultar a outra documentação do SDK específica do idioma para encontrar o código equivalente para seu idioma preferido. Cada SDK é desenvolvido e mantido de forma independente, portanto, algumas funcionalidades podem estar em diferentes estágios de implementação para cada idioma.

Para usar a biblioteca projetos de IA do Azure no Python, você pode usar o utilitário de instalação do pacote pip para instalar o pacote azure-ai-projects do PyPi:

pip install azure-ai-projects

Como usar o SDK para se conectar a um projeto

A primeira tarefa na maioria dos códigos do SDK do Microsoft Foundry é conectar-se a um projeto do Microsoft Foundry. Cada projeto tem um ponto de extremidade exclusivo, que você pode encontrar na página visão geral do projeto no portal do Microsoft Foundry.

Captura de tela da página de visão geral do projeto no portal do Microsoft Foundry.

Observação

O projeto fornece vários pontos de extremidade e chaves, incluindo:

  • Um ponto de extremidade para o projeto em si; que pode ser usado para acessar conexões de projeto, agentes e modelos no recurso Microsoft Foundry.
  • Um endpoint para as APIs do Serviço Azure OpenAI no recurso Microsoft Foundry do projeto.
  • Um ponto de extremidade para APIs do Foundry Tools (como Visão do Azure e Linguagem do Azure) no recurso do Microsoft Foundry.

Você pode usar o ponto de extremidade do projeto em seu código para criar um objeto AIProjectClient , que fornece um proxy programático para o projeto, conforme mostrado neste exemplo do Python:

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient
...

project_endpoint = "https://......"
project_client = AIProjectClient(            
    credential=DefaultAzureCredential(),
    endpoint=project_endpoint)

Observação

O código usa as credenciais padrão do Azure para autenticar ao acessar o projeto. Para habilitar essa autenticação, além do pacote azure-ai-projects, você precisa instalar o pacote azure-identity:

pip install azure-identity

Dica

Para acessar o projeto com êxito, o código deve ser executado no contexto de uma sessão autenticada do Azure. Por exemplo, você pode usar o comando az-login da CLI (interface de linha de comando) do Azure para se conectar antes de executar o código.