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.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
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), 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

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills
microsoftdocs
社区

azure-repos

Expert knowledge for Azure Repos development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. Use when managing Git/TFVC repos, branch policies/PR checks, TFVC→Git migrations, large files, or security scanning, and other Azure Repos related development tasks. Not for Azure DevOps (use azure-devops), Azure Pipelines (use azure-pipelines), Azure Boards (use azure-boards), Azure

安装量
1
GitHub Stars
790
最近更新
10月19日
microsoftdocs
社区

azure-monitor

Expert knowledge for Azure Monitor development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring AMA/DCRs, Log Analytics workspaces, Application Insights, alerts, or Kusto (KQL) queries, and other Azure Monitor related development tasks. Not for Azure Network Watcher (use azure-network-watcher), Azure Resource Graph (use azure-resource-graph), A

安装量
1
GitHub Stars
779
最近更新
10月11日
microsoftdocs
社区

azure-rbac

Expert knowledge for Azure Role-based access control development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when defining custom/built-in roles, ABAC conditions, deny assignments, PIM, or ARM/Bicep-based role automation, and other Azure Role-based access control related development tasks. Not for Azure Policy (use azure-policy), Azure Security (use azure-security), Azure Resource Manager (use azure

安装量
2
GitHub Stars
777
最近更新
10月5日
microsoftdocs
社区

azure-analysis-services

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).

安装量
1
GitHub Stars
777
最近更新
10月5日