+ Total Samples
+{total}
+![\"Adaptive](\"assets/AdaptiveCardsDialogBox.gif\")
\n\n## Version history\n\nVersion|Date|Author|Comments\n-------|----|----|--------\n1.0|April 15, 2026|[YugalPradhan31](https://github.com/YugalPradhan31)|Initial release\n\n## Prerequisites\n\n* [Microsoft 365 account with Copilot access](https://www.microsoft.com/microsoft-365/enterprise/copilot-for-microsoft-365)\n* [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)\n* [Azure Functions Core Tools v4](https://learn.microsoft.com/azure/azure-functions/functions-run-tools)\n* [Visual Studio 2022](https://aka.ms/vs) 17.11 or higher\n* [Microsoft 365 Agents Toolkit for Visual Studio](https://aka.ms/install-teams-toolkit-vs)\n\n## Minimal Path to Awesome\n\n* Clone this repository (or download this solution as a .ZIP file then unzip it)\n ```bash\n git clone https://github.com/pnp/copilot-pro-dev-samples.git\n cd copilot-pro-dev-samples/samples/da-adaptive-card-dialog-csharp\n ```\n* Open **AdaptiveCardDialog.slnx** in Visual Studio 2022\n* In the debug dropdown menu, select **Dev Tunnels > Create a Tunnel** (set authentication type to Public) or select an existing public dev tunnel\n* Right-click the **M365Agent** project in Solution Explorer and select **Microsoft 365 Agents Toolkit > Select Microsoft 365 Account**\n* Sign in to Microsoft 365 Agents Toolkit with a **Microsoft 365 work or school account**\n* Press **F5**, or select **Debug > Start Debugging** in Visual Studio to start your app\n* When the browser launches, open the **Copilot** app, select the agent, and start asking questions like:\n - \"Show me programming tutorials\"\n - \"I want to learn JavaScript\"\n - \"Git tutorials for beginners\"\n* The agent will respond with programming tutorials and you can interact with action buttons:\n - **Watch Video** - Opens YouTube embed in a large dialog\n - **Interactive Quiz** - Opens custom HTML quiz with instant feedback\n\n> **Note:** Please make sure to switch to New Teams when Teams web client has launched.\n\n## Features\n\nThis sample illustrates the following concepts for Microsoft 365 Copilot declarative agents:\n\n* **Action.OpenUrlDialog** - Opens URLs in modal dialogs within Microsoft 365 Copilot without leaving the chat interface\n\n### What is Action.OpenUrlDialog?\n\n`Action.OpenUrlDialog` is a new Adaptive Card action (v1.5+) that opens a URL in a modal dialog within Microsoft 365 Copilot, providing an integrated experience without leaving the chat interface.\n\n**Key Characteristics:**\n- Opens URLs in modal dialogs within Copilot\n- Supports custom dialog sizes (width/height in px or predefined: small, medium, large)\n- Requires URLs to be whitelisted in `validDomains` in manifest.json\n- Works with YouTube embeds, custom HTML pages, and other web content\n\n### Interaction Flow\n\n**Step 1: Ask for tutorials**\n```\nUser: \"Show me programming tutorials\"\n```\n\n**Step 2: Browse learning resources**\nThe agent returns adaptive cards showing:\n- Topic name (Node.js, JavaScript, Git)\n- Difficulty level and duration\n- Description\n- Two action buttons\n\n**Step 3: Watch Video**\nClick \"Watch Video\" button:\n- Opens YouTube embed in a large dialog\n- Shows official Microsoft tutorial videos\n- Supports fullscreen playback\n\n**Step 4: Take Interactive Quiz**\nClick \"Interactive Quiz\" button:\n- Opens custom HTML quiz in dialog\n- 3 questions with multiple choice options\n- Instant feedback with explanations\n- Progress bar showing completion\n- Final score and key takeaways\n- Option to retake quiz\n\n## Help\n\nWe 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.\n\nYou can try looking at [issues related to this sample](https://github.com/pnp/copilot-pro-dev-samples/issues?q=label%3A%22sample%3A%20da-adaptive-card-dialog-csharp%22) to see if anybody else is having the same issues.\n\nIf you encounter any issues using this sample, [create a new issue](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\nFinally, if you have an idea for improvement, [make a suggestion](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\n## Disclaimer\n\n**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.**\n\n## Further reading\n\n- [Action.OpenUrlDialog Documentation](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/adaptive-card-dialog-box)\n- [Build declarative agents for Microsoft 365 Copilot](https://learn.microsoft.com/microsoft-365-copilot/extensibility/overview-declarative-agent)\n- [Adaptive Cards Schema Explorer](https://adaptivecards.io/explorer/)\n- [API Plugins for Microsoft 365 Copilot](https://learn.microsoft.com/microsoft-365-copilot/extensibility/overview-api-plugins)\n- [Declarative agents for Microsoft 365](https://aka.ms/teams-toolkit-declarative-agent)\n\n\n\n\n## Version history\n\nVersion|Date|Author|Comments\n-------|----|----|--------\n1.0|January 6, 2026|Microsoft|Initial release\n\n## Prerequisites\n\n* [Microsoft 365 account with Copilot access](https://www.microsoft.com/microsoft-365/enterprise/copilot-for-microsoft-365)\n* [Node.js](https://nodejs.org) version 18.x, 20.x, or 22.x\n* [Visual Studio Code](https://code.visualstudio.com/)\n* [Microsoft 365 Agents Toolkit for VS Code](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension)\n* [Dev tunnels CLI](https://learn.microsoft.com/azure/developer/dev-tunnels/get-started) for local development\n\n## Minimal Path to Awesome\n\n* Clone this repository (or download this solution as a .ZIP file then unzip it)\n ```bash\n git clone https://github.com/pnp/copilot-pro-dev-samples.git\n cd copilot-pro-dev-samples/samples/da-adaptive-card-dialog-js\n ```\n* Open the project in Visual Studio Code\n* Select the **Microsoft 365 Agents Toolkit** icon on the left in the VS Code toolbar\n* In the **Account** section, sign in with your Microsoft 365 account if you haven't already\n* Create Teams app by selecting **Provision** in the **Lifecycle** section\n* Select **Preview in Copilot (Edge)** or **Preview in Copilot (Chrome)** from the launch configuration dropdown, or use **Debug in Microsoft 365 Agents Playground** for local testing\n* Once the agent is loaded, you can ask questions like:\n - \"Show me programming tutorials\"\n - \"I want to learn JavaScript\"\n - \"Git tutorials for beginners\"\n* The agent will respond with programming tutorials and you can interact with action buttons:\n - **Watch Video** - Opens YouTube embed in a large dialog\n - **Interactive Quiz** - Opens custom HTML quiz with instant feedback\n\n## Features\n\nThis sample illustrates the following concepts for Microsoft 365 Copilot declarative agents:\n\n* **Action.OpenUrlDialog** - Opens URLs in modal dialogs within Microsoft 365 Copilot without leaving the chat interface\n\n### What is Action.OpenUrlDialog?\n\n`Action.OpenUrlDialog` is a new Adaptive Card action (v1.5+) that opens a URL in a modal dialog within Microsoft 365 Copilot, providing an integrated experience without leaving the chat interface.\n\n**Key Characteristics:**\n- Opens URLs in modal dialogs within Copilot\n- Supports custom dialog sizes (width/height in px or predefined: small, medium, large)\n- Requires URLs to be whitelisted in `validDomains` in manifest.json\n- Works with YouTube embeds, custom HTML pages, and other web content\n\n### Interaction Flow\n\n**Step 1: Ask for tutorials**\n```\nUser: \"Show me programming tutorials\"\n```\n\n**Step 2: Browse learning resources**\nThe agent returns adaptive cards showing:\n- Topic name (Node.js, JavaScript, Git)\n- Difficulty level and duration\n- Description\n- Two action buttons\n\n**Step 3: Watch Video**\nClick \"Watch Video\" button:\n- Opens YouTube embed in a large dialog\n- Shows official Microsoft tutorial videos\n- Supports fullscreen playback\n\n**Step 4: Take Interactive Quiz**\nClick \"Interactive Quiz\" button:\n- Opens custom HTML quiz in dialog (700px height)\n- 3 questions with multiple choice options\n- Instant feedback with explanations\n- Progress bar showing completion\n- Final score and key takeaways\n- Option to retake quiz\n\n\n## Help\n\nWe 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.\n\nYou can try looking at [issues related to this sample](https://github.com/pnp/copilot-pro-dev-samples/issues?q=label%3A%22sample%3A%20da-adaptive-card-dialog-js%22) to see if anybody else is having the same issues.\n\nIf you encounter any issues using this sample, [create a new issue](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\nFinally, if you have an idea for improvement, [make a suggestion](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\n\n## Disclaimer\n\n**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.**\n\n\n## Further reading\n\n- [Action.OpenUrlDialog Documentation](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/adaptive-card-dialog-box)\n- [Build declarative agents for Microsoft 365 Copilot](https://learn.microsoft.com/microsoft-365-copilot/extensibility/overview-declarative-agent)\n- [Adaptive Cards Schema Explorer](https://adaptivecards.io/explorer/)\n- [API Plugins for Microsoft 365 Copilot](https://learn.microsoft.com/microsoft-365-copilot/extensibility/overview-api-plugins)\n\n\n\n\n## Version history\n\nVersion|Date|Author|Comments\n-------|----|----|--------\n1.0|April 20, 2026|[YugalPradhan31](https://github.com/YugalPradhan31)|Initial release\n\n## Prerequisites\n\n* [Microsoft 365 account with Copilot access](https://www.microsoft.com/microsoft-365/enterprise/copilot-for-microsoft-365)\n* [Python](https://www.python.org/downloads/) version 3.10 or later\n* [Azure Functions Core Tools](https://learn.microsoft.com/azure/azure-functions/functions-run-local) v4\n* [Visual Studio Code](https://code.visualstudio.com/)\n* [Microsoft 365 Agents Toolkit for VS Code](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension)\n* [Dev tunnels CLI](https://learn.microsoft.com/azure/developer/dev-tunnels/get-started) for local development\n\n## Minimal Path to Awesome\n\n* Clone this repository (or download this solution as a .ZIP file then unzip it)\n ```bash\n git clone https://github.com/pnp/copilot-pro-dev-samples.git\n cd copilot-pro-dev-samples/samples/da-adaptive-card-dialog-python\n ```\n* Open the project in Visual Studio Code\n* Select the **Microsoft 365 Agents Toolkit** icon on the left in the VS Code toolbar\n* In the **Account** section, sign in with your Microsoft 365 account if you haven't already\n* Install Python dependencies:\n ```bash\n pip install -r requirements.txt\n ```\n* Create Teams app by selecting **Provision** in the **Lifecycle** section\n* Select **Preview in Copilot (Edge)** or **Preview in Copilot (Chrome)** from the launch configuration dropdown, or use **Debug in Microsoft 365 Agents Playground** for local testing\n* Once the agent is loaded, you can ask questions like:\n - \"Show me programming tutorials\"\n - \"I want to learn JavaScript\"\n - \"Git tutorials for beginners\"\n* The agent will respond with programming tutorials and you can interact with action buttons:\n - **Watch Video** - Opens YouTube embed in a large dialog\n - **Interactive Quiz** - Opens custom HTML quiz with instant feedback\n\n## Features\n\nThis sample illustrates the following concepts for Microsoft 365 Copilot declarative agents:\n\n* **Action.OpenUrlDialog** - Opens URLs in modal dialogs within Microsoft 365 Copilot without leaving the chat interface\n\n### What is Action.OpenUrlDialog?\n\n`Action.OpenUrlDialog` is a new Adaptive Card action (v1.5+) that opens a URL in a modal dialog within Microsoft 365 Copilot, providing an integrated experience without leaving the chat interface.\n\n**Key Characteristics:**\n- Opens URLs in modal dialogs within Copilot\n- Supports custom dialog sizes (width/height in px or predefined: small, medium, large)\n- Requires URLs to be whitelisted in `validDomains` in manifest.json\n- Works with YouTube embeds, custom HTML pages, and other web content\n\n### Interaction Flow\n\n**Step 1: Ask for tutorials**\n```\nUser: \"Show me programming tutorials\"\n```\n\n**Step 2: Browse learning resources**\nThe agent returns adaptive cards showing:\n- Topic name (Node.js, JavaScript, Git)\n- Difficulty level and duration\n- Description\n- Two action buttons\n\n**Step 3: Watch Video**\nClick \"Watch Video\" button:\n- Opens YouTube embed in a large dialog\n- Shows official Microsoft tutorial videos\n- Supports fullscreen playback\n\n**Step 4: Take Interactive Quiz**\nClick \"Interactive Quiz\" button:\n- Opens custom HTML quiz in dialog (800px height)\n- 3 questions with multiple choice options\n- Instant feedback with explanations\n- Progress bar showing completion\n- Final score and key takeaways\n- Option to retake quiz\n\n\n## Help\n\nWe 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.\n\nYou can try looking at [issues related to this sample](https://github.com/pnp/copilot-pro-dev-samples/issues?q=label%3A%22sample%3A%20da-adaptive-card-dialog-python%22) to see if anybody else is having the same issues.\n\nIf you encounter any issues using this sample, [create a new issue](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\nFinally, if you have an idea for improvement, [make a suggestion](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\n\n## Disclaimer\n\n**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.**\n\n\n## Further reading\n\n- [Action.OpenUrlDialog Documentation](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/adaptive-card-dialog-box)\n- [Build declarative agents for Microsoft 365 Copilot](https://learn.microsoft.com/microsoft-365-copilot/extensibility/overview-declarative-agent)\n- [Adaptive Cards Schema Explorer](https://adaptivecards.io/explorer/)\n- [API Plugins for Microsoft 365 Copilot](https://learn.microsoft.com/microsoft-365-copilot/extensibility/overview-api-plugins)\n\n![\"Adaptive](\"assets/AdaptiveCardsInlineEdit.gif\")
\n\n## Prerequisites\n\n* [Microsoft 365 account with Copilot access](https://www.microsoft.com/microsoft-365/enterprise/copilot-for-microsoft-365)\n* [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)\n* [Azure Functions Core Tools v4](https://learn.microsoft.com/azure/azure-functions/functions-run-tools)\n* [Visual Studio 2022](https://aka.ms/vs) 17.11 or higher\n* [Microsoft 365 Agents Toolkit for Visual Studio](https://aka.ms/install-teams-toolkit-vs)\n\n## Minimal Path to Awesome\n\n* Clone this repository (or download this solution as a .ZIP file then unzip it)\n* Open **AdaptiveCardInlineEdit.slnx** in Visual Studio\n\n### How to add your own API Key\n\n1. Open PowerShell, change the current working directory to this project root, and run:\n ```powershell\n ./M365Agent/GenerateApiKey.ps1\n ```\n2. The above command will output something like \"Generated a new API Key: xxx...\"\n3. Fill in API Key into `M365Agent/env/.env.*.user`:\n ```\n SECRET_API_KEY=\n\n\n## Version history\n\nVersion|Date|Author|Comments\n-------|----|----|--------\n1.0|January 20, 2026|[Harikrishnan-MSFT](https://github.com/Harikrishnan-MSFT)|Initial release\n\n## Prerequisites\n\n* [Microsoft 365 account with Copilot access](https://www.microsoft.com/microsoft-365/enterprise/copilot-for-microsoft-365)\n* [Node.js](https://nodejs.org) version 20.x or 22.x\n* [Visual Studio Code](https://code.visualstudio.com/)\n* [Microsoft 365 Agents Toolkit for VS Code](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension)\n* [Dev tunnels CLI](https://learn.microsoft.com/azure/developer/dev-tunnels/get-started) for local development\n\n## Minimal Path to Awesome\n\n* Clone this repository (or download this solution as a .ZIP file then unzip it)\n ```bash\n git clone https://github.com/pnp/copilot-pro-dev-samples.git\n cd copilot-pro-dev-samples/samples/da-adaptive-card-inline-edit-js\n ```\n* Open the project in Visual Studio Code\n* Select the **Microsoft 365 Agents Toolkit** icon on the left in the VS Code toolbar\n* In the **Account** section, sign in with your Microsoft 365 account if you haven't already\n* Create Teams app by selecting **Provision** in the **Lifecycle** section\n* Select **Preview in Copilot (Edge)** or **Preview in Copilot (Chrome)** from the launch configuration dropdown, or use **Debug in Microsoft 365 Agents Playground** for local testing\n* Once the agent is loaded, you can ask questions like:\n - \"Show repair records assigned to Issac Fielder\"\n - \"Show me all car repair records\"\n - \"List repairs assigned to Karin Blair\"\n* The agent will respond with repair records in Adaptive Cards. You can:\n - View repair details (ID, title, assignee, date)\n - Edit the **Title** and **Assigned To** fields directly in the card\n - Click the **Update** button to save changes\n - See a success confirmation with the updated values\n\n### How to add your own API Key\n\n1. Open terminal and run command `npm install` to install all dependency packages\n\n ```bash\n npm install\n ```\n\n2. After `npm install` completed, run command `npm run keygen`\n ```bash\n npm run keygen\n ```\n3. The above command will output something like \"Generated a new API Key: xxx...\"\n4. Fill in API Key into `env/.env.*.user`\n ```\n SECRET_API_KEY=\n\n\n## Version history\n\nVersion|Date|Author|Comments\n-------|----|----|--------\n1.0|April 13, 2026|[YugalPradhan31](https://github.com/YugalPradhan31)|Initial release\n\n## Prerequisites\n\n* [Microsoft 365 account with Copilot access](https://www.microsoft.com/microsoft-365/enterprise/copilot-for-microsoft-365)\n* [Python](https://www.python.org/downloads/) version 3.10 or later\n* [Azure Functions Core Tools](https://learn.microsoft.com/azure/azure-functions/functions-run-local) v4\n* [Visual Studio Code](https://code.visualstudio.com/)\n* [Microsoft 365 Agents Toolkit for VS Code](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension)\n* [Dev tunnels CLI](https://learn.microsoft.com/azure/developer/dev-tunnels/get-started) for local development\n\n## Minimal Path to Awesome\n\n* Clone this repository (or download this solution as a .ZIP file then unzip it)\n ```bash\n git clone https://github.com/pnp/copilot-pro-dev-samples.git\n cd copilot-pro-dev-samples/samples/da-adaptive-card-inline-edit-python\n ```\n* Open the project in Visual Studio Code\n* Select the **Microsoft 365 Agents Toolkit** icon on the left in the VS Code toolbar\n* In the **Account** section, sign in with your Microsoft 365 account if you haven't already\n* Create Teams app by selecting **Provision** in the **Lifecycle** section\n* Select **Preview in Copilot (Edge)** or **Preview in Copilot (Chrome)** from the launch configuration dropdown, or use **Debug in Microsoft 365 Agents Playground** for local testing\n* Once the agent is loaded, you can ask questions like:\n - \"Show repair records assigned to Issac Fielder\"\n - \"Show me all car repair records\"\n - \"List repairs assigned to Karin Blair\"\n* The agent will respond with repair records in Adaptive Cards. You can:\n - View repair details (ID, title, assignee, date)\n - Edit the **Title** and **Assigned To** fields directly in the card\n - Click the **Update** button to save changes\n - See a success confirmation with the updated values\n\n### How to add your own API Key\n\n1. Open terminal and run following command to install all dependency packages\n\n ```bash\n pip install -r requirements.txt\n ```\n\n2. After that, run command `python src/key_gen.py`\n ```bash\n python src/key_gen.py\n ```\n3. The above command will output something like \"Generated a new API Key: xxx...\"\n4. Fill in API Key into `env/.env.*.user`\n ```\n SECRET_API_KEY=- `appPackage/declarativeAgent.json` (agent configuration & sample prompts) - This file is the definition of your declarative agent
- `appPackage/manifest.json` (Teams/Outlook integration) |\n| `env` | Local environment files (.env.development, .env.local) |\n| `m365agents.yml` | Defines your DA stages & lifecycle for ATK |\n\n## MCP‑specific tips\n\n- **Discovery URL**: your MCP server’s /discover endpoint must expose JSON‑Schema for every action.\n- **Tool selection**: the run_for_functions array in ai-plugin.json limits which MCP tools your agent can call. \n\n- **Auth flows**: ATK supports both OAuth2.1 and API‑Key; you don’t need to hand‑edit auth blocks. \n\n- **Versioning**: when your MCP server schema changes, simply rerun ATK: Fetch Action from MCP to refresh your plugin file. \n\n- **Error logging**: basic request/response logs appear in the ATK console; errors bubble up in your Copilot chat. \n\n\n## Learn More\n\n- [Build Declarative Agents (official docs)](https://learn.microsoft.com/microsoft-365-copilot/extensibility/build-declarative-agents)\n\n- [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)\n\n- [Agents Toolkit guide on GitHub](https://github.com/OfficeDev/TeamsFx/wiki/Teams-Toolkit-Visual-Studio-Code-v5-Guide#overview)\n\nHappy building! \n\nWith MCP + Declarative Agents, you’ll have a turnkey path from your existing APIs to a fully operational Copilot‑powered experience. \n\n
to api.ristorante.com\n Tunnel->>Proxy: Forward to localhost:8000\n Proxy->>Tunnel: Simulated response\n Tunnel->>Copilot: Response (internet)\n```\n\n## Features\n\nThis sample illustrates the following concepts:\n\n* Building a declarative agent for Microsoft 365 Copilot with an API plugin\n* Connecting an API plugin to an anonymous API\n* Using [Dev Proxy](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/overview) to simulate a non-authenticated CRUD API locally\n* Using [dev tunnels](https://learn.microsoft.com/azure/developer/dev-tunnels/overview) to expose the local API over the internet for use with Microsoft 365 Copilot\n\n## Contributors\n\n* [Garry Trinder](https://github.com/garrytrinder)\n* [Waldek Mastykarz](https://github.com/waldekmastykarz)\n\n## Version history\n\nVersion|Date|Comments\n-------|----|--------\n1.1|June 16, 2026|Updated Dev Proxy schemas to v3.0.1\n1.0|May 14, 2026|Initial release\n\n## Prerequisites\n\n* Microsoft 365 tenant with Microsoft 365 Copilot\n* [Node.js](https://nodejs.org/)\n* [Visual Studio Code](https://code.visualstudio.com/) with the following extensions:\n * [Microsoft 365 Agents Toolkit](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension)\n * [Dev Proxy Toolkit](https://marketplace.visualstudio.com/items?itemName=garrytrinder.dev-proxy-toolkit)\n * [Dev Tunnels](https://marketplace.visualstudio.com/items?itemName=ms-devtunnels.ms-devtunnels)\n\n## Minimal path to awesome\n\n* Clone this repository (or [download this solution as a .ZIP file](https://pnp.github.io/download-partial/?url=https://github.com/pnp/copilot-pro-dev-samples/tree/main/samples/da-ristorante-api-devproxy) then unzip it)\n* Open the Microsoft 365 Agents Toolkit extension and sign in to your Microsoft 365 tenant with Microsoft 365 Copilot\n* Select **Debug in Copilot (Edge)** from the launch configuration dropdown\n\n## Testing the API\n\nYou can test the API directly using the `api.http` file included in the project root. This requires the [REST Client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) extension. With the debug session running, open the file and use the **Send Request** links above each request to test the API endpoints through the dev tunnel.\n\n> **Note:** The `api.http` file uses a `.env` symlink in the project root that points to `env/.env.local`. This symlink is created automatically when you start a debug session.\n\n## Help\n\nWe 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.\n\nYou can try looking at [issues related to this sample](https://github.com/pnp/copilot-pro-dev-samples/issues?q=label%3A%22sample%3A%20da-ristorante-api-devproxy%22) to see if anybody else is having the same issues.\n\nIf you encounter any issues using this sample, [create a new issue](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\nFinally, if you have an idea for improvement, [make a suggestion](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\n## Disclaimer\n\n**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.**\n\n
to api.ristorante.com\n Tunnel->>Proxy: Forward to localhost:8000\n Note over Proxy: Validates API key\n Proxy->>Tunnel: Simulated response\n Tunnel->>Copilot: Response (internet)\n```\n\n## Features\n\nThis sample illustrates the following concepts:\n\n* Building a declarative agent for Microsoft 365 Copilot with an API plugin\n* Connecting an API plugin to an API secured with an API key\n* Using [Dev Proxy](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/overview) to simulate a CRUD API secured with an API key locally\n* Using [dev tunnels](https://learn.microsoft.com/azure/developer/dev-tunnels/overview) to expose the local API over the internet for use with Microsoft 365 Copilot\n\n## Contributors\n\n* [Garry Trinder](https://github.com/garrytrinder)\n* [Waldek Mastykarz](https://github.com/waldekmastykarz)\n\n## Version history\n\nVersion|Date|Comments\n-------|----|--------\n1.1|June 16, 2026|Updated Dev Proxy schemas to v3.0.1\n1.0|May 14, 2026|Initial release\n\n## Prerequisites\n\n* Microsoft 365 tenant with Microsoft 365 Copilot\n* [Dev Proxy](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/overview) v3.0.1 or later\n* [Node.js](https://nodejs.org/)\n* [Visual Studio Code](https://code.visualstudio.com/) with the following extensions:\n * [Microsoft 365 Agents Toolkit](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension)\n * [Dev Proxy Toolkit](https://marketplace.visualstudio.com/items?itemName=garrytrinder.dev-proxy-toolkit)\n * [Dev Tunnels](https://marketplace.visualstudio.com/items?itemName=ms-devtunnels.ms-devtunnels)\n\n## Minimal path to awesome\n\n* Clone this repository (or [download this solution as a .ZIP file](https://pnp.github.io/download-partial/?url=https://github.com/pnp/copilot-pro-dev-samples/tree/main/samples/da-ristorante-api-devproxy-apikey) then unzip it)\n* Open the Microsoft 365 Agents Toolkit extension and sign in to your Microsoft 365 tenant with Microsoft 365 Copilot\n* Select **Debug in Copilot (Edge)** from the launch configuration dropdown\n* When prompted for the API key, enter `devproxyrules`\n\n## Testing the API\n\nYou can test the API directly using the `api.http` file included in the project root. This requires the [REST Client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) extension. With the debug session running, open the file and use the **Send Request** links above each request to test the API endpoints through the dev tunnel.\n\n> **Note:** The `api.http` file uses a `.env` symlink in the project root that points to `env/.env.local`. This symlink is created automatically when you start a debug session.\n\n## Help\n\nWe 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.\n\nYou can try looking at [issues related to this sample](https://github.com/pnp/copilot-pro-dev-samples/issues?q=label%3A%22sample%3A%20da-ristorante-api-devproxy-apikey%22) to see if anybody else is having the same issues.\n\nIf you encounter any issues using this sample, [create a new issue](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\nFinally, if you have an idea for improvement, [make a suggestion](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\n## Disclaimer\n\n**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.**\n\n
to api.ristorante.com\n Tunnel->>Proxy: Forward to localhost:8000\n Note over Proxy: Validates Entra token\n Proxy->>Tunnel: Simulated response\n Tunnel->>Copilot: Response (internet)\n```\n\n## Features\n\nThis sample illustrates the following concepts:\n\n* Building a declarative agent for Microsoft 365 Copilot with an API plugin\n* Connecting an API plugin to an API secured with Microsoft Entra ID SSO\n* Registering a Microsoft Entra SSO client in the Teams Developer Portal\n* Pre-authorizing the Microsoft enterprise token store in the Entra app registration\n* Using [Dev Proxy](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/overview) to simulate a CRUD API secured with Entra token validation locally\n* Using [dev tunnels](https://learn.microsoft.com/azure/developer/dev-tunnels/overview) to expose the local API over the internet for use with Microsoft 365 Copilot\n\n## Contributors\n\n* [Garry Trinder](https://github.com/garrytrinder)\n* [Waldek Mastykarz](https://github.com/waldekmastykarz)\n\n## Version history\n\nVersion|Date|Comments\n-------|----|--------\n1.0|June 16, 2026|Initial release\n\n## Prerequisites\n\n* Microsoft 365 tenant with Microsoft 365 Copilot\n* [Node.js](https://nodejs.org/)\n* [Visual Studio Code](https://code.visualstudio.com/) with the following extensions:\n * [Microsoft 365 Agents Toolkit](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension)\n * [Dev Proxy Toolkit](https://marketplace.visualstudio.com/items?itemName=garrytrinder.dev-proxy-toolkit)\n * [Dev Tunnels](https://marketplace.visualstudio.com/items?itemName=ms-devtunnels.ms-devtunnels)\n\n## Minimal path to awesome\n\n* Clone this repository (or [download this solution as a .ZIP file](https://pnp.github.io/download-partial/?url=https://github.com/pnp/copilot-pro-dev-samples/tree/main/samples/da-ristorante-api-devproxy-entra-sso) then unzip it)\n* Open the Microsoft 365 Agents Toolkit extension and sign in to your Microsoft 365 tenant with Microsoft 365 Copilot\n* Select **Debug in Copilot (Edge)** from the launch configuration dropdown\n\nThe provisioning step automatically registers the Entra SSO client in the Teams Developer Portal — no manual portal steps are required.\n\n## Testing the API\n\nYou can test the API directly using the `api.http` file included in the project root. This requires the [REST Client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) extension. With the debug session running, open the file and use the **Send Request** links above each request to test the API endpoints through the dev tunnel.\n\nTo generate a test token for use with the `api.http` file, run the following command:\n\n```bash\ndevproxy jwt create -n \"Dev Proxy\" -a {ENTRA_APP_CLIENT_ID} -i https://login.microsoftonline.com/{ENTRA_APP_TENANT_ID}/v2.0 -s \"api://{ENTRA_APP_CLIENT_ID}/Dishes.Read\" -s \"api://{ENTRA_APP_CLIENT_ID}/Orders.Write\"\n```\n\nReplace `{ENTRA_APP_CLIENT_ID}` and `{ENTRA_APP_TENANT_ID}` with the values from your `env/.env.local` file. Copy the generated token and paste it as the `@token` value in `api.http`.\n\n> **Note:** The `api.http` file uses a `.env` symlink in the project root that points to `env/.env.local`. This symlink is created automatically when you start a debug session.\n\n## Comparing SSO vs OAuth authentication\n\nThis sample uses **Entra ID SSO**, which differs from the [OAuth sample](../da-ristorante-api-devproxy-oauth/):\n\n| Aspect | SSO (this sample) | OAuth |\n|--------|-------------------|-------|\n| User experience | Seamless — no sign-in prompt | User prompted to sign in |\n| Token acquisition | Transparent via existing M365 session | Authorization code flow |\n| Client secret | Not required | Required |\n| Portal registration | Automated via `oauth/register` with `identityProvider: MicrosoftEntra` | Automated via `oauth/register` |\n\n## Help\n\nWe 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.\n\nYou can try looking at [issues related to this sample](https://github.com/pnp/copilot-pro-dev-samples/issues?q=label%3A%22sample%3A%20da-ristorante-api-devproxy-entra-sso%22) to see if anybody else is having the same issues.\n\nIf you encounter any issues using this sample, [create a new issue](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\nFinally, if you have an idea for improvement, [make a suggestion](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\n## Disclaimer\n\n**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.**\n\n\n" + }, + { + "folder": "da-ristorante-api-devproxy-oauth", + "title": "Browse the menu and place an order at a local Italian restaurant using Microsoft 365 Copilot, Dev Proxy and OAuth authentication", + "description": "This sample demonstrates how to build a declarative agent for Microsoft 365 Copilot that allows you to browse a menu of a local Italian restaurant and place an order. The agent uses an API plugin to connect to an API secured with OAuth. Dev Proxy is used to simulate the API.", + "type": "Declarative Agent", + "href": "https://github.com/pnp/copilot-pro-dev-samples/tree/main/samples/da-ristorante-api-devproxy-oauth", + "updatedAt": "2026-06-16T00:00:00.000Z", + "longDescription": [ + "This sample demonstrates how to build a declarative agent for Microsoft 365 Copilot that allows you to browse a menu of a local Italian restaurant and place an order. The agent uses an API plugin to connect to an API secured with OAuth. Dev Proxy is used to simulate the API." + ], + "metadata": [ + { + "key": "PLATFORM", + "value": "Dev Proxy" + }, + { + "key": "LANGUAGE", + "value": "JSON" + }, + { + "key": "API-PLUGIN", + "value": "Yes" + }, + { + "key": "GRAPH-CONNECTOR", + "value": "No" + } + ], + "imageUrl": "https://github.com/pnp/copilot-pro-dev-samples/raw/main/samples/da-ristorante-api-devproxy-oauth/assets/screenshot-menu.png", + "imageAlt": "Declarative agent showing what's on the menu for lunch", + "readmeContent": "# Browse the menu and place an order at a local Italian restaurant using Microsoft 365 Copilot, Dev Proxy and OAuth authentication\n\n## Summary\n\nThis sample demonstrates how to build a declarative agent for Microsoft 365 Copilot that allows you to browse a menu of a local Italian restaurant and place an order. The agent uses an API plugin to connect to an API secured with OAuth. [Dev Proxy](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/overview) is used to simulate the API, so you don't need to build or maintain a real backend. This is useful when the API doesn't exist yet, is owned by a third party, or you want to avoid writing code that won't ship.\n\n\n\n\n\n\n## How it works\n\nMicrosoft 365 Copilot runs in the cloud and needs a publicly accessible API endpoint. Dev Proxy simulates the API on your machine, and a dev tunnel exposes it over the internet so Copilot can reach it. No API infrastructure is deployed — the simulated API runs entirely on your local machine.\n\n### OAuth authentication\n\nThis sample uses OAuth for authentication, with Microsoft Entra as the identity provider. Microsoft 365 Copilot obtains a real OAuth token from Entra and sends it with every API request. Dev Proxy does **not** replace the identity provider — it validates the real token on the API side by checking the audience, issuer, and scopes configured in the CRUD API files. This means the authentication flow between Copilot and the identity provider is identical to what you'd have in production; the only thing Dev Proxy simulates is the API itself.\n\n```mermaid\nsequenceDiagram\n participant Copilot as Microsoft 365 Copilot\n participant Entra as Microsoft Entra\n participant Tunnel as Dev Tunnel\n participant Proxy as Dev Proxy\n Copilot->>Entra: Get OAuth token\n Entra->>Copilot: Access token\n Copilot->>Tunnel: API request with token (internet)\n Note over Tunnel: Rewrites host header
to api.ristorante.com\n Tunnel->>Proxy: Forward to localhost:8000\n Note over Proxy: Validates Entra token\n Proxy->>Tunnel: Simulated response\n Tunnel->>Copilot: Response (internet)\n```\n\n## Features\n\nThis sample illustrates the following concepts:\n\n* Building a declarative agent for Microsoft 365 Copilot with an API plugin\n* Connecting an API plugin to an API secured with OAuth\n* Using [Dev Proxy](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/overview) to simulate a CRUD API secured with OAuth authentication locally\n* Using [dev tunnels](https://learn.microsoft.com/azure/developer/dev-tunnels/overview) to expose the local API over the internet for use with Microsoft 365 Copilot\n\n## Contributors\n\n* [Garry Trinder](https://github.com/garrytrinder)\n* [Waldek Mastykarz](https://github.com/waldekmastykarz)\n\n## Version history\n\nVersion|Date|Comments\n-------|----|--------\n1.2|June 16, 2026|Renamed sample from entra to oauth\n1.1|June 16, 2026|Updated Dev Proxy schemas to v3.0.1\n1.0|May 14, 2026|Initial release\n\n## Prerequisites\n\n* Microsoft 365 tenant with Microsoft 365 Copilot\n* [Node.js](https://nodejs.org/)\n* [Visual Studio Code](https://code.visualstudio.com/) with the following extensions:\n * [Microsoft 365 Agents Toolkit](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension)\n * [Dev Proxy Toolkit](https://marketplace.visualstudio.com/items?itemName=garrytrinder.dev-proxy-toolkit)\n * [Dev Tunnels](https://marketplace.visualstudio.com/items?itemName=ms-devtunnels.ms-devtunnels)\n\n## Minimal path to awesome\n\n* Clone this repository (or [download this solution as a .ZIP file](https://pnp.github.io/download-partial/?url=https://github.com/pnp/copilot-pro-dev-samples/tree/main/samples/da-ristorante-api-devproxy-oauth) then unzip it)\n* Open the Microsoft 365 Agents Toolkit extension and sign in to your Microsoft 365 tenant with Microsoft 365 Copilot\n* Select **Debug in Copilot (Edge)** from the launch configuration dropdown\n* When prompted, sign in with your Microsoft 365 account to authorize the OAuth connection\n\n## Testing the API\n\nYou can test the API directly using the `api.http` file included in the project root. This requires the [REST Client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) extension. With the debug session running, open the file and use the **Send Request** links above each request to test the API endpoints through the dev tunnel.\n\nTo generate a test token for use with the `api.http` file, run the following command:\n\n```bash\ndevproxy jwt create -n \"Dev Proxy\" -a {ENTRA_APP_CLIENT_ID} -i https://login.microsoftonline.com/{ENTRA_APP_TENANT_ID}/v2.0 -s \"api://{ENTRA_APP_CLIENT_ID}/Dishes.Read\" -s \"api://{ENTRA_APP_CLIENT_ID}/Orders.Write\"\n```\n\nReplace `{ENTRA_APP_CLIENT_ID}` and `{ENTRA_APP_TENANT_ID}` with the values from your `env/.env.local` file. Copy the generated token and paste it as the `@token` value in `api.http`.\n\n> **Note:** The `api.http` file uses a `.env` symlink in the project root that points to `env/.env.local`. This symlink is created automatically when you start a debug session.\n\n## Help\n\nWe 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.\n\nYou can try looking at [issues related to this sample](https://github.com/pnp/copilot-pro-dev-samples/issues?q=label%3A%22sample%3A%20da-ristorante-api-devproxy-oauth%22) to see if anybody else is having the same issues.\n\nIf you encounter any issues using this sample, [create a new issue](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\nFinally, if you have an idea for improvement, [make a suggestion](https://github.com/pnp/copilot-pro-dev-samples/issues/new).\n\n## Disclaimer\n\n**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.**\n\n
+
+
+ {
+ samples.length > 0 ? (
+
+
+ View Full Catalog
+ Recent Activity
+Latest Samples
+
+ {samples.map((sample) => (
+
+
+ ) : (
+ {sample.type}
+ {sample.title}
+{sample.description}
++ Updated: {sample.updatedAt ? sample.updatedAt.toLocaleDateString("en-US", { year: "numeric", month: "short", day: "numeric" }) : "Unknown"} +
+ View sample details + + ))} +
+ No samples are available.
+
+ )
+ }
+
+
+
+ Sample Browser
++ Filter by type and search by title, folder, or description. +
+ +
+
+
+
+
+ {sortedTypes.map((type) => (
+
+ ))}
+
+
+ {samples.map((sample) => (
+
+
+
+ {sample.type}
+
+ {sample.title}
+{sample.description}
+Folder: {sample.folder}
+
+ Last updated: {sample.updatedAt ? sample.updatedAt.toLocaleDateString("en-US", { year: "numeric", month: "short", day: "numeric" }) : "Unknown"}
+
+ View sample details
+
+ ))}
+
+
+
+
+ Contributing
+Contribute a sample to this repository
++ This repository accepts community Microsoft 365 Copilot sample submissions. Follow the contribution guidance to submit + one focused pull request at a time, using the required sample structure and documentation. +
+
+
+
+
+
+
+
+ Type Breakdown
+
+ {types.map(([name, count]) => (
+
+ {name}: {count}
+
+ ))}
+
+
+
+
+ Contribution Checklist
+
+ {contributionCards.map((item) => (
+
+
+ ))}
+
+
+
+
+ {item.title}
+{item.description}
+
+
+ Pull Request Flow
+
+ {prFlowCards.map((item) => (
+
+
+ ))}
+
+ {item.step}
+{item.title}
+{item.description}
++ This page is based on the repository guidance in CONTRIBUTING.md. Refer to that file for complete, authoritative details. +
+
+
+
+ Open Source Agent Catalog
++ Explore beyond the + hello world. +
++ Browse real Microsoft 365 Copilot samples by agent type, scan metadata quickly, and jump directly into source folders. +
+ +
+
+ Quick Stats
+
+
+ Total Samples
+{total}
+
+ {typeBreakdown.map(([name, count]) => (
+
+ {name}: {count}
+
+ ))}
+
+ Catalog
+Browse {total} community samples
++ Search by keyword and narrow by sample type to quickly reach the implementation you need. +
+
+
+
+ {
+ sample.imageUrl ? (
+ {sample.type}
+{sample.title}
+{sample.description}
+
+ 
+
+ ) : (
+
+ No image available for this sample.
+
+ )
+ }
+
+
+
+
+
+
+ Details
+
+ {details.map((line) => (
+
+ {line}
+ ))} +
+
+ Open source folder
+
+
+
+
+
+
+
+
+
+ ) : (
+
+ README
+ { + hasReadme ? ( +No README content available for this sample.
+ ) + } +