Note
このツールは以下のMCPサーバーでデフォルトで利用可能です:Dynamics 365 Customer Service。
このドキュメントのツールや例は、現在の能力を示しています。 ツール名、説明、パラメータ、応答形式、利用可能な機能は時間とともに変化することがあります。
エージェントや統合、オーケストレーションロジックを構築する際には、特定のツール名、パラメータ構造、ツールのメタデータ、レスポンススキーマに依存関係をハードコードしないでください。 代わりに、利用可能なツールを実行時に発見し活用できるように設計しましょう。
プラットフォームが進化するにつれて、Microsoftはツールやツールのメタデータを追加、削除、名前変更、または修正するかもしれません。 特定のツール識別子ではなく、能力に基づいて設計することで、サービス更新間の互換性を維持するのに役立ちます。
チャットから知識記事ドラフトの編集保存をアシスタントに手伝ってもらいたい場合にこの機能を活用してください。
それが何をするか
既存の知識記事のインライン編集を維持しつつ、記事はドラフト状態のまま維持します。
例えば、次のようなプロンプトを試してみてください
- 「これを下書きとして保存して」
- 「記事の編集を保存して」
- 「これらの変更は草案に残しておけ」
- 「このタイトルと内容で草稿を更新してください」
チャットで見ることができる内容
アシスタントは下書きが保存されたか、削除されたかすでに公開されている場合にステールステートのメッセージを表示します。
役立つヒント
- タイトルや本文の内容を編集した後、ハーベストウィジェットからこれを使ってください。
- セーブは記事を公開しません。
- 下書きが古くなっている場合は、再度編集する前に収穫カードをリフレッシュしてください。
次に何が起こるか
- 「草稿の編集を続けてください」
- 「最終審査後に草案を公開せよ」
- 「もしもう必要なければ、ドラフトは破棄せよ」
これでデータが変わるのでしょうか?
はい、ドラフトを保存すると、ドラフト知識記事のタイトルと内容が更新されます。
前提条件
このツールには以下の条件が必要です:
- ナレッジ マネージメント
詳しくは 「ナレッジマネジメントの構成」をご覧ください。
ツールの概要
| プロパティ | 価値 |
|---|---|
| ユーザー向け名前 | Save Knowledge 記事ドラフト |
| 内部工具名 | save_knowledge_draft |
| Purpose | 編集済みタイトルと内容を既存のドラフト知識記事に保存します |
ツールの挙動
編集したタイトルと内容を既存のドラフト知識記事に戻します。 ユーザーがハーベストウィジェットでインライン編集を確認し(ドラフトとして保存ボタン)、または変更をドラフトに保存したいとリクエストしたときに使ってください。
Annotations
| Annotation | 価値 | Meaning |
|---|---|---|
readOnlyHint |
false |
このツールはデータを修正します。 |
destructiveHint |
false |
データを更新しますが、記録は削除しません。 |
idempotentHint |
true |
同じ入力で繰り返し呼び出しても同じ結果が得られます。 |
openWorldHint |
未設定 | デフォルト(Dataverseクエリ)を使用しています。 |
入力概念
記事の ID
| 入力 | Description | 必須 |
|---|---|---|
articleId |
articleId (GUID、必須) 更新予定の知識記事のIDです。 |
はい |
Title
| 入力 | Description | 必須 |
|---|---|---|
title |
title (必須)。 更新された記事タイトル。 |
はい |
Content
| 入力 | Description | 必須 |
|---|---|---|
content |
content (必須)。 更新された記事本文の内容。 |
はい |
レスポンスとUIの挙動
応答の種類
テキストのみ
インタラクティブなコンポーネントはレンダリングされません。 下書きの編集が保存されたことを確認する返送。
ルーティングノート
次のようなときは save_knowledge_draft を使います。
- ユーザーがハーベストウィジェットでインライン編集の保存を確認します
- ユーザーが知識記事で「編集を保存」「変更を保持する」「下書きとして保存」をリクエストします
save_knowledge_draft使わない方がいいです:
- ユーザーが記事を 公開 したい場合、ルートは
publish_knowledge_article - ユーザーがドラフトを 破棄 したい場合、ルートを
discard_knowledge_draft
関連ツール
| ツール | リレーションシップ |
|---|---|
harvest_knowledge_article |
このツールが更新するドラフトを作成します |
publish_knowledge_article |
保存済みドラフトを公開します |
discard_knowledge_draft |
貯金せずにドラフトを放棄する |
データ変異分類
書き込み。 Dataverseにおける既存のKnowledge Article草稿のタイトルと内容を更新します。