m365-agent-evaluator

Evaluate Microsoft 365 Copilot declarative agents for relevance, coherence, groundedness, and similarity.

2.9k|323|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/microsoft/skills --skill m365-agent-evaluator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: m365-agent-evaluator
Source: https://github.com/microsoft/skills/tree/main/.github/plugins/microsoft-365-agents-toolkit/skills/m365-agent-evaluator
Command: npx skills add https://github.com/microsoft/skills --skill m365-agent-evaluator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @microsoft/m365-copilot-eval, node, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides the ability to evaluate and fine-tune Microsoft 365 Copilot declarative agents, enabling users to ensure their agents meet the desired standards of relevance, coherence, and groundedness.

Core Features & Use Cases

  • Evaluation: Use the CLI to run evaluation suites on agents and analyze results.
  • Dataset Creation: Design schema-compatible eval datasets for specific agent behaviors.
  • Result Analysis: Analyze output for relevance, coherence, groundedness, and similarity scores.
  • Iterative Improvement: Apply fixes based on analysis to improve agent performance.
  • Use Case: A developer can use this Skill to evaluate and optimize their Copilot agent's performance, ensuring it meets the required quality standards for a production environment.

Quick Start

Use the m365-agent-evaluator skill to evaluate your Microsoft 365 Copilot agent with the following command:

npx -y --package @microsoft/m365-copilot-eval@latest runevals --prompts-file evals\evals.json --output .evals\results.json

Frequently Asked Questions about m365-agent-evaluator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate Microsoft 365 Copilot agents for relevance and groundedness?

You can evaluate Microsoft 365 Copilot agents by running the @microsoft/m365-copilot-eval CLI to analyze outputs for relevance, coherence, groundedness, and similarity. This requires setting up schema-compatible eval datasets to test specific agent behaviors.

What do I need to set up before testing M365 Copilot declarative agents?

Testing M365 Copilot declarative agents requires a Microsoft 365 Copilot license, a configured agent, and Azure OpenAI configuration. You also need Node.js to run the @microsoft/m365-copilot-eval CLI package for executing the evaluation suites.

Can I run multi-turn evaluations on M365 Copilot agents?

Yes, the M365 Copilot evaluation CLI supports both single-turn and multi-turn evaluations for declarative agents. It processes schema version 1.2.0 documents to simulate conversational flows and analyze iterative agent performance.

How do I create eval datasets for Microsoft 365 Copilot agent optimization?

You create eval datasets by designing schema-compatible JSON documents that define specific prompts for your declarative agents. These datasets are then passed to the evaluation CLI to measure agent behaviors across various test scenarios.

What is the best way to analyze Copilot agent evaluation results?

The best way to analyze Copilot agent evaluation results is by reviewing the generated output scores for relevance, coherence, groundedness, and similarity. You can then apply iterative fixes to your agent based on these metrics to improve production performance.

Why does my M365 Copilot agent evaluation require Azure OpenAI?

M365 Copilot agent evaluation requires Azure OpenAI configuration to process and score the groundedness and similarity of generated responses. This setup ensures the evaluation CLI can accurately measure agent performance against expected behaviors.