ケースの更新

Note

このツールは以下のMCPサーバーでデフォルトで利用可能です:Dynamics 365 Customer Service。 このドキュメントのツールや例は、現在の能力を示しています。 ツール名、説明、パラメータ、応答形式、利用可能な機能は時間とともに変化することがあります。
エージェントや統合、オーケストレーションロジックを構築する際には、特定のツール名、パラメータ構造、ツールのメタデータ、レスポンススキーマに依存関係をハードコードしないでください。 代わりに、利用可能なツールを実行時に発見し活用できるように設計しましょう。
プラットフォームが進化するにつれて、Microsoftはツールやツールのメタデータを追加、削除、名前変更、または修正するかもしれません。 特定のツール識別子ではなく、能力に基づいて設計することで、サービス更新間の互換性を維持するのに役立ちます。

この機能は、サポートケースの優先度、タイトル、説明、その他の詳細などのフィールドを変更したいときに活用してください。

それが何をするか

アシスタントはケースレコードの1つ以上のフィールドを更新します。 優先度レベルはプレーンな言語で変更したり、変更したい項目を指定することで他のケースフィールドを更新できます。 アシスタントは変更後にどのフィールドが更新されたかを確認します。

例えば、次のようなプロンプトを試してみてください

  • 「CAS-01010-A0A0A0の優先度を高に設定せよ」
  • 「この事件のタイトルをログイン問題に変更してください」
  • 「この事件の説明を更新してください」
  • 「優先度を低く設定」
  • 「この事件は詳細待遇として記録しろ」
  • 「ケース中の顧客をCAS-01010-A0A0A0に変更」

チャットで見たもの

アシスタントは変更されたフィールドを記載したテキスト返信で更新を確認しました。 このアクションにはインタラクティブなコンポーネントが表示されません。

役立つヒント

  • ケース番号(例:CAS-01010-A0A0A0)でケースを呼ぶか、アシスタントにすでに扱っているケースを使わせることもできます。
  • 優先度変更は「高」「ノーマル」「低」を使いましょう。
  • 1つのリクエストで複数のフィールドを更新できます。
  • ケースを閉じたい場合は、「このケースを閉じる」を使いましょう。これは解決記録付きの別のアクションです。

Tip

まずケースを開き、「show me case CAS-01010-A0A0A0」で現在のフィールドを確認してから更新してください。

次に何が起こるか

更新後は、次のようなプロンプトで続けることができます:

  • 「このケースを見せてくれ」
  • 「この事件をまとめてくれ」
  • 「この事件のSLAの状況はどうなっている?」
  • 「この事件をアレックスに再割り当てしろ」

これでデータが変わるのでしょうか?

Yes. これによりデータが変わります。

ケースレコードはDynamics 365で更新されます。 変更はすぐに有効になります。

前提条件

このツールには以下の条件が必要です:

  • カスタマーサービス担当者の役割

ツールの概要

プロパティ 価値
ユーザー向け名前 ケースの更新
内部工具名 update_case
Purpose サポートケースの1つ以上のフィールドを更新します

ツールの挙動

サポートケースの1つ以上のフィールドを更新します。 優先順位などの共通フィールドに対するタイプ付きショートカットや、タイトル、説明、顧客、ステータス理由を含む任意のDataverse論理名から値への更新のための汎用的な fields マップをサポートしています。

Annotations

Annotation 価値 Meaning
readOnlyHint false このツールはデータを修正します。
destructiveHint false 更新は非破壊的で(フィールドは上書きされますが削除されません)。
idempotentHint true 同じ入力で呼び出しても同じ結果が得られます。
openWorldHint 未設定 デフォルト(Dataverseクエリ)を使用しています。

入力概念

ケース識別子

入力 Description 必須
incidentIdcaseNumber incidentId (GUID)または caseNumber (例:CAS-01010-A0A0A0)です。 少なくとも 1 つは必要です。 caseNumberが提供されると、サーバーはそれをGUIDに解決します。 はい

優先ショートカット

入力 Description 必須
priorityhighnormallow priority (枚数: highnormallow)。 最も一般的なフィールド更新のための利便性パラメータ。 No

任意の体

入力 Description 必須
fields fields (Dataverseの論理名から値ペアへの記録) フォームウィジェットで個々のフィールドのインライン編集や、タイプされたショートカットでカバーされていないフィールドに使用されます。 No

レスポンスとUIの挙動

このMCPツールはMCPアプリによってサポートされています。

応答の種類

テキスト確認

ツールは更新されたフィールドのテキスト確認を返します。 インタラクティブなコンポーネントはレンダリングされません。

ルーティングノート

次の場合に update_case を使用します。

  • ケースレコードのフィールド変更(優先度、タイトル、説明、ステータス理由、カスタムフィールドなど)
  • ケースフォームウィジェットからのインライン編集

update_case使わない方がいいです:

  • ケースのクローズ/解決 - close_case へのルート(Dataverse CloseIncidentアクションを使用)
  • ケースの再割り当て - reassign_case へのルート(所有権移転および引き継ぎノートの処理)
  • 非事件エンティティの更新 - ルートを update_entity_record
ツール リレーションシップ
get_case 編集前にケースフォームを閲覧のために開く
close_case ケースを解決し終了します(フィールド更新ではなくCloseIncidentを使用)
reassign_case ケースを他のユーザー、チーム、またはキューに再割り当てします
list_cases 更新すべきケースをリストアップします
summarize_case 編集前にトリアージ用のAI要約でケースを開けます

データ変異分類

書き/突然変異。

Dataverseのケースレコードの1つ以上のフィールドを更新します。 この演算は冪等であり、同じ入力で呼び出しても同じ結果が得られます。