Note
このツールは以下のMCPサーバーでデフォルトで利用可能です:Dynamics 365 Customer Service。
このドキュメントのツールや例は、現在の能力を示しています。 ツール名、説明、パラメータ、応答形式、利用可能な機能は時間とともに変化することがあります。
エージェントや統合、オーケストレーションロジックを構築する際には、特定のツール名、パラメータ構造、ツールのメタデータ、レスポンススキーマに依存関係をハードコードしないでください。 代わりに、利用可能なツールを実行時に発見し活用できるように設計しましょう。
プラットフォームが進化するにつれて、Microsoftはツールやツールのメタデータを追加、削除、名前変更、または修正するかもしれません。 特定のツール識別子ではなく、能力に基づいて設計することで、サービス更新間の互換性を維持するのに役立ちます。
この機能はセッションを特定のDynamics 365環境に接続し、その後のすべてのアクションでその組織のデータを使用します。
それが何をするか
環境ピッカーで環境をクリックすると、アシスタントがあなたのセッションをその組織に接続します。その後のすべてのアクション(ケースの閲覧、アカウント、連絡先など)は、選択した環境から自動的にデータを使用します。 通常、これを直接呼び出しる必要はありません。ピッカーで環境をクリックすると発生します。
例えば、次のようなプロンプトを試してみてください
通常、プロンプトを入力する必要はありません。 ピッカーで環境をクリックすると自動的に発生します。 環境を変える必要がある場合:
- 「スイッチ環境」(ピッカーを表示する)
- 「環境を見せて」(ピッカーを表示する)
チャットで見ることができる内容
アシスタントはどの環境に接続したかを確認し、環境名を表示します。 この確認が完了したら、その組織のデータ扱いを始められます。
役立つヒント
- 環境IDを手動で入力する必要はありません。 代わりに環境ピッカーを使いましょう。
- 接続後、アシスタントはレスポンスに環境名を含めてくれて、どの組織で働いているか常に分かります。
- もし間違った環境に接続してしまったら、「環境を切り替える」と言って再選してください。
次に何が起こるか
環境に接続した後:
- 「私のケースを見せて」
- 「私の口座をリストアップして」
- 「受信箱に何が入ってる?」
- 「どの環境に接続されているの?」(確認するため)
これでデータが変わるのでしょうか?
いいえ、これはDynamics 365のデータを変更しません。
セッション接続だけを更新します。 Dynamics 365のレコードは一切変更されません。
前提条件
このツールはDynamics 365 Customer Service MCPサーバー上で利用可能です。 詳細はこのページ上部の入手可能性注記をご覧ください。 追加の構成は必要ありません。
ツールの概要
| プロパティ | 価値 |
|---|---|
| ユーザー向け名前 | 環境の選択 |
| 内部工具名 | select_environment |
| Purpose | 現在のセッションのためにDynamics 365環境を選択する |
ツールの挙動
現在のセッションのためにDynamics 365環境を選択します。 その後のすべてのツール呼び出し(ケース、知識、アカウントなど)は自動的にこの環境にルーティングされます。 このツールは通常、ユーザーが環境をクリックした際に組織ピッカーウィジェットによって呼び出され、モデルから直接呼び出されることはありません。
Annotations
| Annotation | 価値 | Meaning |
|---|---|---|
readOnlyHint |
false |
このツールはセッション状態を修正します。 |
destructiveHint |
false |
環境の選択はデータを破壊しません。 |
idempotentHint |
true |
同じ環境を2回選んでも追加効果はありません。 |
openWorldHint |
未設定 | デフォルトを使います。 |
入力概念
環境 ID
| 入力 | Description | 必須 |
|---|---|---|
environmentId |
environmentId (文字列、必須) 環境の組織GUIDを選択してください。 これはget_environmentまたはlist_environmentsで返されるidフィールドです。 |
はい |
レスポンスとUIの挙動
応答の種類
テキストのみ
インタラクティブなコンポーネントはレンダリングされません。 組織選択ウィジェットはこのツールを呼び出した後、自身の状態を楽観的に更新します。 応答は選択した環境名とIDを確認します。
ルーティングノート
select_environment はバックエンドのアクションツールです。 ほとんどの場合、直接モデルルーティングではなく、組織ピッカーウィジェットによって呼び出されます。
- 「組織を切り替える」などのユーザープロンプトを
select_environmentにルーティングしないでください。 代わりに拾い上げlist_environmentsを使いましょう。 - 以前の回答で環境GUIDが確認された場合にのみ、直接
select_environmentに電話してください。
関連ツール
| ツール | リレーションシップ |
|---|---|
get_environment |
現在活動中の環境を戻します |
list_environments |
ユーザーが選択できる組織選択ウィジェットが表示されます |
disconnect_environment |
活発な環境をクリアにします |
データ変異分類
Write(セッション状態)。
セッションのアクティブな環境を修正します。 Dynamics 365のデータは変更されません。