用于翻译的 Azure 资源

Foundry Tools 中的 Azure Translator 是基于云的神经机器翻译（NMT）服务，可用于向应用程序和工作流添加多语言功能。 此服务支持即时翻译和批处理，适合各种业务需求。

如果已有 Azure Translator 或多服务资源（无论是单独使用还是通过 Language Studio 使用），则可以继续使用 Microsoft Foundry 门户中的这些现有翻译器资源进行 NMT 部署。 有关详细信息， 请参阅如何使用 Foundry 工具。

默认情况下，Azure Translator 使用神经机器翻译（NMT）技术。 在最新的预览版中，现在可以选择标准神经机器翻译 (NMT) 或两种大型语言模型 (LLM) 部署类型之一（GPT-4o-mini 或 GPT-4o）。 但是， 使用 LLM 模型需要拥有 Foundry 资源。

下表概述了 Azure AI 生态系统中适用于翻译器的资源解决方案：

铸造工具	Scope	用例
Foundry 资源	此资源类型是建议用于在 Foundry 中生成、部署和管理生成 AI 应用程序和代理的资源。	Foundry 资源适用于需要协调多个 AI 模型、自定义 AI 代理开发和高级 AI 应用程序生命周期管理的方案。
Foundry Tools 的资源	这种多服务资源提供预生成、可直接使用的 AI 模型，这些 AI 模型可通过 API 访问，用于翻译、语言理解、语音识别和计算机视觉等任务。	通过 Foundry Tools 资源，可以将文本翻译、语音听录和图像识别等高级功能集成到应用程序中。 还可以使用预生成的 AI 功能增强 Foundry 门户中的模型。
Azure Translator 服务资源	Azure Translator 资源提供对基于云的神经机器翻译功能的访问权限，以及能够使用自定义翻译器创建自定义翻译模型。	Azure Translator 已准备就绪，可以根据翻译需求无缝扩展或缩减，适应多种语言之间的大量或少量文本或文档。

步骤 1：创建资源

Foundry 资源

• Foundry 资源是用于创建、部署和管理生成式 AI 应用程序和代理的主要工具。 此资源可用于访问代理服务、使用在无服务器环境中托管的模型、运行评估以及连接到 Azure OpenAI 服务。
  

• 如果计划使用 LLM 模型进行翻译， 则必须使用 Foundry 资源。
  

• 若要了解如何创建和管理 Foundry 资源 ，请参阅创建第一个 Foundry 资源

Azure Translator 资源

Azure Translator 资源是你创建的服务的实例。 可以使用 终结点 URL 和只读 密钥 访问 Foundry 工具的所有 API 请求，以便对访问进行身份验证。

先决条件

若要开始，你需要一个有效的 Azure 帐户。

创建 Azure Translator 资源

使用 Azure 帐户，可以通过两种不同的资源类型访问翻译器：

• 单服务资源类型允许访问单服务 API 密钥和终结点。

• 多服务 资源类型允许使用单个 API 密钥和终结点访问多个 Foundry 工具。

填写你的项目和实例详细信息

确定要用于访问翻译器的资源类型后，可以输入项目和实例的详细信息。

1. 订阅。 选择一个可用的 Azure 订阅。

2. 资源组。 你可以创建新的资源组，或将资源添加到预先存在的具有相同生命周期、权限和策略的资源组。

3. 资源区域。 选择“全球”，除非你的业务或应用程序需要特定区域。 如果计划配合使用文档翻译功能与托管标识授权，请选择一个地理区域，例如“美国东部”。

4. 名称。 输入资源的名称。 所选名称在 Azure 中必须独一无二。

   注释

   如果使用的翻译器功能（例如文档翻译）需要自定义域终结点，则需要在 name 字段中输入该终结点的自定义域名参数。

请确保在 name 字段中输入正确的值，以确保功能正常。

1. 定价层。 选择一个可满足你的需求的定价层：

   • 每个订阅都有一个免费层。
   • 免费层具有与付费计划相同的特性和功能，并且不会过期。
   • 每个订阅仅提供一个免费层资源。
   • 付费层支持文档翻译。 Language Studio 仅支持 S1 或 D3 实例层。 如果只是要试用文档翻译，请选择“标准 S1 实例层”。

2. 如果已创建多服务资源，则“基本信息”选项卡底部的链接提供了有关服务相应操作的技术文档。

3. 选择 审阅 + 创建。

4. 查看服务条款，然后选择“创建”以部署资源。

5. 成功部署资源后，选择“转到资源”。

身份验证密钥和终结点 URL

