Agent skill

microsoft-foundry-tools

Expert knowledge for Microsoft Foundry Tools (aka Azure AI services, Azure Cognitive Services) development including best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. Use when using Content Moderator, Content Understanding analyzers, REST/.NET APIs, quotas, or secure Foundry setups, and other Microsoft Foundry Tools related development tasks. Not for Microsoft Foundry (use microsoft-foundry), Microsoft Foundry Classic (use microsoft-foundry-classic), Microsoft Foundry Local (use microsoft-foundry-local).

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/microsoft-foundry-tools

Metadata

Additional technical details for this skill

generator
docs2skills/1.0.0
generated at
2026-04-05

SKILL.md

Microsoft Foundry Tools Skill

This skill provides expert guidance for Microsoft Foundry Tools. Covers best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. 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
Best Practices L35-L40 Improving Content Understanding accuracy, document extraction quality, and using confidence scores/grounding to make extractions more reliable and trustworthy
Decision Making L41-L49 Guides for choosing and comparing Foundry/Content Understanding tools and modes, planning pricing, and migrating from preview to GA document processing APIs
Architecture & Design Patterns L50-L54 Designing and configuring how Content Understanding analyzers are mapped to specific model deployments, including routing strategies and deployment architecture patterns.
Limits & Quotas L55-L62 Quotas, limits, and supported languages for Content Moderator and Content Understanding, including image/list caps, usage constraints, and .NET sample considerations.
Security L63-L67 Securing Foundry: auth methods, Entra-only access, keys/Key Vault, CMK encryption, DLP, VNet rules, API key rotation, Azure Policy and regulatory compliance configuration
Configuration L68-L78 Configuring Foundry environments and resources: credentials, subdomains, ARM provisioning, logging, and detailed setup for Content Understanding analyzers, layouts, images, faces, and routing.
Integrations & Coding Patterns L79-L93 Using Content Moderator and Content Understanding via REST/.NET: text/image/video moderation, term lists, multimodal analysis, and consuming Markdown/structured outputs

Best Practices

Topic URL
Apply best practices for Content Understanding accuracy https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/best-practices
Improve document extraction with confidence and grounding https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/document/analyzer-improvement

Decision Making

Topic URL
Choose Azure AI tool for document processing https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/choosing-right-ai-tool
Choose between Content Understanding standard and pro modes https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/standard-pro-modes
Compare Foundry vs Content Understanding Studio features https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/foundry-vs-content-understanding-studio
Migrate Content Understanding from preview to GA APIs https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/how-to/migration-preview-to-ga
Estimate and plan Content Understanding pricing https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/pricing-explainer

Architecture & Design Patterns

Topic URL
Map Content Understanding analyzers to model deployments https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/models-deployments

Limits & Quotas

Topic URL
Use Content Moderator image lists within quota limits https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/image-lists-quickstart-dotnet
Use supported languages in Content Moderator API https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/language-support
Apply Content Moderator .NET samples with list limits https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/samples-dotnet
Review Content Understanding service quotas and limits https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/service-limits

Security

Topic URL
Secure Content Understanding with keys and identities https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/secure-communications

Configuration

Topic URL
Configure Content Understanding analyzers and parameters https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/analyzer-reference
Use and customize Content Understanding prebuilt analyzers https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/prebuilt-analyzers
Configure document layout analysis with Content Understanding https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/document/elements
Configure face detection and recognition in Content Understanding https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/face/overview
Configure classification and routing in Content Understanding Studio https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/how-to/classification-content-understanding-studio
Configure Standard and Pro tasks in Foundry classic https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/how-to/content-understanding-foundry-classic
Build and refine custom analyzers in Content Understanding Studio https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/how-to/customize-analyzer-content-understanding-studio

Integrations & Coding Patterns

Topic URL
Content Moderator REST API operations reference https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/api-reference
Integrate Content Moderator via .NET client library https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/client-libraries
Call Content Moderator image moderation APIs https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/image-moderation-api
Call Content Moderator REST APIs from C# samples https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/samples-rest
Use .NET SDK term lists with Content Moderator https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/term-lists-quickstart-dotnet
Use Content Moderator text moderation APIs https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/text-moderation-api
Moderate video content using Content Moderator .NET SDK https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/video-moderation-api
Consume Content Understanding document Markdown output https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/document/markdown
Call Content Understanding REST API for multimodal data https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/quickstart/use-rest-api
Create custom Content Understanding analyzers via REST API https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/tutorial/create-custom-analyzer
Extract structured audiovisual content with Content Understanding https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/video/elements
Use audiovisual Markdown output from Content Understanding https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/video/markdown

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