Skip to content
cccskills
FreePublished on GitHub

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 Intelligence (use azure-document-intelligence), Azure AI Immersive Reader (use azure-immersive-reader).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills
Works withAzureDocker
See how to install

Files included (1)

  • SKILL.md17.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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 Azure Translator errors: container startup/runtime issues, usage/FAQ problems, known service bugs, and interpreting HTTP status/error codes for troubleshooting.
Best PracticesL42-L51Best practices for preparing training data, training Custom Translator models, using glossaries, building reliable batch document workflows, and operational guidance/FAQs for Azure Translator.
Decision MakingL52-L61Guides for choosing Translator models, regions, and infrastructure, and for planning and executing migrations/upgrades between Translator API versions and Custom Translator platforms.
Limits & QuotasL62-L67Language, locale, and feature availability for Azure Translator/Translator Pro, plus text and document size, rate, and usage limits and quotas.
SecurityL68-L79Securing Azure Translator: auth (keys, Entra ID, SAS, managed identities), firewall/VNet access, customer-managed keys, and secure deployments (incl. Foundry Tools).
ConfigurationL80-L101Configuring Azure Translator: resource setup, containers, Custom Translator projects, API parameters (translate/detect/dictionary), tagging, profanity filters, alignment, transliteration, and monitoring usage.
Integrations & Coding PatternsL102-L141How 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.
DeploymentL142-L145Running Translator as a Docker container: setup, configuration, authentication, environment variables, and deployment best practices on local or on-prem infrastructure.

Troubleshooting

TopicURL
Diagnose and mitigate known issues in Azure Translatorhttps://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
Prepare and filter training data for Custom Translatorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/data-filtering
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 proper datasetshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/train-custom-model
Create and apply glossaries in Document translationhttps://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 workflowhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/end-to-end-batch-workflow
Operational guidance and FAQs for Azure Translatorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/faq

Decision Making

TopicURL
Evaluate and compare Custom vs baseline Translator modelshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/test-your-model
Plan and execute Custom Translator platform upgradehttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/platform-upgrade
Choose and set up infrastructure for Document Translation APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/prerequisites
Choose Azure Translator regions and endpointshttps://learn.microsoft.com/en-us/azure/ai-services/translator/region-support
Decide and migrate from Translator v3.0 to 2026-06-06https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/migrate-to-2026-06-06
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 language and feature support in Azure Translatorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/language-support
Azure Translator text and document service limitshttps://learn.microsoft.com/en-us/azure/ai-services/translator/service-limits

Security

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

Configuration

TopicURL
Configure Azure Translator container runtime settingshttps://learn.microsoft.com/en-us/azure/ai-services/translator/containers/configuration
Apply document formats and naming rules in Custom Translatorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/document-formats-naming-convention
Configure and manage Custom Translator projectshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-project
Configure and manage Custom Translator workspaceshttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-workspace
Create and configure Azure Translator resourceshttps://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/create-translator-resource
Use Azure Translator in sovereign cloud environmentshttps://learn.microsoft.com/en-us/azure/ai-services/translator/reference/sovereign-clouds
Use Translator 2026-06-06 translate API parametershttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/translate-api
Tag content to prevent translation in Azure Translatorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/prevent-translation
Use dynamic dictionary markup in Azure Translatorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-dynamic-dictionary
Configure profanity filtering in Azure Translatorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-profanity-filtering
Enable word alignment in Azure Translator responseshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/word-alignment
Monitor Azure Translator usage with Azure Monitor metricshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/metrics
Use Translator V3 BreakSentence method for sentence boundarieshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/break-sentence
Call Translator V3 detect method to identify languagehttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/detect
Use Translator V3 dictionary examples for contextual usagehttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-examples
Use Translator V3 dictionary lookup for alternative translationshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-lookup
Use Translator V3 translate method parametershttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/translate
Configure script transliteration with Translator V3https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/transliterate

Integrations & Coding Patterns

