Expert knowledge for Azure Durable Task development including best practices, decision making, architecture & design patterns, limits & quotas, configuration, integrations & coding patterns, and deployment. Use when building Durable orchestrations with Azure Storage/SQL/Netherite, versioning deployments, or using instance APIs, and other Azure Durable Task related development tasks. Not for Azure Functions (use azure-functions), Azure Logic Apps (use azure-logic-apps), Azure App Service (use azure-app-service), Azure Service Fabric (use azure-service-fabric).
This skill provides expert guidance for Azure Durable Task. Covers best practices, decision making, architecture & design patterns, limits & quotas, 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
Best Practices
L35-L41
Guidance on writing reliable orchestrator code, handling failures and retries, and designing singleton orchestrations in Azure Durable Task/Functions.
Decision Making
L42-L47
Guidance on choosing Durable Functions vs. raw Durable Task hosting and comparing storage providers/backends (e.g., Azure Storage, SQL, Netherite) for durability, scale, and reliability.
Architecture & Design Patterns
L48-L57
Patterns for orchestrating complex workflows in Durable Task: long-running/eternal orchestrations, external events, fan-out/fan-in, human approvals, monitoring loops, and function chaining.
Limits & Quotas
L58-L63
Configuring limits for custom orchestration status data, querying status payloads, and monitoring Durable Task Scheduler action metrics, usage, and billing.
Configuration
L64-L68
Configuring Durable Task hubs storage (connection, scaling, reliability) and using instance management APIs to query, control, and manage orchestration instances.
Integrations & Coding Patterns
L69-L73
Managing Durable orchestration instances: starting, querying, terminating, purging, and using instance management APIs for lifecycle control and monitoring.
Deployment
L74-L77
Guidance on safely deploying Durable orchestrations using versioning, handling breaking changes, and managing upgrades without disrupting running workflows.
Best Practices
Topic
URL
Apply orchestrator code constraints in Durable Task
