azure-translator

Original：🇺🇸 English
Translated

Expert knowledge for Azure Translator development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Translator text/document APIs, custom models, glossaries, Docker containers, or Power Automate flows, and other Azure Translator related development tasks. Not for Azure AI Language (use azure-language-service), Azure AI Speech (use azure-speech), Azure AI Immersive Reader (use azure-immersive-reader), Azure AI Search (use azure-cognitive-search).

14installs
Sourcemicrosoftdocs/agent-skills
Added on

NPX Install

npx skill4agent add microsoftdocs/agent-skills azure-translator

Tags

Translated version includes tags in frontmatter
azure-translator-developmentai-translationtroubleshootingdeploymentintegration-patterns

SKILL.md Content

View Translation Comparison →

Azure Translator Skill

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.

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.

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.

Troubleshooting

TopicURL
Resolve common Azure Translator issues in Foundry Toolshttps://learn.microsoft.com/en-us/azure/ai-services/translator/reference/known-issues
Interpret Azure Translator HTTP status and error codeshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/status-response-codes

Best Practices

TopicURL
Deploy and manage user glossaries in Translator containershttps://learn.microsoft.com/en-us/azure/ai-services/translator/containers/deploy-user-managed-glossary
FAQ and operational guidance for Translator containershttps://learn.microsoft.com/en-us/azure/ai-services/translator/containers/faq
FAQ and guidance for Foundry custom translationhttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/faq
Train custom translation models with proper dataset splitshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/how-to/train-model
FAQ and usage tips for Translator document translationhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/faq
Create and apply glossaries for Translator document translationhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-use-glossaries

Decision Making

TopicURL
Evaluate custom translation models using BLEU scoreshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/how-to/test-model
Decide between standard and Custom Translator modelshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/test-your-model
Plan migration from Custom Translator v1.0 platformhttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/platform-upgrade
Migrate from Translator v3 to Foundry preview APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/migrate-to-preview
Migrate applications from Translator v2 to v3https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/migrate-to-v3

Limits & Quotas

TopicURL
Check Custom Translator document formats and limitshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/concepts/document-formats-naming-convention
Review Custom Translator document formats and constraintshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/document-formats-naming-convention
Understand Custom Translator training data requirementshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/model-training
Prepare and upload Custom Translator training documentshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-training-documents
Train Custom Translator models with required data sizeshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/train-custom-model
Use Document translation in Language Studio previewhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/language-studio
Azure Translator character and request limitshttps://learn.microsoft.com/en-us/azure/ai-services/translator/service-limits
Check language and locale support for Translator Prohttps://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/translator-pro/language-support

Security

TopicURL
Configure encryption at rest for Azure Translatorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/encrypt-data-at-rest
Configure and share Custom Translator workspaces securelyhttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-workspace
Secure Custom Translator with Azure VNetshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/enable-vnet-service-endpoint
Create SAS tokens for Translator document storage accesshttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-sas-tokens
Configure managed identities for Translator document translationhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-use-managed-identities
Enable Microsoft Entra ID auth for Translatorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/microsoft-entra-id-auth
Configure firewall access for Azure Translatorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/use-firewalls
Secure Azure Translator data and deploymentshttps://learn.microsoft.com/en-us/azure/ai-services/translator/secure-deployment
Authenticate and authorize Azure Translator requestshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/authentication

Configuration

TopicURL
Configure Azure Translator containers with docker run settingshttps://learn.microsoft.com/en-us/azure/ai-services/translator/containers/configuration
Create and configure Azure Translator resourceshttps://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/create-translator-resource
Prevent specific content from translationhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/prevent-translation
Use Translator dynamic dictionary markuphttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-dynamic-dictionary
Configure profanity filtering in Translatorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-profanity-filtering
Enable word alignment in Translator responseshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/word-alignment
Monitor Azure Translator with usage metricshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/metrics

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

Deployment

TopicURL
Install and run Azure Translator containers with Dockerhttps://learn.microsoft.com/en-us/azure/ai-services/translator/containers/install-run
Copy custom translation models between Foundry projectshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/how-to/copy-model
Deploy custom translation models across regionshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/how-to/deploy-model