Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Applies to: Dynamics 365 Customer Service
Note
- The tools and examples in this documentation illustrate current capabilities. Tool names, descriptions, parameters, response formats, and available functionality can change over time.
- When you build agents, integrations, or orchestration logic, don't hard-code dependencies on specific tool names, parameter structures, tool metadata, or response schemas. Instead, design your solution to discover and use available tools at runtime.
- As the platform evolves, Microsoft might add, remove, rename, or modify tools and tool metadata. Designing against capabilities rather than specific tool identifiers helps maintain compatibility across service updates.
Use this capability when you want the assistant to help with discard a knowledge article draft from chat.
What it does
Hard-deletes a draft knowledge article after the user confirms they want to abandon it.
Try prompts like
- Discard this draft.
- Throw this article away.
- Delete the draft knowledge article.
- I don't want to keep this draft.
What you'll see in chat
The assistant confirms that the draft was discarded, or reports that it was already gone.
Helpful tips
- Use this only after confirming the user wants to discard the draft.
- Discarding removes the draft instead of publishing it.
- Already-discarded drafts return success without creating a new error.
What happens next
- Harvest a new draft if the source still needs an article.
- Open another draft to review.
- Ask for an existing article check before drafting again.
Does this change data?
Yes, discarding a draft deletes the draft knowledge article record.
Prerequisites
This tool requires the following:
- Knowledge management
Learn more in Configure knowledge management.
Tool summary
| Property | Value |
|---|---|
| User-facing name | Discard Knowledge Article Draft |
| Internal tool name | discard_knowledge_draft |
| Purpose | Removes a draft Knowledge Article entirely so it never enters the knowledge base |
Tool behavior
Removes a draft Knowledge Article entirely so it never enters the knowledge base. Use when the user confirms abandoning a draft in the harvest widget (Discard button + inline confirm) or explicitly asks to discard a draft.
Annotations
| Annotation | Value | Meaning |
|---|---|---|
readOnlyHint |
false |
This tool modifies data. |
destructiveHint |
true |
This tool may remove or destroy data. |
idempotentHint |
true |
Repeated calls with the same input produce the same result. |
openWorldHint |
Not set | Uses default (queries Dataverse). |
Input concepts
Article ID
| Input | Description | Required |
|---|---|---|
articleId |
articleId (GUID, required). The ID of the draft knowledge article to discard. |
Yes |
Response and UI behavior
Response type
Text-only
No interactive component is rendered. Returns confirmation that the draft was discarded and removed from the knowledge base.
Routing notes
Use discard_knowledge_draft when:
- The user confirms abandoning a draft through the harvest widget Discard button.
- The user explicitly asks to 'discard', 'throw away', or 'delete' a draft article.
Don't use discard_knowledge_draft when:
- The user wants to save changes—route to
save_knowledge_draft. - The user wants to publish the article—route to
publish_knowledge_article.
Related tools
| Tool | Relationship |
|---|---|
harvest_knowledge_article |
Creates the draft that this tool discards |
save_knowledge_draft |
Saves edits to the draft instead of discarding |
publish_knowledge_article |
Publishes the draft instead of discarding |
Data mutation classification
Destructive write. Permanently deletes the draft Knowledge Article record from Dataverse.