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 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).
Best use case
azure-translator is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
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).
Teams using azure-translator should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/azure-translator/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How azure-translator Compares
| Feature / Agent | azure-translator | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
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).
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
SKILL.md Source
# 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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md) 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 | Category | Lines | Description | |----------|-------|-------------| | Troubleshooting | L36-L41 | Diagnosing and fixing common Azure Translator issues in Foundry Tools, plus understanding HTTP status/error codes and their causes and resolutions. | | Best Practices | L42-L51 | Best practices for custom translation: managing containers, glossaries, dataset splits, Foundry/custom models, and document translation usage, FAQs, and operational guidance. | | Decision Making | L52-L60 | Guidance on choosing standard vs Custom Translator, evaluating custom models with BLEU, and migrating apps between Translator API versions and platforms. | | Limits & Quotas | L61-L72 | Limits, formats, and data size requirements for Custom Translator training/documents, character and request quotas, and language/locale support for Translator and Document Translation. | | Security | L73-L85 | Configuring Azure Translator security: encryption, auth (keys, Entra ID, managed identities, SAS), VNets/firewalls, secure workspaces, and protecting data in document translation. | | Configuration | L86-L96 | Configuring Azure Translator behavior: resource setup, Docker/container settings, profanity filters, content exclusion, dynamic dictionaries, word alignment, and monitoring usage metrics. | | Integrations & Coding Patterns | L97-L136 | Using Translator REST/SDK/containers for text & document translation: endpoints, params, async jobs, status, formats, custom models, preview features, Power Automate, and dictionary/transliteration APIs. | | Deployment | L137-L142 | Running Translator in Docker containers and deploying or copying custom translation models across regions and Foundry projects for scalable, portable translation setups. | ### Troubleshooting | Topic | URL | |-------|-----| | Resolve common Azure Translator issues in Foundry Tools | 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 | |-------|-----| | Deploy and manage user glossaries in Translator containers | https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/deploy-user-managed-glossary | | FAQ and operational guidance for Translator containers | https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/faq | | FAQ and guidance for Foundry custom translation | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/faq | | Train custom translation models with proper dataset splits | https://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 translation | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/faq | | Create and apply glossaries for Translator document translation | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-use-glossaries | ### Decision Making | Topic | URL | |-------|-----| | Evaluate custom translation models using BLEU scores | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/how-to/test-model | | Decide between standard and Custom Translator models | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/test-your-model | | Plan migration from Custom Translator v1.0 platform | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/platform-upgrade | | Migrate from Translator v3 to Foundry preview API | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/migrate-to-preview | | 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 Custom Translator document formats and limits | https://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 constraints | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/document-formats-naming-convention | | Understand Custom Translator training data requirements | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/model-training | | 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 required data sizes | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/train-custom-model | | Use Document translation in Language Studio preview | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/language-studio | | Azure Translator character and request limits | https://learn.microsoft.com/en-us/azure/ai-services/translator/service-limits | | Check language and locale support for Translator Pro | https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/translator-pro/language-support | ### Security | Topic | URL | |-------|-----| | Configure encryption at rest for Azure Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/encrypt-data-at-rest | | Configure and share Custom Translator workspaces securely | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-workspace | | Secure Custom Translator with Azure VNets | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/enable-vnet-service-endpoint | | Create SAS tokens for Translator document storage access | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-sas-tokens | | Configure managed identities for Translator document translation | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-use-managed-identities | | Enable Microsoft Entra ID auth for Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/microsoft-entra-id-auth | | Configure firewall access for Azure Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/use-firewalls | | Secure Azure Translator data and deployments | https://learn.microsoft.com/en-us/azure/ai-services/translator/secure-deployment | | Authenticate and authorize Azure Translator requests | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/authentication | ### Configuration | Topic | URL | |-------|-----| | Configure Azure Translator containers with docker run settings | https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/configuration | | Create and configure Azure Translator resources | https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/create-translator-resource | | Prevent specific content from translation | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/prevent-translation | | Use Translator dynamic dictionary markup | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-dynamic-dictionary | | Configure profanity filtering in Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-profanity-filtering | | Enable word alignment in Translator responses | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/word-alignment | | Monitor Azure Translator with usage metrics | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/metrics | ### Integrations & Coding Patterns | Topic | URL | |-------|-----| | Call translate document operation in Translator containers | https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-document-parameters | | Translator container translate text API parameters | https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-text-parameters | | Use transliterate text parameters for Translator containers | https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/transliterate-text-parameters | | Configure adaptive custom translation API parameters in Foundry | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/concepts/adaptive-custom-translation | | Call Translator API using custom translation models | https://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 models | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/translate-with-custom-model | | Programmatically use Translator document translation REST APIs | https://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 Python | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/quickstarts/client-library-sdks | | Call Translator document translation via REST API | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/quickstarts/rest-api | | Cancel an in-progress Translator document translation | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/cancel-translation | | Get status for a specific document in a translation job | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-document-status | | List document statuses in a batch translation job | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-documents-status | | Retrieve supported document formats for Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-document-formats | | Retrieve supported glossary formats for Translator | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-glossary-formats | | Get status of a single document translation request | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translation-status | | Get status of Translator batch translation jobs | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translations-status | | Reference Document translation REST API methods | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/rest-api-guide | | Start asynchronous batch document translation via REST | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/start-batch-translation | | Synchronous Translator document translation REST API reference | https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/translate-document | | Build Power Automate flows with Translator v3 connector | https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/document-translation-flow | | Configure Power Automate flows with Translator v3 connector | https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/text-translator-flow | | 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 Translator REST APIs with core options | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-rest-api | | Call Translator preview languages REST method | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/preview/get-languages | | Use text translation preview REST APIs in Foundry | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/preview/rest-api-guide | | Invoke Translator preview text translate method | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/preview/translate-api | | Use Translator preview transliterate REST method | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/preview/transliterate-api | | Text translation REST API operations guide | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/rest-api-guide | | Identify sentence boundaries with BreakSentence API | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/break-sentence | | Detect language with Translator detect API | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/detect | | Use Translator dictionary examples API | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-examples | | Use Translator dictionary lookup API | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-lookup | | Use the Translator languages API method | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/languages | | Translator v3 REST API parameter reference | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/reference | | Call the Translator text translate API | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/translate | | Use the Translator transliterate API method | https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/transliterate | ### Deployment | Topic | URL | |-------|-----| | Install and run Azure Translator containers with Docker | https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/install-run | | Copy custom translation models between Foundry projects | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/how-to/copy-model | | Deploy custom translation models across regions | https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/azure-ai-foundry/how-to/deploy-model |
Related Skills
azure-well-architected
Expert guidance for designing, assessing, and optimizing Azure workloads using Azure Well Architected. Covers design review checklists, recommendations, design principles, tradeoffs, service guides, workload patterns, and assessment questions. Use when designing AI, SAP, SaaS, HPC, AVD/AVS workloads, or choosing regions/AZs with cost–reliability tradeoffs, and other Azure Well Architected related development tasks.
azure-web-pubsub
Expert knowledge for Azure Web PubSub development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building WebSocket/MQTT apps, using Socket.IO, geo-replication, private endpoints, or Functions bindings, and other Azure Web PubSub related development tasks. Not for Azure SignalR Service (use azure-signalr-service), Azure Event Hubs (use azure-event-hubs), Azure Service Bus (use azure-service-bus), Azure Relay (use azure-relay).
azure-web-application-firewall
Expert knowledge for Azure Web Application Firewall development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring Front Door/App Gateway WAF rules, rate limits, bot/CAPTCHA, Sentinel logging, or IaC deployments, and other Azure Web Application Firewall related development tasks. Not for Azure Application Gateway (use azure-application-gateway), Azure Front Door (use azure-front-door), Azure Firewall (use azure-firewall), Azure DDos Protection (use azure-ddos-protection).
azure-vpn-gateway
Expert knowledge for Azure VPN Gateway development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring S2S/P2S tunnels, BGP routing, IPsec/IKE policies, Entra/RADIUS auth, or ExpressRoute VPNs, and other Azure VPN Gateway related development tasks. Not for Azure ExpressRoute (use azure-expressroute), Azure Virtual WAN (use azure-virtual-wan), Azure Virtual Network (use azure-virtual-network), Azure Virtual Network Manager (use azure-virtual-network-manager).
azure-vmware-solution
Expert knowledge for Azure VMware Solution development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring AVS with HCX/NSX, vSAN/stretched clusters, Citrix/Horizon, Cloud Director, or JetStream DR, and other Azure VMware Solution related development tasks. Not for Azure Virtual Machines (use azure-virtual-machines), Azure Large Instances (use azure-large-instances), Azure Baremetal Infrastructure (use azure-baremetal-infrastructure), SAP HANA on Azure Large Instances (use azure-sap).
azure-vm-scalesets
Expert knowledge for Azure Virtual Machine Scale Sets development including troubleshooting, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring VMSS autoscale, upgrade modes, zones/PPGs, Spot/standby pools, or disk encryption with Key Vault, and other Azure Virtual Machine Scale Sets related development tasks. Not for Azure Virtual Machines (use azure-virtual-machines), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure App Service (use azure-app-service), Azure Service Fabric (use azure-service-fabric).
azure-virtual-wan
Expert knowledge for Azure Virtual WAN development including troubleshooting, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when designing Virtual WAN hubs, P2S VPN, ExpressRoute/SD‑WAN connectivity, NVAs/firewalls, or Entra ID VPN access, and other Azure Virtual WAN related development tasks. Not for Azure Virtual Network (use azure-virtual-network), Azure VPN Gateway (use azure-vpn-gateway), Azure ExpressRoute (use azure-expressroute), Azure Traffic Manager (use azure-traffic-manager).
azure-virtual-network
Expert knowledge for Azure Virtual Network development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, and configuration. Use when designing VNets, NSGs, service endpoints, VNet peering, VPN gateways, or Azure Firewall/NAT gateways, and other Azure Virtual Network related development tasks. Not for Azure Networking (use azure-networking), Azure Virtual Network Manager (use azure-virtual-network-manager), Azure Virtual WAN (use azure-virtual-wan), Azure VPN Gateway (use azure-vpn-gateway).
azure-virtual-network-manager
Expert knowledge for Azure Virtual Network Manager development including troubleshooting, limits & quotas, security, configuration, and integrations & coding patterns. Use when managing AVNM IPAM pools, network groups, cross-tenant connectivity, security admin rules, or ARG queries, and other Azure Virtual Network Manager related development tasks. Not for Azure Virtual Network (use azure-virtual-network), Azure Virtual WAN (use azure-virtual-wan), Azure Network Watcher (use azure-network-watcher), Azure Networking (use azure-networking).
azure-virtual-machines
Expert knowledge for Azure Virtual Machines development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when choosing VM sizes, configuring scale sets, using Trusted Launch, encrypting disks, or automating via CLI/ARM, and other Azure Virtual Machines related development tasks. Not for Azure Virtual Machine Scale Sets (use azure-vm-scalesets), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure App Service (use azure-app-service).
azure-virtual-desktop
Expert knowledge for Azure Virtual Desktop development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when working with FSLogix profiles, MSIX/App Attach, autoscale/Start VM on Connect, Teams optimization, or SSO/MFA, and other Azure Virtual Desktop related development tasks. Not for Azure Virtual Machines (use azure-virtual-machines), Azure Dev Box (use azure-dev-box).
azure-video-indexer
Expert knowledge for Azure AI Video Indexer development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Video Indexer APIs/widgets, live camera indexing, custom speech/brand models, or Azure OpenAI integrations, and other Azure AI Video Indexer related development tasks. Not for Azure AI services (use microsoft-foundry-tools), Azure AI Vision (use azure-ai-vision).