azure-ai

Azure の AI サービスのうち、どれを使えばいいか決めたいときです。

振り分けるサービス

4 つ

SKILL.md の本文（2026-10-09 確認）

3,394 バイト

同梱ファイル（SDK の手引き 14 件と認証の手引き 1 件）

15 件

4 つのサービスの振り分け表から始まる

本文は 4 つのサービスの振り分け表から始まります。

4 サービスを均等には扱っていない

表の右 2 列が埋まっていないことに注目してください。 OpenAI に MCP の道具は無く、Document Intelligence には MCP も CLI も割り当てられていません。

つまりこのスキルは 4 サービスを均等には扱っていません。検索と音声は手順まで、OpenAI と文書解析は SDK の参照だけです。

検索の 3 つの方式と AI での付加を分けている

AI Search の能力が 4 行の表で整理されています（検索の方式 3 つと、AI での付加）。ここが一番厚い部分です。

• 全文検索言語解析と語幹処理
• ベクトル検索埋め込みによる意味の近さ
• 混合検索キーワードとベクトルの組み合わせ
• AI での付加固有表現の抽出、OCR、感情

「検索」と一括りにせず 3 方式に分けているのが実用的です。ベクトル検索だけで組むと固有名詞や型番に弱くなり、全文検索だけだと言い換えに当たりません。混合はその両方を埋める形です。

音声側も分かれている

音声側も同様に分かれています。逐次と一括の書き起こし、SSML 対応の合成、話者の識別、用語に合わせた独自モデル。

本体は振り分けで、手順は同梱に分かれている

本文は 3,394 バイトしかありません（2026-10-09 確認）。中身は表と参照リンクで、実装の手順はほとんど入っていません。

SDK の手引きが同梱されています。検索・OpenAI・Vision・書き起こし・翻訳・文書解析・Content Safety について、Python / TypeScript / .NET / Java の要約された手引きが 14 件用意されています。残りの 1 件は認証の手引きで、同梱ファイルは計 15 件です。

この作りは文脈の消費に優しい側です。必要な言語の手引きだけが読まれます（スキルを入れすぎて重くなる仕組み）。

MCP が無い場合の逃げ道が書いてある

本文に「Azure の MCP が有効でない場合は、Copilot CLI や Claude Code なら利用者に /mcp から有効にしてもらい、ほかの実行環境ではその環境の MCP の設定から有効にしてもらえ」と明記されています。

同じ公開元のスキル群の中では、MCP を前提にしつつ代替の経路も並記している側です。

Azure の MCP への態度は同じ公開元の中でも揃っていないので、用途ごとに判断してください。整理は Azure を任せる 28 件の地図にあります。

配布元の一覧の説明文が実態とずれています

同梱の SDK の手引きは Python と TypeScript が中心で、Java があるのは Vision と Content Safety の 2 つだけです。Java 専用ではありません。

同じ公開元の azure-cloud-migrate でも同種の食い違いが起きています。一覧の説明文で選ばないでください。

• リソースを作る用途構築は azure-prepare の担当
• エージェントそのものを作りたいときmicrosoft-foundry の側で、モデルの選定から評価までを扱う
• 複数の AI の口をまとめて統制したいとき利用量の制限や課金の按分は azure-aigateway の担当
• OpenAI のモデル運用配備やクォータの引き上げなら azure-quotas
• Azure 以外のサービス手引きも道具も Azure 固有

リソースを作る用途には向かない

このスキルは選び方と使い方の参照で、構築は azure-prepare の担当です。

エージェントそのものを作りたいなら別物

そちらは microsoft-foundry の側で、モデルの選定から評価までを扱います。

複数の AI の口をまとめて統制したいなら別物

利用量の制限や課金の按分は azure-aigateway の担当で、あちらは API Management を使います。

OpenAI のモデル運用は薄い

表の MCP 欄が空で、割り当てられているのは az cognitiveservices だけです。配備やクォータの引き上げを扱いたいなら、同じ公開元の azure-quotas のほうが該当します。

Azure 以外のサービスには使えない

手引きも道具も Azure 固有です。

解析では見つからないが、実際には Azure の API を呼ぶ

SKILL.md の解析では、外部通信・シェル実行・ファイル書き換えの記述は見つかっていません。同梱ファイルは 15 件で、実行可能なスクリプトは含まれていません（2026-10-09 確認）。

ただし実際には Azure の API を呼びます。検索の実行も書き起こしも、課金の対象です。解析が拾っていないのは、それらが表と参照リンクで書かれているためです（スキルを入れる前に確認すること）。

費用が発生する

索引に入れたデータは外に出る

ベクトル検索を組むと、対象の文書は埋め込みに変換されて Azure 側に保存されます。社内文書を扱うなら、保存先の所在と保持期間を先に確認してください。

書き起こしの結果には個人情報が入る

会議の録音を扱うなら、話者の識別も含めて取り扱いの規程を先に決めてください。

本番の認証は管理 ID で、と同梱の手引きが求めている

同梱の認証の手引きは、本番では管理 ID と Azure RBAC を使い、DefaultAzureCredential は手元の開発だけに使え、としています。

理由は、資格情報を順に試す仕組みが本番では遅く、どれで通ったかが環境によって変わるためです。SDK の例をそのまま本番に持ち込まないでください。

allowed-tools の指定が無い

allowed-tools の指定はありません。指定が無いので、確認なしで走る道具はありません。どの道具も、利用者の権限の設定どおりに確認されます。allowed-tools は事前承認の宣言で、実行の範囲を示すものではありません。実行の範囲は依頼文の側で絞ってください。

ライセンス

ライセンス: MIT。再配布や商用利用の前に公開元の表記を確認してください。

Java 専用ですか

違います。配布元の一覧の説明文が Java に触れているだけで、SKILL.md 自身に言語の限定はありません。

同梱の SDK の手引きは Python と TypeScript が中心です。

全文検索とベクトル検索はどちらを選べばいいですか

両方を組み合わせる混合検索が本文に挙げられています。

型番や固有名詞はベクトル検索で外しやすく、言い換えは全文検索で当たりません。片方だけで組むと、どちらかの弱点がそのまま出ます。

MCP が無くても使えますか

使えます。検索は az search、OpenAI は az cognitiveservices の経路が表に併記されています。

ただし音声には CLI の割り当てがありません。その部分は SDK の手引きを見る形になります。

Document Intelligence の手順はありますか

本文にはほとんどありません。表の MCP と CLI の欄が両方とも空です。

同梱の SDK の手引き（.NET と TypeScript）に送られます。帳票の抽出を中心にやりたいなら、本文から得られるものは少ないと考えてください。

費用はどれくらいかかりますか

当サイトでは算出していません。処理量による課金なので、対象の件数と単価で変わります。

書き起こしと埋め込みの生成は、件数が増えると効いてきます。小さく試してから広げてください。

対応しているエージェントはどれですか

Claude Code と Codex です。公開元の README が Claude Code と Codex CLI それぞれへの入れ方を節に分けて案内しています（2026-10-09 確認）。当サイトは公開元が明記しているものだけを「対応」として表示する方針なので、このスキルのページには両方が対応として出ます（指標の意味と限界）。