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 资源中 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 命令进行登录。