O que é o Microsoft Foundry SDK?

  • 5 minutos

O Microsoft Foundry fornece uma API REST que pode usar para trabalhar com projetos de AI Foundry e os recursos que eles contêm. Além disso, estão disponíveis múltiplos SDKs específicos de linguagem, permitindo aos programadores escrever código que utilize recursos de um projeto Microsoft Foundry na sua linguagem de desenvolvimento preferida. Com um SDK Microsoft Foundry, os programadores podem criar aplicações que se ligam a um projeto, aceder às ligações de recursos e modelos desse projeto e usá-los para realizar operações de IA, como enviar prompts para um modelo generativo de IA e processar as respostas.

O pacote principal para trabalhar com projetos é a biblioteca Azure AI Projects , que permite ligar-se a um projeto Microsoft Foundry e aceder aos recursos definidos nele. Os pacotes específicos de idioma disponíveis na biblioteca de Projetos de IA do Azure incluem:

Observação

Neste módulo, vamos usar exemplos de código Python para tarefas comuns que um programador pode precisar de realizar com projetos Microsoft Foundry. Você pode consultar a documentação do SDK de outro idioma específico para encontrar 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 de Projetos do Azure AI em 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

Usando o SDK para se conectar a um projeto

A primeira tarefa na maioria dos códigos do Microsoft Foundry SDK é ligar-se a um projeto Microsoft Foundry. Cada projeto tem um endpoint único, que pode encontrar na página de Visão Geral do projeto no portal Microsoft Foundry.

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

Observação

O projeto fornece vários endpoints e chaves, incluindo:

  • Um endpoint para o próprio projeto; que pode ser usado para aceder a ligações de projetos, agentes e modelos no recurso Microsoft Foundry.
  • Um endpoint para as APIs do serviço Azure OpenAI no recurso Microsoft Foundry do projeto.
  • Um endpoint para APIs do Foundry Tools (como Azure Vision e Azure Language) no recurso 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 a interface de linha de comando (CLI) do Azure az-login comando para entrar antes de executar o código.