azure-translator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Azure Translator Skill

Azure Translator 技能

This skill provides expert guidance for Azure Translator. Covers troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
本技能为Azure Translator提供专业指导,涵盖故障排查、最佳实践、决策指导、限制与配额、安全、配置、集成与编码模式以及部署等内容。它结合了本地快速参考内容与远程文档获取能力。

How to Use This Skill

如何使用本技能

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,
L35-L120
), use
read_file
with the specified lines. For categories with file links (e.g.,
[security.md](security.md)
), use
read_file
on the linked reference file
IMPORTANT for Agent: If
metadata.generated_at
is more than 3 months old, suggest the user pull the latest version from the repository. If
mcp_microsoftdocs
tools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
  • Preferred: Use
    mcp_microsoftdocs:microsoft_docs_fetch
    with query string
    from=learn-agent-skill
    . Returns Markdown.
  • Fallback: Use
    fetch_webpage
    with query string
    from=learn-agent-skill&accept=text/markdown
    . Returns Markdown.
Agent 重要提示:使用下方的分类索引定位相关章节。对于带有行范围的分类(例如:
L35-L120
),使用
read_file
读取指定行内容。对于带有文件链接的分类(例如:
[security.md](security.md)
),使用
read_file
读取链接的参考文件
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格式内容。

Category Index

分类索引

CategoryLinesDescription
TroubleshootingL36-L41Diagnosing and fixing common Azure Translator issues in Foundry Tools, plus understanding HTTP status/error codes and their causes and resolutions.
Best PracticesL42-L51Best practices for custom translation: managing containers, glossaries, dataset splits, Foundry/custom models, and document translation usage, FAQs, and operational guidance.
Decision MakingL52-L60Guidance on choosing standard vs Custom Translator, evaluating custom models with BLEU, and migrating apps between Translator API versions and platforms.
Limits & QuotasL61-L72Limits, formats, and data size requirements for Custom Translator training/documents, character and request quotas, and language/locale support for Translator and Document Translation.
SecurityL73-L85Configuring Azure Translator security: encryption, auth (keys, Entra ID, managed identities, SAS), VNets/firewalls, secure workspaces, and protecting data in document translation.
ConfigurationL86-L96Configuring Azure Translator behavior: resource setup, Docker/container settings, profanity filters, content exclusion, dynamic dictionaries, word alignment, and monitoring usage metrics.
Integrations & Coding PatternsL97-L136Using Translator REST/SDK/containers for text & document translation: endpoints, params, async jobs, status, formats, custom models, preview features, Power Automate, and dictionary/transliteration APIs.
DeploymentL137-L142Running Translator in Docker containers and deploying or copying custom translation models across regions and Foundry projects for scalable, portable translation setups.
分类行范围描述
故障排查L36-L41诊断并修复Foundry Tools中常见的Azure Translator问题,以及理解HTTP状态/错误代码及其原因和解决方法。
最佳实践L42-L51自定义翻译的最佳实践:容器管理、术语表、数据集拆分、Foundry/自定义模型、文档翻译使用、常见问题与操作指导。
决策指导L52-L60指导选择标准翻译器与自定义翻译器,使用BLEU评估自定义模型,以及在Translator API版本和平台之间迁移应用。
限制与配额L61-L72自定义翻译器训练/文档的限制、格式和数据大小要求,字符与请求配额,以及Translator和文档翻译支持的语言/区域设置。
安全L73-L85配置Azure Translator安全:加密、认证(密钥、Entra ID、托管标识、SAS)、虚拟网络/防火墙、安全工作区,以及保护文档翻译中的数据。
配置L86-L96配置Azure Translator行为:资源设置、Docker/容器配置、亵渎内容过滤、内容排除、动态词典、词语对齐,以及监控使用指标。
集成与编码模式L97-L136使用Translator REST/SDK/容器进行文本与文档翻译:端点、参数、异步任务、状态、格式、自定义模型、预览功能、Power Automate,以及词典/音译API。
部署L137-L142在Docker容器中运行Translator,以及跨区域和Foundry项目部署或复制自定义翻译模型,以实现可扩展、可移植的翻译设置。

Troubleshooting

故障排查

Best Practices

最佳实践

Decision Making

决策指导

Limits & Quotas

限制与配额

Security

安全

Configuration

配置

Integrations & Coding Patterns

集成与编码模式

