azure-translator

Azure Translator 技能

此技能提供有关 Azure Translator 的专业指导，涵盖故障排除、最佳实践、决策、限制和配额、安全性、配置、集成和编码模式，以及部署。它结合了本地快速参考内容与远程文档获取功能。

如何使用此技能

IMPORTANT for Agent：使用下方的类别索引查找相关章节。对于标注了行范围的类别（例如，L35-L120），使用 read_file 读取指定行。对于包含文件链接的类别（例如，[security.md](security.md)），使用 read_file 读取链接的参考文件

IMPORTANT for Agent：如果 metadata.generated_at 距今已超过 3 个月，请建议用户从存储库拉取最新版本。如果无法使用 mcp_microsoftdocs 工具，请建议用户安装该工具：安装指南

此技能需要网络访问权限才能获取文档内容：

• 首选：使用 mcp_microsoftdocs:microsoft_docs_fetch，查询字符串为 from=learn-agent-skill。返回 Markdown。
• 备用：使用 fetch_webpage，查询字符串为 from=learn-agent-skill&accept=text/markdown。返回 Markdown。

类别索引

类别	行	说明
故障排除	L36-L41	诊断和修复 Azure Translator 错误：容器启动/运行时问题、使用和常见问题、已知服务 Bug，以及解读用于故障排除的 HTTP 状态码/错误代码。
最佳实践	L42-L51	准备训练数据、训练 Custom Translator 模型、使用术语表、构建可靠的批量文档工作流，以及 Azure Translator 的运维指南和常见问题方面的最佳实践。
决策	L52-L61	选择 Translator 模型、区域和基础设施的指南，以及规划和执行 Translator API 版本与 Custom Translator 平台之间的迁移/升级。
限制和配额	L62-L67	Azure Translator/Translator Pro 的语言、区域设置和功能可用性，以及文本和文档大小、速率和使用限制与配额。
安全性	L68-L79	保护 Azure Translator：身份验证（密钥、Entra ID、SAS、托管标识）、防火墙/VNet 访问、客户管理的密钥，以及安全部署（包括 Foundry Tools）。
配置	L80-L101	配置 Azure Translator：资源设置、容器、Custom Translator 项目、API 参数（translate/detect/dictionary）、标记、不雅内容筛选器、对齐、音译和使用情况监控。
集成和编码模式	L102-L141	如何调用 Translator REST/SDK API 和容器来处理文本、音译和文档翻译，管理作业/状态、格式和术语表，以及集成自定义/自适应模型和 Power Automate 流。
部署	L142-L145	将 Translator 作为 Docker 容器运行：在本地或本地部署基础设施上进行设置、配置、身份验证、环境变量和部署的最佳实践。

故障排除

主题	URL
诊断并缓解 Azure Translator 中的已知问题	https://learn.microsoft.com/en-us/azure/ai-services/translator/reference/known-issues
解读 Azure Translator HTTP 状态和错误代码	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/status-response-codes

最佳实践

主题	URL
为 Custom Translator 准备和筛选训练数据	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/data-filtering
准备并上传 Custom Translator 训练文档	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-training-documents
使用合适的数据集训练 Custom Translator 模型	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/train-custom-model
在 Document translation 中创建和应用术语表	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-use-glossaries
实现可靠的端到端批量文档翻译工作流	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/end-to-end-batch-workflow
Azure Translator 的运营指南和常见问题解答	https://learn.microsoft.com/en-us/azure/ai-services/translator/faq

决策制定

主题	URL
评估和比较 Custom Translator 模型与基线 Translator 模型	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/test-your-model
规划并执行 Custom Translator 平台升级	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/platform-upgrade
为 Document Translation API 选择并设置基础设施	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/prerequisites
选择 Azure Translator 区域和终结点	https://learn.microsoft.com/en-us/azure/ai-services/translator/region-support
决定从 Translator v3.0 迁移到 2026-06-06 并执行迁移	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/migrate-to-2026-06-06
将应用程序从 Translator V2 迁移到 V3	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/migrate-to-v3

限制和配额

主题	URL
检查 Azure Translator 的语言和功能支持情况	https://learn.microsoft.com/en-us/azure/ai-services/translator/language-support
Azure Translator 文本和文档服务限制	https://learn.microsoft.com/en-us/azure/ai-services/translator/service-limits

安全性

