什么是 Azure AI Foundry SDK？

  • 5 分钟

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

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

注意

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

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

pip install azure-ai-projects

使用 SDK 连接到项目

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

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

注意

该项目提供多个终结点和密钥，包括：

  • 项目本身的终结点;可用于访问 Azure AI Foundry 资源中的项目连接、代理和模型。
  • 项目 Azure AI Foundry 资源中 Azure OpenAI 服务 API 的终结点。
  • Azure AI 服务 API（例如 Azure AI 视觉和 Azure AI 语言）的终结点，位于 Azure AI Foundry 资源中。

可以使用代码中的项目终结点创建 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 命令进行登录。