azure-microsoft-discovery

name	azure-microsoft-discovery
description	Expert knowledge for Azure Microsoft Discovery development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Discovery Engine shared sessions, supercomputer jobs, REST job APIs, custom tools, or ACR deployments, and other Azure Microsoft Discovery related development tasks.
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-09","generator":"docs2skills/1.0.0"}

Azure Microsoft Discovery Skill

This skill provides expert guidance for Azure Microsoft Discovery. 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 resolving Microsoft Discovery Engine task failures, and locating/using correlation IDs from Activity Logs to debug and trace issues.
Best Practices	L43-L50	Best practices for structuring projects and shared sessions, applying responsible AI, calibrating trust and safety patterns, and planning tool capabilities and compute for Discovery.
Decision Making	L51-L58	Guidance on selecting ACR setup, agent types, pricing/billing, and suitable AI models to design and configure Microsoft Discovery agents effectively.
Architecture & Design Patterns	L59-L63	Designing and implementing advanced shared session patterns in Discovery Engine, including multi-user session management, data sharing, and scalable architecture best practices.
Limits & Quotas	L64-L69	Planning capacity and Azure quotas for Microsoft Discovery deployments, plus required naming conventions and rules for Discovery resources.
Security	L70-L84	Security, encryption, RBAC, managed identities, private networking, supercomputer network hardening, and audit logging for protecting Microsoft Discovery resources.
Configuration	L85-L105	Configuring Discovery workspaces, supercomputers, storage, tools, data handling, and querying operational/indexing logs via Log Analytics, Kusto, and Azure activity logs
Integrations & Coding Patterns	L106-L113	Integrating custom tools/models into Discovery workflows, containerizing them with Docker, calling Discovery Supercomputer REST job APIs, and writing action scripts for action-based tools.
Deployment	L114-L120	Deploying Discovery infrastructure and tools: network-hardened stacks, Bicep-based deployments, REST provisioning of supercomputer resources, and publishing tool images to Azure Container Registry.

Troubleshooting

Topic	URL
Troubleshoot Discovery Engine task execution issues	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-debug-task-execution
Find Microsoft Discovery correlation IDs in Activity Log	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-get-correlation-id

Best Practices

Topic	URL
Apply projects and shared session best practices in Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-projects-investigations
Apply responsible AI practices in Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-responsible-ai
Calibrate trust and basic shared session patterns in Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-trust-basic-investigation-patterns
Plan tool functionality and compute for Discovery tools	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-plan-tool-requirements

Decision Making

Topic	URL
Choose and configure Azure Container Registry for Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-azure-container-registry
Choose the right Microsoft Discovery agent type	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-discovery-agent-types
Understand Microsoft Discovery billing and charges	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-discovery-billing
Choose appropriate models for Microsoft Discovery agents	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-select-models-for-agents

Architecture & Design Patterns

Topic	URL
Apply advanced shared session patterns with Discovery Engine	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-advanced-investigation-patterns

Limits & Quotas

Topic	URL
Plan Azure quotas and capacity for Microsoft Discovery deployments	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-quota-reservation
Apply Microsoft Discovery resource naming rules	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-resource-naming

Security

Topic	URL
Understand Microsoft Discovery code of conduct and acceptable use	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-code-of-conduct
Manage data encryption at rest in Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-data-encryption-at-rest
Configure managed identities for Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-managed-identities
Configure network security for Microsoft Discovery workspaces	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-network-security
Configure RBAC role assignments for Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-role-assignments
Assign Microsoft Discovery persona RBAC roles via PowerShell	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-assign-persona-roles
Configure user-assigned managed identities for Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-configure-managed-identity
Configure network security and private access for Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-configure-network-security
Secure networking for Discovery Supercomputer	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-configure-supercomputer-network-security
Enable and export audit logs for Discovery resources	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-enable-audit-logging

Configuration

Topic	URL
Manage files and storage assets in Microsoft Discovery shared sessions	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-files-storage-assets
Register Microsoft Discovery resource provider in Azure	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-resource-provider-registration
Configure Azure Blob Storage for Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-storage-account
Configure storage containers and assets for Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-storage-containers-assets
Access Log Analytics workspaces for Discovery resources	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-access-resource-logs
Author tool definition YAML for Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-create-tool-definition
Configure data handling for tools and agents in Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-data-handling-with-tools-agents
Configure Bookshelf and index knowledgebases in Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-index-bookshelf-knowledgebase
Configure storage containers and assets in Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-manage-storage-containers
Create and manage Discovery Supercomputers and node pools	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-manage-supercomputers

Integrations & Coding Patterns

Topic	URL
Integrate tools and models into Microsoft Discovery workflows	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-tools-model-integration
Create Dockerfiles to containerize Discovery tools	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-create-tool-docker-file
Use Discovery Supercomputer REST APIs for jobs	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-run-jobs-supercomputer-rest-api
Implement action scripts for Discovery action-based tools	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-write-tool-action-scripts

Deployment

Topic	URL
Deploy a fully network-hardened Microsoft Discovery stack	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-deploy-network-hardened-stack
Deploy and register tools to Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-deploy-tool-to-discovery
Provision Discovery Supercomputer infrastructure via REST API	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-manage-supercomputers-rest-api
Publish Discovery tool images to Azure Container Registry	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-publish-tool-to-acr