When to use declarative agents
Here, we explain how to decide whether a declarative agent is the right choice to customize Microsoft 365 Copilot. We list some criteria that indicate whether declarative agents meet your objectives.
Decision Criteria
Declarative agents help you extend Microsoft 365 Copilot with agents tailored to specific scenarios without requiring much code. Cases where declarative agents are not the best choice generally involve the need for additional customization and flexibility offered by the platform.
| Factor | Description |
|---|---|
| Scenario | The key question to ask when considering declarative agents is: “Do I have a specific topic or task I want to optimize?” Declarative agents work well when you know the scenario you want to optimize. |
| Orchestrator and Model | Declarative agents use the same orchestrator and model as Microsoft 365 Copilot. Reusing the existing infrastructure and controls provides a consistent experience for end users. If you need a custom orchestrator and/or a different large language model, then a declarative agent is not an option; you should consider creating a custom engine agent. |
| Data Sources | The next consideration concerns data sources. Declarative agents work well when the information relevant to your scenario is available in Microsoft 365. If you need to integrate data into Microsoft 365 from an external system, you can use a Copilot connector. If you need to interact with external systems in real time, you can use a custom action. |
Applying the Criteria
Declarative agents work best when you want to reuse the same orchestrator and base model as Microsoft 365 Copilot.
Our fictional IT support team needed a way for employees to find answers to common IT support questions and create tickets if they couldn’t find the necessary answers.
Our goal was to decide whether this scenario was suitable for a declarative agent. To make our decision, we need to analyze each task using the four criteria we defined: scenario, orchestrator and model, and data sources.
- Do we know the scenario we want to optimize? Yes. Self-service for employee IT support.
- Do we need a custom orchestrator and model? No. The Microsoft 365 Copilot orchestrator and model can summarize and transform information from documents.
- Do we know the reliable data sources? Yes. We know that knowledge base articles are stored as PDFs in SharePoint Online. Although ticket system data is not stored in Microsoft 365, we can create a custom action to interact with that system.
A declarative agent is a good choice for our fictional IT support team. A declarative agent is appropriate if we know:
- the scenario we are optimizing,
- that the orchestrator and model provided by Microsoft 365 Copilot are suitable for the task,
- and that the grounding data is already in Microsoft 365.
Summary of Recommendations
The following diagram summarizes the key questions to ask when considering using declarative agents.
