Note
このツールは以下のMCPサーバーでデフォルトで利用可能です:Dynamics 365 Customer Service。
このドキュメントのツールや例は、現在の能力を示しています。 ツール名、説明、パラメータ、応答形式、利用可能な機能は時間とともに変化することがあります。
エージェントや統合、オーケストレーションロジックを構築する際には、特定のツール名、パラメータ構造、ツールのメタデータ、レスポンススキーマに依存関係をハードコードしないでください。 代わりに、利用可能なツールを実行時に発見し活用できるように設計しましょう。
プラットフォームが進化するにつれて、Microsoftはツールやツールのメタデータを追加、削除、名前変更、または修正するかもしれません。 特定のツール識別子ではなく、能力に基づいて設計することで、サービス更新間の互換性を維持するのに役立ちます。
この記事番号やIDが分かっている場合、この機能を使って特定の知識記事の全内容を閲覧できます。
それが何をするか
アシスタントは、1つの知識記事の全文、著者、評価、キーワード、メタデータなど、すべての詳細を取得します。 これは、検索結果や同僚の参考文献など、どの記事が必要か既に分かっている場合に役立ちます。
記事は記事番号(例:KA-01001)や内部GUIDで検索できます。
例えば、次のようなプロンプトを試してみてください
- 「オープンナレッジ記事 KA-01001」
- 「記事KA-01001の詳細を見せてください」
- 「知識記事 KA-02050 を取得する」
- 「記事KA-01001は何と書いてある?」
- 「KB記事KA-01001を読む」
- 「この知識記事の全内容を表示してください」
チャットで見ることができる内容
アシスタントはチャットで直接記事の詳細を返してきます。 回答には記事タイトル、記事番号、出版状況、本文内容、メタデータ、そしてリンクが利用可能になった場合にDynamics 365で記事を開くリンクが含まれています。
役立つヒント
- 最も直接的な検索には記事番号(KA-XXXXX)をご利用ください。 記事番号は検索結果やDynamics 365ナレッジベースで見つけることができます。
- 記事番号がわからない場合は、まず「知識記事検索」を使って見つけてください。
- 記事の内容は全文表示されているので、Dynamics 365を開かずにチャットで直接読むことができます。
- 記事の内容を使って「この記事を使って返信を作成してください」と尋ねることで、顧客への返信を起草できます。
Tip
同僚が記事番号を言及した場合、直接調べることができます:「記事KA-01001を表示してください。」
次に何が起こるか
記事をご覧になった後、以下のようなプロンプトで続けることができます。
- 「この記事を使って返信を作成してください」
- 「この記事のリンクを顧客に送信」
- 「このテーマに関する他の記事も検索してください」
- 「この記事を要約してください」
これでデータが変わるのでしょうか?
いいえ、これはデータを変えません。
知識記事の閲覧は読み取り専用です。 記録は改変されていません。
アプリ内のチャットコンポーネントからできること
チャットの知識記事ビューアから、以下が可能です:
- 全文の記事本文と全セクション、フォーマットされた内容をご覧ください
- 記事メタデータ(記事番号、状況、出版日)を参照してください。
- 編集や共有のためにDynamics 365で記事を開いてください
- 記事の内容について質問するにはフォローアップのプロンプトを活用してください
前提条件
このツールには以下の条件が必要です:
- ナレッジ マネージメント
詳しくは 「ナレッジマネジメントの構成」をご覧ください。
ツールの概要
| プロパティ | 価値 |
|---|---|
| ユーザー向け名前 | 知識記事の詳細 |
| 内部工具名 | get_knowledge_article |
| Purpose | 単一の知識記事の詳細レコードを記事ID(GUID)または記事番号(例:)で取得します |
ツールの挙動
単一の知識記事の詳細な記録を記事ID(GUID)または記事番号(例: KA-01001)で取得します。 記事本文、著者、評価、メタデータ、Dynamics 365のディープリンクを完封します。 ユーザーが特定の記事に名前を付けた場合に使います。フリーテキスト検索の場合は search_knowledge_articlesをご利用ください。
Annotations
| Annotation | 価値 | Meaning |
|---|---|---|
readOnlyHint |
未設定 | デフォルトの行動(1つの記事を読むこと)。 |
destructiveHint |
未設定 | 適用されません。 |
idempotentHint |
未設定 | 適用されません。 |
openWorldHint |
未設定 | デフォルト(Dataverseクエリ)を使用しています。 |
入力概念
記事識別子
| 入力 | Description | 必須 |
|---|---|---|
articleId、articleNumber |
少なくとも articleId (GUID、最大38文字)または articleNumber (例: KA-01001、最大64文字)のいずれかが必要です。 両方が揃うと、 articleId が優先されます。 |
はい |
レスポンスとUIの挙動
このMCPツールはMCPアプリによってサポートされています。
応答の種類
チャットでのテキストのみの返信
レスポンスは本文内容、著者、評価、キーワード、メタデータ、そして利用可能な場合はDynamics 365リンクを含む記事全文を返します。
ルーティングノート
次のようなときは get_knowledge_article を使います。
- ユーザーは特定の記事に番号(例:
KA-01001)で名前を付けます。 - ユーザーは既知の記事の詳細を知りたいのです
-
search_knowledge_articles結果から掘り下げる
get_knowledge_article使わない方がいいです:
- ユーザーが 記事を横断して検索 したい場合、ルートを
search_knowledge_articles - ユーザーが 新しい記事を作成し たい - ルートを
draft_knowledge_article
関連ツール
| ツール | リレーションシップ |
|---|---|
search_knowledge_articles |
クエリごとにナレッジベースを検索します。 発見のための利用;既知の記事には get_knowledge_article を使う |
draft_knowledge_article |
新しい草稿記事を作成する |
データ変異分類
読み取り専用。
記事データを修正せずに取得できます。