/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 designing shared sessions, RBAC/managed identity, supercomputer jobs, Bookshelf KBs, or Docker/SDK integrations, 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-11-08"
  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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

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-L48 | Diagnosing and fixing Discovery engine, onboarding, deployment/runtime failures, using logs/correlation IDs, CogLoop/bookshelf query debugging, and known error codes/issues. | | Best Practices | L49-L54 | Guidance on responsible AI usage in Microsoft Discovery and rules for naming Discovery resources consistently and correctly. | | Decision Making | L55-L63 | Guidance on planning Discovery deployments: choosing architectures, agent types, network modes/routing, fixed settings, and selecting suitable models for different use cases. | | Architecture & Design Patterns | L64-L69 | Designing shared session architectures in Discovery Engine, including trust models, basic vs advanced patterns, and how to structure multi-user or multi-app session data. | | Limits & Quotas | L70-L74 | Managing Discovery deployment quotas and capacity reservations, including limits, scaling behavior, and how to plan or adjust resources for different workloads. | | Security | L75-L97 | Security, compliance, and access control for Discovery: RBAC design, managed identities, encryption/CMK, network/NSG/UDR setup, STRIDE threat mapping, audit logs, and SIG/security questionnaire support. | | Configuration | L98-L118 | Configuring Discovery infrastructure: storage, registries, workspaces, supercomputers, data handling, onboarding/DryRun, and querying logs/reports for tools and Bookshelf knowledge bases. | | Integrations & Coding Patterns | L119-L130 | Integrating Discovery tools/models into workflows, containerizing with Docker, using REST APIs for Supercomputers/jobs, and coding with .NET, Java, and JavaScript SDKs. | | Deployment | L131-L139 | Guides for deploying Discovery on Azure: landing zone prep, multi-region and hardened setups, AKS upgrade behavior, onboarding tooling, and publishing container images to ACR. |

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 | | Diagnose bookshelf knowledgebase queries via logs | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-bookshelf-logs | | Investigate Microsoft Discovery CogLoop orchestration logs | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-query-cognitive-loop-logs | | Work around known issues in Microsoft Discovery | https://learn.microsoft.com/en-us/azure/microsoft-discovery/known-issues | | Resolve Microsoft Discovery onboarding tool failures | https://learn.microsoft.com/en-us/azure/microsoft-discovery/troubleshoot-deployment-tool | | Troubleshoot Microsoft Discovery deployment and runtime issues | https://learn.microsoft.com/en-us/azure/microsoft-discovery/troubleshoot-microsoft-discovery | | Interpret Microsoft Discovery error codes and fixes | https://learn.microsoft.com/en-us/azure/microsoft-discovery/troubleshooting-error-code |

Best Practices

| Topic | URL | |-------|-----| | Apply responsible AI practices in Microsoft Discovery | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-responsible-ai | | Apply naming rules for Microsoft Discovery resources | https://learn.microsoft.com/en-us/azure/microsoft-discovery/reference-resource-naming |

Decision Making

| Topic | URL | |-------|-----| | Choose Microsoft Discovery architecture and fixed settings | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-deployment-decisions | | Plan Microsoft Discovery deployment paths and prerequisites | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-deployment-planning | | Choose the right Microsoft Discovery agent type | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-discovery-agent-t