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.
“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". ”
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.
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.
DOCUMENTED COMMAND
/plugin install azure-sdk-python@skills 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
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
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
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 ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md
Supports: MIT statement, Copilot CLI plugin install, and a different azure plugin command
- Repository LICENSE ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE
Supports: MIT License
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