Agent skill

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 building CLU intents, custom NER, text classification, CQA/FAQ, sentiment, or summarization solutions, 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 AI Immersive Reader (use azure-immersive-reader), Azure Translator (use azure-translator).

View SKILL.md on GitHub Repository
Stars 485
Forks 45

Install this agent skill to your Project

npx add-skill https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-language-service

Metadata

Additional technical details for this skill

generator
docs2skills/1.0.0
generated at
2026-04-05

SKILL.md

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

Category Lines Description
Troubleshooting L37-L42 Diagnosing and fixing common errors, low-accuracy results, and configuration issues in custom text classification and custom question answering projects in Azure AI Language.
Best Practices L43-L60 Best practices for designing, labeling, and evaluating CLU, custom NER, text classification, and CQA projects, including multilingual handling, emojis, schemas, and autolabeling.
Decision Making L61-L70 Guidance on regions, resources, lifecycles, and migration decisions for Azure Language apps, including moving from LUIS/QnA Maker/Text Analytics and Language Studio to newer Language/Foundry setups
Architecture & Design Patterns L71-L77 Architectural guidance for CLU and custom text classification: choosing CLU vs orchestration workflows, and designing regional backup, redundancy, and failover strategies.
Limits & Quotas L78-L95 Limits, quotas, and language/region support for Azure AI Language features (CLU, NER, classification, PII, CQA), including data size, rate, throughput, and container request limits.
Security L96-L105 Security for Azure AI Language: encryption at rest, customer-managed keys, RBAC, managed identities, SAS tokens, and network isolation/Private Link for CQA resources.
Configuration L106-L133 Configuring Azure AI Language projects and containers: CLU, custom NER, text classification, CQA, sentiment, summarization, health, data formats, resources, and runtime settings.
Integrations & Coding Patterns L134-L165 How to call Azure Language/CLU/Health/Summarization/CQA APIs and SDKs, wire them into bots, Power Automate, and Foundry, and correctly handle async, parameters, and outputs
Deployment L166-L175 How to deploy and run Azure AI Language models (custom classification, NER, QnA, key phrases, language detection) across regions, containers, AKS, and migrate projects/resources.

Troubleshooting

Topic URL
Resolve common issues in custom text classification https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/faq
Troubleshoot common issues in custom question answering https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/troubleshooting

Best Practices

Topic URL
Handle multilingual and emoji offsets in Language https://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/multilingual-emoji-support
Apply CLU conversational design best practices https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/concepts/best-practices
Implement multilingual CLU projects effectively https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/concepts/multiple-languages
Design effective CLU project schemas https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/how-to/build-schema
Tag and label utterances for CLU training https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/how-to/tag-utterances
Interpret and stabilize CLU model evaluations https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/how-to/view-model-evaluation
Prepare data and design schemas for custom NER https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/how-to/design-schema
Label data effectively for custom NER training https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/how-to/tag-data
Use autolabeling to accelerate custom NER annotation https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/how-to/use-autolabeling
Prepare data and design schemas for text classification https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/how-to/design-schema
Label data effectively for custom text classification https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/how-to/tag-data
Implement best practices for CQA project quality https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/concepts/best-practices
Apply project authoring best practices in CQA https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/best-practices
Apply document format guidelines for CQA imports https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/reference/document-format-guidelines

Decision Making

Topic URL
Understand Azure Language model lifecycle policies https://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/model-lifecycle
Choose Azure regions for Language service features https://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/regional-support
Migrate Azure Language Studio projects to Microsoft Foundry https://learn.microsoft.com/en-us/azure/ai-services/language-service/migration-studio-to-foundry
Choose and manage Azure resources for CQA https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/concepts/azure-resources
Decide when to migrate from LUIS or QnA Maker https://learn.microsoft.com/en-us/azure/ai-services/language-service/reference/migrate
Migrate Text Analytics apps to Azure Language API https://learn.microsoft.com/en-us/azure/ai-services/language-service/reference/migrate-language-service-latest

Architecture & Design Patterns

Topic URL
Choose CLU vs orchestration workflow architecture https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/concepts/app-architecture
Design CLU regional backup and failover https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/how-to/fail-over
Design regional fail-over for custom text classification solutions https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/fail-over

Limits & Quotas

