mcpField
A
azure-search-nav

azure-search-nav

github.com/microsoftクラウド・DevOps1.6k95 回インストール今日更新
リポジトリ

azure-search-nav について

リソース URL または ARM リソース ID と検索語から、Azure Portal のナビゲーションリンクを作成するスキルです。PowerShell と Az.Accounts 認証を使い、対応するリソースのポータル画面を検索します。

主な機能

  1. 01ポータル URL または ARM リソース ID を受け付け
  2. 02Azure Portal のナビゲーション項目を検索
  3. 03ブラウザーまたはデバイスコードで認証
  4. 04ポータルのディープリンクを返却
  5. 05設定済みリソースタイプに対応

活用シーン

  1. 01対応する Azure リソースの画面を検索
  2. 02操作に使うポータルメニューを特定
  3. 03ARM リソース ID からディープリンクを作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/microsoft/azure-skills --skill azure-search-nav

インストール後、Claude Code で/azure-search-navを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
Invoke-PortalSearchNav.ps1
README.md
resource-types.json

詳細

Azure Portal 検索リンクビルダー

クイックリファレンス

項目値
スクリプトreferences/Invoke-PortalSearchNav.ps1
リソースマップreferences/resource-types.json
前提条件Az.Accounts PowerShell モジュール
認証Microsoft への対話型サインイン（Connect-AzAccount）、または -UseDeviceAuthentication によるデバイスコード認証

このスキルを使う場面

  • ユーザーが、サポート対象の Container Service、Arc 対応 Kubernetes、または Compute リソースに対する操作を Azure portal のどこで行うか尋ねている。
  • ユーザーが特定のブレード／メニュー項目へのポータルのディープリンクを求めている。
  • ユーザーがリソース URL または ARM リソース ID と、自然言語の検索クエリを提示している。

ワークフロー

  1. ユーザーからリソースリンク（ポータル URL または ARM リソース ID のみ）と検索クエリを受け取ります。
  2. references/Invoke-PortalSearchNav.ps1 -ResourceUrl '<link>' -Query '<query>' を実行します。
  3. スクリプトがサインインし（既定ではブラウザーを使用します。ヘッドレス／CLI 環境では -UseDeviceAuthentication を渡します）、検索 API を呼び出して、常に https://portal.azure.com を起点とするポータルのディープリンクを出力します。

パラメーターの詳細と API の詳細については、references/README.md を参照してください。

エラー処理

エラー原因対処方法
リソースの種類が有効になっていないarmProvider が references/resource-types.json に存在しないその種類が有効なプロバイダーの一覧に含まれていることを確認します
API からの 401トークンが無効、または選択したテナントが誤っている再実行し、対象サブスクリプションのテナントにアクセスできるアカウントを選択します
結果が空クエリに一致するナビゲーション項目がない別の検索語を試します
Az.Accounts が見つからないモジュールがインストールされていないInstall-Module Az.Accounts -Scope CurrentUser
ブラウザーでのサインインに失敗する（ウィンドウハンドルがない）ヘッドレス／CLI 環境-UseDeviceAuthentication を指定して再実行します

コメント

Markdown 対応