你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

从 GitHub 模型升级到 Azure AI 模型推理服务

如果要开发生成式 AI 应用程序，则可以使用 GitHub 模型免费查找和试验 AI 模型。 操场和免费 API 使用受到每分钟请求数、每天请求数、每个请求的令牌数和并发请求数的速率限制。 如果受到速率限制，则需要等待命中的速率限制重置，然后才能发出更多请求。

准备好将应用程序引入生产环境后，可以通过在 Azure 订阅中部署 Azure AI 服务资源并开始使用 Azure AI 模型推理服务来升级体验。 不需要更改代码中的其他任何内容。

以下文章介绍如何开始使用适用于 Azure AI 服务的 Azure AI 模型中的 GitHub 模型。

先决条件

要完成本教程，您需要：

• 有权访问 GitHub 模型的 GitHub 帐户。

• Azure 订阅。 如果没有帐户，系统会提示在准备好将模型部署到生产环境时创建或更新 Azure 帐户以即用即付帐户。

升级到 Azure AI 服务

操场和免费 API 使用的速率限制旨在帮助你试验模型并开发 AI 应用程序。 准备好将应用程序引入生产环境后，请使用付费 Azure 帐户中的密钥和终结点。 不需要更改代码中的其他任何内容。

若要获取密钥和终结点，请执行以下操作：

1. 在模型的操场中，选择“获取 API 密钥”。

2. 选择“获取生产密钥”。

3. 如果没有 Azure 帐户，请选择“创建我的帐户”，然后按照步骤创建一个帐户。

4. 如果有 Azure 帐户，请选择“登录”。

5. 如果现有帐户是免费帐户，则首先必须升级到即用即付计划。 升级后，返回到操场并再次选择“获取 API 密钥”，然后使用升级后的帐户登录。

6. 登录到 Azure 帐户后，会转到 Azure AI Studio。

