Edit

Submit Intent Feedback

Note

This tool is available by default on the following MCP servers: Dynamics 365 Customer Service. 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 to provide feedback on AI-generated action suggestions, helping improve the quality of future recommendations.

What it does

When the assistant suggests next-best-action steps for a case, you can give feedback if a suggestion is unhelpful or inaccurate. Clicking the thumbs-down button on a suggestion opens a feedback dialog where you can select categories and add comments explaining what was wrong.

This feedback is recorded and used to improve the quality of future AI-generated action recommendations.

Try prompts like

This capability is triggered from the next-best-action widget rather than by typing a prompt. You'll use it when:

  • You click the thumbs-down icon on a suggested action
  • You want to report an unhelpful or incorrect suggestion

What you'll see in chat

A feedback dialog appears within the next-best-action widget. You can select one or more feedback categories (such as "issue" or "suggestion") and optionally add free-text comments explaining why the suggestion was unhelpful.

Helpful tips

  • Use the feedback categories to classify what was wrong with the suggestion.
  • Add comments for context - they help the system learn faster.
  • Feedback is anonymous to the AI model; your comments are used for quality improvement only.
  • You can continue working on the case after submitting feedback.

What happens next

After submitting feedback, you can continue with prompts like:

  • "Suggest a different action for this case"
  • "What else can I do on this case?"
  • "Summarize this case"

Does this change data?

Yes, this can change data.

Submitting feedback creates a feedback record in the system. This does not change case data, but it does record your feedback for quality improvement purposes.

Prerequisites

This tool is available on the Dynamics 365 Customer Service MCP server. See the availability note at the top of this page for details. No additional configuration is required.

Tool summary

Property Value
User-facing name Submit Intent Feedback
Internal tool name submit_feedback
Purpose Records agent feedback (thumbs-down) for an intent-based suggestion generated by suggest_next_action_for_case

Tool behavior

Records agent feedback (thumbs-down) for an intent-based suggestion generated by suggest_next_action_for_case. This feedback is used to improve the quality of future AI-generated action recommendations.

Annotations

Annotation Value Meaning
readOnlyHint false This tool modifies data.
destructiveHint false Feedback can be submitted again; does not delete data.
idempotentHint false Each submission creates a new feedback record.
openWorldHint Not set Uses default.

Input concepts

Intent reference

Input Description Required
intentId intentId (optional). The intent ID the feedback relates to. No

Correlation

Input Description Required
requestId requestId (optional). Correlation ID from the intent API response (msdyn_scenariorequestid). No

Feedback categories

Input Description Required
feedbackTypes feedbackTypes (required). Array of selected feedback categories (e.g. issue, suggestion). Yes

Comments

Input Description Required
comments comments (optional). Free-text comments from the agent explaining why the suggestion was unhelpful. No

Response and UI behavior

Response type

Text-only (widget-consumed)

No standalone interactive component is rendered. The feedback confirmation is consumed by the intent-assist widget internally.

Routing notes

This tool is exclusively widget-invoked. The orchestrator should not route user prompts to submit_feedback directly. It is called by the intent-assist widget's feedback dialog.

Tool Relationship
suggest_next_action_for_case The parent tool whose suggestions this feedback applies to
get_response_preview Another downstream tool from intent-assist whose replies may trigger feedback

Data mutation classification

Write / mutation.

Creates a feedback record in the system. Each submission is a new record (not idempotent).