TopicURL
Call translate document operation in Translator containershttps://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-document-parameters
Translator container translate text API parametershttps://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-text-parameters
Use transliterate text parameters for Translator containershttps://learn.microsoft.com/en-us/azure/ai-services/translator/containers/transliterate-text-parameters
Configure adaptive custom translation API parameters in Foundryhttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/concepts/adaptive-custom-translation
Call Translator API using custom translation modelshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/how-to/translate-with-model
Call Azure Translator API with custom modelshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/translate-with-custom-model
Programmatically use Translator document translation REST APIshttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/use-rest-api-programmatically
Use Translator document translation SDKs in .NET and Pythonhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/quickstarts/client-library-sdks
Call Translator document translation via REST APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/quickstarts/rest-api
Cancel an in-progress Translator document translationhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/cancel-translation
Get status for a specific document in a translation jobhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-document-status
List document statuses in a batch translation jobhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-documents-status
Retrieve supported document formats for Translatorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-document-formats
Retrieve supported glossary formats for Translatorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-glossary-formats
Get status of a single document translation requesthttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translation-status
Get status of Translator batch translation jobshttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translations-status
Reference Document translation REST API methodshttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/rest-api-guide
Start asynchronous batch document translation via RESThttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/start-batch-translation
Synchronous Translator document translation REST API referencehttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/translate-document
Build Power Automate flows with Translator v3 connectorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/document-translation-flow
Configure Power Automate flows with Translator v3 connectorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/text-translator-flow
Use Azure Translator neural dictionary in appshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-neural-dictionary
Use Translator REST APIs with core optionshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-rest-api
Call Translator preview languages REST methodhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/preview/get-languages
Use text translation preview REST APIs in Foundryhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/preview/rest-api-guide
Invoke Translator preview text translate methodhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/preview/translate-api
Use Translator preview transliterate REST methodhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/preview/transliterate-api
Text translation REST API operations guidehttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/rest-api-guide
Identify sentence boundaries with BreakSentence APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/break-sentence
Detect language with Translator detect APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/detect
Use Translator dictionary examples APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-examples
Use Translator dictionary lookup APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-lookup
Use the Translator languages API methodhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/languages
Translator v3 REST API parameter referencehttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/reference
Call the Translator text translate APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/translate
Use the Translator transliterate API methodhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/transliterate
主题链接
在Translator容器中调用文档翻译操作https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-document-parameters
Translator容器文本翻译API参数https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-text-parameters
为Translator容器使用音译文本参数https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/transliterate-text-parameters
在Foundry中配置自适应自定义翻译API参数https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/concepts/adaptive-custom-translation
使用自定义翻译模型调用Translator APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/how-to/translate-with-model
使用自定义模型调用Azure Translator APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/translate-with-custom-model
以编程方式使用Translator文档翻译REST APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/use-rest-api-programmatically
在.NET和Python中使用Translator文档翻译SDKhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/quickstarts/client-library-sdks
通过REST API调用Translator文档翻译https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/quickstarts/rest-api
取消进行中的Translator文档翻译https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/cancel-translation
获取翻译任务中特定文档的状态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
检索Translator支持的文档格式https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-document-formats
检索Translator支持的术语表格式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
获取Translator批量翻译任务的状态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
同步Translator文档翻译REST API参考https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/translate-document
使用Translator v3连接器构建Power Automate流https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/document-translation-flow
使用Translator v3连接器配置Power Automate流https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/text-translator-flow
在应用中使用Azure Translator神经词典https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-neural-dictionary
使用带核心选项的Translator REST APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-rest-api
调用Translator预览版语言REST方法https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/preview/get-languages
在Foundry中使用文本翻译预览版REST APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/preview/rest-api-guide
调用Translator预览版文本翻译方法https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/preview/translate-api
使用Translator预览版音译REST方法https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/preview/transliterate-api
文本翻译REST API操作指南https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/rest-api-guide
使用BreakSentence API识别句子边界https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/break-sentence
使用Translator检测API检测语言https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/detect
使用Translator词典示例APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-examples
使用Translator词典查询APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-lookup
使用Translator语言API方法https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/languages
Translator v3 REST API参数参考https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/reference
调用Translator文本翻译APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/translate
使用Translator音译API方法https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/transliterate

Deployment

部署