---
title: "Azure AI Text Translation for Python: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/microsoft-azure-ai-translation-text-py/
description: "Pins Microsoft's Python text-translation skill, which requires a custom subdomain for token auth and keeps the global endpoint on key plus region."
---

# Azure AI Text Translation for Python: review, setup & limitations · Undominated.ai

> Pins Microsoft's Python text-translation skill, which requires a custom subdomain for token auth and keeps the global endpoint on key plus region.

[← Explore all skills](/skills/)

TEXT TRANSLATION / Microsoft

# Azure AI Text Translation for Python

Pins Microsoft's Python text-translation skill, which requires a custom subdomain for token auth and keeps the global endpoint on key plus region.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/microsoft/skills/tree/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-ai-translation-text-py)

SOURCE REVIEW

 Reviewed 2026-10-15
 Evidence 5 linked sources
 Publisher Microsoft
 Licence [MIT ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE)
 Revision fc164ba1d7a0
 [Read what was—and wasn’t—checked ↓](#review)

“Azure AI Text Translation SDK for real-time text translation, transliteration, language detection, and dictionary lookup. Use for translating text content in applications. Triggers: "text translation", "translator", "translate text", "transliterate", "TextTranslationClient". ”

 [Microsoft · upstream description ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-ai-translation-text-py/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - The file says token-credential auth requires a custom subdomain, and that a global endpoint must stay on the key-based path until a custom subdomain exists.
- It says key plus region is the setup against the global endpoint, while new code should still use DefaultAzureCredential when a custom subdomain is available.

### A good fit for

 - Calling Translator from Python when the endpoint is known to be either a custom subdomain for Entra ID or the global endpoint with key and region
- Retrieve alternate translations and usage examples for a source term before selecting wording.

### Weigh up before choosing

 - This review did not execute the resource.
- `/plugin install azure-sdk-python@skills` installs the azure-sdk-python plugin named in the plugin README, not this file alone.
- The plugin README also prints `npx skills add microsoft/skills --skill azure-sdk-python` for that same plugin.
- The repository README prints `/plugin install azure@skills`, which is a different plugin, and `npx skills add microsoft/skills`, which opens a wizard for the repository.
- The repository README says the repository is under active development and says to load skills selectively.
- Linked reference files were not opened.
- The opening auth rule says to avoid API keys, and the legacy section says a global endpoint must stay on the key-based path. The file states that as a service exception, not as a second silent rule.
- The method table names detect. The language-detection example uses translate and reads detected_language. This review did not check whether a detect method exists.
- Profanity handling is an optional translate argument. The file does not require a profanity action.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - .github/plugins/azure-sdk-python/skills/azure-ai-translation-text-py/SKILL.md
- README.md
- .github/plugins/azure-sdk-python/README.md
- LICENSE

### Our findings

 - The file says to prefer DefaultAzureCredential and to avoid connection strings and API keys because they bypass Entra audit and rotation.
- It says production must set AZURE_TOKEN_CREDENTIALS to prod, or to one named credential, to constrain the credential chain.
- It says token-credential auth requires a custom subdomain endpoint, and a caller who only has the global endpoint must provision one or stay on the key-based path.
- It says key plus region is the canonical setup against the global endpoint, and the region is required for a multi-service or global Translator key.
- It says a key against a custom subdomain endpoint does not require a region.

### Not established by this review

 - The resource was not executed and its tools were not called.
- No Azure client was constructed and no credential was used.
- The linked reference files were not opened.
- The azure-sdk-python plugin was not installed.
- No text was translated and no endpoint type was probed.
- Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/README.md)

DOCUMENTED COMMAND

 /plugin install azure-sdk-python@skills Copy command ↗

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

 - The plugin README shows `/plugin install azure-sdk-python@skills`. That installs the azure-sdk-python plugin, not this one file.
- The same README also shows `npx skills add microsoft/skills --skill azure-sdk-python`.
- The repository README shows `npx skills add microsoft/skills`, which starts a wizard for the repository, and `/plugin install azure@skills` for a different plugin.
- The skill shows `pip install azure-ai-translation-text` for the SDK package. That line was not run.

### Before you start

 - Python if the skill's pip line is run; this review did not run it
- A custom subdomain endpoint for Entra ID, or a key and region for the global endpoint, as the skill distinguishes those paths
- AZURE_TOKEN_CREDENTIALS when production uses DefaultAzureCredential, as the skill's environment block says

### Compatibility

GitHub Copilot · GitHub Copilot CLI

### Implementation

python

### Local skill text; translation calls happen only if an operator runs them

 - Read the skill text
- Authenticate with Entra ID only against a custom subdomain, as the skill requires for token credentials
- Authenticate with a key and region only on the global-endpoint path the skill describes
- Send text to Translator only if the operator runs a client call

### Cost model

MIT; no Azure or Python command was run

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [azure-ai-translation-text-py SKILL.md ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-ai-translation-text-py/SKILL.md) Checked 2026-10-14 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-ai-translation-text-py/SKILL.md Supports: custom-subdomain token auth, global-endpoint key plus region, and the production credential constraint
- [Azure SDK Python plugin README ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/README.md) Checked 2026-10-14 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/README.md Supports: /plugin install azure-sdk-python@skills installs the plugin, not one file
- [Repository README ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md) Checked 2026-10-14 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md Supports: MIT statement, Copilot CLI plugin install, and a different azure plugin command
- [Repository LICENSE ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE) Checked 2026-10-14 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE Supports: MIT License
- [Pinned source sections reviewed in continuation W01 on 2026-10-15 ↗](https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-ai-translation-text-py/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-ai-translation-text-py/SKILL.md Supports: upstreamDescription, bestFor, review.notTested

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Azure AI Content Safety for Python ↗ Pins Microsoft's Python Content Safety skill, which keeps new code on Entra credentials and can stop analysis when a blocklist matches.](/skills/microsoft-azure-ai-contentsafety-py/)[### Azure AI Document Translation for Python ↗ Pins Microsoft's Python document-translation skill, which uses Entra for new clients and limits blob SAS permissions on source and target containers.](/skills/microsoft-azure-ai-translation-document-py/)[### Azure AI Language Conversations for Python ↗ Pins Microsoft's Python conversation-analysis skill, which tells new code to use token credentials and reserves API keys for unmigrated keyed deployments.](/skills/microsoft-azure-ai-language-conversations-py/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
