Note
このツールは以下のMCPサーバーでデフォルトで利用可能です:Dynamics 365 Customer Service。
このドキュメントのツールや例は、現在の能力を示しています。 ツール名、説明、パラメータ、応答形式、利用可能な機能は時間とともに変化することがあります。
エージェントや統合、オーケストレーションロジックを構築する際には、特定のツール名、パラメータ構造、ツールのメタデータ、レスポンススキーマに依存関係をハードコードしないでください。 代わりに、利用可能なツールを実行時に発見し活用できるように設計しましょう。
プラットフォームが進化するにつれて、Microsoftはツールやツールのメタデータを追加、削除、名前変更、または修正するかもしれません。 特定のツール識別子ではなく、能力に基づいて設計することで、サービス更新間の互換性を維持するのに役立ちます。
誤字を直したり、情報を追加したり、事件やその他の記録の既存メモを修正したいときにこの機能を活用してください。
それが何をするか
アシスタントは既存のメモを識別子で見つけ、新しい内容でテキストを更新します。 更新されたノートは、レコードのタイムライン上で以前のバージョンを置き換えるものです。 これは誤りを修正したり、以前に作成したノートの詳細を追加したりするのに役立ちます。
例えば、次のようなプロンプトを試してみてください
- 「メモのタイプミスを直してくれ」
- 「メモを更新して、顧客が回避策を確認したと伝えてください」
- 「この事件のメモを変えろ」
- 「最後のメモを修正して」
- 「メモのテキストを新しい電話番号を含めて更新」
チャットで見ることができる内容
アシスタントはアクティビティタイムラインをアプリ内のチャットコンポーネントとして表示し、更新されたメモ内容を表示します。
役立つヒント
- アシスタントはどのノートを更新すべきかを知る必要があります。 複数のメモがある場合は、内容やタイトルで指定してください。
- 「ノートを更新」と言って新しいテキストを提供したり、すべてを一つのプロンプトにまとめて書くこともできます。
- 更新できるのは自分が所有しているノートだけです。
- 既存のノートを編集する代わりに完全に新しいノートを追加したい場合は、「add a note」と言ってください。
Tip
まずタイムラインを見て既存のメモを確認し、その後アシスタントにどのメモを更新するか伝えてください。
次に何が起こるか
メモが更新された後は、以下のようなプロンプトで続けることができます:
- 「タイムラインを見せて」
- 「もう一つメモを追加」
- 「顧客へのメールを作成」
- 「この事件で他に何をすべき?」
これでデータが変わるのでしょうか?
はい、これは既存のメモを更新します。
メモのテキストは、あなたが提供した新しいコンテンツに置き換えられます。 アシスタントは変更前に確認を求めます。
アプリ内のチャットコンポーネントからできること
チャットのタイムラインから、以下のことができます:
- 更新されたメモを文脈でご覧ください
- 活動タイムラインの全ページをご覧ください
- 詳細を見るには任意のアクティビティを選択してください
- Dynamics 365で完全な記録フォームを開く
前提条件
このツールはDynamics 365 Customer Service MCPサーバー上で利用可能です。 詳細はこのページ上部の入手可能性注記をご覧ください。 追加の構成は必要ありません。
ツールの概要
| プロパティ | 価値 |
|---|---|
| ユーザー向け名前 | アップデートノート |
| 内部工具名 | update_note |
| Purpose | Dynamics 365内の既存のノート(注釈)のテキストをGUIDの注釈で更新します |
ツールの挙動
既存のノート(注釈)のテキストをDynamics 365のアノテーションGUIDで更新します。 ユーザーが誤字を直したり、既存のメモを修正したり、修正したい場合に利用してください。
annotationIdはget_activity_timeline応答から得られます。
Annotations
| Annotation | 価値 | Meaning |
|---|---|---|
readOnlyHint |
false |
このツールはデータを修正します。Microsoft 365 Copilotは確認を促します。 |
destructiveHint |
false |
ノートの更新は内容を置き換えますが、破壊的ではありません。 |
idempotentHint |
true |
同じ入力で呼び出しても同じ結果が出ます。再試行しても安全です。 |
openWorldHint |
未設定 | デフォルト(Dataverseクエリ)を使用しています。 |
入力概念
ノート識別子
| 入力 | Description | 必須 |
|---|---|---|
annotationId |
annotationId (更新のための注釈付きGUIDは必須)
get_activity_timelineから入手。 |
Yes |
更新されたコンテンツ
| 入力 | Description | 必須 |
|---|---|---|
notetext、subject |
notetext (更新された注本文テキスト、必須)、 subject (オプションで更新されたタイトル) |
場合により異なる |
レスポンスとUIの挙動
このツールは、ノートが更新されたことを確認するためにアクティビティタイムラインをレンダリングします。
このMCPツールはMCPアプリによってサポートされています。
応答の種類
インタラクティブコンポーネント(アプリ・イン・チャット)
タイムラインウィジェットは更新されたメモ内容を表示するために更新されます。
ルーティングノート
次の場合に update_note を使用します。
- 「音を直せ」「音符を更新しろ」「音符を修正しろ」
- 既存の注釈のテキストやタイトルへの編集
update_note使わない方がいいです:
- ユーザーが新しいノートを作成したい場合、
create_note - ユーザーがタイムラインのアクティビティ(タスク、電話など)を更新したい場合、
create_activityを使います。activityId
関連ツール
| ツール | リレーションシップ |
|---|---|
create_note |
レコードに新しいノートを作成します |
get_activity_timeline |
メモを含むタイムラインを取得する(注釈IDの出典) |
create_activity |
タイムラインのアクティビティ(注釈ではなく)を作成する |
データ変異分類
書き/突然変異。
このツールはDataverse内の既存の注釈レコードを更新します。 M365 Copilotは実行前にユーザーに確認を求めます。 この演算は冪等であり、同じ入力で再試しても同じ結果が得られます。