DOCUMENT TRANSLATION / Microsoft
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.
“Azure AI Document Translation SDK for batch translation of documents with format preservation. Use for translating Word, PDF, Excel, PowerPoint, and other document formats at scale. Triggers: "document translation", "batch translation", "translate documents", "DocumentTranslationClient". ”
01 / THE REASONING
Why this made the selection.
- The file says new code should use DefaultAzureCredential, avoid API keys, and set AZURE_TOKEN_CREDENTIALS in production to constrain the credential chain.
- It says blob SAS tokens should carry minimal permissions: source read and list, and target write and list.
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-document-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 AzureKeyCredential is only for an existing keyed deployment that has not been migrated to Entra ID.
- It says source and target containers must be Azure Blob Storage, and SAS permissions are source read and list, target write and list.
- It shows cancel_translation for a running operation.
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 translation job was started and no translation was cancelled.
- 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@skillsCopying 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-document` 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 document-translation endpoint and source and target container URLs, as the skill's environment block names them
- DefaultAzureCredential for new code, or the legacy key only for an unmigrated keyed deployment
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-document-py/SKILL.md
Supports: Entra preference, legacy key limit, and SAS read/list versus write/list
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-document-py/SKILL.md
Supports: upstreamDescription, access.permissions, review, limitations