主题	URL
为静态存储的 Azure Translator 数据配置客户管理的密钥	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/encrypt-data-at-rest
使用 VNet 服务终结点保护 Custom Translator	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/enable-vnet-service-endpoint
为 Document translation 存储访问创建 SAS 令牌	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-sas-tokens
为 Document translation 存储访问配置托管标识	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-use-managed-identities
为 Translator 配置 Microsoft Entra ID 身份验证	https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/microsoft-entra-id-auth
使用防火墙保护 Azure Translator 访问	https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/use-firewalls
保护 Foundry Tools 中的 Azure Translator 部署	https://learn.microsoft.com/en-us/azure/ai-services/translator/secure-deployment
对 Azure Translator 请求进行身份验证和授权	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/authentication

配置

主题	URL
配置 Azure Translator 容器运行时设置	https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/configuration
在 Custom Translator 中应用文档格式和命名规则	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/document-formats-naming-convention
配置和管理 Custom Translator 项目	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-project
配置和管理 Custom Translator 工作区	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-workspace
创建和配置 Azure Translator 资源	https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/create-translator-resource
在主权云环境中使用 Azure Translator	https://learn.microsoft.com/en-us/azure/ai-services/translator/reference/sovereign-clouds
使用 Translator 2026-06-06 translate API 参数	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/translate-api
标记内容以防止 Azure Translator 翻译	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/prevent-translation
在 Azure Translator 中使用动态词典标记	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-dynamic-dictionary
在 Azure Translator 中配置亵渎语过滤	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-profanity-filtering
在 Azure Translator 响应中启用词语对齐	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/word-alignment
使用 Azure Monitor 指标监视 Azure Translator 使用情况	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/metrics
使用 Translator V3 BreakSentence 方法确定句子边界	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/break-sentence
调用 Translator V3 detect 方法识别语言	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/detect
使用 Translator V3 词典示例了解上下文用法	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-examples
使用 Translator V3 词典查询获取备选译文	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-lookup
使用 Translator V3 translate 方法参数	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/translate
使用 Translator V3 配置文字转写	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/transliterate

集成与编码模式

主题	URL
在 Translator 容器中部署用户管理的术语表	https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/deploy-user-managed-glossary
调用 Translator 容器文档翻译 API	https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-document-parameters
使用 Translator 容器文本翻译参数	https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-text-parameters
使用 Translator 容器音译 API 参数	https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/transliterate-text-parameters
使用 Custom Translator 模型调用 Translator API	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/translate-with-custom-model
使用 Azure 进行异步批量文档翻译	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/quickstarts/asynchronous
集成同步单文件文档翻译 API	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/quickstarts/synchronous
取消异步文档翻译作业	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/cancel-translation
获取作业中所有文档的状态	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-all-documents
通过 REST 列出所有文档翻译作业	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-all-translations
获取单个已翻译文档的状态	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-specific-document
获取特定翻译作业的状态	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-specific-translation
查询支持翻译的文档格式	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-supported-document-formats
查询支持翻译的术语表格式	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-supported-glossary-formats
调用 Azure 文档翻译异步 REST API	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/translate-asynchronous
调用同步文档翻译 REST 终结点	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/translate-synchronous
取消批量文档翻译作业	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/cancel-translation
在 Translator 文档翻译中使用 Get document status	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-document-status
获取翻译作业中所有文档的状态	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-documents-status
通过 REST 获取支持的文档格式	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-document-formats
通过 REST 获取支持的术语表格式	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-glossary-formats
获取文档翻译请求的状态	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translation-status
通过 REST 列出翻译作业及其状态	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translations-status
使用文档翻译 REST API 操作	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/rest-api-guide
通过 REST 启动批量文档翻译	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/start-batch-translation
使用同步文本翻译 REST API 翻译文档	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/translate-document
集成自适应自定义翻译（AdaptCT）API	https://learn.microsoft.com/en-us/azure/ai-services/translator/foundry/adaptive-custom-translation
使用 Translator v3 连接器构建文档翻译流	https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/document-translation-flow
使用 Translator v3 连接器配置文本翻译流	https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/text-translator-flow
使用 Azure Translator 文本翻译 REST API	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/rest-api-guide
调用 Azure Translator 音译 REST 方法	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/transliterate-api
在应用中使用 Azure Translator 神经词典	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-neural-dictionary
使用代码示例调用 Azure Translator REST API	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-rest-api
通过 SDK 客户端库集成 Azure Translator	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/quickstart/client-library-sdk
以编程方式调用 Azure Translator REST API	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/quickstart/rest-api
Translator V3 API 参数和请求架构	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/reference

部署

主题	URL
使用 Docker 部署并运行 Azure Translator 容器	https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/install-run