SkillsAdd

microsoftdocs/agent-skills

azure-translator

Expert knowledge for Azure Translator development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using translate/detect/dictionary APIs, Custom Translator, glossaries, document jobs, or Docker containers, and other Azure Translator related development tasks. Not for Azure AI Language (use azure-language-service), Azure Speech in Foundry Tools (use azure-speech), Azure AI Document Inte…

First seen Mar 10, 2026

Installation

$ npx skills add microsoftdocs/agent-skills --skill azure-translator
View on skills.sh ↗ GitHub repository ↗

Summary

  • Expert knowledge for Azure Translator development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment.
  • Use when using translate/detect/dictionary APIs, Custom Translator, glossaries, document jobs, or Docker containers, and other Azure Translator related development tasks.
  • Not for Azure AI Language (use azure-language-service), Azure Speech in Foundry Tools (use azure-speech), Azure AI Document Intelligence (use azure-document-intelligence), Azure AI Immersive Reader (use azure-immersive-reader).

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

microsoft-foundry Shared topics
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-prepare Shared topics
microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Te…

568.3K installs
azure-ai Shared topics
microsoft/azure-skills

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybr…

568.2K installs
azure-aigateway Shared topics
microsoft/azure-skills

Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: sem…

566.3K installs
azure-compute Shared topics
microsoft/azure-skills

Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compar…

510K installs
azure-rbac Shared topics
microsoft/azure-skills 489K installs

Also in this package

Other skills from microsoftdocs/agent-skills · top by installs.

npx skills add microsoftdocs/agent-skills
azure-container-apps 13 azure-sql-database 12 azure-well-architected 399 azure-architecture 325 azure-pipelines 315 azure-functions 289 azure-devops 270 azure-security 251 azure-monitor 251 azure-blob-storage 242

Browse all from microsoftdocs/agent-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 737
License LICENSE
Default branch main
Open issues 2
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

CompatibilityRequires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
More metadata
generated_at
2026-08-31
generator
docs2skills/1.0.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 17,632 B
  • docs SUMMARY.md 622 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 125 installs

SKILL.md

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 readfile with the specified lines. For categories with file links (e.g., [security.md](security.md)), use readfile on the linked reference file

IMPORTANT for Agent: If metadata.generatedat is more than 3 months old, suggest the user pull the latest version from the repository. If mcpmicrosoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use mcpmicrosoftdocs:microsoftdocs_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

Category Lines Description
Troubleshooting L36-L41 Diagnosing and fixing Azure Translator errors: container startup/runtime issues, usage/FAQ problems, known service bugs, and interpreting HTTP status/error codes for troubleshooting.
Best Practices L42-L51 Best practices for preparing training data, training Custom Translator models, using glossaries, building reliable batch document workflows, and operational guidance/FAQs for Azure Translator.
Decision Making L52-L61 Guides for choosing Translator models, regions, and infrastructure, and for planning and executing migrations/upgrades between Translator API versions and Custom Translator platforms.
Limits & Quotas L62-L68 Language, locale, and feature availability for Azure Translator/Translator Pro, plus text and document size, rate, and usage limits and quotas.
Security L69-L80 Securing Azure Translator: auth (keys, Entra ID, SAS, managed identities), firewall/VNet access, customer-managed keys, and secure deployments (incl. Foundry Tools).
Configuration L81-L102 Configuring Azure Translator: resource setup, containers, Custom Translator projects, API parameters (translate/detect/dictionary), tagging, profanity filters, alignment, transliteration, and monitoring usage.
Integrations & Coding Patterns L103-L142 How to call Translator REST/SDK APIs and containers for text, transliteration, and document translation, manage jobs/status, formats, glossaries, and integrate custom/adaptive models and Power Automate flows.
Deployment L143-L146 Running Translator as a Docker container: setup, configuration, authentication, environment variables, and deployment best practices on local or on-prem infrastructure.

Troubleshooting

Topic URL
Diagnose and mitigate known issues in Azure Translator https://learn.microsoft.com/en-us/azure/ai-services/translator/reference/known-issues
Interpret Azure Translator HTTP status and error codes https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/status-response-codes

Best Practices

Topic URL
Prepare and filter training data for Custom Translator https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/data-filtering
Prepare and upload Custom Translator training documents https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-training-documents
Train Custom Translator models with proper datasets https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/train-custom-model
Create and apply glossaries in Document translation https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-use-glossaries
Implement reliable end-to-end batch document translation workflow https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/end-to-end-batch-workflow
Operational guidance and FAQs for Azure Translator https://learn.microsoft.com/en-us/azure/ai-services/translator/faq

Decision Making

Topic URL
Evaluate and compare Custom vs baseline Translator models https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/test-your-model
Plan and execute Custom Translator platform upgrade https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/platform-upgrade
Choose and set up infrastructure for Document Translation API https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/prerequisites
Choose Azure Translator regions and endpoints https://learn.microsoft.com/en-us/azure/ai-services/translator/region-support
Decide and migrate from Translator v3.0 to 2026-06-06 https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/migrate-to-2026-06-06
Migrate applications from Translator V2 to V3 https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/migrate-to-v3

