Catalog
MicrosoftDocs/azure-fluid-relay

MicrosoftDocs

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 other Azure Fluid Relay related development tasks. Not for Azure Web PubSub (use azure-web-pubsub), Azure SignalR Service (use azure-signalr-service), Azure Relay (use azure-relay), Azure Service Bus (use azure-service-bus).

v1.0Latest
New~1.5kUpdated Jun 26, 2026

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

Category Lines Description
Troubleshooting L35-L39 Recovering from corrupted Azure Fluid Relay container data, including detection, mitigation steps, and restoring or reconstructing data to resume collaboration.
Best Practices L40-L44 Guidance on integrating Azure Fluid Relay with test automation frameworks, setting up automated tests, and validating Fluid collaboration scenarios in CI/CD workflows.
Limits & Quotas L45-L49 Details on Azure Fluid Relay capacity limits, throttling behavior, quotas per tenant/container, and guidance to avoid or handle rate limiting and overuse scenarios.
Security L50-L60 Securing Fluid Relay apps: auth/JWT design, token providers, key rotation, CMK and data encryption, and validating container creator identity.
Configuration L61-L66 Configuring compatible Fluid Framework client/server versions with Azure Fluid Relay and deleting Fluid Relay containers via Azure CLI.
Integrations & Coding Patterns L67-L73 Building 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
Deployment L74-L77 Guidance 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

Topic URL
Recover corrupted Azure Fluid Relay container data https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/container-recovery

Best Practices

Topic URL
Use test automation frameworks with Azure Fluid Relay https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/test-automation

Limits & Quotas

Topic URL
Review Azure Fluid Relay service limits and throttling https://learn.microsoft.com/en-us/azure/azure-fluid-relay/reference/service-limits

Security

Topic URL
Implement authentication and authorization for Fluid Relay apps https://learn.microsoft.com/en-us/azure/azure-fluid-relay/concepts/authentication-authorization
Use customer-managed keys with Azure Fluid Relay https://learn.microsoft.com/en-us/azure/azure-fluid-relay/concepts/customer-managed-keys
Configure data encryption for Azure Fluid Relay https://learn.microsoft.com/en-us/azure/azure-fluid-relay/concepts/data-encryption
Implement a secure TokenProvider with Azure Functions for Fluid Relay https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/azure-function-token-provider
Understand and configure Azure Fluid Relay JWT token contract https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/fluid-json-web-token
Rotate Azure Fluid Relay tenant access keys securely https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/rotate-fluid-relay-access-keys
Validate container creator identity in Azure Fluid Relay https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/validate-document-creator

Configuration

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

Integrations & Coding Patterns

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

Deployment

Topic URL
Deploy Fluid applications to Azure Static Web Apps https://learn.microsoft.com/en-us/azure/azure-fluid-relay/how-tos/deploy-fluid-static-web-apps
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

82/100

Grade

B

Good

Safety

88

Quality

78

Clarity

85

Completeness

72

Summary

This skill provides expert guidance for Azure Fluid Relay development by combining quick-reference documentation with remote documentation fetching capabilities. It covers troubleshooting, best practices, security, configuration, integrations, and deployment patterns, and explicitly directs agents to use MCP tools (mcp_microsoftdocs or fetch_webpage) to retrieve detailed content from Microsoft Learn.

Detected Capabilities

network request (fetch documentation via mcp_microsoftdocs or fetch_webpage)read reference filesreference external Microsoft Learn documentationstructured knowledge retrieval

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

azure fluid relay developmentfluid relay authentication setupfluid relay deploymentazure collaborative appscontainer recovery fluidfluid relay testingazure static web apps deployment

Risk Signals

INFO

Network-based documentation fetching via mcp_microsoftdocs or fetch_webpage

Lines 24-29, compatibility section
INFO

References external Microsoft Learn domains without data transmission or code execution

Referenced URLs in category sections
INFO

No file writes, shell execution, or credential access detected

Entire skill content

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Diagnose and recover corrupted Azure Fluid Relay containers
  • Set up test automation frameworks with Azure Fluid Relay
  • Implement authentication, JWT tokens, and key rotation for Fluid Relay apps
  • Configure version compatibility between Fluid Framework and Azure Fluid Relay
  • Connect applications using AzureClient and configure local development mode
  • Deploy collaborative Fluid apps to Azure Static Web Apps
  • Implement secure TokenProviders using Azure Functions

Quality Notes

  • Clear scope: focused exclusively on Azure Fluid Relay (explicitly excludes Web PubSub, SignalR, Azure Relay, Service Bus)
  • Well-structured category index with line ranges and descriptions enabling efficient lookup
  • Provides fallback tool recommendation (fetch_webpage) if mcp_microsoftdocs is unavailable
  • Includes staleness check: agents prompted to pull latest version if metadata >3 months old
  • Network requirement explicitly documented upfront in compatibility section
  • Comprehensive reference table with 13 distinct documentation topics across 7 categories
  • Structured instructions for agents on using Category Index and handling missing tools
  • Minor: some line range references (e.g., L35-L39) point to content not included in skill body—agents must fetch via network tools
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use MicrosoftDocs/azure-fluid-relay in your dev environment

Command Palette

Search for a command to run...