azure-microsoft-discovery

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-L45	Diagnosing and fixing Microsoft Discovery deployment/runtime failures, task execution issues, known bugs, and specific error codes using logs and correlation IDs.
Best Practices	L46-L52	Guidance on structuring projects and shared sessions, calibrating trust levels, and applying responsible AI and safety practices when building with Microsoft Discovery.
Decision Making	L53-L60	Guidance on selecting agent types, models, container registries, and understanding billing so you can design, size, and cost-optimize Microsoft Discovery solutions.
Architecture & Design Patterns	L61-L65	Designing and implementing advanced shared session patterns in Discovery Engine, including multi-user session management, data sharing, and scalable architecture best practices.
Limits & Quotas	L66-L71	Planning capacity and quota limits for Microsoft Discovery deployments, plus required naming conventions and patterns for Discovery resources in Azure.
Security	L72-L93	Security, encryption, RBAC, managed identities, network hardening, audit logging, and compliance mappings for securing Microsoft Discovery deployments and supercomputers.
Configuration	L94-L111	Configuring Discovery resources: storage, files, tools, data handling, Bookshelf/indexes, and querying logs (Kusto, Log Analytics, activity) for monitoring and troubleshooting
Integrations & Coding Patterns	L112-L122	Integrating Discovery tools/models into workflows, containerizing with Docker, running jobs via REST, and using .NET, Java, and JavaScript SDKs and action scripts.
Deployment	L123-L129	Deploying and upgrading Discovery Supercomputer on AKS, provisioning its infrastructure via REST, publishing Discovery tool images to ACR, and deploying across multiple Azure regions.

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
Work around known issues in Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/known-issues
Troubleshoot Microsoft Discovery deployment and runtime issues	https://learn.microsoft.com/en-us/azure/microsoft-discovery/troubleshoot-microsoft-discovery
Resolve Microsoft Discovery error codes and messages	https://learn.microsoft.com/en-us/azure/microsoft-discovery/troubleshooting-error-code

Best Practices

Topic	URL
Apply project and shared session practices in 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

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
Select appropriate models for 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 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
Map compliance controls for Microsoft Discovery deployments	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-compliance-framework-mappings
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
Design project-level RBAC boundaries in Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-project-rbac
Configure Microsoft Discovery RBAC roles and scopes	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-role-assignments
Evaluate security and compliance posture of Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-security-overview
Answer SIG-based security and compliance questions for Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/faq-security-compliance-sig
Assign Microsoft Discovery persona roles via PowerShell	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-assign-persona-roles
Configure managed identities and roles for Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-configure-managed-identity
Configure network security for Microsoft Discovery workspaces	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-configure-network-security
Configure project-level access and least privilege	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-configure-project-rbac
Secure networking configuration for Discovery Supercomputers	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-configure-supercomputer-network-security
Deploy a fully network-hardened Microsoft Discovery stack	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-deploy-network-hardened-stack
Enable and export audit logs for Discovery resources	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-enable-audit-logging
Plan NSG rules for Discovery supercomputers	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-plan-supercomputer-network-security-groups
Configure customer-managed keys for Discovery resources	https://learn.microsoft.com/en-us/azure/microsoft-discovery/howto-data-encryption-at-rest

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 Discovery tools	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 storage containers and assets in Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-manage-storage-containers
Query bookshelf indexing logs in Discovery supercomputers	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-bookshelf-indexing-logs
Query bookshelf knowledgebase query logs in Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-bookshelf-logs
Query CogLoop orchestration logs for Discovery investigations	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-cognitive-loop-logs
Query supercomputer platform and tool logs in Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-supercomputer-logs
Query Discovery workspace logs with Kusto and correlation IDs	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-workspace-logs
View Azure activity logs for Discovery control plane	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-view-activity-logs

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 job runs	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
Use .NET SDK packages for Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/reference-dotnet-sdks
Use Java SDK artifacts for Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/reference-java-sdks
Use JavaScript SDK packages for Microsoft Discovery	https://learn.microsoft.com/en-us/azure/microsoft-discovery/reference-javascript-sdks

Deployment

Topic	URL
Understand AKS upgrade behavior for Discovery Supercomputer	https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-supercomputer-aks-upgrades
Deploy Microsoft Discovery across Azure regions	https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-deploy-across-regions
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