Topic URL
Data size and rate limits for Azure Language features https://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/data-limits
Train and manage CLU model jobs and limits https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/how-to/train-model
Apply CLU Docker container request limits https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/how-to/use-containers
Apply CLU data, region, and throughput limits https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/service-limits
Check language and region support for custom NER https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/language-support
Language support matrix for custom text classification https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/language-support
Review custom text classification data and rate limits https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/service-limits
Check language support for entity linking API https://learn.microsoft.com/en-us/azure/ai-services/language-service/entity-linking/language-support
Check language support for key phrase extraction https://learn.microsoft.com/en-us/azure/ai-services/language-service/key-phrase-extraction/language-support
Review language detection supported languages and codes https://learn.microsoft.com/en-us/azure/ai-services/language-service/language-detection/language-support
Review language support for Named Entity Recognition https://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/language-support
Review orchestration workflow data and throughput limits https://learn.microsoft.com/en-us/azure/ai-services/language-service/orchestration-workflow/service-limits
Apply PII container per-call character and document limits https://learn.microsoft.com/en-us/azure/ai-services/language-service/personally-identifiable-information/how-to/use-containers
Service limits and boundaries for CQA projects https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/concepts/limits

Security

Topic URL
Understand Language service data-at-rest encryption https://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/encryption-data-at-rest
Apply Azure RBAC to Azure Language resources https://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/role-based-access-control
Use managed identities for Language Blob access https://learn.microsoft.com/en-us/azure/ai-services/language-service/native-document-support/managed-identities
Create SAS tokens for Language Blob access https://learn.microsoft.com/en-us/azure/ai-services/language-service/native-document-support/shared-access-signatures
Configure data-at-rest encryption and CMK for CQA https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/encrypt-data-at-rest
Configure network isolation and Private Link for CQA https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/network-isolation

Configuration

Topic URL
Configure Azure resources for CLU fine-tuning https://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/configure-azure-resources
Configure Azure Language service containers https://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/configure-containers
Format data correctly for CLU projects https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/concepts/data-formats
Configure and use CLU None intent https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/concepts/none-intent
Use CLU prebuilt entity components https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/prebuilt-component-reference
Create custom NER projects and configure Azure resources https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/how-to/create-project
Configure and run Custom NER Docker containers on-premises https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/how-to/use-containers
Use required data formats for custom text classification https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/concepts/data-formats
Set up resources and create custom text classification projects https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/how-to/create-project
Configure and run training jobs for text classification models https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/how-to/train-model
View and interpret evaluation metrics for text classification models https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/how-to/view-model-evaluation
Map NER entity types and tags across API versions https://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/concepts/ga-preview-mapping
Configure NER skill parameters and inference options https://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/how-to/skill-parameters
Understand and configure confidence scores in CQA https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/concepts/confidence-score
Enable diagnostics and run analytics for CQA projects https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/analytics
Customize default answer behavior in CQA projects https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/change-default-answer
Add and configure chitchat personas in CQA https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/chit-chat
Configure Azure resources and permissions for CQA fine-tuning https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/configure-azure-resources
Configure smart URL refresh for CQA projects https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/smart-url-refresh
Use supported markdown formats in CQA answers https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/reference/markdown-format
Run Sentiment Analysis Docker containers https://learn.microsoft.com/en-us/azure/ai-services/language-service/sentiment-opinion-mining/how-to/use-containers
Run Summarization Docker containers on-premises https://learn.microsoft.com/en-us/azure/ai-services/language-service/summarization/how-to/use-containers
Configure Text Analytics for health containers https://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/how-to/configure-containers
Run Text Analytics for health containers https://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/how-to/use-containers

Integrations & Coding Patterns

