Note
このツールは以下のMCPサーバーでデフォルトで利用可能です:Dynamics 365 Customer Service。
このドキュメントのツールや例は、現在の能力を示しています。 ツール名、説明、パラメータ、応答形式、利用可能な機能は時間とともに変化することがあります。
エージェントや統合、オーケストレーションロジックを構築する際には、特定のツール名、パラメータ構造、ツールのメタデータ、レスポンススキーマに依存関係をハードコードしないでください。 代わりに、利用可能なツールを実行時に発見し活用できるように設計しましょう。
プラットフォームが進化するにつれて、Microsoftはツールやツールのメタデータを追加、削除、名前変更、または修正するかもしれません。 特定のツール識別子ではなく、能力に基づいて設計することで、サービス更新間の互換性を維持するのに役立ちます。
組織やプロフィールレベルでどのツールが見えるか、隠されているか、復元されているかを確認したいときにこの機能を活用してください。
それが何をするか
このツールは、選択したスコープの現在のツールの可視性設定を一覧にします。 ツールカタログ、解決された隠しセット、組織やプロファイルに保存された生の可視性パッチを返します。
例えば、次のようなプロンプトを試してみてください
- 「どの道具が隠されているの?」
- 「この組織のツールの可視性を表示する」
- 「プロファイルの一覧ツールの可視性」
- 「どの道具が無効化されるの?」
- 「現在の道具を見せて」
チャットで見ることができる内容
アシスタントは可視性状態のテキスト概要を返します。スコープ、ツール名、現在の隠しまたは復元状態などが含まれます。
役立つヒント
-
level: orgを使って組織全体の可視性を見直しましょう。 -
level: profileを使って特定のプロフィールを調べ、profileIdを含めてください。 - このツールは読み取り専用です。
save_tool_selectionを使って変更を加えましょう。
次に何が起こるか
- 「このプロフィールのメールツールを非表示にする」
- 「隠された道具を復元」
- 「ツールの可視性をデフォルトにリセット」
これでデータが変わるのでしょうか?
いいえ、これはデータを変えません。
現在の可視設定のみを読み取ります。
前提条件
このツールはDynamics 365 Customer Service MCPサーバー上で利用可能です。 詳細はこのページ上部の入手可能性注記をご覧ください。 追加の構成は必要ありません。
ツールの概要
| プロパティ | 価値 |
|---|---|
| ユーザー向け名前 | リストツールの可視化 |
| 内部工具名 | list_tool_selection |
| Purpose | 選択した組織またはプロファイルの範囲に関する現在のツールの可視化設定を一覧にします |
ツールの挙動
選択した組織またはプロファイルの範囲に関する現在のツールの可視性設定を一覧にします。 ツールカタログ全体、解決済みの隠しセット、現在保存されている生の可視性パッチを返します。
Annotations
| Annotation | 価値 | Meaning |
|---|---|---|
readOnlyHint |
true |
このツールはデータを改変しません。 |
destructiveHint |
未設定 | 適用されません。 |
idempotentHint |
未設定 | 適用されません。 |
openWorldHint |
未設定 | デフォルトを使います。 |
入力概念
Level
| 入力 | Description | 必須 |
|---|---|---|
level、org、profile |
level (org または profile、必須) 組織全体の可視性かプロファイルレベルの可視性の検査かを選択します。 |
はい |
プロファイル ID
| 入力 | Description | 必須 |
|---|---|---|
profileId |
profileId (UUID文字列、任意)
level が profile の場合に必要です。 |
場合により異なる |
レスポンスとUIの挙動
応答の種類
テキストのみ
インタラクティブなコンポーネントはレンダリングされません。 現在の可視性状態を記述した構造化テキスト(スコープ、ツール名、隠しまたは復元状態など)を返します。
ルーティングノート
次のようなときは list_tool_selection を使います。
- どのツールが隠されているか、見えるかを確認する必要があります
- 変更する前に視認性を確認しましょう
- 工具選択設定の読み取り専用監査が欲しいのです
list_tool_selection使わない方がいいです:
- あなたはすでに、何を変えたいか正確に決めています。
save_tool_selectionを代わりに使用します。
関連ツール
| ツール | リレーションシップ |
|---|---|
save_tool_selection |
可視性オーバーライドを省く |
delete_tool_selection |
視認オーバーライドをクリアする |
browse_agent_config_options |
関連する設定オプションを発見 |
データ変異分類
読み取り専用。
このツールは現在の可視性設定のみを読み取ります。