Skip to content
azure-fluid-relay logo

azure-fluid-relay

Expert knowledge for Azure Fluid Relay development including troubleshooting, best practices, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using AzureClient, audience APIs, JWT auth tokens, container recovery, or Static Web Apps hosting, and o...

MicrosoftDocs/Agent-Skills0installs770stars

SKILL.md

Full skill instructions

Azure Fluid Relay Skill

This skill provides expert guidance for Azure Fluid Relay. Covers troubleshooting, best practices, 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

CategoryLinesDescription
TroubleshootingL35-L39Recovering from corrupted Azure Fluid Relay container data, including detection, mitigation steps, and restoring or reconstructing data to resume collaboration.
Best PracticesL40-L44Guidance on integrating Azure Fluid Relay with test automation frameworks, setting up automated tests, and validating Fluid collaboration scenarios in CI/​CD workflows.
Limits & QuotasL45-L49Details on Azure Fluid Relay capacity limits, throttling behavior, quotas per tenant/​container, and guidance to avoid or handle rate limiting and overuse scenarios.
SecurityL50-L60Securing Fluid Relay apps: auth/​JWT design, token providers, key rotation, CMK and data encryption, and validating container creator identity.
ConfigurationL61-L66Configuring compatible Fluid Framework client/​server versions with Azure Fluid Relay and deleting Fluid Relay containers via Azure CLI.
Integrations & Coding PatternsL67-L73Building Fluid apps with AzureClient: connecting to Azure Fluid Relay, configuring local dev/​test mode, and using audience APIs with React for presence and user management
DeploymentL74-L77Guidance for deploying Fluid Framework apps with Azure Fluid Relay to Azure Static Web Apps, including setup, configuration, and integration steps for hosting collaborative apps.

Troubleshooting

TopicURL
Recover corrupted Azure Fluid Relay container datahttps://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/container-recovery

Best Practices

TopicURL
Use test automation frameworks with Azure Fluid Relayhttps://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/test-automation

Limits & Quotas

TopicURL
Review Azure Fluid Relay service limits and throttlinghttps://learn.microsoft.com/en-us/azure/azure-fluid-relay/reference/service-limits

Security

Configuration

TopicURL
Configure Fluid Framework versions compatible with Azure Fluid Relayhttps://learn.microsoft.com/en-us/azure/azure-fluid-relay/concepts/version-compatibility
Delete Azure Fluid Relay containers using Azure CLIhttps://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/container-deletion

Integrations & Coding Patterns

TopicURL
Connect applications to Azure Fluid Relay using AzureClienthttps://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/connect-fluid-azure-service
Configure AzureClient local mode for Fluid app testinghttps://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/local-mode-with-azure-client
Use Fluid Framework audience features with React and AzureClienthttps://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/use-audience-in-fluid

Deployment