Topic URL
Integrate Azure Language SDK and REST APIs https://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/developer-guide
Use Azure Language features asynchronously https://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/use-asynchronously
Call CLU prediction APIs and SDKs https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/how-to/call-api
Integrate CLU with Bot Framework SDK https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/tutorials/bot-framework
Start building custom NER models via Foundry or REST https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/quickstart
Send prediction requests to custom text classification deployments https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/how-to/call-api
Call the entity linking API with correct parameters https://learn.microsoft.com/en-us/azure/ai-services/language-service/entity-linking/how-to/call-api
Call entity linking via SDKs and REST API https://learn.microsoft.com/en-us/azure/ai-services/language-service/entity-linking/quickstart
Call the key phrase extraction API correctly https://learn.microsoft.com/en-us/azure/ai-services/language-service/key-phrase-extraction/how-to/call-api
Use key phrase extraction via .NET client library https://learn.microsoft.com/en-us/azure/ai-services/language-service/key-phrase-extraction/quickstart
Call language detection API and interpret results https://learn.microsoft.com/en-us/azure/ai-services/language-service/language-detection/how-to/call-api
Implement language detection using SDKs and REST https://learn.microsoft.com/en-us/azure/ai-services/language-service/language-detection/quickstart
Call the NER API to extract named entities https://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/how-to-call
Use the NER client library to extract entities https://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/quickstart
Use native document support with Language APIs https://learn.microsoft.com/en-us/azure/ai-services/language-service/native-document-support/overview
Use the CQA Authoring API for automated management https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/authoring
Call the prebuilt CQA API for ad-hoc answering https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/prebuilt
Call Sentiment and Opinion Mining APIs https://learn.microsoft.com/en-us/azure/ai-services/language-service/sentiment-opinion-mining/how-to/call-api
Call Sentiment Analysis via SDK and REST https://learn.microsoft.com/en-us/azure/ai-services/language-service/sentiment-opinion-mining/quickstart
Call conversation summarization API for chats https://learn.microsoft.com/en-us/azure/ai-services/language-service/summarization/how-to/conversation-summarization
Summarize native documents via API https://learn.microsoft.com/en-us/azure/ai-services/language-service/summarization/how-to/document-summarization
Use extractive text summarization API https://learn.microsoft.com/en-us/azure/ai-services/language-service/summarization/how-to/text-summarization
Use Azure Summarization via SDK and REST https://learn.microsoft.com/en-us/azure/ai-services/language-service/summarization/quickstart
Enable FHIR structuring in health API output https://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/concepts/fhir
Interpret relation extraction JSON output https://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/concepts/relation-extraction
Call Text Analytics for health API https://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/how-to/call-api
Quickstart Text Analytics for health via SDK/REST https://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/quickstart
Use Azure Language in Power Automate flows https://learn.microsoft.com/en-us/azure/ai-services/language-service/tutorials/power-automate

Deployment

Topic URL
Deploy custom language projects to multiple regions https://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/custom-features/multi-region-deployment
Deploy custom text classification models for prediction https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/how-to/deploy-model
Run key phrase extraction in Docker containers on-premises https://learn.microsoft.com/en-us/azure/ai-services/language-service/key-phrase-extraction/how-to/use-containers
Deploy language detection with Docker containers on-premises https://learn.microsoft.com/en-us/azure/ai-services/language-service/language-detection/how-to/use-containers
Deploy NER with Docker containers on-premises https://learn.microsoft.com/en-us/azure/ai-services/language-service/named-entity-recognition/how-to/use-containers
Move custom question answering projects between resources https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/migrate-knowledge-base
Deploy Language containers to Azure Kubernetes Service https://learn.microsoft.com/en-us/azure/ai-services/language-service/tutorials/use-kubernetes-service

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

MicrosoftDocs/Agent-Skills

azure-blueprints

Expert knowledge for Azure Blueprints development including troubleshooting, architecture & design patterns, security, configuration, and integrations & coding patterns. Use when defining Azure Blueprints, mapping built-in compliance sets, automating via CLI/PowerShell/REST, or fixing assignment errors, and other Azure Blueprints related development tasks. Not for Azure Policy (use azure-policy), Azure Resource Manager (use azure-resource-manager), Azure Managed Applications (use azure-managed-applications), Azure Deployment Environments (use azure-deployment-environments).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-hdinsight

Expert knowledge for Azure HDInsight development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when working with HDInsight Spark/Hive/Kafka/HBase clusters, Ambari, VNet networking, or Azure SQL/Cosmos DB integration, and other Azure HDInsight related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure Databricks (use azure-databricks), Azure Stream Analytics (use azure-stream-analytics).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-advisor

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when configuring Advisor alerts, workbooks, RBAC access, bulk fixes, or Resource Graph/Kusto queries, and other Azure Advisor related development tasks. Not for Azure Cost Management (use azure-cost-management), Azure Monitor (use azure-monitor), Azure Policy (use azure-policy), Azure Service Health (use azure-service-health).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-cognitive-search

Expert knowledge for Azure AI Search development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when designing indexes/skillsets, vector/semantic search, indexers, RAG knowledge bases, or secure data access, and other Azure AI Search related development tasks. Not for Azure Cosmos DB (use azure-cosmos-db), Azure Data Explorer (use azure-data-explorer), Azure SQL Database (use azure-sql-database), Azure Synapse Analytics (use azure-synapse-analytics).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-migrate

Expert knowledge for Azure Migrate development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using AppCAT/CAST, Site Recovery REST APIs, Azure Migrate appliance, Arc-based discovery, or Resource Mover, and other Azure Migrate related development tasks. Not for Azure Database Migration service (use azure-database-migration), Azure Site Recovery (use azure-site-recovery), Azure Virtual Machines (use azure-virtual-machines), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines).

485 45
Explore
MicrosoftDocs/Agent-Skills

azure-maps

Expert knowledge for Azure Maps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. Use when using Azure Maps web SDK, search/geocoding, routing/traffic, weather APIs, or migrating from Bing/Google Maps, and other Azure Maps related development tasks.

485 45
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results