Skip to content

[Docs] Add Vietnamese Text Analytics samples - #49764

Open
Slai.life (huong8373tt-beep) wants to merge 2 commits into
Azure:mainfrom
huong8373tt-beep:docs/vietnamese-language-samples-49700
Open

Slai.life (huong8373tt-beep) wants to merge 2 commits into
Azure:mainfrom
huong8373tt-beep:docs/vietnamese-language-samples-49700

Conversation

@huong8373tt-beep

@huong8373tt-beep Slai.life (huong8373tt-beep) commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Add synchronous and asynchronous Vietnamese (vi) examples for Azure AI Text Analytics:

  • sentiment analysis
  • key phrase extraction
  • named entity recognition

The samples follow the existing package conventions and are linked from the Text Analytics samples README. They pass vi through the existing SDK client APIs and do not change SDK behavior.

Fixes #49700.

Validation

  • Created sync/async sample pairs using the existing TextAnalyticsClient and async client APIs.
  • Compiled all six new samples with Python compileall.
  • Installed package and development requirements in an isolated virtual environment and compiled the complete samples directory.
  • CSpell 9.7.0 reports 0 issues for the six new samples after adding only the intentional Vietnamese vocabulary to the package-specific override.
  • git diff --check passed.
  • Azure Analyze, docs, Linux, macOS, Windows, and other available pipeline checks passed or are running on the current head.

No service credentials or live calls were used. Therefore, this PR verifies the sample syntax and SDK invocation pattern, but does not claim live service-language availability for Vietnamese key phrase extraction.

Disclosure and authorization

Slai Agent Runtime performed the investigation, implementation, and test execution. The account owner authorized this contribution and is responsible for its content.

@github-actions github-actions Bot added Cognitive - Text Analytics Community Contribution Community members are working on the issue customer-reported Issues that are reported by GitHub users external to the Azure organization. labels Oct 29, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Thank you for your contribution Slai.life (@huong8373tt-beep)! We will review the pull request and get back to you soon.

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 1 pipeline(s).
10 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

@huong8373tt-beep

Copy link
Copy Markdown
Contributor Author

Addressed the Build Analyze spelling failure in 8727f6093d.

The Vietnamese sample text is intentional, so I added the Vietnamese words used by the six new Text Analytics samples to the existing package-specific sdk/textanalytics/azure-ai-textanalytics/** CSpell override in .vscode/cspell.json.

Validation:

  • CSpell 9.7.0 against all six new sync/async samples: 0 issues
  • python -m compileall -q sdk/textanalytics/azure-ai-textanalytics/samples
  • git diff --check

The other build/test jobs were already green; this should unblock the Analyze stage.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

Vietnamese key phrase extraction support remains unverified because the SDK only forwards vi, and compile-only validation does not confirm support in the service language matrix or through a live call.

No open issues 🎉

What changed in this PR

Adds Vietnamese (vi) examples to the Azure AI Text Analytics SDK samples, addressing the Text Analytics documentation gap in #49700 without changing SDK behavior.

Changes:

  • Adds synchronous and asynchronous samples for sentiment analysis, key phrase extraction, and named entity recognition.
  • Links all six examples from the samples README.
  • Adds Vietnamese sample vocabulary to the spell-check configuration.
File Description
sdk/​textanalytics/​azure-ai-textanalytics/​samples/​sample_recognize_entities_vietnamese.py Adds synchronous Vietnamese entity recognition.
sdk/​textanalytics/​azure-ai-textanalytics/​samples/​sample_extract_key_phrases_vietnamese.py Adds synchronous Vietnamese key phrase extraction.
sdk/​textanalytics/​azure-ai-textanalytics/​samples/​sample_analyze_sentiment_vietnamese.py Adds synchronous Vietnamese sentiment analysis.
sdk/​textanalytics/​azure-ai-textanalytics/​samples/​README.md Lists and links the six new samples.
sdk/​textanalytics/​azure-ai-textanalytics/​samples/​async_samples/​sample_recognize_entities_vietnamese_async.py Adds asynchronous Vietnamese entity recognition.
sdk/​textanalytics/​azure-ai-textanalytics/​samples/​async_samples/​sample_extract_key_phrases_vietnamese_async.py Adds asynchronous Vietnamese key phrase extraction.
sdk/​textanalytics/​azure-ai-textanalytics/​samples/​async_samples/​sample_analyze_sentiment_vietnamese_async.py Adds asynchronous Vietnamese sentiment analysis.
.vscode/​cspell.json Allows Vietnamese vocabulary used in the samples.

Review effort: Balanced

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Cognitive - Text Analytics Community Contribution Community members are working on the issue customer-reported Issues that are reported by GitHub users external to the Azure organization.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Docs] Vietnamese language example for Azure AI Text Analytics / Language service

2 participants