7. 在页面顶部，选择“转到 GitHub AI 资源”转到 Azure AI Studio/Github](https://ai.azure.com/github)。 在 AI Studio 中加载初始模型详细信息可能需要一两分钟。

8. 页面将加载模型的详细信息。 选择“创建部署”按钮，将模型部署到帐户。

9. 部署后，模型 API 密钥和终结点会显示在概述中。 在代码中使用这些值，以在生产环境中使用该模型。

   

此时，所选的模型可供使用。

提示

使用参数 model="<deployment-name> 将请求路由到此部署。 部署在某些配置下充当给定模型的别名。 请参阅“路由概念”页，了解 Azure AI 服务如何路由部署。

升级代码以使用新终结点

配置 Azure AI 服务资源后，即可开始从代码中使用它。 需要终结点 URL 和密钥，可在“概述”部分找到：

可以使用任何受支持的 SDK 从终结点中获取预测。 正式支持以下 SDK：

• OpenAI SDK
• Azure OpenAI SDK
• Azure AI 推理 SDK

有关更多详细信息和示例，请参阅支持的语言和 SDK 部分。 以下示例演示如何将 Azure AI 模型推理 SDK 与新部署的模型配合使用：

Python

使用包管理器（例如 pip）安装包 azure-ai-inference：

pip install azure-ai-inference>=1.0.0b5

警告

Azure AI 服务资源需要 Python 版本 azure-ai-inference>=1.0.0b5。

然后，可以使用包来使用模型。 以下示例演示如何创建客户端来使用聊天补全：

import os
from azure.ai.inference import ChatCompletionsClient
from azure.core.credentials import AzureKeyCredential

client = ChatCompletionsClient(
    endpoint=os.environ["AZUREAI_ENDPOINT_URL"],
    credential=AzureKeyCredential(os.environ["AZUREAI_ENDPOINT_KEY"]),
)

浏览我们的示例，并阅读 API 参考文档以开始使用。

JavaScript

使用 npm 安装包 @azure-rest/ai-inference：

npm install @azure-rest/ai-inference

然后，可以使用包来使用模型。 以下示例演示如何创建客户端来使用聊天补全：

import ModelClient from "@azure-rest/ai-inference";
import { isUnexpected } from "@azure-rest/ai-inference";
import { AzureKeyCredential } from "@azure/core-auth";

const client = new ModelClient(
    process.env.AZUREAI_ENDPOINT_URL, 
    new AzureKeyCredential(process.env.AZUREAI_ENDPOINT_KEY)
);

浏览我们的示例，并阅读 API 参考文档以开始使用。

C#

请使用以下命令安装 Azure AI 推理库：

dotnet add package Azure.AI.Inference --prerelease

导入下列命名空间：

using Azure;
using Azure.Identity;
using Azure.AI.Inference;

然后，可以使用包来使用模型。 以下示例演示如何创建客户端来使用聊天补全：

ChatCompletionsClient client = new ChatCompletionsClient(
    new Uri(Environment.GetEnvironmentVariable("AZURE_INFERENCE_ENDPOINT")),
    new AzureKeyCredential(Environment.GetEnvironmentVariable("AZURE_INFERENCE_CREDENTIAL"))
);

浏览我们的示例，并阅读 API 参考文档以开始使用。

Java

将包添加到项目：

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-ai-inference</artifactId>
    <version>1.0.0-beta.1</version>
</dependency>

然后，可以使用包来使用模型。 以下示例演示如何创建客户端来使用聊天补全：

ChatCompletionsClient client = new ChatCompletionsClientBuilder()
    .credential(new AzureKeyCredential("{key}"))
    .endpoint("{endpoint}")
    .buildClient();

浏览我们的示例，并阅读 API 参考文档以开始使用。

REST

使用参考部分来探索 API 设计以及可用的参数。 例如，聊天补全的参考部分详细介绍了如何使用路由 /chat/completions 根据聊天格式的指令生成预测。 请注意，URL 的根目录包含路径 /models：

Request

POST models/chat/completions?api-version=2024-04-01-preview
Authorization: Bearer <bearer-token>
Content-Type: application/json

生成第一个聊天补全：

Python

from azure.ai.inference.models import SystemMessage, UserMessage

response = client.complete(
    messages=[
        SystemMessage(content="You are a helpful assistant."),
        UserMessage(content="Explain Riemann's conjecture in 1 paragraph"),
    ],
    model="mistral-large"
)

print(response.choices[0].message.content)

JavaScript

var messages = [
    { role: "system", content: "You are a helpful assistant" },
    { role: "user", content: "Explain Riemann's conjecture in 1 paragraph" },
];

var response = await client.path("/chat/completions").post({
    body: {
        messages: messages,
        model: "mistral-large"
    }
});

console.log(response.choices[0].message.content)

C#

requestOptions = new ChatCompletionsOptions()
{
    Messages = {
        new ChatRequestSystemMessage("You are a helpful assistant."),
        new ChatRequestUserMessage("Explain Riemann's conjecture in 1 paragraph")
    },
    Model = "mistral-large"
};

response = client.Complete(requestOptions);
Console.WriteLine($"Response: {response.Value.Choices[0].Message.Content}");

Java

List<ChatRequestMessage> chatMessages = new ArrayList<>();
chatMessages.add(new ChatRequestSystemMessage("You are a helpful assistant"));
chatMessages.add(new ChatRequestUserMessage("Explain Riemann's conjecture in 1 paragraph"));

ChatCompletionsOptions options = new ChatCompletionsOptions(chatMessages);
options.setModel("Mistral-large");

ChatCompletions response = client.complete(options);

for (ChatChoice choice : chatCompletions.getChoices()) {
    ChatResponseMessage message = choice.getMessage();
    System.out.println("Response:" + message.getContent());
}

REST

请求

POST models/chat/completions?api-version=2024-04-01-preview
Authorization: Bearer <bearer-token>
Content-Type: application/json

{
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant"
        },
        {
            "role": "user",
            "content": "Explain Riemann's conjecture in 1 paragraph"
        }
    ],
    "model": "mistral-large"
}

探索更多功能

Azure AI 模型推理支持在 GitHub 模型中不可用的更多功能，包括：

• 浏览模型目录以查看 GitHub 模型中不可用的其他模型。
• 配置内容筛选器。
• 配置速率限制（针对特定模型）。
• 浏览更多部署 SKU（适用于特定模型）。
• 配置专用网络。

遇到麻烦？

请参阅“常见问题解答”部分 ，了解更多帮助。

后续步骤

• 向终结点添加更多模型。
• 浏览 Azure AI Studio 中的模型目录。