azure-language-service について
azure-language-service は Azure AI Language 向けのエージェント用ガイダンススキルです。設計、開発、デプロイ、トラブルシューティングを、ローカルの参照情報とリモート文書取得で支援します。
主な機能
- 01Azure Language のトラブルシューティング
- 02設計とベストプラクティスの参照
- 03制限、クォータ、セキュリティ情報
- 04構成、連携、コーディングパターン
- 05デプロイと移行のガイダンス
活用シーン
- 01カスタム NER や CQA の問題を診断
- 02CLU または CQA の構成を計画
- 03Azure Language のセキュリティ設定を確認
- 04API と SDK の利用方法を参照
MCP 対応
mcp_microsoftdocs:microsoft_docs_fetch でリモート文書を取得でき、代替手段として fetch_webpage も利用できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-language-serviceインストール後、Claude Code で/azure-language-serviceを入力して読み込まれたか確認します。
詳細
Azure AI Language スキル
このスキルでは、Azure AI Language に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイを扱います。ローカルのクイックリファレンスコンテンツと、ドキュメントを取得するリモート機能を組み合わせています。
このスキルの使い方
IMPORTANT for Agent:関連するセクションを探すには、以下のカテゴリインデックスを使用してください。行範囲が記載されているカテゴリ(例:
L35-L120)では、指定した行をread_fileで読み取ってください。ファイルへのリンクが記載されているカテゴリ(例:[security.md](security.md))では、リンク先の参照ファイルをread_fileで読み取ってください。
IMPORTANT for Agent:
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-L42 | Azure Language のカスタム NER と会話形式の質問応答(CQA)に関する一般的な問題の診断と解決方法です。モデルエラー、構成の問題、トラブルシューティングのワークフローを含みます。 |
| ベストプラクティス | L43-L53 | CLU、カスタム NER、PII、CQA プロジェクトの設計と作成に関するベストプラクティスです。データ準備、スキーマ、ライフサイクル、雑談用ペルソナ、ドキュメントの書式設定を含みます。 |
| 意思決定 | L54-L63 | リージョンとアプリの種類の選択、CQA ソリューションの計画、LUIS、QnA Maker、Text Analytics、Language Studio から Azure Language/Fountry への移行の判断や実行に関するガイドです。 |
| アーキテクチャと設計パターン | L64-L71 | Azure AI Language の CLU、カスタム NER、カスタムテキスト分類、オーケストレーションワークフローモデルにおけるリージョンフェールオーバーと高可用性パターンの設計と実装について説明します。 |
| 制限とクォータ | L72-L95 | CLU、NER、テキスト分類、CQA、health など、Azure Language の各機能に関する制限、クォータ、言語、モデルのライフサイクルを扱います。データサイズ、レート、スループット、コンテナーの制約を含みます。 |
| セキュリティ | L96-L107 | Azure Language と CQA のセキュリティ保護について説明します。保存データの暗号化(CMK を含む)、RBAC、マネージド ID、SAS トークン、ネットワーク分離/Private Link、安全なデプロイとデータアクセスの構成を含みます。 |
| 構成 | L108-L124 | Azure AI Language の各機能の構成方法を説明します。CLU のファインチューニング、コンテナー、カスタム/health NER、オーケストレーションの None インテント、CQA のスコアリング/テレメトリ、FHIR 出力、関連するプロジェクト/スキル設定を含みます。 |
| 統合とコーディングパターン | L125-L144 | NER、エンティティのリンク、キー フレーズ、言語検出、感情分析、PII の編集、リレーション、オーケストレーションワークフローで Azure Language/TA/health/CLU/CQA の API と SDK を呼び出す方法を説明します。 |
| デプロイ | L145-L155 | カスタム言語/NER/CQA/感情分析/health モデルをリージョン間や Docker コンテナーを使用したオンプレミス環境にデプロイして実行する方法と、環境間でプロジェクトを移動する方法を説明します。 |
トラブルシューティング
| トピック | URL |
|---|---|
| Azure Language のカスタム NER に関する一般的な問題を解決する | https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/faq |
| CQA に関する一般的な問題とエラーのトラブルシューティング | https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/how-to/troubleshooting |
ベストプラクティス
意思決定
| トピック | URL |
|---|---|
| Language サービスの機能に使用する Azure リージョンを選択する | https://learn.microsoft.com/en-us/azure/ai-services/language-service/concepts/regional-support |
| CLU アプリとオーケストレーションワークフローのどちらを使用するか選択する | https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/concepts/app-architecture |
| Azure Language Studio プロジェクトを Microsoft Foundry に移行する | https://learn.microsoft.com/en-us/azure/ai-services/language-service/migration-studio-to-foundry |
| CQA アプリを計画し、Azure リソースを選択する | https://learn.microsoft.com/en-us/azure/ai-services/language-service/question-answering/concepts/plan |
| LUIS と QnA Maker から Azure Language への移行を判断する | https://learn.microsoft.com/en-us/azure/ai-services/language-service/reference/migrate |
| Text Analytics アプリを Azure Language API に移行する | https://learn.microsoft.com/en-us/azure/ai-services/language-service/reference/migrate-language-service-latest |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| CLU モデルのリージョン フェールオーバーを設計する | https://learn.microsoft.com/en-us/azure/ai-services/language-service/conversational-language-understanding/how-to/fail-over |
| カスタム NER モデルのリージョン フェールオーバーを設計する | https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-named-entity-recognition/fail-over |
| カスタム テキスト分類のリージョン フェールオーバーを設計する | https://learn.microsoft.com/en-us/azure/ai-services/language-service/custom-text-classification/fail-over |
| オーケストレーションワークフロー モデルのリージョン フェールオーバーを実装する | https://learn.microsoft.com/en-us/azure/ai-services/language-service/orchestration-workflow/concepts/fail-over |