pnp / pnp/copilot-pro-dev-samples

Declarative agent manifest 1.6 feature code samples

Open
#102 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
No language data
Stars
162
Forks
82
PR merge metrics
No merged PRs in 30d

Description

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
  1. Enable unrestricted web search
  2. Restrict web search to specific sites
OneDrive and SharePoint Samples
  1. Enable OneDrive and SharePoint search (all content)
  2. Scope SharePoint search by URL
  3. Scope SharePoint search by IDs
  4. Include SharePoint HubSite associated sites
  5. Scope SharePoint search to a OneNote page
Copilot Connectors (Graph Connectors) Samples
  1. Enable all Copilot connectors
  2. Scope Copilot connectors by connection ID
  3. Filter Copilot connector items with KQL
  4. Scope Copilot connector items by external ID
  5. Scope Copilot connector items by path
  6. Scope Copilot connector items by container name
  7. Scope Copilot connector items by container URL
Graphic Art Samples
  1. Enable image generation
Code Interpreter Samples
  1. Enable code interpreter
Dataverse Samples
  1. Enable Dataverse search
  2. Scope Dataverse search to specific tables
Microsoft Teams Messages Samples
  1. Enable Teams messages search (all content)
  2. Scope Teams messages to specific channels
  3. Scope Teams messages to a meeting chat
  4. Scope Teams messages to a group chat
Email Samples
  1. Enable email search
  2. Enable shared mailbox search
  3. Enable group mailbox search
  4. Scope email search to specific folders
People Samples
  1. Enable people search
  2. Enable people search with related content
Scenario Models Samples
  1. Enable task-specific models
Meetings Samples
  1. Enable meetings search
  2. Scope meetings to specific meeting by ID
  3. Scope meetings to a meeting series
Embedded Knowledge Samples (New in 1.6)
  1. Add embedded knowledge files
Conversation Starters Samples
  1. Add a single conversation starter
  2. Add multiple conversation starters
  3. Add conversation starters with titles
Actions Samples
  1. Add a single API plugin action
  2. Add multiple API plugin actions
Behavior Overrides Samples
  1. Disable suggestions feature
  2. Discourage model knowledge in responses
Disclaimer Samples
  1. Add a disclaimer to the agent
Sensitivity Label Samples (New in 1.6)
  1. Add a sensitivity label to the agent
Worker Agents Samples (New in 1.6)
  1. Connect to another declarative agent as a worker agent
User Overrides Samples (New in 1.6)
  1. Allow users to remove OneDrive/SharePoint sources
  2. Allow users to remove Copilot connector sources
  3. Allow users to remove email sources
Combined Samples
  1. Create an agent with multiple capabilities
API Plugin Manifest 2.4 Samples
  1. Enable API plugin authentication
  2. Add custom authorization flow
  3. Define API endpoints with OpenAPI 3.0 schema
  4. Limit operations by allowed scopes
  5. Add required headers for plugin requests
  6. Utilize session parameters in manifest
  7. Implement dynamic endpoint URL substitution
  8. Add custom branding (logo, color, publisher)
  9. Localize API plugin metadata
  10. Add privacy policy and terms of service URLs
  11. Enable plugin for tenant/organization-only use
  12. Provide sample for plugin manifest version upgrade

Reference:


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.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the linked declarative agent manifest 1.6 and API Plugin Manifest 2.4 references; no repository files or tests are named. Organize standalone samples for the checklist, with each capability demonstrated and documented, and keep them maintainable as the schemas change.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi
Domain
content, documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.