Microsoft Foundry SDK 是什么?

已完成

Microsoft Foundry 提供了一个 REST API,可用于处理 AI Foundry 项目及其包含的资源。 此外,可以使用多种语言特定的 SDK,使开发人员能够以首选的开发语言编写在 A Microsoft Foundry 项目中使用资源的代码。 借助 Microsoft Foundry SDK,开发人员可以创建连接到项目的应用程序、访问该项目中的资源连接和模型,并使用这些应用程序来执行 AI作,例如向生成 AI 模型发送提示并处理响应。

用于处理项目的核心包是 Azure AI 项目 库,可用于连接到 A Microsoft Foundry 项目并访问其中定义的资源。 适用于 Azure AI 项目库的可用语言特定包包括:

注意

在本模块中,我们将使用 Python 代码示例来执行开发人员可能需要对 Microsoft Foundry 项目执行的常见任务。 可以参考其他特定于语言的 SDK 文档来查找首选语言的等效代码。 每个 SDK 都是独立开发和维护的,因此某些功能可能处于每种语言实现的不同阶段。

若要在 Python 中使用 Azure AI 项目库,可以使用 pip 包安装实用工具从 PyPi 安装 azure-ai-projects 包:

pip install azure-ai-projects

使用 SDK 连接到项目

大多数 Microsoft Foundry SDK 代码中的第一个任务是连接到 A Microsoft Foundry 项目。 每个项目都有一个唯一 的终结点,可在Microsoft Foundry 门户的项目 “概述 ”页上找到该终结点。

Microsoft Foundry 门户中项目概述页的屏幕截图。

注意

该项目提供多个终结点和密钥,包括:

  • 项目本身的终结点;可用于访问 Microsoft Foundry 资源中的项目连接、代理和模型。
  • 项目的 Microsoft Foundry 资源中 Azure OpenAI 服务 API 的端点。
  • Microsoft Foundry 资源中 Foundry Tools API(例如 Azure 视觉和 Azure 语言)的终结点。

可以使用代码中的项目终结点创建 AIProjectClient 对象,该对象为项目提供编程代理,如以下 Python 示例所示:

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

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

注意

在访问项目时,该代码使用默认的 Azure 凭据进行身份验证。 若要启用此身份验证,除了 azure-ai-projects 包外,还需要安装 azure 标识 包:

pip install azure-identity

提示

若要成功访问项目,必须在经过身份验证的 Azure 会话的上下文中运行代码。 例如,在运行代码之前,可以使用 Azure 命令行接口 (CLI) az-login 命令进行登录。