azure-web-pubsub について
Azure Web PubSub Skillは、Azure Web PubSubを扱うエージェント向けのガイドです。ローカルのクイックリファレンスとリモート文書を組み合わせ、トラブルシューティング、設計、セキュリティ、開発統合を扱います。
主な機能
- 01サービスとイベントハンドラーのトラブルシューティング
- 02信頼性の高いWebSocketクライアントの指針
- 03アーキテクチャ、容量、コストの参照情報
- 04IDとネットワークのセキュリティガイド
- 05SDK、REST、MQTT、Socket.IOの統合
活用シーン
- 01サービスやイベントハンドラーの問題を調査
- 02マルチリージョンやプロトコル間連携を設計
- 03認証、権限、ネットワークアクセスを計画
- 04SDKまたはRESTを選び、クライアントを統合
MCP 対応
mcp_microsoftdocs:microsoft_docs_fetchで文書を取得でき、代替手段としてfetch_webpageも利用できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-web-pubsubインストール後、Claude Code で/azure-web-pubsubを入力して読み込まれたか確認します。
詳細
Azure Web PubSub スキル
このスキルでは、Azure Web PubSub に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイを扱います。ローカルのクイックリファレンスコンテンツと、リモートでドキュメントを取得する機能を組み合わせています。
このスキルの使用方法
エージェント向けの重要事項:関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行範囲が指定されているカテゴリ(例:
L35-L120)では、指定された行をread_fileで読み取ってください。ファイルへのリンクがあるカテゴリ(例:[security.md](security.md))では、リンク先の参照ファイルに対してread_fileを使用してください。
エージェント向けの重要事項:
metadata.generated_atが 3 か月以上前の場合は、リポジトリから最新バージョンを取得するようユーザーに提案してください。mcp_microsoftdocsツールを利用できない場合は、インストールするようユーザーに提案してください:インストールガイド
このスキルでは、ドキュメントの取得にネットワークアクセスが必要です:
- 推奨:クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用します。Markdown が返されます。 - 代替手段:クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用します。Markdown が返されます。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L37-L47 | Web PubSub のエラー、イベントハンドラーやデバッグの問題、サービスと Socket.IO の問題の診断と修正、リソースログや診断ログ、エラーコードを使ったトラブルシューティング。 |
| ベストプラクティス | L48-L52 | Azure Web PubSub 向けの堅牢な WebSocket クライアントの構築に関するガイダンス。再接続戦略、切断への対処、エラー処理、接続ライフサイクルのベストプラクティスを含みます。 |
| 意思決定 | L53-L59 | チャット SDK と REST の選択、シナリオに適した Web PubSub 機能の選択、料金、課金メーター、コストへの影響の理解に関するガイダンス。 |
| アーキテクチャと設計パターン | L60-L66 | Web PubSub のアーキテクチャパターン:マルチリージョンの耐障害性、MQTT と WebSocket/Web PubSub のブリッジ、統合設計に向けた Socket.IO サポートの内部動作の理解。 |
| 制限とクォータ | L67-L72 | Web PubSub の容量とパフォーマンスの制限(接続、メッセージ、スケーリング)、および Socket.IO サーバー API のうち、サポートされないものや動作が異なるもの。 |
| セキュリティ | L73-L101 | Azure Web PubSub のセキュリティ保護:クライアントとアプリの認証/認可(キー、Entra ID、ID、ロール)、mTLS、ネットワーク/プライベートエンドポイント、ファイアウォール、送信の制限、Azure Policy によるコンプライアンス。 |
| 構成 | L102-L117 | Web PubSub のランタイム構成:ストレージ/チャットのセットアップ、メトリック/ログとアラート、監視、カスタムドメイン、イベントルーティング、地理レプリケーション、ローカルトンネリング、MQTT/Socket.IO オプション、管理 UI。 |
| 統合とコーディングパターン | L118-L150 | Azure Web PubSub 向けのクライアントとサーバーの統合パターン:SDK/REST の使用、WebSocket/MQTT、JSON/protobuf サブプロトコル、認証、イベント(HTTP/AMQP/Functions)、Socket.IO の統合。 |
| デプロイ | L151-L156 | Web PubSub のリージョン間移行、Premium 自動スケーリングの構成、Socket.IO アプリとサーバーレスチャットの Azure Web PubSub へのデプロイおよび移行に関するガイド。 |
トラブルシューティング
| トピック | URL |
|---|---|
| Azure Web PubSub のチャットエラーコードを解釈する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/chat-reference-errors |
| Azure Web PubSub のイベントハンドラーをローカルでデバッグする | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-local-debug-event-handler |
| Azure Web PubSub の一般的な問題をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-troubleshoot-common-issues |
| トラブルシューティングに Web PubSub リソースログを使用する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-troubleshoot-resource-logs |
| Azure Web PubSub サービスの一般的な問題を解決する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/resource-faq |
| Web PubSub for Socket.IO の一般的な問題をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-troubleshoot-common-issues |
| Web PubSub Socket.IO の診断ログを収集する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-troubleshoot-logging |
ベストプラクティス
| トピック | URL |
|---|---|
| Azure Web PubSub 向けに信頼性の高い WebSocket クライアントを設計する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-develop-reliable-clients |
意思決定
| トピック | URL |
|---|---|
| Azure Web PubSub Chat SDK または REST API を選択する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/chat-reference-sdk-and-rest |
| 適切な Azure Web PubSub の機能を選択する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/choose-web-pubsub-capability |
| Azure Web PubSub の課金モデルを理解する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/concept-billing-model |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| 回復性の高いマルチリージョン Azure Web PubSub を設計する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/concept-disaster-recovery |
| MQTT と Web PubSub 間のクロスプロトコル通信 | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/reference-mqtt-cross-protocol-communication |
| Web PubSub for Socket.IO サポートの内部設計 | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-service-internal |
制限とクォータ
| トピック | URL |
|---|---|
| Web PubSub のパフォーマンスと容量を計画する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/concept-performance |
| Web PubSub でサポートされていない Socket.IO サーバー API | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-supported-server-apis |
セキュリティ
構成
統合とコーディングパターン
デプロイ
| トピック | URL |
|---|---|
| Azure Web PubSub リソースをリージョン間で移動する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-move-across-regions |
| Azure Web PubSub Premium の自動スケールを構成する | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-scale-autoscale |
| Azure Functions を使用して Socket.IO Serverless チャットをデプロイする | https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socket-io-serverless-quickstart |