注释
该工具默认可在以下 MCP 服务器上使用:Dynamics 365 Customer Service。
本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
当你构建代理、集成或编排逻辑时,不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反,设计解决方案时能在运行时发现并使用可用工具。
随着平台的发展,Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你需要助手帮助从聊天中保存知识条目草稿编辑时,可以使用这个功能。
它的作用是什么
在保持草稿状态的前提下,保留对已有知识草稿条目的内嵌编辑。
试试像这样的提示
- “把这保存成草稿”
- “保存我的条目编辑”
- “把这些改动记在草稿里”
- “更新草稿,标题和内容如下”
你在聊天中会看到的内容
如果草稿被删除或已发布,助理会确认草稿已被保存,或者显示陈旧状态提示。
有用的提示
- 编辑标题或正文内容后,请通过收获小部件使用该功能。
- 保存不发布文章。
- 如果草稿已经陈旧,编辑前先刷新收获卡。
接下来会发生什么
- “继续编辑草稿”
- “最终审核后发布草案”
- “如果不再需要,就丢弃草稿”
这会改变数据吗?
是的,保存草稿会更新草稿知识条目标题和内容。
先决条件
该工具需要以下条件:
- 知识管理
了解更多内容,请参阅 “配置知识管理”。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 保存知识文章草稿 |
| 内部工具名称 | save_knowledge_draft |
| Purpose | 将编辑后的标题和内容保存回已有的知识条目草稿 |
工具行为
将编辑后的标题和内容保存回已有的知识条目草稿。 当用户在收获小部件(“另存为草稿”按钮)确认内联编辑,或请求将更改保存到草稿时使用。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
该工具会修改数据。 |
destructiveHint |
false |
更新数据但不删除记录。 |
idempotentHint |
true |
同一输入的重复调用会产生相同的结果。 |
openWorldHint |
未设置 | 使用默认值(查询Dataverse)。 |
输入概念
文章 ID
| 输入 | Description | 必需 |
|---|---|---|
articleId |
articleId (GUID,必需)。 更新知识条目草稿的ID。 |
是的 |
Title
| 输入 | Description | 必需 |
|---|---|---|
title |
title (必需)。 更新后的文章标题。 |
是的 |
Content
| 输入 | Description | 必需 |
|---|---|---|
content |
content (必需)。 更新后的文章正文内容。 |
是的 |
响应与用户界面行为
响应类型
仅文本
没有渲染任何交互组件。 回返回确认草稿编辑已被保存。
路由注释
在以下情况下使用 save_knowledge_draft:
- 用户确认在收割小部件中保存内联编辑
- 用户请求在知识条目中“保存我的编辑”、“保留我的更改”或“保存为草稿”
不要在以下情况下使用 save_knowledge_draft :
- 用户想 发布 文章——路由到
publish_knowledge_article - 用户想 丢弃 草稿——路由到
discard_knowledge_draft
相关工具
| 工具 | 关系 |
|---|---|
harvest_knowledge_article |
生成草稿,该工具会更新 |
publish_knowledge_article |
发布保存的草稿 |
discard_knowledge_draft |
放弃选秀而不是存档 |
数据变异分类
写。 更新Dataverse中现有知识条目草稿的标题和内容。