Note
このツールは以下のMCPサーバーでデフォルトで利用可能です:Dynamics 365 Customer Service。
このドキュメントのツールや例は、現在の能力を示しています。 ツール名、説明、パラメータ、応答形式、利用可能な機能は時間とともに変化することがあります。
エージェントや統合、オーケストレーションロジックを構築する際には、特定のツール名、パラメータ構造、ツールのメタデータ、レスポンススキーマに依存関係をハードコードしないでください。 代わりに、利用可能なツールを実行時に発見し活用できるように設計しましょう。
プラットフォームが進化するにつれて、Microsoftはツールやツールのメタデータを追加、削除、名前変更、または修正するかもしれません。 特定のツール識別子ではなく、能力に基づいて設計することで、サービス更新間の互換性を維持するのに役立ちます。
チャットの既存の知識記事のチェックをアシスタントに依頼したい場合にこの機能を活用してください。
それが何をするか
Knowledge Management Agentによる重複除去チェックを実行し、ソースレコードの既存記事一致または一致なしの結果を返します。
例えば、次のようなプロンプトを試してみてください
- 「この事件のKBはありますか?」
- 「この会話について既に記事はありますか?」
- 「この問題がすでにドキュメント化されているか確認してください」
- 「この記録のための既存の知識記事を探してください」
チャットで見たもの
アシスタントは、選択したソースレコードに対して類似の記事がすでに存在しているかどうかを示します。
役立つヒント
- 記事がすでに存在しているかどうか知りたいときは、このツールを使いましょう。
- 収穫前に使わないでください。 ハーベストパイプラインはすでに独自の重複チェックを行っています。
- 具体的なケースや会話から始めて、チェックに十分な文脈を持たせましょう。
次に何が起こるか
- 「マッチした記事があれば開けてください」
- 「適切な記事が存在しない場合のみ草稿を収穫する」
- 「作成前にソースレコードの要約を求める」
これでデータが変わるのでしょうか?
このツールはバックエンドのチェックステートを作成または更新できますが、知識記事の公開や削除は行いません。
アプリ内のチャットコンポーネントからできること
チャットのコンポーネントから、以下ができます:
- 現在の結果や状態を見直してください
- コンポーネントがリンクを提供した際に関連するDynamics 365レコードを開きます
- 利用可能なコンポーネントアクションでワークフローを継続してください
前提条件
このツールには以下の条件が必要です:
- Copilotの機能が有効になっています
カスタマーサービスでは「知識管理の設定」と「Copilot機能の管理」をご覧ください。
ツールの概要
| プロパティ | 価値 |
|---|---|
| ユーザー向け名前 | 知識ギャップをチェックしてください |
| 内部工具名 | check_knowledge_gap |
| Purpose | Knowledge Management Agentのdedupパイプラインを通じて、ソースケース、会話、カスタムエンティティに対して類似の知識記事が既に存在しているかどうかを確認します。 |
ツールの挙動
ナレッジマネジメントエージェントのデアップパイプラインを通じて、ソースケース、会話、カスタムエンティティに対して類似のナレッジ記事が既に存在しているかどうかを確認します。 ユーザーが記事の存在を明確に尋ねる前に harvest_knowledge_article 事前フライトとして使用してください。
Annotations
| Annotation | 価値 | Meaning |
|---|---|---|
readOnlyHint |
false |
このツールはデータを修正します。 |
destructiveHint |
false |
データは更新しますが、記録は削除しません。 |
idempotentHint |
false |
同じ入力で繰り返し呼び出しても同じ結果が得られます。 |
openWorldHint |
未設定 | デフォルトを使います。 (Dataverse クエリ) |
入力概念
出典記録
| 入力 | Description | 必須 |
|---|---|---|
sourceId |
sourceId (GUID、必須) 確認すべき元のケース、会話、またはカスタムエンティティのIDです。 |
はい |
ソース エンティティの種類
| 入力 | Description | 必須 |
|---|---|---|
sourceEntityType |
sourceEntityType (必須)。 ソースエンティティの論理名です。 たとえば、incident、msdyn_ocliveworkitem のようになります。 |
はい |
レスポンスとUIの挙動
このMCPツールはMCPアプリによってサポートされています。
応答の種類
インタラクティブ(ウィジェット)
一致する記事が存在するかどうかを示すウィジェットをレンダリングし、重複が見つからなければ収穫を進めるオプションを提供します。
ルーティングノート
次のようなときは check_knowledge_gap を使います。
- ユーザーは記事を作成する前に明確にその記事が存在するかどうかを尋ねます
- 事前フライトステップとして使用されます
harvest_knowledge_article
check_knowledge_gap使わない方がいいです:
- ユーザーがすぐに記事を作成したいので、
harvest_knowledge_articleへのルート(内部でチェックされます) - ユーザーはキーワードで記事を検索したい - ルート先へ
search_knowledge_articles
関連ツール
| ツール | リレーションシップ |
|---|---|
harvest_knowledge_article |
主な収穫ツールです。
check_knowledge_gap はオプションのプリフライトです |
search_knowledge_articles |
キーワードで記事を閲覧・リスト |
データ変異分類
ライトで書く。 KMAのデデアップパイプラインをトリガーしますが、知識記事の作成や修正は行いません。