Declarative agent manifest 1.6 feature code samples

[garrytrinder]

Create and maintain a set of atomic 'How-to' code samples demonstrating each capability offered by the declarative agent manifest 1.6 for Microsoft 365 Copilot.

Goal:

• For every core capability and property in the manifest schema (e.g., WebSearch, OneDriveAndSharePoint, GraphConnectors, etc.), create a separate sample demonstrating its usage.
• Each sample should act as a standalone, instructive example showcasing the relevant manifest object, settings, and fields required to enable that capability.
• The samples should focus on technical demonstration for reference, not business scenarios.

Initial tasks:

• Create sample manifests covering each object or schema feature:
  • Core manifest structure (basic agent, name, description, instructions)
  • Every Capability (WebSearch, OneDriveAndSharePoint, GraphConnectors, etc.)
  • Embedded Knowledge object
  • Conversation Starters, Behavior Overrides, Disclaimer, Sensitivity Label, Worker Agents, User Overrides
  • Action plugins
  • API Plugin Capabilities (based on API Plugin Manifest 2.4)
• Document and organize each sample for clarity and reuse.

---

Samples Checklist

Core Manifest Samples

1. Create a basic declarative agent (minimal manifest)
2. Add an identifier to your agent (id property)
3. Add localized strings to your agent

Web Search Samples

4. Enable unrestricted web search
5. Restrict web search to specific sites

OneDrive and SharePoint Samples

6. Enable OneDrive and SharePoint search (all content)
7. Scope SharePoint search by URL
8. Scope SharePoint search by IDs
9. Include SharePoint HubSite associated sites
10. Scope SharePoint search to a OneNote page

Copilot Connectors (Graph Connectors) Samples

11. Enable all Copilot connectors
12. Scope Copilot connectors by connection ID
13. Filter Copilot connector items with KQL
14. Scope Copilot connector items by external ID
15. Scope Copilot connector items by path
16. Scope Copilot connector items by container name
17. Scope Copilot connector items by container URL

Graphic Art Samples

18. Enable image generation

Code Interpreter Samples

19. Enable code interpreter

Dataverse Samples

20. Enable Dataverse search
21. Scope Dataverse search to specific tables

Microsoft Teams Messages Samples

22. Enable Teams messages search (all content)
23. Scope Teams messages to specific channels
24. Scope Teams messages to a meeting chat
25. Scope Teams messages to a group chat

Email Samples

26. Enable email search
27. Enable shared mailbox search
28. Enable group mailbox search
29. Scope email search to specific folders

People Samples

30. Enable people search
31. Enable people search with related content

Scenario Models Samples

32. Enable task-specific models

Meetings Samples

33. Enable meetings search
34. Scope meetings to specific meeting by ID
35. Scope meetings to a meeting series

Embedded Knowledge Samples (New in 1.6)

36. Add embedded knowledge files

Conversation Starters Samples

37. Add a single conversation starter
38. Add multiple conversation starters
39. Add conversation starters with titles

Actions Samples

40. Add a single API plugin action
41. Add multiple API plugin actions

Behavior Overrides Samples

42. Disable suggestions feature
43. Discourage model knowledge in responses

Disclaimer Samples

44. Add a disclaimer to the agent

Sensitivity Label Samples (New in 1.6)

45. Add a sensitivity label to the agent

Worker Agents Samples (New in 1.6)

46. Connect to another declarative agent as a worker agent

User Overrides Samples (New in 1.6)

47. Allow users to remove OneDrive/SharePoint sources
48. Allow users to remove Copilot connector sources
49. Allow users to remove email sources

Combined Samples

50. Create an agent with multiple capabilities

API Plugin Manifest 2.4 Samples

51. Enable API plugin authentication
52. Add custom authorization flow
53. Define API endpoints with OpenAPI 3.0 schema
54. Limit operations by allowed scopes
55. Add required headers for plugin requests
56. Utilize session parameters in manifest
57. Implement dynamic endpoint URL substitution
58. Add custom branding (logo, color, publisher)
59. Localize API plugin metadata
60. Add privacy policy and terms of service URLs
61. Enable plugin for tenant/organization-only use
62. Provide sample for plugin manifest version upgrade

---

Reference:

• Microsoft documentation
• Agent manifest schema on GitHub
• API Plugin Manifest documentation

---

This issue will serve as a hub to collect, discuss, and update samples work. Please comment below to coordinate division of work or to share sample contributions.

[garrytrinder]

I've been thinking about this and not sure having lots of small feature based samples would be good when this can easily be documented in official docs. Where a sample is more complex where it requires multiple files to be created/changed then that would be a good candidate for a sample. We should review the list of proposed samples and refine them down to the more complex examples.

[sebastienlevert]

This sounds a lot more like reference docs, right?