Skip to content
cccskills
FreePublished on GitHub

azure-language-service

Expert knowledge for Azure AI Language development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using CLU, custom/health NER, CQA, sentiment/PII APIs, or Language/TA/health containers, and other Azure AI Language related development tasks. Not for Azure AI Search (use azure-cognitive-search), Azure AI Document Intelligence (use azure-document-intelligence), Azure Speech in Foundry Tools (use azure-speech), Azure Translator (use azure-translator).

The English summary is being prepared. Showing the original description.

Works withAzureDocker
See how to install

Files included (1)

  • SKILL.md18.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Azure AI Language Skill

This skill provides expert guidance for Azure AI Language. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

CategoryLinesDescription
TroubleshootingL37-L42Diagnosing and fixing common issues in Azure Language custom NER and conversational question answering (CQA), including model errors, configuration problems, and troubleshooting workflows.
Best PracticesL43-L53Best practices for designing and authoring CLU, custom NER, PII, and CQA projects, including data prep, schemas, lifecycles, chitchat personas, and document formatting.
Decision MakingL54-L63Guides for choosing regions and app types, planning CQA solutions, and deciding or executing migrations from LUIS, QnA Maker, Text Analytics, and Language Studio to Azure Language/Fountry.
Architecture & Design PatternsL64-L71Designing and implementing regional failover and high-availability patterns for CLU, custom NER, custom text classification, and orchestration workflow models in Azure AI Language.
Limits & QuotasL72-L95Limits, quotas, languages, and model lifecycles for Azure Language features (CLU, NER, text classification, CQA, health), including data size, rate, throughput, and container constraints.
SecurityL96-L107Securing Azure Language and CQA: encryption at rest (including CMK), RBAC, managed identities, SAS tokens, network isolation/Private Link, and secure deployment/data access configuration.
ConfigurationL108-L124Configuring Azure AI Language features: CLU fine-tuning, containers, custom/health NER, orchestration None intent, CQA scoring/telemetry, FHIR output, and related project/skill settings.
Integrations & Coding PatternsL125-L144How to call Azure Language/TA/health/CLU/CQA APIs and SDKs for NER, entity linking, key phrases, language detection, sentiment, PII redaction, relations, and orchestration workflows.
DeploymentL145-L155Guides for deploying and running custom language/NER/CQA/sentiment/health models across regions, on-prem via Docker containers, and moving projects between environments.

Troubleshooting

TopicURL
Resolve common issues with custom NER in Azure Languagehttps://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/faq
Troubleshoot common CQA issues and errorshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/troubleshooting

Best Practices

TopicURL
Apply CLU project authoring best practiceshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/concepts/best-practices
Adapt PII detection to custom domain terminologyhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/personally-identifiable-information/how-to/adapt-to-domain-pii
Implement CQA project best practiceshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/concepts/best-practices
Follow CQA project development lifecyclehttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/concepts/project-development-lifecycle
Apply authoring best practices to CQA projectshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/best-practices
Add chitchat personas to CQA projectshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/chit-chat
Apply document formatting best practices for custom Q&Ahttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/reference/document-format-guidelines

Decision Making

TopicURL
Choose Azure regions for Language service featureshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/regional-support
Choose CLU app vs orchestration workflowhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/concepts/app-architecture
Migrate Azure Language Studio projects to Microsoft Foundryhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/migration-studio-to-foundry
Plan a CQA app and select Azure resourceshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/concepts/plan
Decide migration from LUIS and QnA Maker to Azure Languagehttps://learn.microsoft.com/en-us/azure/ai-services/language-service/reference/migrate
Migrate Text Analytics apps to Azure Language APIhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/reference/migrate-language-service-latest

Architecture & Design Patterns

TopicURL
Design regional failover for CLU modelshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/how-to/fail-over
Design regional failover for custom NER modelshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/fail-over
Design regional failover for custom text classificationhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/fail-over
Implement regional failover for orchestration workflow modelshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/orchestration-workflow/concepts/fail-over

Limits & Quotas

TopicURL
Data size and rate limits for Azure Language featureshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/data-limits
Understand lifecycle timelines for Azure Language modelshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/model-lifecycle
Use CLU containers with on-premises limitshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/how-to/use-containers
Check CLU supported languages and localeshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/language-support
Reference CLU prebuilt entity componentshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/prebuilt-component-reference
Review CLU data and throughput limitshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/service-limits
Manage custom NER training jobs and expirationhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/how-to/train-model
Check language support matrix for custom text classificationhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/language-support
Review data and rate limits for custom text classificationhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/service-limits
Check language support for entity linkinghttps://learn.microsoft.com/en-us/azure/ai-services/language-service/entity-linking/language-support
Review language support for Key Phrase Extractionhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/key-phrase-extraction/language-support
Understand entity categories and types in NERhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/concepts/named-entity-categories
Check language support for Azure NER featurehttps://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/language-support
Check language support for orchestration workflow projectshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/orchestration-workflow/language-support
Review data and throughput limits for orchestration workflowhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/orchestration-workflow/service-limits
Understand PII detection container data limitshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/personally-identifiable-information/how-to/use-containers
Understand CQA project and service limitshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/concepts/limits
Review language support for CQA projectshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/language-support
Explore medical entity categories in health analyticshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/concepts/health-entity-categories
Review language support for Text Analytics for healthhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/language-support

Security

TopicURL
Understand data-at-rest encryption in Azure Languagehttps://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/encryption-data-at-rest
Configure RBAC for Azure Language resourceshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/role-based-access-control
Use managed identities to secure storage blob accesshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/native-document-support/managed-identities
Configure SAS tokens for Azure storage blobshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/native-document-support/shared-access-signatures
Configure Azure resources for CQA fine-tuninghttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/configure-azure-resources
Configure CMK encryption for CQA data at resthttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/encrypt-data-at-rest
Enable network isolation and Private Link for CQAhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/network-isolation
Secure Azure Language deployments and data accesshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/secure-deployment

