사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-translator시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: Ifmetadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools 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_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=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-L67 | Language, locale, and feature availability for Azure Translator/Translator Pro, plus text and document size, rate, and usage limits and quotas. |
| Security | L68-L79 | Securing Azure Translator: auth (keys, Entra ID, SAS, managed identities), firewall/VNet access, customer-managed keys, and secure deployments (incl. Foundry Tools). |
| Configuration | L80-L101 | 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 | L102-L141 | 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 | L142-L145 | 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 |
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 |