Limits & Quotas

Topic URL
Check language and feature support in Azure Translator https://learn.microsoft.com/en-us/azure/ai-services/translator/language-support
Azure Translator text and document service limits https://learn.microsoft.com/en-us/azure/ai-services/translator/service-limits
Check language and locale support in Translator Pro https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/translator-pro/language-support

Security

Topic URL
Configure customer-managed keys for Azure Translator data at rest https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/encrypt-data-at-rest
Secure Custom Translator with VNet service endpoints https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/enable-vnet-service-endpoint
Create SAS tokens for Document translation storage access https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-sas-tokens
Configure managed identities for Document translation storage access https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-use-managed-identities
Configure Microsoft Entra ID auth for Translator https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/microsoft-entra-id-auth
Secure Azure Translator access behind firewalls https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/use-firewalls
Secure Azure Translator deployments in Foundry Tools https://learn.microsoft.com/en-us/azure/ai-services/translator/secure-deployment
Authenticate and authorize requests to Azure Translator https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/authentication

Configuration

Topic URL
Configure Azure Translator container runtime settings https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/configuration
Apply document formats and naming rules in Custom Translator https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/document-formats-naming-convention
Configure and manage Custom Translator projects https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-project
Configure and manage Custom Translator workspaces https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-workspace
Create and configure Azure Translator resources https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/create-translator-resource
Use Azure Translator in sovereign cloud environments https://learn.microsoft.com/en-us/azure/ai-services/translator/reference/sovereign-clouds
Use Translator 2026-06-06 translate API parameters https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/translate-api
Tag content to prevent translation in Azure Translator https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/prevent-translation
Use dynamic dictionary markup in Azure Translator https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-dynamic-dictionary
Configure profanity filtering in Azure Translator https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-profanity-filtering
Enable word alignment in Azure Translator responses https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/word-alignment
Monitor Azure Translator usage with Azure Monitor metrics https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/metrics
Use Translator V3 BreakSentence method for sentence boundaries https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/break-sentence
Call Translator V3 detect method to identify language https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/detect
Use Translator V3 dictionary examples for contextual usage https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-examples
Use Translator V3 dictionary lookup for alternative translations https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-lookup
Use Translator V3 translate method parameters https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/translate
Configure script transliteration with Translator V3 https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/transliterate

Integrations & Coding Patterns

Topic URL
Deploy user-managed glossary in Translator containers https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/deploy-user-managed-glossary
Call Translator container document translation API https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-document-parameters
Use Translator container text translation parameters https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-text-parameters
Use Translator container transliteration API parameters https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/transliterate-text-parameters
Call Translator API using a Custom Translator model https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/translate-with-custom-model
Use asynchronous batch document translation with Azure https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/quickstarts/asynchronous
Integrate synchronous single-file document translation API https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/quickstarts/synchronous
Cancel an asynchronous document translation job https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/cancel-translation
Retrieve status for all documents in a job https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-all-documents
List all document translation jobs via REST https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-all-translations
Get status for a single translated document https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-specific-document
Get status of a specific translation job https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-specific-translation
Query supported document formats for translation https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-supported-document-formats
Query supported glossary formats for translation https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-supported-glossary-formats
Call Azure Document Translation asynchronous REST API https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/translate-asynchronous
Call synchronous document translation REST endpoint https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/translate-synchronous
Cancel a batch document translation job https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/cancel-translation
Use Get document status in Translator Document Translation https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-document-status
Get status for all documents in a translation job https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-documents-status
Retrieve supported document formats via REST https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-document-formats
Retrieve supported glossary formats via REST https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-glossary-formats
Get status of a document translation request https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translation-status
List translation jobs and statuses via REST https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translations-status
Use Document Translation REST API operations https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/rest-api-guide
Start batch document translation via REST https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/start-batch-translation
Use synchronous text translation REST API for documents https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/translate-document
Integrate with adaptive custom translation (AdaptCT) API https://learn.microsoft.com/en-us/azure/ai-services/translator/foundry/adaptive-custom-translation
Build document translation flows with Translator v3 connector https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/document-translation-flow
Configure text translation flows using Translator v3 connector https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/text-translator-flow
Use Azure Translator text translation REST APIs https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/rest-api-guide
Call Azure Translator transliterate REST method https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/transliterate-api
Use Azure Translator neural dictionary in apps https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-neural-dictionary
Use Azure Translator REST APIs with code examples https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-rest-api
Integrate Azure Translator via SDK client libraries https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/quickstart/client-library-sdk
Call Azure Translator REST API programmatically https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/quickstart/rest-api
Translator V3 API parameters and request schema https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/reference

Deployment

Topic URL
Deploy and run Azure Translator container with Docker https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/install-run