Configuration

TopicURL
Configure Azure resources for CLU fine-tune modelshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/configure-azure-resources
Configure Azure AI Language service containershttps://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/configure-containers
Use supported data formats for custom NERhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/concepts/data-formats
Use NER entity metadata and resolutionshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/concepts/entity-metadata
Map NER API versions and entity tags/typeshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/concepts/ga-preview-mapping
Configure NER skill parameters and inference optionshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/how-to/skill-parameters
Configure the None intent behavior in orchestration workflowhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/orchestration-workflow/concepts/none-intent
Interpret and configure CQA confidence scoreshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/concepts/confidence-score
Enable and query CQA analytics telemetryhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/analytics
Manage CQA project settings and sourceshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/manage-knowledge-base
Use assertion detection in Text Analytics for healthhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/concepts/assertion-detection
Configure FHIR structuring in health analytics outputhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/concepts/fhir
Configure Text Analytics for health container settingshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/how-to/configure-containers

Integrations & Coding Patterns

TopicURL
Integrate Azure Language via SDK and REST APIshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/developer-guide
Call custom NER prediction API and SDKhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/how-to/call-api
Start building custom NER models via Foundry or RESThttps://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/quickstart
Call the entity linking API with correct parametershttps://learn.microsoft.com/en-us/azure/ai-services/language-service/entity-linking/how-to/call-api
Invoke the Key Phrase Extraction API correctlyhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/key-phrase-extraction/how-to/call-api
Implement language detection using SDKs and RESThttps://learn.microsoft.com/en-us/azure/ai-services/language-service/language-detection/quickstart
Perform NER calls with Azure Language servicehttps://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/how-to-call
Build a .NET app using NER client libraryhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/quickstart
Integrate CLU and custom Q&A via orchestration workflowhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/orchestration-workflow/tutorials/connect-services
Redact PII from native documents with Azure Languagehttps://learn.microsoft.com/en-us/azure/ai-services/language-service/personally-identifiable-information/how-to/redact-document-pii
Automate CQA authoring with REST APIhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/authoring
Use the CQA prebuilt answering APIhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/prebuilt
Call sentiment analysis and opinion mining APIs correctlyhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/sentiment-opinion-mining/how-to/call-api
Use relation extraction in Text Analytics for healthhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/concepts/relation-extraction
Call Text Analytics for health APIhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/how-to/call-api
Quickstart integrating Text Analytics for healthhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/quickstart

Deployment

TopicURL
Deploy custom language projects to multiple regionshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/custom-features/multi-region-deployment
Deploy custom NER with Docker containers on-premiseshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/how-to/use-containers
Deploy Key Phrase Extraction containers on-premiseshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/key-phrase-extraction/how-to/use-containers
Run NER Docker containers on-premiseshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/how-to/use-containers
Create and deploy a CQA agent in Foundryhttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/deploy-agent
Move CQA projects between environmentshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/migrate-knowledge-base
Deploy Sentiment Analysis containers on-premiseshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/sentiment-opinion-mining/how-to/use-containers
Deploy Text Analytics for health containers on-premiseshttps://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/how-to/use-containers

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Expert knowledge for Azure Active Directory B2C development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building B2C user flows/custom policies, configuring IdPs/MFA, securing APIs, automating CI/CD, or monitoring with Sentinel, and other Azure Active Directory B2C related development tasks. Not for Azure Role-based access control (use azure-rbac), Azure Information Protection (use azure-information-protection), Azure Security (use azure-security), Azure Sentinel (use azure-sentinel).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when managing Advisor alerts, digests, recommendation states, Resource Graph queries, or RBAC access, and other Azure Advisor related development tasks. Not for Cost Management (use azure-cost-management), Azure Monitor (use azure-monitor), Azure Policy (use azure-policy), Azure Security (use azure-security).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

Expert knowledge for Azure AI Vision development including decision making, limits & quotas, configuration, integrations & coding patterns, and deployment. Use when using Image Analysis, Read OCR containers, smart-crop thumbnails, background removal, or video frame analysis, and other Azure AI Vision related development tasks. Not for Azure AI Custom Vision (use azure-custom-vision), Azure AI Video Indexer (use azure-video-indexer), Azure AI Document Intelligence (use azure-document-intelligence), Azure AI Immersive Reader (use azure-immersive-reader).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

Expert knowledge for Azure Kubernetes Service Edge Essentials development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when deploying AKS Edge/Hybrid with Arc, Azure Local, GitOps, IoT/OPC/ONVIF, or Key Vault-integrated workloads, and other Azure Kubernetes Service Edge Essentials related development tasks. Not for Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure IoT Edge (use azure-iot-edge), Azure Stack Edge (use azure-stack-edge), Azure Container Apps (use azure-container-apps).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

Expert knowledge for Azure Analysis Services development including troubleshooting. Use when resolving server connectivity, firewall/VNet, DNS, client connection, or network error issues, and other Azure Analysis Services related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure SQL Database (use azure-sql-database), Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

Expert knowledge for Azure Anyscale On Azure development including limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when registering AKS as Anyscale clouds, wiring ACR images, enabling Private Link/RBAC, ARM-based deployments, or region checks, and other Azure Anyscale On Azure related development tasks. Not for Azure Databricks (use azure-databricks), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Machine Learning (use azure-machine-learning), Azure HDInsight (use azure-hdinsight).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

See all skills by MicrosoftDocs

Report a problem with this skill