Copilot Pro Dev Samples
Back to samples

Declarative Agent

Declarative for Microsoft 365 Copilot with an API plugin connected to an API secured with OAuth

This sample demonstrates how to build a declarative agent for Microsoft 365 Copilot that answers questions about repairs. The agent uses an API plugin to connect to an API secured with OAuth. The project contains an Azure Function that serves as the API and uses the built-in Azure App Service authentication and authorization capabilities (also referred to as Easy Auth) to secure access to APIs.

Yugal Pradhan
Open source folder Download sample
Declarative agent answering questions about repairs using the information from an API secured with OAuth
Sample type
Declarative Agent
Last updated
Contributors
1
License
MIT

About this sample

This sample demonstrates how to build a declarative agent for Microsoft 365 Copilot that answers questions about repairs. The agent uses an API plugin to connect to an API secured with OAuth. The project contains an Azure Function that serves as the API and uses the built-in Azure App Service authentication and authorization capabilities (also referred to as Easy Auth) to secure access to APIs.

PLATFORM
.NET
LANGUAGE
C#
API-PLUGIN
Yes
GRAPH-CONNECTOR
No

Setup and usage

Sample documentation

Summary

This sample demonstrates how to build a declarative agent for Microsoft 365 Copilot that answers questions about repairs. The agent uses an API plugin to connect to an API secured with OAuth. The project contains an Azure Function written in C# (.NET isolated worker) that serves as the API and uses the built-in Azure App Service authentication and authorization capabilities (Easy Auth) to secure access to APIs.

Declarative agent answering questions about repairs using the information from an API secured with OAuth

Contributors

Version history

Version Date Comments
1.0 May 21, 2026 C# conversion of da-repairs-oauth-js sample

Prerequisites

Minimal path to awesome

  • Clone this repository (or download this solution as a .ZIP file then unzip it)
  • Open DaRepairsOAuth.slnx in Visual Studio 2022
  • In the debug dropdown menu, select Dev Tunnels > Create a Tunnel (set authentication type to Public) or select an existing public dev tunnel
  • Right-click the M365Agent project in Solution Explorer and select Microsoft 365 Agents Toolkit > Select Microsoft 365 Account
  • Sign in to Microsoft 365 Agents Toolkit with a Microsoft 365 work or school account
  • Press F5, or select Debug > Start Debugging in Visual Studio to start your app
  • In Copilot, ask for example prompts:
    • "List all repairs"
    • "Show repair records assigned to Karin Blair"

Features

This sample illustrates the following concepts:

  • Building a declarative agent for Microsoft 365 Copilot with an API plugin
  • Connecting an API plugin to an API secured with OAuth
  • Using Azure Functions (.NET isolated, C#) to build an API secured with Azure App Service authentication and authorization (Easy Auth)
  • Using dev tunnels to test the API plugin locally

Help

We do not support samples, but this community is always willing to help, and we want to improve these samples. We use GitHub to track issues, which makes it easy for community members to volunteer their time and help resolve issues.

You can try looking at issues related to this sample to see if anybody else is having the same issues.

If you encounter any issues using this sample, create a new issue.

Finally, if you have an idea for improvement, make a suggestion.

Disclaimer

THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.