TEXT ANALYTICS / Microsoft
Azure AI Text Analytics for Python
Pins Microsoft's Python text-analytics skill, which keeps new code on DefaultAzureCredential and reserves API keys for unmigrated keyed deployments.
“Azure AI Text Analytics SDK for sentiment analysis, entity recognition, key phrases, language detection, PII, and healthcare NLP. Use for natural language processing on text. Triggers: "text analytics", "sentiment analysis", "entity recognition", "key phrase", "PII detection", "TextAnalyticsClient". ”
01 / THE REASONING
Why this made the selection.
- The file says to prefer DefaultAzureCredential and to avoid connection strings and API keys because they bypass Entra audit and rotation.
- It says new code should use DefaultAzureCredential, and AzureKeyCredential only for an existing keyed deployment that has not been migrated to Entra ID.
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-textanalytics-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 not to mix the sync text-analytics client with the aio client in the same call path.
- It says to use batch operations for multiple documents, up to 10 per request.
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 document was sent and no PII or healthcare call was made.
- 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-textanalytics` 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
- An Azure AI Language endpoint in AZURE_LANGUAGE_ENDPOINT
- DefaultAzureCredential for new code, or AZURE_LANGUAGE_KEY only for the legacy keyed path the skill describes
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-textanalytics-py/SKILL.md
Supports: Entra preference, production credential constraint, legacy key limit, and the sync/async split
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-textanalytics-py/SKILL.md
Supports: upstreamDescription, limitations, review