验证 Foundry 工具 API 请求的最快方法是在身份验证标头中包含终结点 URL 和只读密钥。 有关详细信息，请参阅身份验证和授权

• 身份验证密钥。 你的密钥是在每次请求时传递给翻译服务的唯一字符串。 你可以通过一个查询字符串参数传递密钥，也可以通过在 HTTP 请求头中指定密钥来进行传递。

• 终结点 URL。 请在 API 请求中使用“全球”终结点，除非你需要特定的 Azure 区域或自定义终结点。 有关详细信息，请参阅基 URL。 “全球”终结点 URL 为 api.cognitive.microsofttranslator.com。

获取身份验证密钥和终结点

要对翻译器资源的连接进行身份验证，需要资源的密钥和终结点。

1. 部署新资源后，选择“转到资源”或直接转到资源页。
2. 在左窗格中的“资源管理”下，选择“密钥和终结点”。
3. 将密钥和终结点 URL 复制并粘贴到一个方便的位置（例如记事本）。

创建文本翻译客户端

文本翻译支持全局终结点和区域终结点。 获得身份验证密钥后，需要创建 TextTranslationClient 的实例，使用 AzureKeyCredential 进行身份验证，以便与文本翻译服务进行交互：

• 若要使用全局资源终结点创建 TextTranslationClient，需要资源 API 密钥：

    AzureKeyCredential credential = new('<apiKey>');
    TextTranslationClient client = new(credential);
  

• 若要使用区域资源终结点创建 TextTranslationClient，需要资源 API 密钥和资源所在的区域名称：

   AzureKeyCredential credential = new('<apiKey>');
   TextTranslationClient client = new(credential, '<region>');
  

Azure 翻译器 REST API 入门

在本快速入门中，了解如何将翻译器与 REST API 配合使用。

翻译器入门

步骤 2：为 Foundry 配置资源

完成此设置对于将环境与 Foundry 完全集成至关重要。 只需设置一次，之后都可无缝访问 AI 支持的高级问答功能。

此外，我们还介绍如何在 Azure 门户中分配正确的角色和权限。 这些步骤可帮助你快速有效地开始使用 Azure Translator。

先决条件

在设置环境之前，需要：

• 有效的 Azure 订阅。 如果没有帐户，可以免费创建一个帐户。
• 必备权限。 确保在订阅级别将负责建立帐户和项目的人员分配为 Azure AI 帐户拥有者角色。 若在订阅范围内具有 参与者 或 认知服务参与者 角色，也可以满足此要求。 有关详细信息，请参阅基于角色的访问控制（RBAC）。
• Foundry 多服务资源或 Azure Translator 资源。

注释

强烈建议在 AI Foundry 中使用 Azure AI Foundry 资源；但也可以按照这些说明使用 Azure 翻译器资源进行操作。

Foundry 提供了一个统一的平台，用于使用各种模型和工具构建、管理和部署 AI 解决方案。 进行此集成后，可以通过相关功能，利用生成式 AI 扩展训练数据。 不断添加新功能，使 Foundry 成为可缩放翻译解决方案的建议选择。

1. 导航到 Azure 门户。

2. 转到 Foundry 资源（选择 “所有资源 ”以查找 Foundry 或 Azure Translator 资源）。

3. 然后在左侧窗格中，选择“访问控制(IAM)”，再选择“添加角色分配”。

   

4. 搜索“认知服务用户”角色并将其选中。 选择“下一步”。

   

5. 导航到“成员”选项卡，然后选择“托管标识”。

   

6. 选择 “选择成员”，然后在右侧面板中搜索并选择 Foundry 资源（用于此项目），然后选择 “选择”。

7. 最后，选择“查看 + 分配”以确认选择。

8. 资源现在已正确设置。 继续设置微调任务并继续自定义 Azure Translator 项目。

步骤 3（可选）：清理资源

如果要清理和删除 Azure 资源，可以删除资源或资源组。

警告

删除某个资源组还会删除该组中包含的所有资源。

若要删除资源，请执行以下操作：

1. 在 Azure 门户中搜索并选择“资源组”，然后选择你的资源组。
2. 通过选择相邻的复选框，选择要删除的资源。
3. 从右边缘附近的顶部菜单中选择“删除”。
4. 在“删除资源”对话框中输入“delete”。
5. 选择 删除。

若要删除资源组，请执行以下操作：

1. 转到 Azure 门户中的资源组。
2. 在顶部菜单中选择“删除资源组”。
3. 通过输入资源组名称并选择“删除”来确认删除请求。

后续步骤

详细了解 Azure Translator 功能：

• 文本翻译
• 文档翻译
• 自定义翻译