TopicURL
Deploy user-managed glossary in Translator containershttps://learn.microsoft.com/en-us/azure/ai-services/translator/containers/deploy-user-managed-glossary
Call Translator container document translation APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-document-parameters
Use Translator container text translation parametershttps://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-text-parameters
Use Translator container transliteration API parametershttps://learn.microsoft.com/en-us/azure/ai-services/translator/containers/transliterate-text-parameters
Call Translator API using a Custom Translator modelhttps://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/translate-with-custom-model
Use asynchronous batch document translation with Azurehttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/quickstarts/asynchronous
Integrate synchronous single-file document translation APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/quickstarts/synchronous
Cancel an asynchronous document translation jobhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/cancel-translation
Retrieve status for all documents in a jobhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-all-documents
List all document translation jobs via RESThttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-all-translations
Get status for a single translated documenthttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-specific-document
Get status of a specific translation jobhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-specific-translation
Query supported document formats for translationhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-supported-document-formats
Query supported glossary formats for translationhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-supported-glossary-formats
Call Azure Document Translation asynchronous REST APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/translate-asynchronous
Call synchronous document translation REST endpointhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/translate-synchronous
Cancel a batch document translation jobhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/cancel-translation
Use Get document status in Translator Document Translationhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-document-status
Get status for all documents in a translation jobhttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-documents-status
Retrieve supported document formats via RESThttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-document-formats
Retrieve supported glossary formats via RESThttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-glossary-formats
Get status of a document translation requesthttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translation-status
List translation jobs and statuses via RESThttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translations-status
Use Document Translation REST API operationshttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/rest-api-guide
Start batch document translation via RESThttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/start-batch-translation
Use synchronous text translation REST API for documentshttps://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/translate-document
Integrate with adaptive custom translation (AdaptCT) APIhttps://learn.microsoft.com/en-us/azure/ai-services/translator/foundry/adaptive-custom-translation
Build document translation flows with Translator v3 connectorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/document-translation-flow
Configure text translation flows using Translator v3 connectorhttps://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/text-translator-flow
Use Azure Translator text translation REST APIshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/rest-api-guide
Call Azure Translator transliterate REST methodhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/transliterate-api
Use Azure Translator neural dictionary in appshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-neural-dictionary
Use Azure Translator REST APIs with code exampleshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-rest-api
Integrate Azure Translator via SDK client librarieshttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/quickstart/client-library-sdk
Call Azure Translator REST API programmaticallyhttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/quickstart/rest-api
Translator V3 API parameters and request schemahttps://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/reference

Deployment

TopicURL
Deploy and run Azure Translator container with Dockerhttps://learn.microsoft.com/en-us/azure/ai-services/translator/containers/install-run

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

azure-active-directory-b2c

Free

Expert knowledge for Azure Active Directory B2C development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building B2C user flows/custom policies, configuring IdPs/MFA, securing APIs, automating CI/CD, or monitoring with Sentinel, and other Azure Active Directory B2C related development tasks. Not for Azure Role-based access control (use azure-rbac), Azure Information Protection (use azure-information-protection), Azure Security (use azure-security), Azure Sentinel (use azure-sentinel).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-advisor

Free

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when managing Advisor alerts, digests, recommendation states, Resource Graph queries, or RBAC access, and other Azure Advisor related development tasks. Not for Cost Management (use azure-cost-management), Azure Monitor (use azure-monitor), Azure Policy (use azure-policy), Azure Security (use azure-security).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-ai-vision

Free

Expert knowledge for Azure AI Vision development including decision making, limits & quotas, configuration, integrations & coding patterns, and deployment. Use when using Image Analysis, Read OCR containers, smart-crop thumbnails, background removal, or video frame analysis, and other Azure AI Vision related development tasks. Not for Azure AI Custom Vision (use azure-custom-vision), Azure AI Video Indexer (use azure-video-indexer), Azure AI Document Intelligence (use azure-document-intelligence), Azure AI Immersive Reader (use azure-immersive-reader).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-aks-edge-essentials

Free

Expert knowledge for Azure Kubernetes Service Edge Essentials development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when deploying AKS Edge/Hybrid with Arc, Azure Local, GitOps, IoT/OPC/ONVIF, or Key Vault-integrated workloads, and other Azure Kubernetes Service Edge Essentials related development tasks. Not for Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure IoT Edge (use azure-iot-edge), Azure Stack Edge (use azure-stack-edge), Azure Container Apps (use azure-container-apps).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-analysis-services

Free

Expert knowledge for Azure Analysis Services development including troubleshooting. Use when resolving server connectivity, firewall/VNet, DNS, client connection, or network error issues, and other Azure Analysis Services related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure SQL Database (use azure-sql-database), Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-anyscale-on-azure

Free

Expert knowledge for Azure Anyscale On Azure development including limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when registering AKS as Anyscale clouds, wiring ACR images, enabling Private Link/RBAC, ARM-based deployments, or region checks, and other Azure Anyscale On Azure related development tasks. Not for Azure Databricks (use azure-databricks), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Machine Learning (use azure-machine-learning), Azure HDInsight (use azure-hdinsight).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

See all skills by MicrosoftDocs

Report a problem with this skill