Tech Hub

@ Solution Architecture Works

MS-4010 – Extend Microsoft 365 Copilot with declarative agents using Visual Studio Code

When to use declarative agents

Estimated reading: 3 minutes 14 views

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.

FactorDescription
ScenarioThe 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 ModelDeclarative 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 SourcesThe 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.

Next unit: Module Evaluation

Share this Doc

When to use declarative agents

Or copy link

CONTENTS