azure-content-safety

Azure Content Safety Skill

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

How to Use This Skill

IMPORTANT for Agent: This file may be large. Use the Category Index below to locate relevant sections, then use read_file with specific line ranges (e.g., L136-L144) to read the sections needed for the user's question This skill requires network access to fetch documentation content. Use mcp_microsoftdocs:microsoft_docs_fetch to retrieve full articles.

• Fallback: Use the built-in WebFetch tool if the Microsoft Learn MCP server is not available.

Category Index

Category	Lines	Description
Troubleshooting	L30-L33	Diagnosing and resolving Azure AI Content Safety API errors, including HTTP status codes, common failure causes, and recommended fixes or retries.
Best Practices	L35-L38	Tuning Content Safety thresholds, categories, and prompts to reduce misclassifications, plus strategies to balance safety, recall, and user experience.
Decision Making	L40-L44	Guidance on migrating apps from Content Safety preview to GA and deciding when and how to use limited-access Content Safety features and models.
Architecture & Design Patterns	L46-L49	Architectural guidance for combining cloud, hybrid, and on-device Azure AI Content Safety, including design patterns, deployment options, and integration strategies.
Limits & Quotas	L51-L56	Language coverage, building and training custom safety categories, and detecting protected/third‑party code in model outputs.
Security	L58-L61	Details on how Azure AI Content Safety encrypts data at rest, including encryption models, key management options, and compliance/security considerations.
Configuration	L63-L66	Configuring and using text blocklists in Azure AI Content Safety, including creating, managing, and applying custom blocked terms to filter harmful or unwanted content.
Deployment	L68-L74	How to install, configure, and run Azure AI Content Safety Docker containers for text, image, and prompt shield analysis in your own environment.

Troubleshooting

Topic	URL
Resolve Azure AI Content Safety API error codes	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/concepts/response-codes

Best Practices

Topic	URL
Reduce false positives and negatives in Content Safety	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/improve-performance

Decision Making

Topic	URL
Migrate apps from Content Safety preview to GA	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/migrate-to-general-availability
Decide when to use limited access Content Safety features	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/limited-access

Architecture & Design Patterns

Topic	URL
Design hybrid and on-device Content Safety solutions	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/embedded-content-safety

Limits & Quotas

Topic	URL
Check language support for Azure AI Content Safety	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/language-support
Create and train custom categories with Content Safety	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/quickstart-custom-categories
Use protected material detection for code outputs	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/quickstart-protected-material-code

Security

Topic	URL
Understand data-at-rest encryption in Content Safety	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/encrypt-data-at-rest

Configuration

Topic	URL
Configure and use text blocklists in Content Safety	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/use-blocklist

Deployment

Topic	URL
Deploy image analysis Content Safety container with Docker	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/containers/image-container
Install and run Azure Content Safety Docker containers	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/containers/install-run-container
Run Prompt Shields Content Safety container for prompt attacks	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/containers/prompt-shields-container
Deploy text analysis Content Safety container with Docker	https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/containers/text-container