├── .acrolinx-config.edn ├── .editorconfig ├── .gitattributes ├── .github ├── ISSUE_TEMPLATE │ ├── config.yml │ └── issue-template.yml └── workflows │ └── eol-blocker.yml ├── .gitignore ├── .markdownlint.json ├── .openpublishing.publish.config.json ├── .vscode ├── extensions.json └── settings.json ├── CONTRIBUTING.md ├── LICENSE ├── LICENSE-CODE ├── README.md ├── SECURITY.md ├── ThirdPartyNotices.md ├── cspell.json ├── docs ├── TOC.yml ├── agent-builder-template-career-coach.md ├── agent-builder-template-customer-insight.md ├── agent-builder-template-idea-coach.md ├── agent-builder-template-interview-questions.md ├── agent-builder-template-learning-coach.md ├── agent-builder-template-meeting-coach.md ├── agent-builder-template-prompt-coach.md ├── agent-builder-template-quiz-tutor.md ├── agent-builder-template-scrum-assistant.md ├── agent-builder-template-writing-coach.md ├── agent-builder-templates.md ├── agents-are-apps.md ├── agents-overview.md ├── api-plugin-adaptive-cards.md ├── api-plugin-authentication.md ├── api-plugin-confirmation-prompts.md ├── api-plugin-debug-local.md ├── api-plugin-manifest-2.1.md ├── api-plugin-manifest-2.2.md ├── api-plugin-manifest-2.3.md ├── assets │ ├── diagrams │ │ └── API plugin data flow.vsdx │ ├── icons │ │ ├── copilot.svg │ │ ├── microsoft-graph.svg │ │ ├── power-platform.svg │ │ ├── teams-toolkit-sidebar-icon.png │ │ └── teams.svg │ ├── images │ │ ├── Copilot_orchestrator_sequence_v2.png │ │ ├── aad-default-client-type.png │ │ ├── agent-in-browser.png │ │ ├── agent-ux │ │ │ ├── ai-labels.png │ │ │ ├── citations.png │ │ │ ├── feedback.png │ │ │ ├── sensitivity-labels.png │ │ │ ├── streaming-response.png │ │ │ ├── suggested-prompts.png │ │ │ └── zero-prompts.png │ │ ├── agents-system-cea.png │ │ ├── agents-system-da.png │ │ ├── anatomy-agents.png │ │ ├── anatomy-m365-copilot.png │ │ ├── api-plugins │ │ │ ├── adaptive-card-citation.png │ │ │ ├── api-plugin-credit-card.png │ │ │ ├── api-plugin-data-flow.svg │ │ │ ├── api-plugin-debit-card.png │ │ │ ├── api-plugin-typespec-card.png │ │ │ ├── api-plugin-typespec-delete.png │ │ │ ├── api-plugin-typespec-get.png │ │ │ ├── api-plugin-typespec-patch.png │ │ │ ├── api-plugin-typespec-post.png │ │ │ ├── copilot-agents.png │ │ │ ├── create-plugin-ttk.png │ │ │ ├── generate-plugin-kiota.png │ │ │ ├── get-always-allow.png │ │ │ ├── post-confirm.png │ │ │ ├── provision-complete-ttk.png │ │ │ ├── select-operations-kiota.png │ │ │ └── select-operations-ttk.png │ │ ├── app-manifest-agents.png │ │ ├── app-package.png │ │ ├── atk-copilot-connectors │ │ │ ├── add-connector-id.png │ │ │ ├── admin-consent.png │ │ │ ├── choose-connector-id.png │ │ │ ├── choose-connector-name.png │ │ │ ├── copilot-output.png │ │ │ ├── create-new-app.png │ │ │ ├── env-local.png │ │ │ ├── include-connector-results.png │ │ │ ├── items-indexed.png │ │ │ ├── select-copilot-connector.png │ │ │ └── vs-code-customization-point.png │ │ ├── build-da │ │ │ ├── atk │ │ │ │ ├── copilot-agent-list.png │ │ │ │ ├── create-new-app-agent.png │ │ │ │ ├── excel-agent-copilot-confirmation.png │ │ │ │ ├── excel-agent-pane-success.png │ │ │ │ ├── excel-agent-teams-app-list.png │ │ │ │ ├── provision-agent-atk.png │ │ │ │ └── select-copilot-agent-atk.png │ │ │ └── ttk │ │ │ │ ├── agent-answer.png │ │ │ │ ├── code-interpreter-graph-content.png │ │ │ │ ├── code-interpreter-python-content.png │ │ │ │ ├── conversation-starters.png │ │ │ │ ├── create-new-app.png │ │ │ │ ├── email-content.png │ │ │ │ ├── graph-connector-content.png │ │ │ │ ├── graphic-art-content.png │ │ │ │ ├── people-content.png │ │ │ │ ├── plugin-response.png │ │ │ │ ├── provision-agent.png │ │ │ │ ├── select-agent.png │ │ │ │ ├── select-apis.png │ │ │ │ ├── select-copilot-agent.png │ │ │ │ ├── sharepoint-onedrive-content.png │ │ │ │ ├── teams-content.png │ │ │ │ ├── updated-instructions.png │ │ │ │ └── web-content.png │ │ ├── build-with-agents-sdk.png │ │ ├── build-with-teams-ai-library.png │ │ ├── capabilities-teamsChat-emails.png │ │ ├── capabilities-toggle.png │ │ ├── cea-da-decision-guide.png │ │ ├── clippy-response.png │ │ ├── clippy.png │ │ ├── code-interpreter-pet-word-cloud.png │ │ ├── code-interpreter-python-1.png │ │ ├── code-interpreter-python-2.png │ │ ├── color-icon.png │ │ ├── connectors-copilot-hover.png │ │ ├── connectors-copilot-logo.png │ │ ├── connectors-copilot-response.png │ │ ├── copilot-architecture.png │ │ ├── copilot-experiences.png │ │ ├── copilot-extensibility-diagram.png │ │ ├── copilot-stack.png │ │ ├── copilot-studio-agent-builder │ │ │ ├── embedded-authoring-auto-share.png │ │ │ ├── embedded-authoring-configure.png │ │ │ ├── embedded-authoring-copilot-connectors.png │ │ │ ├── embedded-authoring-entry.png │ │ │ ├── embedded-authoring-feedback-general.png │ │ │ ├── embedded-authoring-get-support-1-updated.png │ │ │ ├── embedded-authoring-get-support-2-updated.png │ │ │ ├── embedded-authoring-knowledge-preparing.png │ │ │ ├── embedded-authoring-last-accessed.png │ │ │ ├── embedded-authoring-sharepoint-picker-folders.png │ │ │ └── embedded-authoring-starter.png │ │ ├── custom-engine-agent.png │ │ ├── debugged-function.png │ │ ├── declarative-agent-scenarios.png │ │ ├── declarative-agent-showcase.png │ │ ├── declarative-agents │ │ │ ├── add-document-selection.png │ │ │ ├── document-selection-prompt.png │ │ │ ├── document-selection-result.png │ │ │ ├── graph-explorer-consent-to-permissions.png │ │ │ ├── graph-explorer-external-connection-permission.png │ │ │ ├── graph-explorer-get-connections.png │ │ │ ├── graph-explorer-post-query.png │ │ │ ├── graph-explorer-sign-in.png │ │ │ ├── graph-explorer-sites-permission.png │ │ │ └── image-insert.png │ │ ├── developer-mode-agent-actions.png │ │ ├── developer-mode-agent-capabilities.png │ │ ├── developer-mode-agent-executed-actions.png │ │ ├── developer-mode-agent-execution.png │ │ ├── developer-mode-agent-metadata.png │ │ ├── developer-mode-atk-F5.png │ │ ├── developer-mode-atk-actions.png │ │ ├── developer-mode-atk-capabilities.png │ │ ├── developer-mode-atk-connection.png │ │ ├── developer-mode-atk-metadata.png │ │ ├── developer-mode-feedback-message.png │ │ ├── developer-mode-feedback.png │ │ ├── developer-mode-on.png │ │ ├── enter-code.png │ │ ├── entra-portal-app-registrations.png │ │ ├── icon-actionable.png │ │ ├── icon-deep-content.png │ │ ├── icon-preview.png │ │ ├── icon-search.png │ │ ├── image-gen-beach-prompt.png │ │ ├── image-gen-flier-prompt.png │ │ ├── instruction-api-plugins-h-2.png │ │ ├── instruction-components.png │ │ ├── instruction-process.png │ │ ├── jupyter-output.png │ │ ├── knowledge-picker-agent-builder.png │ │ ├── knowledge-picker-agent-builder2.png │ │ ├── loc-manifest.png │ │ ├── m365-extensibility-types.png │ │ ├── mac-integrated-apps.png │ │ ├── message-extensions-ux.png │ │ ├── microsoft-365-and-copilot-program.png │ │ ├── outline-icon.png │ │ ├── personas-build-custom-ai-apps.png │ │ ├── personas-extend-copilot.png │ │ ├── skills-knowledge-chart.png │ │ ├── tac-setup-policies.png │ │ └── validation-principles.png │ ├── scripts │ │ ├── GetGraphConnectorIds.ps1 │ │ └── GetSharePointIds.ps1 │ └── snippets │ │ └── sharepoint-id-query-response.json ├── breadcrumb │ └── toc.yml ├── bring-agents-to-copilot.md ├── build-api-plugins-existing-api.md ├── build-api-plugins-local-office-api.md ├── build-api-plugins-new-api.md ├── build-api-plugins-typespec.md ├── build-declarative-agents-typespec.md ├── build-declarative-agents.yml ├── build-your-first-connector.md ├── code-interpreter.md ├── context.yml ├── copilot-apis-overview.md ├── copilot-studio-agent-builder-availability.md ├── copilot-studio-agent-builder-build.md ├── copilot-studio-agent-builder-publish.md ├── copilot-studio-agent-builder.md ├── cost-considerations.md ├── create-deploy-agents-sdk.md ├── data-privacy-security.md ├── debugging-copilot-agent-vscode.md ├── debugging-copilot-agent.md ├── declarative-agent-capabilities-ids.md ├── declarative-agent-document-interaction.md ├── declarative-agent-instructions.md ├── declarative-agent-manifest-1.0.md ├── declarative-agent-manifest-1.2.md ├── declarative-agent-manifest-1.3.md ├── declarative-agent-manifest-1.4.md ├── declarative-agent-tool-comparison.md ├── docfx.json ├── ecosystem.md ├── faq.md ├── feedback.md ├── graph-actions-semantic-kernel.md ├── graph-api-tutorial.yml ├── image-generator.md ├── includes │ ├── agent-template-extension-note.md │ ├── agent-template-limitations.md │ ├── agent-template-prerequisites.md │ ├── api-plugins-declarative-agents-only.md │ ├── copilot-in-word-and-powerpoint.md │ ├── copilot-studio-agent-naming.md │ ├── declarative-agents-gov.md │ ├── declarative-agents-walkthrough │ │ ├── 01-intro.md │ │ ├── 02-create-agent.md │ │ ├── 03-add-instructions.md │ │ ├── 04-add-conversation-starters.md │ │ ├── 05-add-web-content.md │ │ ├── 06-add-onedrive-sharepoint.md │ │ ├── 07-add-teams-messages.md │ │ ├── 08-add-people.md │ │ ├── 09-add-email.md │ │ ├── 10-add-graphic-art.md │ │ ├── 11-add-code-interpreter.md │ │ ├── 12-add-copilot-connectors.md │ │ ├── 13-add-plugins.md │ │ ├── 14-completed.md │ │ └── posts-api.yml │ ├── graph-api-tutorial │ │ ├── 01-intro.md │ │ ├── 02-prerequisites.md │ │ ├── 03-register-app.md │ │ ├── 04-set-up-project.md │ │ ├── 05-run-agent.md │ │ ├── 06-run-personal-assistant.md │ │ ├── 07-make-standalone-app.md │ │ └── 08-completed.md │ ├── latest-declarative-agent-manifest.md │ ├── latest-plugin-manifest.md │ ├── preview-disclaimer-cea.md │ ├── preview-disclaimer-copilot-no-license.md │ ├── preview-disclaimer-declarative-agents.md │ ├── preview-disclaimer-me.md │ ├── preview-disclaimer.md │ ├── sample-manifests │ │ ├── declarative-agent-sample-manifest-1.0.json │ │ ├── declarative-agent-sample-manifest-1.2.json │ │ ├── declarative-agent-sample-manifest-1.3.json │ │ ├── declarative-agent-sample-manifest-1.4.json │ │ ├── plugin-sample-manifest-2.1.json │ │ ├── plugin-sample-manifest-2.2.json │ │ └── plugin-sample-manifest-2.3.json │ ├── security-on-das-note.md │ └── toolkit-version-note.md ├── index.md ├── instructions-api-plugins.md ├── knowledge-sources.md ├── known-issues.md ├── localize-agents.md ├── m365-agents-sdk.md ├── manage.md ├── openapi-document-guidance.md ├── optimize-sharepoint-content.md ├── orchestrator.md ├── overview-api-plugins.md ├── overview-business-applications.md ├── overview-copilot-connector.md ├── overview-custom-engine-agent.md ├── overview-declarative-agent.md ├── overview-message-extension-bot.md ├── planning-guide.md ├── plugin-guidelines.md ├── prerequisites.md ├── publish.md ├── rai-validation.md ├── samples.md ├── teams-ai-library.md ├── transparency-faq-declarative-agent.md ├── ux-custom-engine-agent.md ├── whats-new-history.md └── whats-new.md ├── redirects ├── .openpublishing.redirection.december-2024.json ├── .openpublishing.redirection.march-2025.json ├── .openpublishing.redirection.may-2025.json ├── .openpublishing.redirection.november-2024.json └── .openpublishing.redirection.september-2024.json └── scripts └── CleanupUnusedImages.ps1 /.acrolinx-config.edn: -------------------------------------------------------------------------------- 1 | { 2 | :allowed-branchname-matches ["main" "live" "build.*"] 3 | :allowed-filename-matches ["(?i)(?!(^.*/p|^p)osts-api\\.yml$|(^.*/r|^r)eadme\\.md$)^docs/.*$"] ;; Can be overridden in repo-specific edn file. This is an allow list that identifies which folders contain the files Acrolinx will check. Separate multiple folders as follows ["folder/" "folder2"] 4 | 5 | :use-gh-statuses true 6 | 7 | :targets 8 | { 9 | :counts { 10 | ;;:spelling 10 11 | ;;:grammar 3 12 | ;;:total 15 ;; absolute flag count but i don't know the difference between this and issues 13 | ;;:issues 15 ;; coming from the platform, will need to be tested. 14 | } 15 | :scores { 16 | ;;:terminology 100 17 | :qualityscore 80 ;; Remove the ;; to turn on the min score. Set 80 to whatever min score client wants (eventually should be 80) and leave the structure in place 18 | ;;:spelling 40 19 | } 20 | } 21 | 22 | :guidance-profile "d2b6c2c8-00ee-47f1-8d10-b280cc3434c1" ;; Profile ID for "M365-specific" 23 | 24 | :template-header 25 | 26 | " 27 | 28 | ## Acrolinx Scorecards 29 | 30 | **A minimum Acrolinx score of 80 is required.** 31 | 32 | Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology. 33 | 34 | | Article | Score | Issues | Correctness
score | Scorecard | Processed | 35 | | ------- | ----- | ------ | -------------------- | --------- | --------- | 36 | " 37 | 38 | :template-change ;; Can be overriden in repo-specific edn file. This displays in the pull request results pane. 39 | "| ${s/file} | ${acrolinx/qualityscore} | ${acrolinx/flags/issues} | ${acrolinx/scores/correctness} | [link](${acrolinx/scorecard}) | ${s/status} | 40 | " 41 | 42 | :template-footer ;; Can be overriden in repo-specific edn file. This displays in the pull request results pane. 43 | " 44 | **More information about Acrolinx** 45 | 46 | - [Use the Visual Studio Code extension to run Acrolinx locally](https://review.learn.microsoft.com/office-authoring-guide/acrolinx-vscode?branch=main) 47 | - [False positives or issues](https://aka.ms/acrolinxbug) 48 | - [Troubleshooting issues with Acrolinx](https://review.learn.microsoft.com/help/contribute/acrolinx-error-messages) 49 | 50 | " 51 | } 52 | -------------------------------------------------------------------------------- /.editorconfig: -------------------------------------------------------------------------------- 1 | [*] 2 | indent_style = space 3 | indent_size = 2 4 | insert_final_newline = true 5 | -------------------------------------------------------------------------------- /.gitattributes: -------------------------------------------------------------------------------- 1 | # Set the default behavior, in case people don't have core.autocrlf set. 2 | * text=auto 3 | 4 | # Explicitly declare text files you want to always be normalized and converted 5 | # to native line endings on checkout. 6 | *.c text 7 | *.h text 8 | 9 | # Declare files that will always have CRLF line endings on checkout. 10 | *.sln text eol=crlf 11 | 12 | # Denote all files that are truly binary and should not be modified. 13 | *.png binary 14 | *.jpg binary -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/config.yml: -------------------------------------------------------------------------------- 1 | blank_issues_enabled: false 2 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/issue-template.yml: -------------------------------------------------------------------------------- 1 | name: Microsoft 365 Copilot extensibility content request 2 | description: Use this template to file a request for new Microsoft 365 Copilot extensibility documentation or an update to existing content. 3 | title: "[Content request]: " 4 | labels: 5 | - triage 6 | assignees: 7 | - lauragra 8 | 9 | body: 10 | - type: dropdown 11 | id: issue_type 12 | attributes: 13 | label: Issue type 14 | description: Are you requesting new content or an update to existing content? 15 | multiple: false 16 | options: 17 | - New content request 18 | - Update to existing content 19 | validations: 20 | required: true 21 | 22 | - type: textarea 23 | id: details 24 | attributes: 25 | label: Details 26 | description: Please describe your content request. If it's an update, please provide the link to the topic to be updated. If new content, include a link to a spec or a content draft. 27 | validations: 28 | required: true 29 | 30 | - type: input 31 | id: sme 32 | attributes: 33 | label: Subject matter expert 34 | description: Provide the names of SMEs who can help to craft or review the content. 35 | validations: 36 | required: true 37 | 38 | - type: dropdown 39 | id: priority 40 | attributes: 41 | label: Priority 42 | multiple: false 43 | options: 44 | - P1 - The request is blocking or affects multiple customers or is related to security, privacy, etc. 45 | - P2 - The request is a high priority but not urgent. 46 | - P3 - The request is medium priority and is not blocking. 47 | default: 2 48 | validations: 49 | required: true 50 | 51 | - type: input 52 | id: target_publish_date 53 | attributes: 54 | label: Target publish date 55 | 56 | - type: dropdown 57 | id: size 58 | attributes: 59 | label: Approximate size of the work item 60 | multiple: false 61 | options: 62 | - Small - The request will take one day to complete. 63 | - Medium - The request will take less than five days to complete. 64 | - Large - The request will take less than two weeks to complete. 65 | - X-large - The request will take more than two weeks to complete. 66 | 67 | - type: textarea 68 | id: additional_details 69 | attributes: 70 | label: Additional details 71 | description: Provide any additional details that will help us manage your request. 72 | -------------------------------------------------------------------------------- /.github/workflows/eol-blocker.yml: -------------------------------------------------------------------------------- 1 | name: EOL Blocker 2 | 3 | on: 4 | pull_request: 5 | branches: [ main, live ] 6 | 7 | permissions: {} 8 | jobs: 9 | check_pull_request_job: 10 | permissions: 11 | pull-requests: write # to comment on pull-requests 12 | 13 | runs-on: ubuntu-latest 14 | name: Check files for CRLF 15 | steps: 16 | - name: Validate files 17 | with: 18 | repoToken: ${{ secrets.GITHUB_TOKEN }} 19 | excludeFiles: '**/**.{png,PNG,jpg,JPG,jpeg,JPEG,gif,GIF,bmp,BMP}' 20 | id: validate 21 | uses: microsoftgraph/eol-blocker@v1.0.12 22 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | log/ 2 | obj/ 3 | _site/ 4 | .optemp/ 5 | _themes*/ 6 | _repo.*/ 7 | 8 | .openpublishing.buildcore.ps1 9 | *.~vsdx 10 | -------------------------------------------------------------------------------- /.markdownlint.json: -------------------------------------------------------------------------------- 1 | { 2 | "MD013": false, 3 | "MD025": { 4 | "front_matter_title": "" 5 | }, 6 | "MD028": false, 7 | "MD033": { 8 | "allowed_elements": ["br", "li"] 9 | } 10 | } 11 | -------------------------------------------------------------------------------- /.openpublishing.publish.config.json: -------------------------------------------------------------------------------- 1 | { 2 | "docsets_to_publish": [ 3 | { 4 | "docset_name": "m365copilot-docs", 5 | "build_source_folder": "docs", 6 | "build_output_subfolder": "m365copilot-docs", 7 | "locale": "en-us", 8 | "monikers": [], 9 | "moniker_ranges": [], 10 | "open_to_public_contributors": true, 11 | "type_mapping": { 12 | "Conceptual": "Content" 13 | }, 14 | "build_entry_point": "docs", 15 | "template_folder": "_themes" 16 | } 17 | ], 18 | "notification_subscribers": [], 19 | "sync_notification_subscribers": [], 20 | "branches_to_filter": [], 21 | "git_repository_url_open_to_public_contributors": "https://github.com/MicrosoftDocs/m365copilot-docs", 22 | "git_repository_branch_open_to_public_contributors": "main", 23 | "need_preview_pull_request": true, 24 | "dependent_repositories": [ 25 | { 26 | "path_to_root": "_themes", 27 | "url": "https://github.com/Microsoft/templates.docs.msft", 28 | "branch": "main", 29 | "branch_mapping": {} 30 | } 31 | ], 32 | "branch_target_mapping": {}, 33 | "targets": {}, 34 | "redirection_files": [ 35 | "redirects/.openpublishing.redirection.september-2024.json" 36 | ] 37 | } 38 | -------------------------------------------------------------------------------- /.vscode/extensions.json: -------------------------------------------------------------------------------- 1 | { 2 | "recommendations": [ 3 | "docsmsft.docs-authoring-pack", 4 | "streetsidesoftware.code-spell-checker" 5 | ] 6 | } 7 | -------------------------------------------------------------------------------- /.vscode/settings.json: -------------------------------------------------------------------------------- 1 | { 2 | "cSpell.spellCheckOnlyWorkspaceFiles": true, 3 | "markdownlint.lintWorkspaceGlobs": [ 4 | "**/*.{md,mkd,mdwn,mdown,markdown,markdn,mdtxt,mdtext,workbook}", 5 | "!**/.git", 6 | "!**/LICENSE_CODE" 7 | ], 8 | "yaml.schemas": { 9 | "https://json.schemastore.org/github-issue-config.json": ".github/ISSUE_TEMPLATE/config.yml" 10 | }, 11 | "cSpell.words": [ 12 | "preconfigured" 13 | ] 14 | } 15 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # Contributing 2 | 3 | This project welcomes contributions and suggestions. Most contributions require you to 4 | agree to a Contributor License Agreement (CLA) declaring that you have the right to, 5 | and actually do, grant us the rights to use your contribution. For details, visit 6 | [https://cla.microsoft.com](https://cla.microsoft.com). 7 | 8 | When you submit a pull request, a CLA-bot will automatically determine whether you need 9 | to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the 10 | instructions provided by the bot. You will only need to do this once across all repositories using our CLA. 11 | 12 | This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments. 13 | 14 | Most of the documentation in this repository is written in Markdown. Reference for Markdown, including the Learn-specific Markdown extensions, is found in the [Learn Markdown reference](https://review.learn.microsoft.com/help/platform/markdown-reference). 15 | 16 | Writing should follow the [Microsoft Writing Style Guide](https://learn.microsoft.com/style-guide/welcome/). 17 | 18 | ## Editor 19 | 20 | You can use any text editor to edit Markdown files. However, we recommend using Visual Studio Code with the Learn Authoring Pack. Visual Studio Code should prompt you to install this extension the first time you open this workspace. The extension include a number of capabilities that will make contributing easier. 21 | 22 | ## Validations 23 | 24 | This repository runs a number of validations on all pull requests that must pass before the PR can be merged. 25 | 26 | ### OpenPublishing.Build validation 27 | 28 | This validation is run by the Open Publishing system and identifies any build errors or warnings. The Learn Authoring Pack validates your documents in real time so you can fix problems before submitting a pull request. Issues will show in the **Problems** window, which you can enable via the **View** menu. 29 | 30 | ### Lint and spell check 31 | 32 | This validation runs to ensure that your Markdown conforms to the Markdown linting rules defined by [markdownlint](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md). The Learn Authoring Pack validates these rules in real time, showing issues in the **Problems** window. 33 | 34 | This validation also runs spell check via [CSpell](https://github.com/streetsidesoftware/cspell). Misspelled or unrecognized words are reported in the **Problems** window. 35 | 36 | #### Fixing lint errors 37 | 38 | Ideally, you would fix all issues reported by the Markdown linter. However, there are some Learn features that require violating certain rules. For example, repeated tabbed sections in documents will introduce duplicated headers in the document, which violates [MD024](https://github.com/DavidAnson/markdownlint/blob/main/doc/md024.md). In these cases, you can disable the rule for portions of a document by using `markdownlint-disable` and `markdownlint-enable` comments. 39 | 40 | ```markdown 41 | 42 | 43 | ## Heading 44 | 45 | ## Heading 46 | 47 | ``` 48 | 49 | #### Fixing spell check issues 50 | 51 | It's not uncommon for the spell checker to find a word it doesn't recognize, especially when writing about code. For example, by default, the keyword `struct` is not recognized by the spell checker. In the case where the spell checker does not recognize a valid word, add the word to [cspell.json](cspell.json), either manually, or by right-clicking the word in Visual Studio Code (either in the Markdown file or in the **Problems** window) and select **Spelling** -> **Add Words to CSpell Configuration**. Be sure to include **cspell.json** in your pull request. 52 | -------------------------------------------------------------------------------- /LICENSE-CODE: -------------------------------------------------------------------------------- 1 | The MIT License (MIT) 2 | Copyright (c) Microsoft Corporation 3 | 4 | Permission is hereby granted, free of charge, to any person obtaining a copy of this software and 5 | associated documentation files (the "Software"), to deal in the Software without restriction, 6 | including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, 7 | and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, 8 | subject to the following conditions: 9 | 10 | The above copyright notice and this permission notice shall be included in all copies or substantial 11 | portions of the Software. 12 | 13 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT 14 | NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 15 | IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 16 | WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 17 | SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Microsoft 365 Copilot documentation 2 | 3 | This repository contains the source for docs published to [https://learn.microsoft.com/m365copilot](https://learn.microsoft.com/microsoft-365-copilot/extensibility). For information on authoring guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md). 4 | 5 | ## Microsoft Open Source Code of Conduct 6 | 7 | This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). 8 | For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments. 9 | -------------------------------------------------------------------------------- /SECURITY.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | # Security 4 | 5 | Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/). 6 | 7 | If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below. 8 | 9 | ## Reporting Security Issues 10 | 11 | **Please do not report security vulnerabilities through public GitHub issues.** 12 | 13 | Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report). 14 | 15 | If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com). If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey). 16 | 17 | You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc). 18 | 19 | Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue: 20 | 21 | * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.) 22 | * Full paths of source file(s) related to the manifestation of the issue 23 | * The location of the affected source code (tag/branch/commit or direct URL) 24 | * Any special configuration required to reproduce the issue 25 | * Step-by-step instructions to reproduce the issue 26 | * Proof-of-concept or exploit code (if possible) 27 | * Impact of the issue, including how an attacker might exploit the issue 28 | 29 | This information will help us triage your report more quickly. 30 | 31 | If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs. 32 | 33 | ## Preferred Languages 34 | 35 | We prefer all communications to be in English. 36 | 37 | ## Policy 38 | 39 | Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/opensource/security/cvd). 40 | 41 | 42 | -------------------------------------------------------------------------------- /ThirdPartyNotices.md: -------------------------------------------------------------------------------- 1 | # Legal Notices 2 | 3 | Microsoft and any contributors grant you a license to the Microsoft documentation and other content 4 | in this repository under the [Creative Commons Attribution 4.0 International Public License](https://creativecommons.org/licenses/by/4.0/legalcode), 5 | see the [LICENSE](LICENSE) file, and grant you a license to any code in the repository under the [MIT License](https://opensource.org/licenses/MIT), see the 6 | [LICENSE-CODE](LICENSE-CODE) file. 7 | 8 | Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation 9 | may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. 10 | The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. 11 | You can find Microsoft general trademark guidelines at [Microsoft Trademark and Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks). 12 | 13 | For privacy information, see [privacy at Microsoft](https://privacy.microsoft.com/en-us/). 14 | 15 | Microsoft and any contributors reserve all others rights, whether under their respective copyrights, patents, 16 | or trademarks, whether by implication, estoppel or otherwise. 17 | -------------------------------------------------------------------------------- /cspell.json: -------------------------------------------------------------------------------- 1 | { 2 | "version": "0.2", 3 | "dictionaryDefinitions": [], 4 | "dictionaries": [], 5 | "words": [ 6 | "Accueil", 7 | "Addin", 8 | "Agentdev", 9 | "agentic", 10 | "Agentlocal", 11 | "apiplugin", 12 | "applianceparts", 13 | "appsource", 14 | "aycabas", 15 | "CarolKigoonya", 16 | "chemtrails", 17 | "ckigoonya", 18 | "compris", 19 | "Contoso", 20 | "coversational", 21 | "Dataverse", 22 | "devtunnel", 23 | "discoverability", 24 | "docfx", 25 | "DOCSMD", 26 | "edoyle", 27 | "Entra", 28 | "erikadoyle", 29 | "fileshare", 30 | "galerie", 31 | "girliemac", 32 | "githubrepos", 33 | "Hidi", 34 | "isvargas", 35 | "isvargasmsft", 36 | "jasonjoh", 37 | "jasonxian", 38 | "jchudakova", 39 | "jessicaaawu", 40 | "jhaskett", 41 | "joshuapa", 42 | "jthake", 43 | "kelvinnjaci", 44 | "kiota", 45 | "kmkoenen", 46 | "koenenkaty", 47 | "lauragra", 48 | "lightbox", 49 | "localizable", 50 | "maisarissi", 51 | "Malik", 52 | "malikrachit", 53 | "microsoftsearch", 54 | "microsoftteams", 55 | "mobajemu", 56 | "msrc", 57 | "MSSQL", 58 | "multimodal", 59 | "multitenant", 60 | "multitenants", 61 | "muwagerikpe", 62 | "nextstepaction", 63 | "njaci1", 64 | "nonwhitespace", 65 | "Northwind", 66 | "Numberof", 67 | "onedrive", 68 | "onpremises", 69 | "openai", 70 | "openapi", 71 | "oraclesql", 72 | "Outils", 73 | "partlow", 74 | "permissioned", 75 | "personnels", 76 | "PKCE", 77 | "policieslocal", 78 | "postsapi", 79 | "powerapps", 80 | "powerplatform", 81 | "prereqs", 82 | "pretrained", 83 | "professionnels", 84 | "propos", 85 | "publiques", 86 | "quickstart", 87 | "Rachit", 88 | "redirections", 89 | "repairshub", 90 | "ressources", 91 | "rickki", 92 | "rimisra", 93 | "roadmapping", 94 | "runtimes", 95 | "sebastienlevert", 96 | "sideload", 97 | "sideloadable", 98 | "sideloaded", 99 | "sideloading", 100 | "sideloads", 101 | "simranajwani", 102 | "slevert", 103 | "struct", 104 | "subpaths", 105 | "tapanm", 106 | "taskpane", 107 | "teamsapp", 108 | "templating", 109 | "testdev", 110 | "testlocal", 111 | "timura", 112 | "toolsets", 113 | "Typeof", 114 | "typespec", 115 | "vscodeversion", 116 | "wujessica" 117 | ], 118 | "ignoreWords": [], 119 | "flagWords": [ 120 | "teh" 121 | ], 122 | "import": [], 123 | "ignorePaths": [ 124 | ".openpublishing.publish.config.json", 125 | "cspell.json", 126 | "LICENSE", 127 | "sharepoint-id-query-response.json", 128 | "posts-api.yml" 129 | ] 130 | } 131 | -------------------------------------------------------------------------------- /docs/agent-builder-template-career-coach.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Create a Career Coach agent from a template 3 | description: Learn how to create a declarative agent in Copilot Studio agent builder by using the Career Coach template. 4 | author: kmkoenen 5 | ms.author: v-koenenkaty 6 | ms.topic: conceptual 7 | ms.localizationpriority: medium 8 | ms.date: 04/01/2025 9 | --- 10 | 11 | # Use the Career Coach template to build an agent 12 | 13 | You can use the Career Coach template to build an agent that provides personalized suggestions and action plans to help users advance in their careers. The career coach offers tailored advice on skill development, learning opportunities, and career transitions based on the user's current role, experience, and available learning opportunities. 14 | 15 | The Career Coach uses a professional and supportive tone to make interactions contextually relevant and encouraging. 16 | 17 | To try a Career Coach, [install the Career Coach agent](https://teams.microsoft.com/l/app/89b7d7a3-fae0-47d7-8140-a38efe34510f?source=share-app-dialog). 18 | 19 | ## Prerequisites 20 | 21 | [!INCLUDE [agent-template-prerequisites](includes/agent-template-prerequisites.md)] 22 | 23 | ## Capabilities 24 | 25 | Agents built on the Career Coach template can offer: 26 | 27 | - Personalized career roadmapping that includes detailed career development plans and actionable advice based on the user's role, skills, and career aspirations. 28 | - Comprehensive skill gap analysis to identify target areas for growth and recommendations for tailored learning opportunities. 29 | - Holistic career support, including guidance on career transitions, performance improvement, and strategic networking. 30 | 31 | ## Use cases 32 | 33 | Career Coach agents are useful for the following tasks. 34 | 35 | | **Task** | **Description** | 36 | | ---------- | ---------- | 37 | | Career development plans | Helps create detailed plans based on your current role and your career goals goals. | 38 | | Skill gap analysis | Identifies gaps between your current skills and your career goals and then suggests ways to address them. | 39 | | Learning opportunities | Recommends courses, certifications, and workshops to help you grow. | 40 | | Career transition advice | Provides guidance for successfully changing careers. | 41 | | Networking strategies | Offers tips for growing and making the most of your professional network. | 42 | | Performance improvement | Provides advice about how to improve your performance in your current role. | 43 | 44 | ## Extension opportunities 45 | 46 | You can enhance the functionality of your Career Coach agents by connecting to additional resources via Microsoft 365 Copilot connectors (formerly Microsoft Graph connectors), Power Platform connectors, or API plugins, depending on the source system in use. 47 | 48 | Suggestions for such connections include: 49 | 50 | - **Linking with a Learning Management System (LMS):** Link with your preferred LMS to provide robust support for both recommending and registering for relevant courses, certifications, and workshops based on the user's role, experience, and aspirations. 51 | - **Integrating with your HR and Talent Management Systems:** Provide more helpful and personalized responses by connecting the agent to internal HR databases or talent management systems. 52 | 53 | 54 | [!INCLUDE [agent-template-extension-note](includes/agent-template-extension-note.md)] 55 | 56 | 57 | [!INCLUDE [agent-template-limitations](includes/agent-template-limitations.md)] 58 | 59 | ## Related content 60 | 61 | - [Copilot Studio agent builder](copilot-studio-agent-builder.md) 62 | - [Build agents with agent builder](copilot-studio-agent-builder-build.md) 63 | - [Publish agents](copilot-studio-agent-builder-publish.md) -------------------------------------------------------------------------------- /docs/agent-builder-template-customer-insight.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Create a Customer Insights agent from a template 3 | description: Learn how to create a declarative agent in Copilot Studio agent builder by using the Customer Insights template. 4 | author: kmkoenen 5 | ms.author: v-koenenkaty 6 | ms.topic: conceptual 7 | ms.localizationpriority: medium 8 | ms.date: 04/01/2025 9 | --- 10 | 11 | # Use the Customer Insight Assistant template to build an agent 12 | 13 | You can use the Customer Insight Assistant template to create agents that help teams understand their customers by providing relevant information and insights. Agents based on this template deliver detailed customer profiles, including the customer's main industry, top products or services, corporate ethos, key priorities, main business units, senior leadership, main competitors, and industry trends. If the customer is publicly traded, the agent provides the stock symbol and stock price over the past year. 14 | 15 | ## Prerequisites 16 | 17 | [!INCLUDE [agent-template-prerequisites](includes/agent-template-prerequisites.md)] 18 | 19 | ## Capabilities 20 | 21 | The Customer Insights agent is designed to provide the information you need to help you better engage with your customers. Agents built on this template deliver detailed customer profiles that include the customer's: 22 | 23 | - Industry 24 | - Top products or services 25 | - Mission and vision 26 | - Key priorities 27 | - Primary business units 28 | - Senior leadership 29 | - Chief competitors 30 | - Industry trends 31 | - Stock symbol and stock price over the past year 32 | 33 | ## Use cases 34 | 35 | A Customer Insight agent can be useful for the following scenarios. 36 | 37 | | **Scenario** | **Description** | 38 | | ---------- | ---------- | 39 | | Customer insights | Provides detailed insights about customers, including industry trends and competitive analysis. | 40 | | Customer initiatives | Identifies a customer's key initiatives. | 41 | | Partnering | Suggests ideas for engaging customers through partnership opportunities. | 42 | | Regional insights | Provides a breakdown of the number of employees a customer has in each region. | 43 | | Customer feedback | Compares how your customers feel about your company relative to your competitors. | 44 | | Customer support | Offers suggestions on how to better support customers. | 45 | 46 | ## Extension opportunities 47 | 48 | You can enhance the functionality of your Customer Insights Assistant agents in a number of ways. For example, you can: 49 | 50 | - **Target relevant enterprise data:** Connect the agent to a SharePoint document library that contains information on how to engage with customers and that provides best practices on how to move the relationship forward. 51 | - **Connect to your (CRM) solution:** Use a Power Platform Connector an API plugin to provide your agent access to details about your key account and customer contacts as well as to relevant products and projects. (Typically, CRM integration requires collaboration with your organizations service owners and IT department.) 52 | - **Simplify creating customer materials:** Integrate the Customer Insight agent in Word and PowerPoint to help create targeted presentations, marketing materials, etc. 53 | 54 | 55 | [!INCLUDE [agent-template-extension-note](includes/agent-template-extension-note.md)] 56 | 57 | 58 | 59 | [!INCLUDE [agent-template-limitations](includes/agent-template-limitations.md)] 60 | 61 | ## Related content 62 | 63 | - [Copilot Studio agent builder](copilot-studio-agent-builder.md) 64 | - [Build agents with agent builder](copilot-studio-agent-builder-build.md) 65 | - [Publish agents](copilot-studio-agent-builder-publish.md) -------------------------------------------------------------------------------- /docs/agent-builder-template-idea-coach.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Create an Idea Coach agent from a template 3 | description: Learn how to create a declarative agent in Copilot Studio agent builder from the Idea Coach template. 4 | author: kmkoenen 5 | ms.author: v-koenenkaty 6 | ms.topic: conceptual 7 | ms.localizationpriority: medium 8 | ms.date: 04/01/2025 9 | --- 10 | 11 | # Use the Idea Coach template to build an agent 12 | 13 | You can use the Idea Coach template to create an agent that helps users develop and refine their ideas and enhance their brainstorming sessions. The Idea Coach agent template uses a fun, collaborative tone to inspire creativity and ensure engaging and productive brainstorming interactions. Idea Coach agents gather user feedback to continuously improve the brainstorming experience. 14 | 15 | By acting as a personal assistant, an agent based on the Idea Coach template can help users: 16 | 17 | - Generate ideas and topics 18 | - Plan brainstorming sessions 19 | - Find creative brainstorming exercises 20 | - Organize ideas 21 | - Improve their brainstorming skills 22 | 23 | To try an Idea Coach, [install the Idea Coach agent](https://teams.microsoft.com/l/app/03386cc1-d424-4eaa-95a8-4a8ec605190e?source=share-app-dialog). 24 | 25 | ## Prerequisites 26 | 27 | [!INCLUDE [agent-template-prerequisites](includes/agent-template-prerequisites.md)] 28 | 29 | ## Capabilities 30 | 31 | Agents built on this template can: 32 | 33 | - Provide AI-driven brainstorming through a guided dialogue and creative exercises to help users effectively develop and refine their ideas. 34 | - Customize agendas and exercises for brainstorming sessions based on user input to ensure engaging and productive brainstorming sessions. 35 | - Collect session insights and feedback to iteratively enhance brainstorming techniques and creative outcomes. 36 | 37 | ## Use cases 38 | 39 | An Idea Coach agent can help with the following scenarios. 40 | 41 | | **Scenario** | **Description** | 42 | | ---------- | ---------- | 43 | | Brainstorming Assistance | Provides a question-based dialogue to help users brainstorm ideas. | 44 | | Brainstorm Session Planning | Customizes brainstorming session agendas by gathering context and offering creative suggestions. | 45 | | Creative Exercises | Proposes activities tailored to user goals and session details.| 46 | | Idea organization | Provides unbiased tools for prioritizing ideas. | 47 | | Feedback and Improvement | Collects session feedback and makes recommendations for improving the brainstorming session. | 48 | | Training and Development | Helps users grow their brainstorming skills. | 49 | 50 | ## Extension opportunities 51 | 52 | You can further enhance your Idea Coach agents through integration and added intelligence. For example, you can: 53 | 54 | - **Connect to additional knowledge base sources:** Link to internal wikis, research repositories, or material from past brainstorming sessions to allow your Idea Coach to access relevant insights and historical context. 55 | - **Scope your agent to specific materials:** Connect a SharePoint site or files containing the specific materials you want your agent to work from. 56 | - **Whiteboarding, CRM, and Project Management tool integrations:** Sync with whiteboarding tools like Microsoft Whiteboard for visualizing ideas. Then, translate refined ideas into actionable tasks by moving them to project management tools like Planner. 57 | - **Automate meeting summaries:** Generate concise summaries of brainstorming sessions, capturing key takeaways, decisions, and next steps. 58 | 59 | 60 | [!INCLUDE [agent-template-extension-note](includes/agent-template-extension-note.md)] 61 | 62 | 63 | 64 | [!INCLUDE [agent-template-limitations](includes/agent-template-limitations.md)] 65 | 66 | ## Related content 67 | 68 | - [Copilot Studio agent builder](copilot-studio-agent-builder.md) 69 | - [Build agents with agent builder](copilot-studio-agent-builder-build.md) 70 | - [Publish agents](copilot-studio-agent-builder-publish.md) -------------------------------------------------------------------------------- /docs/agent-builder-template-learning-coach.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Create a Learning Coach agent from a template 3 | description: Learn how to create a declarative agent in Copilot Studio agent builder from the Learning Coach template. 4 | author: kmkoenen 5 | ms.author: v-koenenkaty 6 | ms.topic: conceptual 7 | ms.localizationpriority: medium 8 | ms.date: 04/01/2025 9 | --- 10 | 11 | # Use the Learning Coach template to build an agent 12 | 13 | You can use the Learning Coach template to create an agent that helps users understand complex topics by breaking them down into simple, intermediate, and detailed summaries. Learning Coach agents create structured learning plans and help users practice skills and prepare for tests. Theses agents provide tailored exercises, guide optimal learning processes, and offer interactive language practice. 14 | 15 | To try a Learning Coach, [install the Learning Coach agent](https://teams.microsoft.com/l/app/78079743-a11b-45d0-99cb-a69d37717373?source=share-app-dialog). 16 | 17 | ## Prerequisites 18 | 19 | [!INCLUDE [agent-template-prerequisites](includes/agent-template-prerequisites.md)] 20 | 21 | ## Capabilities 22 | 23 | Learning Coach agents empower users to achieve their learning goals through structured guidance and support. Key agent capabilities include: 24 | 25 | - Crafting tailored learning plans and exercises based on individual knowledge gaps, study preferences, and learner goals. 26 | - Breaking complex topics into digestible summaries at simple, intermediate, and detailed levels for enhanced learner comprehension. 27 | - Providing targeted exam preparation guidance, recommendations for educational resources, and interactive language practice. 28 | 29 | ## Use cases 30 | 31 | Learning Coach agents are useful in the following scenarios. 32 | 33 | | **Scenario** | **Description** | 34 | | ---------- | ---------- | 35 | | Content comprehension | Helps learners comprehend complex topics by breaking them down into simpler chunks. | 36 | | Knowledge reinforcement | Guides learners through exercises on the skills and knowledge that they already have. | 37 | | Learning plan customization | Helps create tailored learning plans to best fit the needs of the user by assessing the learner's existing knowledge and asking questions about their preferred approach to learning. | 38 | | Test preparation | Helps learners prepare for academic and certification exams. | 39 | | Language education | Facilitates learning new languages based on the user's current knowledge. | 40 | | Study techniques | Suggests personalized study techniques to the user. | 41 | 42 | ## Extension opportunities 43 | 44 | You can enhance the functionality of your Learning Coach agents by connecting to additional resources via Microsoft 365 Copilot connectors (formerly Microsoft Graph connectors), Power Platform connectors, or API plugins, depending on the source system in use. The following are some ideas: 45 | 46 | - **Link with your Learning Management System (LMS):** Link with your preferred LMS or Massive Open Online Course (MOOC) platforms to source up-to-date content, track progress, and streamline certification pathways. 47 | - **Leverage internal knowledge repositories:** Connect your Learning Coach to a SharePoint document library that contains company training materials, research papers, or best practices. This allows the agent to provide contextualized learning recommendations based on your organization's proprietary content. 48 | 49 | 50 | [!INCLUDE [agent-template-extension-note](includes/agent-template-extension-note.md)] 51 | 52 | 53 | 54 | [!INCLUDE [agent-template-limitations](includes/agent-template-limitations.md)] 55 | 56 | ## Related content 57 | 58 | - [Copilot Studio agent builder](copilot-studio-agent-builder.md) 59 | - [Build agents with agent builder](copilot-studio-agent-builder-build.md) 60 | - [Publish agents](copilot-studio-agent-builder-publish.md) -------------------------------------------------------------------------------- /docs/agent-builder-template-meeting-coach.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Create a Meeting Coach agent from a template 3 | description: Learn how to create a declarative agent in Copilot Studio agent builder by using the Meeting Coach template. 4 | author: kmkoenen 5 | ms.author: v-koenenkaty 6 | ms.topic: conceptual 7 | ms.localizationpriority: medium 8 | ms.date: 04/01/2025 9 | --- 10 | 11 | # Use the Meeting Coach template to build an agent 12 | 13 | You can use the Meeting Coach template to create agents that help meeting organizers create and run effective meetings. Agents based on the Meeting Coach template can help users: 14 | 15 | - Set clear objectives 16 | - Create structured agendas 17 | - Assign meeting roles 18 | - Prepare meeting invitations 19 | - Keep meetings on track 20 | - Encourage participation 21 | - Assign action items 22 | 23 | Agents built from this template help ensure that meetings are productive, engaging, and well organized. 24 | 25 | ## Prerequisites 26 | 27 | [!INCLUDE [agent-template-prerequisites](includes/agent-template-prerequisites.md)] 28 | 29 | ## Capabilities 30 | 31 | Agents built on the Meeting Coach template can help meeting organizers: 32 | 33 | - Create agendas. 34 | - Prepare invite emails. 35 | - Assign meeting roles. 36 | - Prepare invite emails. 37 | - Take meeting notes. 38 | 39 | Organizers can also use these agents during meetings to keep them on track and encourage participation. 40 | 41 | ## Use cases 42 | 43 | Meeting Coach agents are useful for the following types of meetings. 44 | 45 | | **Meeting type** | **Purpose** | 46 | | ---------- | ---------- | 47 | | Strategic planning | Define an organization's strategic direction. | 48 | | Stakeholder engagement | Gather stakeholder input and make critical organizational decisions. | 49 | | Innovation workshops | Brainstorm new ideas and innovative strategies. | 50 | | Review sessions | Ensure open and honest communication about successes and areas of improvement, even for challenging topics. | 51 | | Sales pitches | Present an organization's products and services to make sales. | 52 | 53 | ## Extension opportunities 54 | 55 | You can enhance the functionality of your Interview Question Assistant agents by connecting to additional resources via Microsoft 365 Copilot connectors (formerly Microsoft Graph connectors), Power Platform connectors, or API plugins, depending on the source system in use. The following are some ideas: 56 | 57 | - **Connect to your (CRM) solution:** Use a Power Platform Connector an API plugin to give your agent access to details about your key accounts and customer contacts as well as to relevant products and projects. 58 | - **Increase customer engagement:** Connect your agents to SharePoint sites that include meeting materials (sales pitches, customer information, etc.) you can create an agent specialized for customer follow-up. 59 | - **Standardize meetings across teams:** By connecting SharePoint sites that include template files (agendas, meeting minutes, etc.), you can standardize how meetings are organized. You can also standardize how action items and results are recorded and reported at the end of the meeting. 60 | 61 | 62 | [!INCLUDE [agent-template-extension-note](includes/agent-template-extension-note.md)] 63 | 64 | 65 | [!INCLUDE [agent-template-limitations](includes/agent-template-limitations.md)] 66 | 67 | ## Related content 68 | 69 | - [Copilot Studio agent builder](copilot-studio-agent-builder.md) 70 | - [Build agents with agent builder](copilot-studio-agent-builder-build.md) 71 | - [Publish agents](copilot-studio-agent-builder-publish.md) -------------------------------------------------------------------------------- /docs/agent-builder-template-prompt-coach.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Create a Prompt Coach agent from a template 3 | description: Learn how to create a declarative agent in Copilot Studio agent builder from the Prompt Coach template. 4 | author: kmkoenen 5 | ms.author: v-koenenkaty 6 | ms.topic: conceptual 7 | ms.localizationpriority: medium 8 | ms.date: 04/01/2025 9 | --- 10 | 11 | # Use the Prompt Coach template to build an agent 12 | 13 | You can use the Prompt Coach template to create agents that help new Copilot users create effective prompts. Acting as a supportive teacher, these agents guide users through prompt generation, analysis, and improvement. Key features include helping users create well-structured prompts, providing feedback, ensuring compliance with Responsible AI guidelines, troubleshooting, and suggesting examples. The goal is to help users articulate requests clearly for optimal Copilot responses. 14 | 15 | To try Prompt Coach, [Install the Prompt Coach agent](https://teams.microsoft.com/l/app/90680790-0a82-47bf-bab3-6c60c4221d1d?source=share-app-dialog). 16 | 17 | ## Prerequisites 18 | 19 | [!INCLUDE [agent-template-prerequisites](includes/agent-template-prerequisites.md)] 20 | 21 | ## Capabilities 22 | 23 | Agents built on this template provide: 24 | 25 | - Interactive prompt guidance to help users develop well-structured prompts through an iterative feedback process that help clarify user goals, context, and expectations. 26 | - Detailed prompt analysis that evaluates and helps refine user prompts to ensure clarity, optimal phrasing, and compliance with Responsible AI guidelines. 27 | - Concrete prompt examples, with step-by-step explanations, to help users understand and apply AI prompt engineering best practices. 28 | 29 | ## Use cases 30 | 31 | Prompt Coach agents are optimized for the following tasks. 32 | 33 | | **Task** | **Description** | 34 | | ---------- | ---------- | 35 | | Prompt creation | Helps users create effective prompts. | 36 | | Prompt analysis | Evaluates user prompts and offers detailed suggestions for improvement. | 37 | | Prompt Compliance | Checks to determine whether prompts follow Responsible AI guidelines. | 38 | | Prompt Correction | Analyzes and fixes problematic prompts, providing more context for better results. | 39 | | Prompt Examples | Provides well-structured prompt examples and explains their purpose, context, sources, and expectations to help users learn to improve their own prompts. | 40 | | Prompt Engineering | Helps tailor prompts to accomplish a particular task by iterating over a prompt and making incremental changes. | 41 | 42 | ## Extension opportunities 43 | 44 | You can further enhance your Prompt Coach agents with integrations such as the following: 45 | 46 | - **Contextual resources:** Connect your Prompt Coach to SharePoint or other document repositories that contain domain information, prompt guidelines, and your organization's best practices for Responsible AI. 47 | - **Prompt libraries:** Add connectors to pull from prompt repositories across your organization to enable and encourage prompt sharing and collaborative learning about how to write more effective prompts. 48 | 49 | 50 | [!INCLUDE [agent-template-extension-note](includes/agent-template-extension-note.md)] 51 | 52 | 53 | 54 | [!INCLUDE [agent-template-limitations](includes/agent-template-limitations.md)] 55 | 56 | ## Related content 57 | 58 | - [Copilot Studio agent builder](copilot-studio-agent-builder.md) 59 | - [Build agents with agent builder](copilot-studio-agent-builder-build.md) 60 | - [Publish agents](copilot-studio-agent-builder-publish.md) -------------------------------------------------------------------------------- /docs/agent-builder-template-quiz-tutor.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Create a Quiz Tutor agent from a template 3 | description: Learn how to create a declarative agent in Copilot Studio agent builder by using the Quiz Tutor template. 4 | author: kmkoenen 5 | ms.author: v-koenenkaty 6 | ms.topic: conceptual 7 | ms.localizationpriority: medium 8 | ms.date: 04/01/2025 9 | --- 10 | 11 | # Use the Quiz Tutor template to build an agent 12 | 13 | You can use the Quiz Tutor template to create agents that provide fun, bite-sized quizzes based on predefined training content. These quizzes can even be interactive to make the learning process more engaging. The template is designed to enhance a user's understanding and retention of the material by using varied and interesting questions and providing coaching and feedback to support learning. 14 | 15 | ## Prerequisites 16 | 17 | [!INCLUDE [agent-template-prerequisites](includes/agent-template-prerequisites.md)] 18 | 19 | ## Capabilities 20 | 21 | Quiz Tutor agents help users learn quickly. For example, these agents support multiple languages and can: 22 | 23 | - Create fun and engaging quizzes based on the associated training content. 24 | - Provide coaching on answers, praise for correct answers, with offers to explain incorrect answers. 25 | - Adapt the difficulty of the questions based on user performance. 26 | - Use clear language, not technical jargon. 27 | 28 | ## Use cases 29 | 30 | Quiz Tutor agents are useful for the following scenarios. 31 | 32 | | **Scenario** | **Use case** | 33 | | ----------- | ----------- | 34 | | Onboarding new employees | Create interactive quizzes related to your organization's policies and key information. | 35 | | Product training | Test employee knowledge of new products and services . | 36 | | Compliance training | Create quizzes to cement employee knowledge of regulatory requirements and policies. | 37 | | Skill development | Help employees develop and improve their skills. | 38 | | Customer Service training | Quiz employees on best practices for various customer service scenarios. | 39 | | Continuous learning | Help employees learn about industry trends and new technologies. | 40 | 41 | ## Extension opportunities 42 | 43 | You can enhance the functionality of your Quiz Tutor agents by: 44 | 45 | - **Scoping your agent to a particular training or topic:** Connect a SharePoint site or files that contain training materials for a specific topic to create a Quiz Tutor agent specialized for a particular course. 46 | - **Linking with a Learning Management System (LMS):** Link with your preferred LMS to provide robust support for both recommending and registering for relevant courses, certifications, and workshops based on the user's role, experience, and aspirations. 47 | 48 | 49 | [!INCLUDE [agent-template-extension-note](includes/agent-template-extension-note.md)] 50 | 51 | 52 | [!INCLUDE [agent-template-limitations](includes/agent-template-limitations.md)] 53 | 54 | ## Related content 55 | 56 | - [Copilot Studio agent builder](copilot-studio-agent-builder.md) 57 | - [Build agents with agent builder](copilot-studio-agent-builder-build.md) 58 | - [Publish agents](copilot-studio-agent-builder-publish.md) -------------------------------------------------------------------------------- /docs/agent-builder-template-scrum-assistant.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Create a Scrum Assistant agent from a template 3 | description: Learn how to create a declarative agent in Copilot Studio agent builder by using the Scrum Assistant template. 4 | author: kmkoenen 5 | ms.author: v-koenenkaty 6 | ms.topic: conceptual 7 | ms.localizationpriority: medium 8 | ms.date: 04/01/2025 9 | --- 10 | 11 | # Use the Scrum Assistant template to build an agent 12 | 13 | You can use the Scrum Assistant template to create agents that support scrum masters and Agile teams by providing real-time guidance on scrum ceremonies, backlog management, and Agile best practices. Agents based on this template apply trusted scrum resources, analyze team artifacts (sprint reports, retrospective notes), and offer data-driven recommendations to enhance team performance, collaboration, and operational efficiency. 14 | 15 | ## Prerequisites 16 | 17 | [!INCLUDE [agent-template-prerequisites](includes/agent-template-prerequisites.md)] 18 | 19 | ## Capabilities 20 | 21 | Scrum Assistants support multiple languages and can: 22 | 23 | - Provide real-time guidance on scrum ceremonies, backlog management, and best practices for Agile development. 24 | - Use trusted scrum resources and team artifacts to offer data-driven recommendations. 25 | - Help teams improve performance, collaboration, and efficiency. 26 | 27 | ## Use cases 28 | 29 | Scrum Assistant agents are useful in the following scenarios. 30 | 31 | | **Scenario** | **Description** | 32 | | ----------- | ----------- | 33 | | Improve operational efficiency | Helps reduce inefficiencies and support continuous improvement with suggestions for streamlining scrum ceremonies and improving sprint execution. | 34 | | Boost productivity | Fetches relevant scrum insights automatically to enable teams to focus on their deliverables. | 35 | 36 | ## Extension opportunities 37 | 38 | You can enhance the functionality of your Scrum Assistant agents by: 39 | 40 | - **Referencing company-specific Agile practices:** Connect a SharePoint site or files that contain company-specific Agile practices that are stored internally to align guidance with your organizational standards. 41 | - **Linking with your learning materials:** Use Microsoft 365 Copilot connectors (formerly Microsoft Graph connectors) or APIs to index data about your team's Azure DevOps work items. This way, you can allow your Scrum Assistant to provide more contextual advice and guidance. 42 | 43 | 44 | [!INCLUDE [agent-template-extension-note](includes/agent-template-extension-note.md)] 45 | 46 | 47 | [!INCLUDE [agent-template-limitations](includes/agent-template-limitations.md)] 48 | 49 | ## Related content 50 | 51 | - [Copilot Studio agent builder](copilot-studio-agent-builder.md) 52 | - [Build agents with agent builder](copilot-studio-agent-builder-build.md) 53 | - [Publish agents](copilot-studio-agent-builder-publish.md) -------------------------------------------------------------------------------- /docs/agent-builder-template-writing-coach.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Create a Writing Coach agent from a template 3 | description: Learn how to create a declarative agent from the Writing Coach template in Copilot Studio agent builder. 4 | author: kmkoenen 5 | ms.author: v-koenenkaty 6 | ms.topic: conceptual 7 | ms.localizationpriority: medium 8 | ms.date: 04/01/2025 9 | --- 10 | 11 | # Use the Writing Coach template to build an agent 12 | 13 | You can use the Writing Coach template to create agents that help users improve their writing skills and complete various writing tasks. Acting as a supportive coach, agents based on the Writing Coach template provide detailed feedback on clarity, coherence, grammar, and tone. These agents help users modify the nuance and tone of messages, translate text, and guide users through writing instructions, stories, and whitepapers. 14 | 15 | To try a Writing Coach, [install the Writing Coach agent](https://teams.microsoft.com/l/app/f72d7797-c6ee-4fd3-9454-028d0095068b?source=share-app-dialog). 16 | 17 | ## Prerequisites 18 | 19 | [!INCLUDE [agent-template-prerequisites](includes/agent-template-prerequisites.md)] 20 | 21 | ## Capabilities 22 | 23 | Writing Coach agents can: 24 | 25 | - Provide detailed feedback on clarity, coherence, grammar, and tone to elevate overall writing quality. 26 | - Help transform casual text and narratives into formal documents, such as instructions and whitepapers. 27 | - Offer specific suggestions to help adjust the tone or style of a document, or make it easier to translate a document into other languages. 28 | 29 | ## Use cases 30 | 31 | Writing Coach agents can provide helpful guidance for the following types of tasks. 32 | 33 | | **Type of guidance** | **Description** | 34 | | ---------- | ---------- | 35 | | Writing refinement | Provides a wide range of suggestions to help users refine their writing. Suggestions can include: ways to improve grammar, clarity, coherence, and key concepts and details to focus on.| 36 | | Audience targeting | Suggests ways to tailor the voice and tone, and details of a document to your target audience. The agent provides examples of the suggested changes.| 37 | | Writing for a global audience | Identifies wording that might be culturally sensitive and offers alternatives. | 38 | | Descriptive and procedural | Provides feature descriptions as well as clear and concise instructions for using products and services. | 39 | | Customer story writing | Asks for customer details and story goals, then provides suggestions for structuring the story with a clear beginning, middle, and end. | 40 | | Creating whitepapers | Provides assistance in identifying the audience, generating topics, and structuring the document. | 41 | 42 | ## Extension opportunities 43 | 44 | You can further enhance your Writing Coach agents with integration. For example: 45 | 46 | - **Contextual content integration:** Connect your Writing Coach to SharePoint or other document repositories containing internal style guides, best practices, and historical writing examples. Doing this allows the agent to provide more personalized and context-aware recommendations. 47 | - **Application integration:** Customize and configure your Word and PowerPoint implementations to let users access your Writing Coach from within those applications. 48 | 49 | 50 | [!INCLUDE [agent-template-extension-note](includes/agent-template-extension-note.md)] 51 | 52 | 53 | 54 | [!INCLUDE [agent-template-limitations](includes/agent-template-limitations.md)] 55 | 56 | ## Related content 57 | 58 | - [Copilot Studio agent builder](copilot-studio-agent-builder.md) 59 | - [Build agents with agent builder](copilot-studio-agent-builder-build.md) 60 | - [Publish agents](copilot-studio-agent-builder-publish.md) -------------------------------------------------------------------------------- /docs/agent-builder-templates.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Copilot Studio Agent Builder Templates Overview 3 | description: Learn how to use the templates in Copilot Studio agent builder to quickly create a declarative agent for Microsoft 365 Copilot. 4 | author: lauragra 5 | ms.author: lauragra 6 | ms.topic: concept-article 7 | ms.localizationpriority: medium 8 | ms.date: 04/07/2025 9 | --- 10 | 11 | # Agent builder templates overview 12 | 13 | Copilot Studio agent builder includes various templates that you can use to create declarative agents for Microsoft 365 Copilot. The templates apply design guidelines and industry best practices to help you get started quickly. This enables you to spend more time customizing the logic and functionality to meet your business requirements. The agent builder templates accelerate the agent development process to help organizations improve overall operational efficiency. 14 | 15 | This article provides information about how to use the templates in agent builder to create your own agents by using natural language as input. 16 | 17 | ## Use templates to create an agent 18 | 19 | To create an agent from a template in agent builder: 20 | 21 | 1. On the **Describe** tab in agent builder, select a template. You can test the agent in the right pane right away. 22 | 2. Using natural language, provide additional information to update and enhance the agent, including the agent name, description, and instructions. 23 | 3. On the **Configure** tab, add an icon, knowledge sources, and capabilities to your agent. 24 | 25 | You can also configure the agent directly on the **Configure** tab in agent builder: 26 | 27 | 1. On the **Configure** tab, select a template from the dropdown in the **Template** field. 28 | 2. The agent icon, name, description, instructions, and starter prompts are prepopulated. Update any of the fields to meet your scenario. 29 | 3. Add any knowledge sources and capabilities to enhance your agent. 30 | 31 | The **Describe** and **Configure** tabs are in sync. You can switch between both tabs based on your preferences to author your agent. 32 | 33 | Changes that you make to the agent are saved automatically in agent builder. When you're satisfied with your agent's behavior and content, choose **Create** on the top right corner of agent builder to create your agent. 34 | 35 | After the agent is created, choose **Go to agent** in Copilot to chat with the agent. You can return to your agent from the right rail in Copilot. 36 | 37 | ## Related content 38 | 39 | - [Build agents with Copilot Studio agent builder](copilot-studio-agent-builder-build.md) 40 | - [Declarative agents overview](overview-declarative-agent.md) 41 | - [Write effective instructions for declarative agents](declarative-agent-instructions.md) 42 | -------------------------------------------------------------------------------- /docs/assets/diagrams/API plugin data flow.vsdx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/diagrams/API plugin data flow.vsdx -------------------------------------------------------------------------------- /docs/assets/icons/copilot.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /docs/assets/icons/microsoft-graph.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 5 | 13 | 14 | 15 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | -------------------------------------------------------------------------------- /docs/assets/icons/teams-toolkit-sidebar-icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/icons/teams-toolkit-sidebar-icon.png -------------------------------------------------------------------------------- /docs/assets/icons/teams.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /docs/assets/images/Copilot_orchestrator_sequence_v2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/Copilot_orchestrator_sequence_v2.png -------------------------------------------------------------------------------- /docs/assets/images/aad-default-client-type.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/aad-default-client-type.png -------------------------------------------------------------------------------- /docs/assets/images/agent-in-browser.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/agent-in-browser.png -------------------------------------------------------------------------------- /docs/assets/images/agent-ux/ai-labels.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/agent-ux/ai-labels.png -------------------------------------------------------------------------------- /docs/assets/images/agent-ux/citations.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/agent-ux/citations.png -------------------------------------------------------------------------------- /docs/assets/images/agent-ux/feedback.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/agent-ux/feedback.png -------------------------------------------------------------------------------- /docs/assets/images/agent-ux/sensitivity-labels.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/agent-ux/sensitivity-labels.png -------------------------------------------------------------------------------- /docs/assets/images/agent-ux/streaming-response.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/agent-ux/streaming-response.png -------------------------------------------------------------------------------- /docs/assets/images/agent-ux/suggested-prompts.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/agent-ux/suggested-prompts.png -------------------------------------------------------------------------------- /docs/assets/images/agent-ux/zero-prompts.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/agent-ux/zero-prompts.png -------------------------------------------------------------------------------- /docs/assets/images/agents-system-cea.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/agents-system-cea.png -------------------------------------------------------------------------------- /docs/assets/images/agents-system-da.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/agents-system-da.png -------------------------------------------------------------------------------- /docs/assets/images/anatomy-agents.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/anatomy-agents.png -------------------------------------------------------------------------------- /docs/assets/images/anatomy-m365-copilot.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/anatomy-m365-copilot.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/adaptive-card-citation.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/adaptive-card-citation.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/api-plugin-credit-card.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/api-plugin-credit-card.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/api-plugin-debit-card.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/api-plugin-debit-card.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/api-plugin-typespec-card.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/api-plugin-typespec-card.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/api-plugin-typespec-delete.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/api-plugin-typespec-delete.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/api-plugin-typespec-get.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/api-plugin-typespec-get.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/api-plugin-typespec-patch.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/api-plugin-typespec-patch.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/api-plugin-typespec-post.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/api-plugin-typespec-post.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/copilot-agents.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/copilot-agents.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/create-plugin-ttk.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/create-plugin-ttk.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/generate-plugin-kiota.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/generate-plugin-kiota.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/get-always-allow.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/get-always-allow.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/post-confirm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/post-confirm.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/provision-complete-ttk.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/provision-complete-ttk.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/select-operations-kiota.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/select-operations-kiota.png -------------------------------------------------------------------------------- /docs/assets/images/api-plugins/select-operations-ttk.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/api-plugins/select-operations-ttk.png -------------------------------------------------------------------------------- /docs/assets/images/app-manifest-agents.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/app-manifest-agents.png -------------------------------------------------------------------------------- /docs/assets/images/app-package.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/app-package.png -------------------------------------------------------------------------------- /docs/assets/images/atk-copilot-connectors/add-connector-id.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/atk-copilot-connectors/add-connector-id.png -------------------------------------------------------------------------------- /docs/assets/images/atk-copilot-connectors/admin-consent.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/atk-copilot-connectors/admin-consent.png -------------------------------------------------------------------------------- /docs/assets/images/atk-copilot-connectors/choose-connector-id.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/atk-copilot-connectors/choose-connector-id.png -------------------------------------------------------------------------------- /docs/assets/images/atk-copilot-connectors/choose-connector-name.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/atk-copilot-connectors/choose-connector-name.png -------------------------------------------------------------------------------- /docs/assets/images/atk-copilot-connectors/copilot-output.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/atk-copilot-connectors/copilot-output.png -------------------------------------------------------------------------------- /docs/assets/images/atk-copilot-connectors/create-new-app.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/atk-copilot-connectors/create-new-app.png -------------------------------------------------------------------------------- /docs/assets/images/atk-copilot-connectors/env-local.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/atk-copilot-connectors/env-local.png -------------------------------------------------------------------------------- /docs/assets/images/atk-copilot-connectors/include-connector-results.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/atk-copilot-connectors/include-connector-results.png -------------------------------------------------------------------------------- /docs/assets/images/atk-copilot-connectors/items-indexed.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/atk-copilot-connectors/items-indexed.png -------------------------------------------------------------------------------- /docs/assets/images/atk-copilot-connectors/select-copilot-connector.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/atk-copilot-connectors/select-copilot-connector.png -------------------------------------------------------------------------------- /docs/assets/images/atk-copilot-connectors/vs-code-customization-point.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/atk-copilot-connectors/vs-code-customization-point.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/atk/copilot-agent-list.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/atk/copilot-agent-list.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/atk/create-new-app-agent.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/atk/create-new-app-agent.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/atk/excel-agent-copilot-confirmation.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/atk/excel-agent-copilot-confirmation.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/atk/excel-agent-pane-success.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/atk/excel-agent-pane-success.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/atk/excel-agent-teams-app-list.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/atk/excel-agent-teams-app-list.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/atk/provision-agent-atk.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/atk/provision-agent-atk.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/atk/select-copilot-agent-atk.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/atk/select-copilot-agent-atk.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/agent-answer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/agent-answer.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/code-interpreter-graph-content.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/code-interpreter-graph-content.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/code-interpreter-python-content.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/code-interpreter-python-content.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/conversation-starters.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/conversation-starters.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/create-new-app.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/create-new-app.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/email-content.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/email-content.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/graph-connector-content.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/graph-connector-content.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/graphic-art-content.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/graphic-art-content.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/people-content.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/people-content.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/plugin-response.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/plugin-response.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/provision-agent.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/provision-agent.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/select-agent.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/select-agent.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/select-apis.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/select-apis.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/select-copilot-agent.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/select-copilot-agent.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/sharepoint-onedrive-content.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/sharepoint-onedrive-content.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/teams-content.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/teams-content.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/updated-instructions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/updated-instructions.png -------------------------------------------------------------------------------- /docs/assets/images/build-da/ttk/web-content.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-da/ttk/web-content.png -------------------------------------------------------------------------------- /docs/assets/images/build-with-agents-sdk.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-with-agents-sdk.png -------------------------------------------------------------------------------- /docs/assets/images/build-with-teams-ai-library.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/build-with-teams-ai-library.png -------------------------------------------------------------------------------- /docs/assets/images/capabilities-teamsChat-emails.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/capabilities-teamsChat-emails.png -------------------------------------------------------------------------------- /docs/assets/images/capabilities-toggle.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/capabilities-toggle.png -------------------------------------------------------------------------------- /docs/assets/images/cea-da-decision-guide.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/cea-da-decision-guide.png -------------------------------------------------------------------------------- /docs/assets/images/clippy-response.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/clippy-response.png -------------------------------------------------------------------------------- /docs/assets/images/clippy.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/clippy.png -------------------------------------------------------------------------------- /docs/assets/images/code-interpreter-pet-word-cloud.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/code-interpreter-pet-word-cloud.png -------------------------------------------------------------------------------- /docs/assets/images/code-interpreter-python-1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/code-interpreter-python-1.png -------------------------------------------------------------------------------- /docs/assets/images/code-interpreter-python-2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/code-interpreter-python-2.png -------------------------------------------------------------------------------- /docs/assets/images/color-icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/color-icon.png -------------------------------------------------------------------------------- /docs/assets/images/connectors-copilot-hover.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/connectors-copilot-hover.png -------------------------------------------------------------------------------- /docs/assets/images/connectors-copilot-logo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/connectors-copilot-logo.png -------------------------------------------------------------------------------- /docs/assets/images/connectors-copilot-response.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/connectors-copilot-response.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-architecture.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-architecture.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-experiences.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-experiences.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-extensibility-diagram.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-extensibility-diagram.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-stack.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-stack.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-studio-agent-builder/embedded-authoring-auto-share.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-studio-agent-builder/embedded-authoring-auto-share.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-studio-agent-builder/embedded-authoring-configure.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-studio-agent-builder/embedded-authoring-configure.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-studio-agent-builder/embedded-authoring-copilot-connectors.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-studio-agent-builder/embedded-authoring-copilot-connectors.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-studio-agent-builder/embedded-authoring-entry.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-studio-agent-builder/embedded-authoring-entry.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-studio-agent-builder/embedded-authoring-feedback-general.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-studio-agent-builder/embedded-authoring-feedback-general.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-studio-agent-builder/embedded-authoring-get-support-1-updated.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-studio-agent-builder/embedded-authoring-get-support-1-updated.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-studio-agent-builder/embedded-authoring-get-support-2-updated.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-studio-agent-builder/embedded-authoring-get-support-2-updated.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-studio-agent-builder/embedded-authoring-knowledge-preparing.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-studio-agent-builder/embedded-authoring-knowledge-preparing.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-studio-agent-builder/embedded-authoring-last-accessed.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-studio-agent-builder/embedded-authoring-last-accessed.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-studio-agent-builder/embedded-authoring-sharepoint-picker-folders.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-studio-agent-builder/embedded-authoring-sharepoint-picker-folders.png -------------------------------------------------------------------------------- /docs/assets/images/copilot-studio-agent-builder/embedded-authoring-starter.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/copilot-studio-agent-builder/embedded-authoring-starter.png -------------------------------------------------------------------------------- /docs/assets/images/custom-engine-agent.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/custom-engine-agent.png -------------------------------------------------------------------------------- /docs/assets/images/debugged-function.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/debugged-function.png -------------------------------------------------------------------------------- /docs/assets/images/declarative-agent-scenarios.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/declarative-agent-scenarios.png -------------------------------------------------------------------------------- /docs/assets/images/declarative-agent-showcase.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/declarative-agent-showcase.png -------------------------------------------------------------------------------- /docs/assets/images/declarative-agents/add-document-selection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/declarative-agents/add-document-selection.png -------------------------------------------------------------------------------- /docs/assets/images/declarative-agents/document-selection-prompt.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/declarative-agents/document-selection-prompt.png -------------------------------------------------------------------------------- /docs/assets/images/declarative-agents/document-selection-result.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/declarative-agents/document-selection-result.png -------------------------------------------------------------------------------- /docs/assets/images/declarative-agents/graph-explorer-consent-to-permissions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/declarative-agents/graph-explorer-consent-to-permissions.png -------------------------------------------------------------------------------- /docs/assets/images/declarative-agents/graph-explorer-external-connection-permission.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/declarative-agents/graph-explorer-external-connection-permission.png -------------------------------------------------------------------------------- /docs/assets/images/declarative-agents/graph-explorer-get-connections.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/declarative-agents/graph-explorer-get-connections.png -------------------------------------------------------------------------------- /docs/assets/images/declarative-agents/graph-explorer-post-query.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/declarative-agents/graph-explorer-post-query.png -------------------------------------------------------------------------------- /docs/assets/images/declarative-agents/graph-explorer-sign-in.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/declarative-agents/graph-explorer-sign-in.png -------------------------------------------------------------------------------- /docs/assets/images/declarative-agents/graph-explorer-sites-permission.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/declarative-agents/graph-explorer-sites-permission.png -------------------------------------------------------------------------------- /docs/assets/images/declarative-agents/image-insert.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/declarative-agents/image-insert.png -------------------------------------------------------------------------------- /docs/assets/images/developer-mode-agent-actions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/developer-mode-agent-actions.png -------------------------------------------------------------------------------- /docs/assets/images/developer-mode-agent-capabilities.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/developer-mode-agent-capabilities.png -------------------------------------------------------------------------------- /docs/assets/images/developer-mode-agent-executed-actions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/developer-mode-agent-executed-actions.png -------------------------------------------------------------------------------- /docs/assets/images/developer-mode-agent-execution.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/developer-mode-agent-execution.png -------------------------------------------------------------------------------- /docs/assets/images/developer-mode-agent-metadata.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/developer-mode-agent-metadata.png -------------------------------------------------------------------------------- /docs/assets/images/developer-mode-atk-F5.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/developer-mode-atk-F5.png -------------------------------------------------------------------------------- /docs/assets/images/developer-mode-atk-actions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/developer-mode-atk-actions.png -------------------------------------------------------------------------------- /docs/assets/images/developer-mode-atk-capabilities.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/developer-mode-atk-capabilities.png -------------------------------------------------------------------------------- /docs/assets/images/developer-mode-atk-connection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/developer-mode-atk-connection.png -------------------------------------------------------------------------------- /docs/assets/images/developer-mode-atk-metadata.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/developer-mode-atk-metadata.png -------------------------------------------------------------------------------- /docs/assets/images/developer-mode-feedback-message.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/developer-mode-feedback-message.png -------------------------------------------------------------------------------- /docs/assets/images/developer-mode-feedback.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/developer-mode-feedback.png -------------------------------------------------------------------------------- /docs/assets/images/developer-mode-on.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/developer-mode-on.png -------------------------------------------------------------------------------- /docs/assets/images/enter-code.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/enter-code.png -------------------------------------------------------------------------------- /docs/assets/images/entra-portal-app-registrations.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/entra-portal-app-registrations.png -------------------------------------------------------------------------------- /docs/assets/images/icon-actionable.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/icon-actionable.png -------------------------------------------------------------------------------- /docs/assets/images/icon-deep-content.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/icon-deep-content.png -------------------------------------------------------------------------------- /docs/assets/images/icon-preview.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/icon-preview.png -------------------------------------------------------------------------------- /docs/assets/images/icon-search.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/icon-search.png -------------------------------------------------------------------------------- /docs/assets/images/image-gen-beach-prompt.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/image-gen-beach-prompt.png -------------------------------------------------------------------------------- /docs/assets/images/image-gen-flier-prompt.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/image-gen-flier-prompt.png -------------------------------------------------------------------------------- /docs/assets/images/instruction-api-plugins-h-2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/instruction-api-plugins-h-2.png -------------------------------------------------------------------------------- /docs/assets/images/instruction-components.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/instruction-components.png -------------------------------------------------------------------------------- /docs/assets/images/instruction-process.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/instruction-process.png -------------------------------------------------------------------------------- /docs/assets/images/jupyter-output.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/jupyter-output.png -------------------------------------------------------------------------------- /docs/assets/images/knowledge-picker-agent-builder.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/knowledge-picker-agent-builder.png -------------------------------------------------------------------------------- /docs/assets/images/knowledge-picker-agent-builder2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/knowledge-picker-agent-builder2.png -------------------------------------------------------------------------------- /docs/assets/images/loc-manifest.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/loc-manifest.png -------------------------------------------------------------------------------- /docs/assets/images/m365-extensibility-types.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/m365-extensibility-types.png -------------------------------------------------------------------------------- /docs/assets/images/mac-integrated-apps.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/mac-integrated-apps.png -------------------------------------------------------------------------------- /docs/assets/images/message-extensions-ux.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/message-extensions-ux.png -------------------------------------------------------------------------------- /docs/assets/images/microsoft-365-and-copilot-program.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/microsoft-365-and-copilot-program.png -------------------------------------------------------------------------------- /docs/assets/images/outline-icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/outline-icon.png -------------------------------------------------------------------------------- /docs/assets/images/personas-build-custom-ai-apps.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/personas-build-custom-ai-apps.png -------------------------------------------------------------------------------- /docs/assets/images/personas-extend-copilot.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/personas-extend-copilot.png -------------------------------------------------------------------------------- /docs/assets/images/skills-knowledge-chart.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/skills-knowledge-chart.png -------------------------------------------------------------------------------- /docs/assets/images/tac-setup-policies.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/tac-setup-policies.png -------------------------------------------------------------------------------- /docs/assets/images/validation-principles.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MicrosoftDocs/m365copilot-docs/ff9345e93cede0fe52f7503f68e99f50852ad168/docs/assets/images/validation-principles.png -------------------------------------------------------------------------------- /docs/assets/scripts/GetGraphConnectorIds.ps1: -------------------------------------------------------------------------------- 1 | param( 2 | [Parameter(Mandatory = $false)] 3 | [Switch] 4 | $StayConnected = $false 5 | ) 6 | 7 | # Requires an admin 8 | Connect-MgGraph -Scopes "ExternalConnection.Read.All" ` 9 | -UseDeviceCode -ErrorAction Stop -NoWelcome 10 | 11 | Get-MgExternalConnection -Property "Name", "Id" | Format-Table "Name", "Id" 12 | 13 | if ($StayConnected -eq $false) { 14 | Disconnect-MgGraph | Out-Null 15 | Write-Host "Disconnected from Microsoft Graph" 16 | } 17 | else { 18 | Write-Host 19 | Write-Host -ForegroundColor Yellow ` 20 | "The connection to Microsoft Graph is still active. To disconnect, use Disconnect-MgGraph" 21 | } 22 | -------------------------------------------------------------------------------- /docs/assets/scripts/GetSharePointIds.ps1: -------------------------------------------------------------------------------- 1 | param( 2 | [Parameter(Mandatory = $true, 3 | HelpMessage = "The URL path to the file or folder to search for")] 4 | [String] 5 | $FilePath, 6 | 7 | [Parameter(Mandatory = $false)] 8 | [Switch] 9 | $StayConnected = $false 10 | ) 11 | 12 | Connect-MgGraph -Scopes "Sites.Read.All Files.Read.All" ` 13 | -UseDeviceCode -ErrorAction Stop -NoWelcome 14 | 15 | $searchQuery = @{ 16 | requests = @( 17 | @{ 18 | entityTypes = @("driveItem") 19 | query = @{ 20 | queryString = "Path:""" + $FilePath + """" 21 | } 22 | fields = @( 23 | "fileName" 24 | "listId" 25 | "webId" 26 | "siteId" 27 | "uniqueId" 28 | ) 29 | } 30 | ) 31 | } 32 | 33 | $results = Invoke-MgQuerySearch -Body $searchQuery 34 | 35 | foreach($hitContainer in $results.HitsContainers) 36 | { 37 | foreach($hit in $hitContainer.Hits) 38 | { 39 | Write-Output $hit.Resource.AdditionalProperties["listItem"]["fields"] | Format-Table 40 | } 41 | } 42 | 43 | if ($StayConnected -eq $false) { 44 | Disconnect-MgGraph | Out-Null 45 | Write-Host "Disconnected from Microsoft Graph" 46 | } 47 | else { 48 | Write-Host 49 | Write-Host -ForegroundColor Yellow ` 50 | "The connection to Microsoft Graph is still active. To disconnect, use Disconnect-MgGraph" 51 | } 52 | -------------------------------------------------------------------------------- /docs/assets/snippets/sharepoint-id-query-response.json: -------------------------------------------------------------------------------- 1 | { 2 | "value": [ 3 | { 4 | "searchTerms": [], 5 | "hitsContainers": [ 6 | { 7 | "hits": [ 8 | { 9 | "hitId": "01AJOINAHZHINTBHPESZBISPIPSJG3D5EO", 10 | "rank": 1, 11 | "summary": "Reorder policy Our reorder policy for suppliers is straightforward and designed to maintain cost-efficiency and inventory control. We kindly request that no order exceeds a total", 12 | "resource": { 13 | "@odata.type": "#microsoft.graph.driveItem", 14 | "listItem": { 15 | "@odata.type": "#microsoft.graph.listItem", 16 | "id": "301b3af9-e49d-4296-893d-0f924db1f48e", 17 | "fields": { 18 | "fileName": "YourFile.docx", 19 | "listId": "12fde922-4fab-4238-8227-521829cd1099", 20 | "webId": "a25fab47-f3b9-4fa3-8ed9-1acb83c12a4f", 21 | "siteId": "5863dfa5-b39d-4cd1-92a6-5cf539e04971", 22 | "uniqueId": "{301b3af9-e49d-4296-893d-0f924db1f48e}" 23 | } 24 | } 25 | } 26 | } 27 | ], 28 | "total": 1, 29 | "moreResultsAvailable": false 30 | } 31 | ] 32 | } 33 | ] 34 | } 35 | -------------------------------------------------------------------------------- /docs/breadcrumb/toc.yml: -------------------------------------------------------------------------------- 1 | items: 2 | - name: Microsoft 365 Copilot 3 | tocHref: /microsoft-365-copilot/ 4 | topicHref: /microsoft-365-copilot/index 5 | items: 6 | - name: Extensibility 7 | tocHref: /microsoft-365-copilot/extensibility 8 | topicHref: /microsoft-365-copilot/extensibility/index 9 | -------------------------------------------------------------------------------- /docs/build-declarative-agents.yml: -------------------------------------------------------------------------------- 1 | ### YamlMime:Tutorial 2 | title: Create declarative agents using Microsoft 365 Agents Toolkit 3 | metadata: 4 | title: Create declarative agents using Microsoft 365 Agents Toolkit 5 | description: Learn how to build a declarative agent for Microsoft 365 Copilot using Microsoft 365 Agents Toolkit. 6 | audience: Developer 7 | level: Beginner 8 | displayType: one-column 9 | ms.date: 05/19/2025 10 | author: sebastienlevert 11 | ms.author: slevert 12 | ms.topic: tutorial 13 | scenarios: getting-started 14 | items: 15 | - durationInMinutes: 1 16 | content: | 17 | [!INCLUDE [](./includes/declarative-agents-walkthrough/01-intro.md)] 18 | - title: Create a declarative agent 19 | durationInMinutes: 3 20 | content: | 21 | [!INCLUDE [](./includes/declarative-agents-walkthrough/02-create-agent.md)] 22 | - title: Add instructions 23 | durationInMinutes: 3 24 | content: | 25 | [!INCLUDE [](./includes/declarative-agents-walkthrough/03-add-instructions.md)] 26 | - title: Add conversation starters 27 | durationInMinutes: 3 28 | content: | 29 | [!INCLUDE [](./includes/declarative-agents-walkthrough/04-add-conversation-starters.md)] 30 | - title: Add web content 31 | durationInMinutes: 3 32 | content: | 33 | [!INCLUDE [](./includes/declarative-agents-walkthrough/05-add-web-content.md)] 34 | - title: Add OneDrive and SharePoint content 35 | durationInMinutes: 3 36 | content: | 37 | [!INCLUDE [](./includes/declarative-agents-walkthrough/06-add-onedrive-sharepoint.md)] 38 | - title: Add Teams messages 39 | durationInMinutes: 3 40 | content: | 41 | [!INCLUDE [](./includes/declarative-agents-walkthrough/07-add-teams-messages.md)] 42 | - title: Add people knowledge 43 | durationInMinutes: 3 44 | content: | 45 | [!INCLUDE [](./includes/declarative-agents-walkthrough/08-add-people.md)] 46 | - title: Add email knowledge 47 | durationInMinutes: 3 48 | content: | 49 | [!INCLUDE [](./includes/declarative-agents-walkthrough/09-add-email.md)] 50 | - title: Add image generator 51 | durationInMinutes: 3 52 | content: | 53 | [!INCLUDE [](./includes/declarative-agents-walkthrough/10-add-graphic-art.md)] 54 | - title: Add code interpreter 55 | durationInMinutes: 3 56 | content: | 57 | [!INCLUDE [](./includes/declarative-agents-walkthrough/11-add-code-interpreter.md)] 58 | - title: Add Copilot connectors content 59 | durationInMinutes: 3 60 | content: | 61 | [!INCLUDE [](./includes/declarative-agents-walkthrough/12-add-copilot-connectors.md)] 62 | - title: Add API plugins 63 | durationInMinutes: 5 64 | content: | 65 | [!INCLUDE [](./includes/declarative-agents-walkthrough/13-add-plugins.md)] 66 | - content: | 67 | [!INCLUDE [](./includes/declarative-agents-walkthrough/14-completed.md)] 68 | -------------------------------------------------------------------------------- /docs/code-interpreter.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Code Interpreter Capability for Declarative Agents for Microsoft 365 Copilot. 3 | description: Learn about the code interpreter capability and how to add it to your declarative agents. 4 | author: kmkoenen 5 | ms.author: v-koenenkaty 6 | ms.topic: concept-article 7 | ms.localizationpriority: medium 8 | ms.date: 5/09/2025 9 | --- 10 | 11 | # Add the code interpreter capability to your agent 12 | 13 | You can enhance the user experience of your declarative agent for Microsoft 365 Copilot by adding the code interpreter capability. The [**capabilities** element](declarative-agent-manifest-1.4.md#capabilities-object) in the manifest reference and the **Capabilities** section in the Copilot Studio agent builder provide several options for you to unlock features for your users. This article describes the code interpreter capability and how to add it to your declarative agents. 14 | 15 | Code interpreter is an advanced tool designed to solve complex tasks via Python code. It uses the reasoning model to write and run code, enabling users to solve complex math problems, analyze data, generate visualizations, and more. After the code runs, code interpreter outputs the results and generated code. It can also produce images or files based on the scenario, and accepts files as input for modifications and analysis. 16 | 17 | The code interpreter capability is available to Copilot Chat users with no metered usage or Microsoft 365 Copilot license. 18 | 19 | > [!NOTE] 20 | > Support for in-context agents that have code interpreter enabled varies by host. 21 | 22 | ## Code interpreter examples 23 | 24 | ### Data graphing 25 | 26 | The user prompt "Graph the first 20 numbers in a Fibonacci sequence" generates both a line graph and, when the user clicks the ` Code` button, provides the corresponding Python code. 27 | 28 | The following images show examples of the results of a data graphing request. 29 | 30 | :::image type="content" source="assets/images/code-interpreter-python-1.png" alt-text="Graph response to the user prompt"::: 31 | 32 | :::image type="content" source="assets/images/code-interpreter-python-2.png" alt-text="Python code response to the user prompt"::: 33 | 34 | ### Data visualization 35 | 36 | The user prompt "Create a word cloud of top pet names" generates a word cloud that includes the top names, as shown in the following example. 37 | 38 | :::image type="content" source="assets/images/code-interpreter-pet-word-cloud.png" alt-text="Word cloud response to the user prompt"::: 39 | 40 | ### Enable code interpreter 41 | 42 | #### Microsoft 365 Agents Toolkit 43 | 44 | If you're using [Agents Toolkit and Visual Studio Code](build-declarative-agents.yml) to create your agent, to enable code interpreter, add the `CodeInterpreter` value to the **capabilities** property in your manifest file, as shown in the following example. 45 | 46 | > [!NOTE] 47 | > You must be using [version 1.2](declarative-agent-manifest-1.2.md) or later of the declarative agent manifest schema to add the `CodeInterpreter` capability. 48 | 49 | ```json 50 | { 51 | "capabilities": [ 52 | { 53 | "name": "CodeInterpreter" 54 | } 55 | ] 56 | } 57 | ``` 58 | 59 | #### Copilot Studio agent builder 60 | 61 | If you're using [Copilot Studio agent builder](copilot-studio-agent-builder.md) to create your agent, on the **Configure** tab, under **Capabilities**, choose the toggle next to **Code interpreter**. 62 | 63 | :::image type="content" source="assets/images/capabilities-toggle.png" alt-text="Screenshot of the Capabilities section of the agent builder"::: 64 | 65 | ## Related content 66 | 67 | - [Declarative agents overview](overview-declarative-agent.md) 68 | - [Declarative agent manifest reference](declarative-agent-manifest-1.4.md) 69 | - [Add the image generator capability to your agent](image-generator.md) 70 | - [Add knowledge sources to your declarative agent](knowledge-sources.md) 71 | -------------------------------------------------------------------------------- /docs/context.yml: -------------------------------------------------------------------------------- 1 | ### YamlMime:ContextObject 2 | breadcrumb_path: ./breadcrumb/toc.yml 3 | toc_rel: ./toc.yml 4 | uhfHeaderId: MSDocsHeader-M365-IT 5 | -------------------------------------------------------------------------------- /docs/copilot-studio-agent-builder-availability.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Copilot Studio agent builder regional availability and language support 3 | description: Learn about the regional availability and supported languages for Copilot Studio agent builder. 4 | author: jasonxian-msft 5 | ms.author: jasonxian 6 | ms.localizationpriority: medium 7 | ms.date: 2/26/2025 8 | ms.topic: conceptual 9 | --- 10 | 11 | # Agent builder regional availability and language support 12 | 13 | This article provides information about Copilot Studio regional availability and the agent and authoring languages that Copilot Studio supports. 14 | 15 | ## Regional availability 16 | 17 | Copilot Studio agent builder is available if your [Power Platform default environment](/power-platform/admin/environments-overview#default-environment) is in any of the following countries or regions: 18 | 19 | - Asia Pacific 20 | - Australia 21 | - Brazil 22 | - Canada 23 | - Europe 24 | - France 25 | - Germany 26 | - India 27 | - Japan 28 | - Korea 29 | - Norway 30 | - South Africa 31 | - Sweden 32 | - Switzerland 33 | - United Arab Emirates 34 | - United Kingdom 35 | - United States 36 | 37 | The Power Platform default environment location is automatically set to the location of the tenant. You can verify the location of your Power Platform default environment in the Power Platform Admin Center. For more information, see [Environment location](/power-platform/admin/environments-overview#environment-location). 38 | 39 | ## Language support 40 | 41 | ### Authoring canvas languages 42 | 43 | The authoring canvas language is the one in which the authoring UI is presented. By default, this language is your Microsoft 365 language setting. You can change the authoring language by [changing your Microsoft 365 language setting](https://support.microsoft.com/topic/change-your-display-language-and-time-zone-in-microsoft-365-for-business-6f238bff-5252-441e-b32b-655d5d85d15b). 44 | 45 | The following authoring languages are supported: 46 | 47 | - Chinese (Simplified) (zh-CN) 48 | - Chinese (Traditional) (zh-TW) 49 | - Czech (cs-CZ) 50 | - Danish (da-DK) 51 | - Dutch (nl-NL) 52 | - English (United States) (en-US) 53 | - Finnish (fi-FI) 54 | - French (France) (fr-FR) 55 | - German (de-DE) 56 | - Greek (el-GR) 57 | - Hindi (hi-IN) 58 | - Indonesian (id-ID) 59 | - Italian (it-IT) 60 | - Japanese (ja-JP) 61 | - Korean (ko-KR) 62 | - Norwegian (Bokmål) (nb-NO) 63 | - Polish (pl-PL) 64 | - Portuguese (Brazil) (pt-BR) 65 | - Russian (ru-RU) 66 | - Spanish (Spain) (es-ES) 67 | - Swedish (sv-SE) 68 | - Thai (th-TH) 69 | - Turkish (tr-TR) 70 | 71 | ### Describe tab languages 72 | 73 | The **Describe** tab supports the following languages: 74 | 75 | - Chinese (Simplified) (zh-CN) 76 | - Chinese (Traditional) (zh-TW) 77 | - Czech (cs-CZ) 78 | - Danish (da-DK) 79 | - Dutch (nl-NL) 80 | - English 81 | - Finnish (fi-FI) 82 | - French 83 | - German (de-DE) 84 | - Hindi (hi-IN) 85 | - Indonesian (id-ID) 86 | - Italian (it-IT) 87 | - Japanese (ja-JP) 88 | - Korean (ko-KR) 89 | - Norwegian (Bokmål) (nb-NO) 90 | - Polish (pl-PL) 91 | - Portuguese (Brazil) (pt-BR) 92 | - Russian (ru-RU) 93 | - Spanish 94 | - Swedish (sv-SE) 95 | - Thai (th-TH) 96 | - Turkish (tr-TR) 97 | -------------------------------------------------------------------------------- /docs/create-deploy-agents-sdk.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Create and Deploy a Custom Engine Agent with Microsoft 365 Agents SDK 3 | description: Use the Microsoft 365 Agents SDK to build a custom engine agent and deploy it to Microsoft 365 Copilot. 4 | author: jessicaaawu 5 | ms.author: scritchley 6 | ms.topic: conceptual 7 | ms.localizationpriority: medium 8 | ms.date: 05/15/2025 9 | ms.custom: [copilot-learning-hub] 10 | --- 11 | 12 | # Create and deploy an agent with Microsoft 365 Agents SDK 13 | 14 | The Microsoft 365 Agents SDK enables you to build custom engine agents by using the AI stack of your choice, then deploy them to Microsoft 365 Copilot. With the Microsoft 365 Agents Toolkit for Visual Studio and Visual Studio Code, you can use the built-in templates to scaffold your projects. 15 | 16 | The SDK supports integration with a wide range of models and orchestrators—including Azure Foundry, Semantic Kernel, OpenAI Agents, LangChain, or custom-built solutions. You can even combine multiple agents built with different technologies and surface them through Microsoft 365 Copilot. 17 | 18 | ## What you can do with the Microsoft 365 Agents SDK 19 | 20 | You can use the Microsoft 365 Agents SDK to: 21 | 22 | - **Build agents quickly** and surface them across multiple channels, including Microsoft 365 Copilot and Microsoft Teams. 23 | 24 | - **Use your preferred AI services** to implement agentic patterns. The SDK is model- and orchestrator-agnostic - giving you full flexibility. 25 | 26 | - **Customize agent behavior** based on the capabilities of each client channel. For example, you can tailor your agent to respond to specific events or actions in Copilot, Teams, or other platforms. 27 | 28 | ## Get started with the SDK 29 | 30 | You can get started with the Microsoft 365 Agents SDK in one of three ways: 31 | 32 | - [Use the Microsoft 365 Agents Toolkit](#use-the-agents-toolkit-recommended) (recommended) - Available in C#, JavaScript, and Python for Visual Studio and Visual Studio Code, the toolkit provides scaffolding and templates to help you set up your agent project. 33 | - [Clone a sample project](#clone-a-sample-project-or-use-the-cli) - Start with a working example and open it in your preferred IDE. 34 | - [Use the CLI](#clone-a-sample-project-or-use-the-cli) - Generate a new agent using command-line tools. 35 | 36 | ### Use the Agents Toolkit (recommended) 37 | 38 | The Microsoft 365 Agents Toolkit helps you quickly scaffold agent projects using built-in templates for Visual Studio and Visual Studio Code. 39 | 40 | The Agents Toolkit includes the following templates: 41 | 42 | - **Echo Agent / Empty Agent** - Start from a minimal baseline and add your own AI, orchestration, and knowledge sources. 43 | - **Weather Agent** - Integrate Azure Foundry or OpenAI AI services with orchestration tools like Semantic Kernel or LangChain already configured for you. 44 | 45 | You can run and test your agent locally by using the agents playground. For more information, see the following articles: 46 | 47 | - [Create a new agent using Visual Studio (C#)](/microsoft-365/agents-sdk/create-new-toolkit-project-vs) 48 | - [Create a new agent using Visual Studio Code (JavaScript & Python coming soon)](/microsoft-365/agents-sdk/create-new-toolkit-project-vsc) 49 | 50 | ### Clone a sample project or use the CLI 51 | 52 | If you prefer not to use the Agents Toolkit, you can clone a sample in GitHub or use the CLI. 53 | 54 | To get started, see the [Agents SDK quickstart](/microsoft-365/agents-sdk/create-test-basic-agent?tabs=csharp). 55 | 56 | ## Related content 57 | 58 | - [Managing Turns in the Agents SDK](/microsoft-365/agents-sdk/managing-turns) 59 | - [Using Activities](/microsoft-365/agents-sdk/using-activities) 60 | - [Creating Messages](/microsoft-365/agents-sdk/creating-messages) 61 | -------------------------------------------------------------------------------- /docs/docfx.json: -------------------------------------------------------------------------------- 1 | { 2 | "build": { 3 | "content": [ 4 | { 5 | "files": [ 6 | "**/*.md", 7 | "**/*.yml" 8 | ], 9 | "exclude": [ 10 | "**/obj/**", 11 | "**/includes/**", 12 | "_themes/**", 13 | "_themes.pdf/**", 14 | "**/docfx.json", 15 | "_repo.en-us/**", 16 | "README.md", 17 | "LICENSE", 18 | "LICENSE-CODE", 19 | "ThirdPartyNotices.md", 20 | "SECURITY.md" 21 | ] 22 | } 23 | ], 24 | "resource": [ 25 | { 26 | "files": [ 27 | "**/*.png", 28 | "**/*.jpg", 29 | "**/*.svg" 30 | ], 31 | "exclude": [ 32 | "**/obj/**", 33 | "**/includes/**", 34 | "_themes/**", 35 | "_themes.pdf/**", 36 | "**/docfx.json", 37 | "_repo.en-us/**" 38 | ] 39 | } 40 | ], 41 | "overwrite": [], 42 | "externalReference": [], 43 | "globalMetadata": { 44 | "breadcrumb_path": "/microsoft-365-copilot/extensibility/breadcrumb/toc.json", 45 | "feedback_system": "Standard", 46 | "feedback_product_url": "https://learn.microsoft.com/microsoft-365-copilot/extensibility/feedback#microsoft-365-copilot-feedback", 47 | "feedback_help_link_url": "https://learn.microsoft.com/answers/tags/466/copilot-m365-development", 48 | "feedback_help_link_type": "get-help-at-qna", 49 | "permissioned-type": "public", 50 | "uhfHeaderId": "MSDocsHeader-M365-IT", 51 | "ms.service": "microsoft-365-copilot", 52 | "ms.subservice": "developer", 53 | "ms.collection": "ce-skilling-ai-copilot", 54 | "uhfHeaderId": "MSDocsHeader-M365CopilotExt" 55 | }, 56 | "fileMetadata": {}, 57 | "template": [], 58 | "dest": "m365copilot-docs" 59 | } 60 | } 61 | -------------------------------------------------------------------------------- /docs/feedback.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Microsoft 365 Copilot Developer Community Support and Feedback Channels 3 | description: Find resources for help and support for Microsoft 365 Copilot extensibility. 4 | author: mobajemu 5 | ms.author: mobajemu 6 | ms.topic: conceptual 7 | ms.localizationpriority: medium 8 | ms.date: 12/04/2024 9 | --- 10 | 11 | # Support and feedback 12 | 13 | This article provides information about how you can get support for Microsoft 365 Copilot extensibility questions and how you can provide feedback on or contribute to the documentation. 14 | 15 | ## Developer support channels 16 | 17 | To ask general questions about Microsoft 365 Copilot and Copilot samples, use the channels listed in the following table. For any business-critical issues that need service level agreement (SLA)-based support, use the [Microsoft 365 Admin Center](https://admin.microsoft.com/Adminportal/Home#/homepage). For general questions, use [Microsoft Q&A](/answers/tags/466/copilot-m365-development). 18 | 19 | | **Support channel category** | **Channel** | 20 | |:------------|:------------| 21 | | Microsoft 365 Copilot service issues, development issues, and limited advisory support. | If you have a Premier/Unified support agreement for Microsoft 365, go to the [Microsoft 365 Admin Center](https://admin.microsoft.com/Adminportal/Home#/homepage) and use the Support menu to open a service request. | 22 | | General questions about Microsoft 365 Copilot | If you have general questions about Microsoft 365 Copilot, submit your questions to [Microsoft Q&A](/answers/tags/466/copilot-m365-development). | 23 | | Developer community help | [Microsoft Q&A](/answers/) is the site for technical questions and answers for Microsoft products. Use the [Microsoft 365 Copilot Development](/answers/tags/466/copilot-m365-development.html) tag to ask questions, connect with other developers, and submit answers. | 24 | | Extensibility samples | Submit issues and ask general questions related to samples in the respective Microsoft 365 Copilot [extensibility samples](samples.md) GitHub repositories. | 25 | 26 | ## Documentation feedback 27 | 28 | If you want to report an issue with the documentation or you'd like to make a contribution, follow the steps described in the following table. We welcome contributions through GitHub and other channels. 29 | 30 | 31 | | **Feedback type** | **Instructions** | 32 | |:------------|:------------| 33 | | Submit documentation updates | Select **Edit** at the top right of the article you want to update and submit a pull request to the [Microsoft 365 Copilot Extensibility GitHub](https://github.com/MicrosoftDocs/m365copilot-docs/blob/main/docs/index.md) repository. | 34 | | Report documentation issues | Select **Edit** at the top right of the article you want to update an [open an issue](https://github.com/MicrosoftDocs/m365copilot-docs/issues) on the [Microsoft 365 Copilot Extensibility GitHub](https://github.com/MicrosoftDocs/m365copilot-docs/blob/main/docs/index.md) repository. | 35 | 36 | ## Microsoft 365 Copilot feedback 37 | 38 | To provide feedback on Microsoft 365 Copilot, in the Copilot in-context experience or the Copilot app, select the ellipses (...) on the top right and choose **Send feedback**. You can send compliments, report a problem, or provide suggestions. -------------------------------------------------------------------------------- /docs/graph-api-tutorial.yml: -------------------------------------------------------------------------------- 1 | ### YamlMime:Tutorial 2 | title: Use Microsoft Graph APIs in your LangChain agent 3 | metadata: 4 | title: Use Microsoft Graph APIs in your LangChain agent 5 | description: Learn how to build a custom engine agent that uses Microsoft Graph APIs. 6 | audience: Developer 7 | level: Beginner 8 | displayType: one-column 9 | ms.date: 02/12/2025 10 | author: sakov-ms 11 | ms.author: sakov 12 | ms.topic: tutorial 13 | scenarios: getting-started 14 | items: 15 | - content: | 16 | [!INCLUDE [](./includes/graph-api-tutorial/01-intro.md)] 17 | - title: Complete the prerequisites 18 | content: | 19 | [!INCLUDE [](./includes/graph-api-tutorial/02-prerequisites.md)] 20 | - title: Register the app in the portal 21 | content: | 22 | [!INCLUDE [](./includes/graph-api-tutorial/03-register-app.md)] 23 | - title: Set up the project 24 | content: | 25 | [!INCLUDE [](./includes/graph-api-tutorial/04-set-up-project.md)] 26 | - title: Run your first agent 27 | content: | 28 | [!INCLUDE [](./includes/graph-api-tutorial/05-run-agent.md)] 29 | - title: Run Clippy, your personal assistant 30 | content: | 31 | [!INCLUDE [](./includes/graph-api-tutorial/06-run-personal-assistant.md)] 32 | - title: Make your agent a standalone app 33 | content: | 34 | [!INCLUDE [](./includes/graph-api-tutorial/07-make-standalone-app.md)] 35 | - title: Congratulations! 36 | content: | 37 | [!INCLUDE [](./includes/graph-api-tutorial/08-completed.md)] 38 | -------------------------------------------------------------------------------- /docs/includes/agent-template-extension-note.md: -------------------------------------------------------------------------------- 1 | --- 2 | author: kmkoenen 3 | ms.author: v-koenenkaty 4 | ms.topic: include 5 | ms.localizationpriority: medium 6 | --- 7 | 8 | 9 | 10 | > [!NOTE] 11 | > Adding connections typically requires collaboration with the service owners and IT admins. Some functionality might be available only for users in tenants with metered usage or users with Microsoft 365 Copilot licenses. -------------------------------------------------------------------------------- /docs/includes/agent-template-limitations.md: -------------------------------------------------------------------------------- 1 | --- 2 | author: kmkoenen 3 | ms.author: v-koenenkaty 4 | ms.topic: include 5 | ms.localizationpriority: medium 6 | --- 7 | 8 | 9 | 10 | ## Limitations 11 | 12 | The following limitations apply to this template: 13 | 14 | - **Interacting with the agent:** Agents created with this template are designed to answer one question at time. For best results, users shouldn't ask multiple or compound questions in a single prompt. 15 | - **Handling sensitive information:** When you create agents with this template, it's your responsibility to ensure that any personal or sensitive information used in the agent is handled according to your organization's data privacy policies. 16 | - **Incorrect or harmful responses:** Although agents based on this template are designed to prevent the output of incorrect and harmful content, these agents use generative AI technology, which can sometimes make mistakes. A disclaimer is included to remind users to verify accuracy before making decisions, especially financial decisions. Customers are responsible for conducting due diligence on AI-generated content. You can edit the disclaimer to align with your organization's policies, but we don't recommend removing it. For more information, review the [supplemental terms](https://www.microsoft.com/business-applications/legal/supp-powerplatform-preview/). -------------------------------------------------------------------------------- /docs/includes/agent-template-prerequisites.md: -------------------------------------------------------------------------------- 1 | --- 2 | author: kmkoenen 3 | ms.author: v-koenenkaty 4 | ms.topic: include 5 | ms.localizationpriority: medium 6 | --- 7 | 8 | 9 | Before you work with the template, make sure that you have: 10 | 11 | - A working knowledge of how to [build agents with Copilot Studio agent builder](../copilot-studio-agent-builder-build.md). 12 | - An understanding of how to [write effective instructions for declarative agents](../declarative-agent-instructions.md). -------------------------------------------------------------------------------- /docs/includes/api-plugins-declarative-agents-only.md: -------------------------------------------------------------------------------- 1 | --- 2 | author: jasonjoh 3 | ms.topic: include 4 | ms.localizationpriority: medium 5 | --- 6 | 7 | 8 | 9 | > [!IMPORTANT] 10 | > API plugins are only supported as actions within [declarative agents](../overview-declarative-agent.md). They are not enabled in Microsoft 365 Copilot. 11 | -------------------------------------------------------------------------------- /docs/includes/copilot-in-word-and-powerpoint.md: -------------------------------------------------------------------------------- 1 | --- 2 | author: lauragra 3 | ms.topic: include 4 | ms.localizationpriority: medium 5 | --- 6 | 7 | 8 | 9 | > [!NOTE] 10 | > Declarative agents based on Microsoft 365 Copilot are now supported in Word and PowerPoint. 11 | -------------------------------------------------------------------------------- /docs/includes/copilot-studio-agent-naming.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.topic: include 3 | ms.localizationpriority: medium 4 | --- 5 | 6 | 7 | 8 | > [!NOTE] 9 | > Microsoft Copilot Studio refers to custom engine agents as custom copilots. 10 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-gov.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.topic: include 3 | ms.localizationpriority: medium 4 | --- 5 | 6 | 7 | 8 | > [!NOTE] 9 | > Declarative agents are currently not available in [Microsoft 365 Government](https://www.microsoft.com/microsoft-365/government) tenants. 10 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/01-intro.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | A declarative agent is a customized version of Microsoft 365 Copilot that allows users to create personalized experiences by declaring specific instructions, actions, and knowledge. This guide provides information about how to build a declarative agent by using Microsoft 365 Agents Toolkit ([an evolution of Teams Toolkit](https://aka.ms/M365AgentsToolkit)). 8 | 9 | The agent that you build in this tutorial targets licensed Microsoft 365 Copilot users. You can also build agents for Microsoft 365 Copilot Chat users, with limited capabilities. For details, see [Agent capabilities for Microsoft 365 users](../../prerequisites.md#agent-capabilities-for-microsoft-365-users). 10 | 11 | :::image type="content" source="../../assets/images/build-da/ttk/agent-answer.png" alt-text="Screenshot shows the answer from the declarative agent in Microsoft 365 Copilot."::: 12 | 13 | For overview information, see [Declarative agents for Microsoft 365 Copilot](../../overview-declarative-agent.md). 14 | 15 | [!INCLUDE [copilot-in-word-and-powerpoint](../copilot-in-word-and-powerpoint.md)] 16 | 17 | ## Prerequisites 18 | 19 | Before you start, make sure that Microsoft 365 Copilot is available for your organization. 20 | 21 | The following options are available for your development environment: 22 | 23 | - A sandbox Microsoft 365 organization with Copilot (available in limited preview through [TAP membership](https://developer.microsoft.com/microsoft-365/tap)). 24 | - An [eligible Microsoft 365 or Office 365 production environment](../../prerequisites.md#organizations-with-microsoft-365-copilot-licenses) with a Microsoft 365 Copilot license. 25 | 26 | The following resources are required to complete the steps described in this article: 27 | 28 | - [Visual Studio Code](https://code.visualstudio.com/) 29 | - [Microsoft 365 Agents Toolkit Visual Studio Code extension](/microsoftteams/platform/toolkit/install-teams-toolkit?tabs=vscode#install-a-prerelease-version) 30 | 31 | [!INCLUDE [toolkit-version-note](../toolkit-version-note.md)] 32 | 33 | You should be familiar with the following standards and guidelines for declarative agents for Microsoft 365 Copilot: 34 | 35 | - Standards for compliance, performance, security, and user experience described in [Teams Store validation guidelines](/microsoftteams/platform/concepts/deploy-and-publish/appsource/prepare/teams-store-validation-guidelines#teams-apps-extensible-as-plugin-for-microsoft-copilot-for-microsoft-365). 36 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/02-create-agent.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | Begin by creating a basic declarative agent. 8 | 9 | 1. Open **Visual Studio Code**. 10 | 11 | 1. Select **Microsoft 365 Agents Toolkit > Create a New Agent/App**. 12 | 13 | :::image type="content" source="../../assets/images/build-da/ttk/create-new-app.png" alt-text="A screenshot of the Create a New Agent/App button in the Agents Toolkit sidebar"::: 14 | 15 | 1. Select **Declarative Agent**. 16 | 17 | :::image type="content" source="../../assets/images/build-da/ttk/select-copilot-agent.png" alt-text="A screenshot of the New Project options with Agent selected"::: 18 | 19 | 1. Select **No Action** to create a basic declarative agent. 20 | 21 | 1. Select **Default folder** to store your project root folder in the default location. 22 | 23 | 1. Enter `My Agent` as the **Application Name** and press **Enter**. 24 | 25 | 1. In the new Visual Studio Code window that opens, select **Microsoft 365 Agents Toolkit**, then select **Provision** in the **Lifecycle** pane. 26 | 27 | :::image type="content" source="../../assets/images/build-da/ttk/provision-agent.png" alt-text="A screenshot of the Provision option in the Lifecycle pane of Agents Toolkit"::: 28 | 29 | ## Test the agent 30 | 31 | 1. Navigate to the Copilot application with the URL [https://m365.cloud.microsoft/chat](https://m365.cloud.microsoft/chat). 32 | 33 | 1. Next to the **New Chat** button, select the conversation drawer icon. 34 | 35 | 1. Select the declarative agent **My Agent**. 36 | 37 | :::image type="content" source="../../assets/images/build-da/ttk/select-agent.png" alt-text="A screenshot of the declarative agent in Copilot"::: 38 | 39 | 1. Enter a question for your declarative agent and ensure that it replies with "Thanks for using Microsoft 365 Agents Toolkit to create your declarative agent!" 40 | 41 | :::image type="content" source="../../assets/images/build-da/ttk/agent-answer.png" alt-text="A screenshot of an answer from the declarative agent in Microsoft 365 Copilot"::: 42 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/03-add-instructions.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | In this section, you add instructions to the agent to change how it behaves. 8 | 9 | 1. Open the `appPackage/instructions.txt` file and replace its contents with the following text. 10 | 11 | ```txt 12 | You are a declarative agent and were created with Microsoft 365 Agents Toolkit. You are an expert at creating poems. 13 | 14 | Every time a user asks a question, you **must** turn the answer into a poem. The poem **must** not use the quote markdown and use regular text. 15 | ``` 16 | 17 | The contents of this file are inserted in the `instructions` property in the agent's manifest during provisioning. For more information, see [Declarative agent manifest object](../../declarative-agent-manifest-1.4.md#declarative-agent-manifest-object). 18 | 19 | 1. Select **Provision** in the **Lifecycle** pane of the Agents Toolkit. 20 | 21 | The declarative agent will use your updated instructions after you reload the page. 22 | 23 | :::image type="content" source="../../assets/images/build-da/ttk/updated-instructions.png" alt-text="A screenshot of an answer from a declarative agent based on updated instructions"::: 24 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/04-add-conversation-starters.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | In this section, you add conversation starters to your agent. Conversation starters are hints that are displayed to the user to demonstrate how they can get started using the declarative agent. 8 | 9 | 1. Open the `appPackage/declarativeAgent.json` file and add the `conversation_starters` array with the following content: 10 | 11 | ```json 12 | "conversation_starters": [ 13 | { 14 | "title": "Getting Started", 15 | "text": "How can I get started with Agents Toolkit?" 16 | }, 17 | { 18 | "title": "Getting Help", 19 | "text": "How can I get help with Agents Toolkit?" 20 | } 21 | ] 22 | ``` 23 | 24 | For more information, see [Conversation starters object](../../declarative-agent-manifest-1.4.md#conversation-starters-object). 25 | 26 | 1. Select **Provision** in the **Lifecycle** pane of the Teams Toolkit. 27 | 28 | The updated conversation starters will be available in your declarative agent after you refresh the page. 29 | 30 | :::image type="content" source="../../assets/images/build-da/ttk/conversation-starters.png" alt-text="A screenshot showing the conversation starters from the declarative agent in Microsoft 365 Copilot"::: 31 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/05-add-web-content.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | In this section, you add the ability to search the web to the agent. 8 | 9 | 1. Open the `appPackage/declarativeAgent.json` file and add the `capabilities` array with the following content. 10 | 11 | ```json 12 | "capabilities": [ 13 | { 14 | "name": "WebSearch" 15 | } 16 | ] 17 | ``` 18 | 19 | For more information, see [Web search object](../../declarative-agent-manifest-1.4.md#web-search-object). 20 | 21 | 1. Select **Provision** in the **Lifecycle** pane of the Teams Toolkit. 22 | 23 | The declarative agent will have access to web content to generate its answers after you reload the page. 24 | 25 | :::image type="content" source="../../assets/images/build-da/ttk/web-content.png" alt-text="A screenshot showing a response from the declarative agent that contains web content"::: 26 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/06-add-onedrive-sharepoint.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | In this section, you add the contents of a SharePoint site to the available knowledge for the agent. 8 | 9 | 1. Open the `appPackage/declarativeAgent.json` file and update the `capabilities` array to the following value, replacing `https://contoso.sharepoint.com/sites/ProductSupport` with a SharePoint site URL in your Microsoft 365 organization. 10 | 11 | ```json 12 | "capabilities": [ 13 | { 14 | "name": "WebSearch" 15 | }, 16 | { 17 | "name": "OneDriveAndSharePoint", 18 | "items_by_url": [ 19 | { 20 | "url": "https://contoso.sharepoint.com/sites/ProductSupport" 21 | } 22 | ] 23 | } 24 | ] 25 | ``` 26 | 27 | For more information, see [OneDrive and SharePoint object](../../declarative-agent-manifest-1.4.md#onedrive-and-sharepoint-object). 28 | 29 | > [!NOTE] 30 | > 31 | > - URLs should be full path to SharePoint items (site, document library, folder, or file). You can use the "Copy direct link" option in SharePoint to get the full path or files and folders. Right-click on the file or folder and select **Details**. Navigate to **Path** and select the copy icon. 32 | > - Not specifying the `items_by_url` array (or the alternative `items_by_sharepoint_ids` array) causes all OneDrive and SharePoint content in your Microsoft 365 organization that is available to the logged in user to be available to the agent. 33 | 34 | 1. Select **Provision** in the **Lifecycle** pane of the Teams Toolkit. 35 | 36 | The declarative agent will have access to OneDrive and SharePoint content to generate its answers after you reload the page. 37 | 38 | :::image type="content" source="../../assets/images/build-da/ttk/sharepoint-onedrive-content.png" alt-text="A screenshot showing a response from the declarative agent that contains SharePoint and OneDrive content"::: 39 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/07-add-teams-messages.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | In this section, you provide the declarative agent with Teams channels, team, and meeting chat grounding information. 8 | 9 | 1. Open the `appPackage/declarativeAgent.json` file and update the `capabilities` array to the following value, replacing `https://teams.microsoft.com/l/team/...` with a Teams channel or team url from your organization. 10 | 11 | ```json 12 | "capabilities": [ 13 | { 14 | "name": "WebSearch" 15 | }, 16 | { 17 | "name": "OneDriveAndSharePoint", 18 | "items_by_url": [ 19 | { 20 | "url": "https://contoso.sharepoint.com/sites/ProductSupport" 21 | } 22 | ] 23 | }, 24 | { 25 | "name": "TeamsMessages", 26 | "urls": [ 27 | { 28 | "url": "https://teams.microsoft.com/l/team/..." 29 | } 30 | ] 31 | } 32 | ] 33 | ``` 34 | 35 | For more information, see [Teams messages object](../../declarative-agent-manifest-1.4.md#teams-messages-object). 36 | 37 | > [!NOTE] 38 | > - The url in the url object must be well formed links to a Teams chat, team, or meeting chat. 39 | > - Not specifying the `urls` array causes all Teams channels, teams, meetings, 1:1 chat, and group chats in your Microsoft 365 organization that is available to the logged in user to be available to the agent. 40 | 41 | 1. Select **Provision** in the **Lifecycle** pane of the Teams Toolkit. 42 | 43 | The declarative agent will have access to Teams data to generate its answers after you reload the page. 44 | 45 | :::image type="content" source="../../assets/images/build-da/ttk/teams-content.png" alt-text="A screenshot showing a response from the declarative agent that contains Teams content"::: 46 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/08-add-people.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | In this section, you add the [people capability](../../knowledge-sources.md#people) to the declarative agent. The people capability allows you to scope your agent to answer questions about individuals in an organization. 8 | 9 | 1. Open the `appPackage/declarativeAgent.json` file and add the `People` entry to the `capabilities` array. 10 | 11 | ```json 12 | "capabilities": [ 13 | { 14 | "name": "WebSearch" 15 | }, 16 | { 17 | "name": "OneDriveAndSharePoint", 18 | "items_by_url": [ 19 | { 20 | "url": "https://contoso.sharepoint.com/sites/ProductSupport" 21 | } 22 | ] 23 | }, 24 | { 25 | "name": "TeamsMessages", 26 | "urls": [ 27 | { 28 | "url": "https://teams.microsoft.com/l/team/..." 29 | } 30 | ] 31 | }, 32 | { 33 | "name": "People" 34 | } 35 | ] 36 | ``` 37 | 38 | For more information, see [People object](../../declarative-agent-manifest-1.4.md#people-object). 39 | 40 | 1. Select **Provision** in the **Lifecycle** pane of the Teams Toolkit. 41 | 42 | The declarative agent will have access to people knowledge after you reload the page. 43 | 44 | :::image type="content" source="../../assets/images/build-da/ttk/people-content.png" alt-text="A screenshot showing a response from the declarative agent that contains people knowledge"::: 45 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/09-add-email.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | In this section, you add the [email capability](../../knowledge-sources.md#email) to the declarative agent. The email capability allows you to scope your agent to use email from the user's mailbox or a shared mailbox as a knowledge source. 8 | 9 | 1. Open the `appPackage/declarativeAgent.json` file and add the `Email` entry to the `capabilities` array. 10 | 11 | ```json 12 | "capabilities": [ 13 | { 14 | "name": "WebSearch" 15 | }, 16 | { 17 | "name": "OneDriveAndSharePoint", 18 | "items_by_url": [ 19 | { 20 | "url": "https://contoso.sharepoint.com/sites/ProductSupport" 21 | } 22 | ] 23 | }, 24 | { 25 | "name": "TeamsMessages", 26 | "urls": [ 27 | { 28 | "url": "https://teams.microsoft.com/l/team/..." 29 | } 30 | ] 31 | }, 32 | { 33 | "name": "People" 34 | }, 35 | { 36 | "name": "Email", 37 | "folders": [ 38 | { 39 | "folder_id": "inbox" 40 | } 41 | ] 42 | } 43 | ] 44 | ``` 45 | 46 | For more information, see [Email object](../../declarative-agent-manifest-1.4.md#email-object). 47 | 48 | > [!NOTE] 49 | > 50 | > - This example accesses the user of the agent's mailbox. To access a shared mailbox instead, add the optional `shared_mailbox` property set to the email address of the shared mailbox. 51 | > - The `folders` array limits the mailbox access to specific folders. To access the entire mailbox, omit the `folders` array. 52 | 53 | 1. Select **Provision** in the **Lifecycle** pane of the Teams Toolkit. 54 | 55 | The declarative agent will have access to email knowledge after you reload the page. 56 | 57 | :::image type="content" source="../../assets/images/build-da/ttk/email-content.png" alt-text="A screenshot showing a response from the declarative agent that contains email knowledge"::: 58 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/10-add-graphic-art.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | In this section, you add the [image generator capability](../../image-generator.md) to the declarative agent. 8 | 9 | 1. Open the `appPackage/declarativeAgent.json` file and add the `GraphicArt` entry to the `capabilities` array. 10 | 11 | ```json 12 | "capabilities": [ 13 | { 14 | "name": "WebSearch" 15 | }, 16 | { 17 | "name": "OneDriveAndSharePoint", 18 | "items_by_url": [ 19 | { 20 | "url": "https://contoso.sharepoint.com/sites/ProductSupport" 21 | } 22 | ] 23 | }, 24 | { 25 | "name": "TeamsMessages", 26 | "urls": [ 27 | { 28 | "url": "https://teams.microsoft.com/l/team/..." 29 | } 30 | ] 31 | }, 32 | { 33 | "name": "People" 34 | }, 35 | { 36 | "name": "Email", 37 | "folders": [ 38 | { 39 | "folder_id": "inbox" 40 | } 41 | ] 42 | }, 43 | { 44 | "name": "GraphicArt" 45 | } 46 | ] 47 | ``` 48 | 49 | For more information, see [Graphic art object](../../declarative-agent-manifest-1.4.md#graphic-art-object). 50 | 51 | 1. Select **Provision** in the **Lifecycle** pane of the Agents Toolkit. 52 | 53 | The declarative agent will have the ability to generate images after you reload the page. 54 | 55 | :::image type="content" source="../../assets/images/build-da/ttk/graphic-art-content.png" alt-text="A screenshot showing a response from the declarative agent that contains generated graphic art"::: 56 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/11-add-code-interpreter.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | In this section, you add the [code interpreter capability](../../code-interpreter.md) to the declarative agent. Code interpreter is an advanced tool designed to solve complex tasks via Python code. 8 | 9 | 1. Open the `appPackage/declarativeAgent.json` file and add the `CodeInterpreter` entry to the `capabilities` array. 10 | 11 | ```json 12 | "capabilities": [ 13 | { 14 | "name": "WebSearch" 15 | }, 16 | { 17 | "name": "OneDriveAndSharePoint", 18 | "items_by_url": [ 19 | { 20 | "url": "https://contoso.sharepoint.com/sites/ProductSupport" 21 | } 22 | ] 23 | }, 24 | { 25 | "name": "TeamsMessages", 26 | "urls": [ 27 | { 28 | "url": "https://teams.microsoft.com/l/team/..." 29 | } 30 | ] 31 | }, 32 | { 33 | "name": "People" 34 | }, 35 | { 36 | "name": "Email", 37 | "folders": [ 38 | { 39 | "folder_id": "inbox" 40 | } 41 | ] 42 | }, 43 | { 44 | "name": "GraphicArt" 45 | }, 46 | { 47 | "name": "CodeInterpreter" 48 | } 49 | ] 50 | ``` 51 | 52 | For more information, see [Code interpreter object](../../declarative-agent-manifest-1.4.md#code-interpreter-object). 53 | 54 | 1. Select **Provision** in the **Lifecycle** pane of the Agents Toolkit. 55 | 56 | The declarative agent will have the code interpreter capability after you reload the page. 57 | 58 | :::image type="content" source="../../assets/images/build-da/ttk/code-interpreter-graph-content.png" alt-text="A screenshot showing a response from the declarative agent that contains a generated graph"::: 59 | 60 | :::image type="content" source="../../assets/images/build-da/ttk/code-interpreter-python-content.png" alt-text="A screenshot showing the Python code used to generate the requested graph"::: 61 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/12-add-copilot-connectors.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | In this section, you add items ingested by a Microsoft 365 Copilot connector (formerly Microsoft Graph connectors) to the available knowledge for the agent. 8 | 9 | 1. Open the `appPackage/declarativeAgent.json` file and update the `capabilities` array to the following value, replacing `policieslocal` with a valid Copilot connector ID in your Microsoft 365 organization. For more information about how to find Copilot connector IDs, see [Retrieving capabilities IDs for declarative agent manifest](../../declarative-agent-capabilities-ids.md#microsoft-365-copilot-connectors). 10 | 11 | ```json 12 | "capabilities": [ 13 | { 14 | "name": "WebSearch" 15 | }, 16 | { 17 | "name": "OneDriveAndSharePoint", 18 | "items_by_url": [ 19 | { 20 | "url": "https://contoso.sharepoint.com/sites/ProductSupport" 21 | } 22 | ] 23 | }, 24 | { 25 | "name": "TeamsMessages", 26 | "channels_by_url": [ 27 | { 28 | "url": "https://teams.microsoft.com/l/team/..." 29 | } 30 | ] 31 | }, 32 | { 33 | "name": "People" 34 | }, 35 | { 36 | "name": "Email", 37 | "folders": [ 38 | { 39 | "folder_id": "inbox" 40 | } 41 | ] 42 | }, 43 | { 44 | "name": "GraphicArt" 45 | }, 46 | { 47 | "name": "CodeInterpreter" 48 | }, 49 | { 50 | "name": "GraphConnectors", 51 | "connections": [ 52 | { 53 | "connection_id": "policieslocal" 54 | } 55 | ] 56 | } 57 | ] 58 | ``` 59 | 60 | For more information, see [Copilot connectors object](../../declarative-agent-manifest-1.4.md#copilot-connectors-object). 61 | 62 | > [!NOTE] 63 | > 64 | > - Not specifying the `connections` array causes all Copilot connectors content in your Microsoft 365 organization that is available to the logged in user to be available to the agent. 65 | 66 | 1. Select **Provision** in the **Lifecycle** pane of the Agents Toolkit. 67 | 68 | The declarative agent will have access to Copilot connectors content to generate its answers after you reload the page. 69 | 70 | :::image type="content" source="../../assets/images/build-da/ttk/graph-connector-content.png" alt-text="A screenshot showing a response from the declarative agent that contains Copilot connector content"::: 71 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/13-add-plugins.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | In this section, you add an [API plugin](../../overview-api-plugins.md) as an action to your agent. API plugins add new abilities to your agent by allowing your agent to interact with a REST API. 8 | 9 | Before you begin, create a file named `posts-api.yml` and add the code from the [Posts API OpenAPI description document](#posts-api-openapi-description-document). 10 | 11 | 1. Select **Add Action** in the **Development** pane of Agents Toolkit. 12 | 13 | 1. Select **Start with an OpenAPI Description Document**. 14 | 15 | 1. Select **Browse** and browse to the `posts-api.yml` file. 16 | 17 | 1. Select all available APIs, then select **OK**. 18 | 19 | :::image type="content" source="../../assets/images/build-da/ttk/select-apis.png" alt-text="A screenshot of the API selection dialog in Visual Studio code"::: 20 | 21 | 1. Select **manifest.json**. 22 | 23 | 1. Review the warning in the dialog. When you're ready to proceed, select **Add**. 24 | 25 | 1. Select **Provision** in the **Lifecycle** pane of the Agents Toolkit. 26 | 27 | The declarative agent will have access to your plugin content to generate its answers after you reload the page. 28 | 29 | :::image type="content" source="../../assets/images/build-da/ttk/plugin-response.png" alt-text="A screenshot showing a response from the declarative agent that contains API plugin content"::: 30 | 31 | ## Posts API OpenAPI description document 32 | 33 | The following OpenAPI description is for the [JSONPlaceHolder API](https://jsonplaceholder.typicode.com/), a free online REST API that you can use whenever you need some fake data. 34 | 35 | :::code language="yml" source="posts-api.yml"::: 36 | -------------------------------------------------------------------------------- /docs/includes/declarative-agents-walkthrough/14-completed.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | You've completed the declarative agent guide for Microsoft 365 Copilot. Now that you're familiar with the capabilities of a declarative agent, you can learn more about declarative agents in the following articles. 8 | 9 | - Learn how to [write effective instructions](../../declarative-agent-instructions.md) for your agent. 10 | - Test your agent with [Copilot developer mode](../../debugging-copilot-agent.md) to verify if and how the copilot orchestrator selects your knowledge sources for use in response to given prompts. 11 | - Get answers to [frequently asked questions](../../transparency-faq-declarative-agent.md). 12 | - Learn about an alternative method of building declarative agents with [Copilot Studio agent builder](../../copilot-studio-agent-builder.md). 13 | -------------------------------------------------------------------------------- /docs/includes/graph-api-tutorial/01-intro.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | Custom engine agents are specialized chat experiences that can be built on any LLM, toolchain, or orchestration tool. This tutorial shows you how to build a custom engine agent that serves as a personal assistant that can tell you about the weather or help you plan a work trip. 8 | 9 | The following image shows an example of a chat with the personal assistant you'll build. 10 | 11 | :::image type="content" source="../../assets/images/clippy.png" alt-text="An image of the Clippy personal assistant showing a hello message and a response to a user query." border="false"::: 12 | 13 | In this tutorial, you will: 14 | 15 | 1. Learn how to build a LangChain agent in Python. 16 | 2. Add tools that connect with Microsoft Graph APIs. 17 | 3. Build the front end for your agent using Chainlit library. 18 | 19 | > [!TIP] 20 | > You can download the code for this tutorial from the [CopilotDevX GitHub repo](https://github.com/OfficeDev/CopilotDevX). 21 | -------------------------------------------------------------------------------- /docs/includes/graph-api-tutorial/02-prerequisites.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | To complete this tutorial, you should have some familiarity with Python. For an introduction to Python, see the [Python tutorial on W3Schools](https://www.w3schools.com/python/default.asp). 8 | 9 | > [!NOTE] 10 | > This tutorial uses Python version 3.10.4 and pip version 24.3.1. 11 | 12 | ## Prerequisites 13 | 14 | 1. Install [Python](https://www.python.org/) and [pip](https://pip.pypa.io/en/stable/) on your development computer. 15 | 2. Install [Jupyter](https://jupyter.org/install) to use Jupyter notebooks with this tutorial. 16 | 3. Get a Microsoft work or school account with an Exchange Online mailbox, if you don't already have one. 17 | 18 | > [!NOTE] 19 | > If you don't have a Microsoft 365 tenant, you might qualify for one through the [Microsoft 365 Developer Program](https://developer.microsoft.com/microsoft-365/dev-program); for details, see the [FAQ](https://learn.microsoft.com/en-us/office/developer-program/microsoft-365-developer-program-faq#who-qualifies-for-a-microsoft-365-e5-developer-subscription-). Alternatively, you can [sign up for a one-month free trial or purchase a Microsoft 365 plan](https://www.microsoft.com/en-us/microsoft-365/try). 20 | 21 | 4. Get an OpenAI API Key. To get one, create an account with OpenAI and follow the steps in the [Developer quickstart](https://platform.openai.com/docs/quickstart). You need to buy a license to use the OpenAI GPT models, but you can pay only for what you need. 22 | 5. Get a Tavily Search API Key, if you want your agent to do a web search to answer your user queries. To get one, go to the [Tavily site](https://app.tavily.com/sign-in) and create an account. We recommend that you get this API key; it has a free tier for hobby-level projects. 23 | 6. Optionally, if you want log traces, go to [LangSmith](https://smith.langchain.com/) and make sure to set your environment variables to start logging traces. LangSmith isn't required but it's helpful. 24 | -------------------------------------------------------------------------------- /docs/includes/graph-api-tutorial/03-register-app.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | In this exercise, you register a new application in Microsoft Entra ID to enable [user authentication](/graph/auth-v2-user). You can register an application using the Microsoft Entra admin center, or by using the [Microsoft Graph PowerShell SDK](/graph/powershell/get-started). 7 | 8 | ## Register application for user authentication 9 | 10 | In this section, you register an application that supports user authentication using [device code flow](/azure/active-directory/develop/v2-oauth2-device-code). 11 | 12 | 13 | 1. Open a browser, go to the [Microsoft Entra admin center](https://entra.microsoft.com), and sign using a Global administrator account. 14 | 15 | 2. In the left navigation, select **Microsoft Entra ID**, expand **Identity**, expand **Applications**, and then select **App registrations**. 16 | 17 | :::image type="content" source="../../assets/images/entra-portal-app-registrations.png" alt-text="A screenshot of the App registrations"::: 18 | 19 | 3. Select **New registration**. Enter a name for your application; for example, `Clippy`. 20 | 21 | 4. Set **Supported account types** as needed. The following table lists the options. 22 | 23 | | Option | Who can sign in? | 24 | |--------|------------------| 25 | | **Accounts in this organizational directory only** | Only users in your Microsoft 365 organization | 26 | | **Accounts in any organizational directory** | Users in any Microsoft 365 organization (work or school accounts) | 27 | | **Accounts in any organizational directory ... and personal Microsoft accounts** | Users in any Microsoft 365 organization (work or school accounts) and personal Microsoft accounts | 28 | 29 | 5. Leave **Redirect URI** empty. 30 | 31 | 6. Select **Register**. On the application's **Overview** page, copy the value of the **Application (client) ID** and save it; you'll need it in the next step. If you chose **Accounts in this organizational directory only** for **Supported account types**, also copy the **Directory (tenant) ID** and save it. 32 | 33 | 7. Select **Authentication** under **Manage**. Locate the **Advanced settings** section and change the **Allow public client flows** toggle to **Yes**, then choose **Save**. 34 | 35 | :::image type="content" source="../../assets/images/aad-default-client-type.png" alt-text="A screenshot of the Allow public client flows toggle"::: 36 | 37 | 8. Under **Manage**, go to **API Permissions** and choose **Add a Permission**. In **Microsoft APIs**, choose **Microsoft Graph**, and select **Delegated permissions**. From the list of permissions, select *Calendars.Read*, *Contacts.Read*, *Mail.Read*, *User.Read*, *Calendars.ReadBasic*, *Mail.ReadBasic*, and *User.ReadAll*. -------------------------------------------------------------------------------- /docs/includes/graph-api-tutorial/04-set-up-project.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | Next, set up the project: 8 | 9 | 1. Go to the [CopilotDevX GitHub repo](https://github.com/OfficeDev/CopilotDevX) GitHub repo and download the zip file or clone the repository. 10 | 11 | 2. Go to the folder that contains the **.env** file. Add your values for the fields as follows: 12 | 13 | ``` 14 | OPENAI_API_KEY=xxxxxx 15 | TAVILY_API_KEY=xxxxxx 16 | LANGCHAIN_API_KEY=xxxxxx 17 | CLIENT_ID=xxxxx 18 | TENANT_ID=xxxxx 19 | USERNAME={your email id} 20 | ``` 21 | 22 | 3. Install all the required libraries: 23 | 1. Open a Windows command prompt. 24 | 2. Go to the folder that contains **requirements.txt**. 25 | 3. Run the following command to install all the right libraries: 26 | `pip install --requirement=.\requirements.txt` 27 | -------------------------------------------------------------------------------- /docs/includes/graph-api-tutorial/05-run-agent.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | Next, run the agent: 8 | 9 | 1. Open a command prompt and go to the folder where the repository is. 10 | 2. Type the following command: `jupyter notebook`. This opens a web page that contains all your scripts. 11 | 3. To make sure your LangChain setup is working, start with a simple agent: 12 | 13 | 1. Select the **firstAgent** script. It will open in a separate page. 14 | 2. Click the **run** icon. You should see the following output. 15 | 16 | :::image type="content" source="../../assets/images/jupyter-output.png" alt-text="An image that shows the jupyter output." border="false"::: 17 | 18 | The script does the following: 19 | 20 | - Sets the variables from the .env file. 21 | - Uses the gpt-4o-mini model. 22 | - Asks the agent to act like a character from Star Wars. 23 | - The `Hello! What are you up to?` text is the user query that is passed to the agent. 24 | - The `*Roooaaarrr!......` text is the output generated by the agent. 25 | 26 | > [!NOTE] 27 | > If you run into an error because modules aren't available, you can install those Python packages from inside Jupyter Notebook. Go to a new line and type: 28 | > 29 | > `%pip install {package-name}` 30 | 31 | Congratulations! You have successfully created your first agent. You can change characters and text input fields and run the script again to see what your agent does. 32 | -------------------------------------------------------------------------------- /docs/includes/graph-api-tutorial/06-run-personal-assistant.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | Now that your setup is working, you can run Clippy. Clippy is a personal assistant that can talk to Microsoft Graph APIs and web search APIs. 8 | 9 | 1. On the Jupyter home page, choose the **Clippy2** script to open it in a separate page. 10 | 2. Run the script. The output provides a Microsoft device code window that asks you to open a URL and provide a code. 11 | 3. Copy the code, select the URL, and a new tab or window opens. Paste the code and sign in. You only need to do this step for the first run; the access_token is saved and used for later runs. 12 | 13 | :::image type="content" source="../../assets/images/enter-code.png" alt-text="An image of the CEnter code to allow access dialog box." border="false"::: 14 | 15 | 4. Close the window. Wait for a second for your agent to get the access_token required. You should then see a series of queries and responses. 16 | 17 | :::image type="content" source="../../assets/images/clippy-response.png" alt-text="An image that shows a Clippy query and response." border="false"::: 18 | 19 | The script does the following: 20 | 21 | - Imports libraries. 22 | - Declares the scopes of the data to access via the Microsoft Graph APIs. 23 | - Loads the .env files and sets those variables for the agent to use. 24 | - Uses the Microsoft Authentication Library (MSAL) to get the access token. 25 | - Creates two tools: getEvents and getContacts. Each tool talks to a Microsoft Graph API endpoint. 26 | - Does web searches with a third tool called Tavily Search, which is provided by LangChain. 27 | - Creates a memory object to save the queries and send them as context (system messages) in the prompts sent to the agent. 28 | - Logs all conversations against a session_id:def234. 29 | - Sends user queries for the agent to respond. 30 | 31 | Congratulations! Your personal assistant is set up and is answering complex questions about your work trip. You can change the queries in the script and run it again to see how your agent performs. 32 | -------------------------------------------------------------------------------- /docs/includes/graph-api-tutorial/07-make-standalone-app.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | Now that your agent is up and running, you can give it a UI and host it so that you can access it in a browser similar to ChatGPT. You use the Chainlit Python package to do this. 8 | 9 | 1. Open a command prompt and go to the folder that contains **ClippywithUI.py**. 10 | 2. Run the following command: `Chainlit run ClippywithUI.py -w`. 11 | 3. Your agent opens in a browser and you should be able to ask it questions. 12 | 13 | :::image type="content" source="../../assets/images/agent-in-browser.png" alt-text="An image of the Clippy personal assistant running in a browser." border="false"::: 14 | -------------------------------------------------------------------------------- /docs/includes/graph-api-tutorial/08-completed.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.localizationpriority: medium 3 | --- 4 | 5 | 6 | 7 | Congratulations! You've successfully completed the tutorial. Now that you're familiar with the capabilities of an agent and Microsoft Graph APIs, you can experiment and add new features. 8 | 9 | ## Next steps 10 | 11 | - Learn how to use [app-only authentication](/graph/tutorials/python-app-only) with the Microsoft Graph SDK for Python. 12 | - Learn more about the data you can access with [Microsoft Graph](/graph/overview). 13 | -------------------------------------------------------------------------------- /docs/includes/latest-declarative-agent-manifest.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.topic: include 3 | ms.localizationpriority: medium 4 | --- 5 | 6 | 7 | 8 | > [!IMPORTANT] 9 | > The latest version of the declarative agent manifest schema is [version 1.4](../declarative-agent-manifest-1.4.md). We recommend new agents use the latest schema version. 10 | -------------------------------------------------------------------------------- /docs/includes/latest-plugin-manifest.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.topic: include 3 | ms.localizationpriority: medium 4 | --- 5 | 6 | 7 | 8 | > [!IMPORTANT] 9 | > The latest version of the API plugin manifest schema is [version 2.3](../api-plugin-manifest-2.3.md). We recommend new plugins use the latest schema version. 10 | -------------------------------------------------------------------------------- /docs/includes/preview-disclaimer-cea.md: -------------------------------------------------------------------------------- 1 | --- 2 | ms.topic: include 3 | ms.localizationpriority: medium 4 | --- 5 | 6 | 7 | 8 | > [!IMPORTANT] 9 | > Custom engine agents for Microsoft 365 Copilot Chat are currently in public preview. 10 | -------------------------------------------------------------------------------- /docs/includes/preview-disclaimer-copilot-no-license.md: -------------------------------------------------------------------------------- 1 | --- 2 | author: aycabas 3 | ms.topic: include 4 | ms.localizationpriority: medium 5 | --- 6 | 7 | 8 | 9 | > [!IMPORTANT] 10 | > 11 | > - Custom engine agents are specialized chat experiences that can be built on any LLM, toolchain, or orchestration tool tailored to the domain or tenant workflows. They don't require a Microsoft 365 Copilot license to build, debug and deploy. However, custom engine agents are only available to licensed Microsoft 365 Copilot users or users in tenants that allow metered usage of agents. 12 | > - The cost of a custom engine agent depends on the Azure services consumed in the app. To estimate the cost, visit the [Azure Pricing Calculator](https://azure.microsoft.com/pricing/calculator/). 13 | -------------------------------------------------------------------------------- /docs/includes/preview-disclaimer-declarative-agents.md: -------------------------------------------------------------------------------- 1 | --- 2 | author: aycabas 3 | ms.topic: include 4 | ms.localizationpriority: medium 5 | --- 6 | 7 | 8 | 9 | > [!IMPORTANT] 10 | > Declarative agents for Microsoft 365 are currently generally available; however, all users might not have access during the staged rollout. 11 | -------------------------------------------------------------------------------- /docs/includes/preview-disclaimer-me.md: -------------------------------------------------------------------------------- 1 | --- 2 | author: girliemac 3 | ms.topic: include 4 | ms.localizationpriority: medium 5 | --- 6 | 7 | 8 | 9 | > [!IMPORTANT] 10 | > Message extensions as Copilot plugins are currently in public preview with limited functionality. Message extension plugins work as standalone experiences in Microsoft 365 Copilot in Teams, Word, and PowerPoint; however, they can't be added from declarative agents. 11 | -------------------------------------------------------------------------------- /docs/includes/preview-disclaimer.md: -------------------------------------------------------------------------------- 1 | --- 2 | author: jasonjoh 3 | ms.topic: include 4 | ms.localizationpriority: medium 5 | --- 6 | 7 | 8 | 9 | > [!IMPORTANT] 10 | > 11 | > - API plugins are currently only supported as actions within [declarative agents](../overview-declarative-agent.md). They aren't enabled in Microsoft 365 Copilot. For an example that shows how to add an API plugin to a declarative agent, see [Add a plugin](../build-declarative-agents.yml?tutorial-step=7). 12 | > - The capability is enabled by default in all Microsoft 365 Copilot-licensed tenants. Admins can disable this functionality on a user and group basis and control how individual plugins are approved for use, and which plugins are enabled. For more information, see [Manage Agents in Integrated Apps](/microsoft-365/admin/manage/manage-plugins-for-copilot-in-integrated-apps?context=/microsoft-365-copilot/extensibility/context). 13 | -------------------------------------------------------------------------------- /docs/includes/sample-manifests/declarative-agent-sample-manifest-1.0.json: -------------------------------------------------------------------------------- 1 | { 2 | "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.0/schema.json", 3 | "version": "v1.0", 4 | "name": "Microsoft 365 Agents Toolkit declarative copilot", 5 | "description": "Declarative copilot created with Agents Toolkit", 6 | "instructions": "You are a repairs expert copilot. With the response from the listRepairs function, you **must** create a poem out of the repairs listed and always include their title and the assigned person. The poem **must** not use the quote markdown and use regular text. If the user is asking to create a new repair, use the createRepair function and do not add poems.", 7 | "conversation_starters": [ 8 | { 9 | "title": "Getting Started", 10 | "text": "How can I get started with Agents Toolkit?" 11 | }, 12 | { 13 | "title": "Getting Help", 14 | "text": "How can I get help with Agents Toolkit?" 15 | } 16 | ], 17 | "actions": [ 18 | { 19 | "id": "repairsPlugin", 20 | "file": "repairs-hub-api-plugin.json" 21 | } 22 | ], 23 | "capabilities": [ 24 | { 25 | "name": "WebSearch" 26 | }, 27 | { 28 | "name": "OneDriveAndSharePoint", 29 | "items_by_url": [ 30 | { 31 | "url": "https://contoso.sharepoint.com/sites/ProductSupport" 32 | } 33 | ] 34 | }, 35 | { 36 | "name": "GraphConnectors", 37 | "connections": [ 38 | { 39 | "connection_id": "foodStore" 40 | } 41 | ] 42 | } 43 | ] 44 | } 45 | -------------------------------------------------------------------------------- /docs/includes/sample-manifests/declarative-agent-sample-manifest-1.2.json: -------------------------------------------------------------------------------- 1 | { 2 | "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.2/schema.json", 3 | "version": "v1.2", 4 | "name": "Microsoft 365 Agents Toolkit declarative copilot", 5 | "description": "Declarative copilot created with Agents Toolkit", 6 | "instructions": "You are a repairs expert copilot. With the response from the listRepairs function, you **must** create a poem out of the repairs listed and always include their title and the assigned person. The poem **must** not use the quote markdown and use regular text. If the user is asking to create a new repair, use the createRepair function and do not add poems.", 7 | "conversation_starters": [ 8 | { 9 | "title": "Getting Started", 10 | "text": "How can I get started with Agents Toolkit?" 11 | }, 12 | { 13 | "title": "Getting Help", 14 | "text": "How can I get help with Agents Toolkit?" 15 | } 16 | ], 17 | "actions": [ 18 | { 19 | "id": "repairsPlugin", 20 | "file": "repairs-hub-api-plugin.json" 21 | } 22 | ], 23 | "capabilities": [ 24 | { 25 | "name": "WebSearch", 26 | "sites": [ 27 | { 28 | "url": "https://contoso.com/projects/mark-8" 29 | } 30 | ] 31 | }, 32 | { 33 | "name": "OneDriveAndSharePoint", 34 | "items_by_url": [ 35 | { 36 | "url": "https://contoso.sharepoint.com/sites/ProductSupport" 37 | } 38 | ] 39 | }, 40 | { 41 | "name": "GraphConnectors", 42 | "connections": [ 43 | { 44 | "connection_id": "foodStore" 45 | } 46 | ] 47 | }, 48 | { 49 | "name": "GraphicArt" 50 | }, 51 | { 52 | "name": "CodeInterpreter" 53 | } 54 | ] 55 | } 56 | -------------------------------------------------------------------------------- /docs/includes/sample-manifests/declarative-agent-sample-manifest-1.3.json: -------------------------------------------------------------------------------- 1 | { 2 | "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.3/schema.json", 3 | "version": "v1.3", 4 | "name": "Microsoft 365 Agents Toolkit declarative copilot", 5 | "description": "Declarative copilot created with Agents Toolkit", 6 | "instructions": "You are a repairs expert copilot. With the response from the listRepairs function, you **must** create a poem out of the repairs listed and always include their title and the assigned person. The poem **must** not use the quote markdown and use regular text. If the user is asking to create a new repair, use the createRepair function and do not add poems.", 7 | "conversation_starters": [ 8 | { 9 | "title": "Getting Started", 10 | "text": "How can I get started with Agents Toolkit?" 11 | }, 12 | { 13 | "title": "Getting Help", 14 | "text": "How can I get help with Agents Toolkit?" 15 | } 16 | ], 17 | "actions": [ 18 | { 19 | "id": "repairsPlugin", 20 | "file": "repairs-hub-api-plugin.json" 21 | } 22 | ], 23 | "capabilities": [ 24 | { 25 | "name": "WebSearch", 26 | "sites": [ 27 | { 28 | "url": "https://contoso.com/projects/mark-8" 29 | } 30 | ] 31 | }, 32 | { 33 | "name": "OneDriveAndSharePoint", 34 | "items_by_url": [ 35 | { 36 | "url": "https://contoso.sharepoint.com/sites/ProductSupport" 37 | } 38 | ] 39 | }, 40 | { 41 | "name": "GraphConnectors", 42 | "connections": [ 43 | { 44 | "connection_id": "foodStore" 45 | } 46 | ] 47 | }, 48 | { 49 | "name": "GraphicArt" 50 | }, 51 | { 52 | "name": "CodeInterpreter" 53 | }, 54 | { 55 | "name": "Dataverse", 56 | "knowledge_sources": [ 57 | { 58 | "host_name": "organization.crm.dynamics.com", 59 | "skill": "DVCopilotSkillName", 60 | "tables": [ 61 | { 62 | "table_name": "account" 63 | }, 64 | { 65 | "table_name": "opportunity" 66 | } 67 | ] 68 | } 69 | ] 70 | }, 71 | { 72 | "name": "TeamsMessages", 73 | "urls": [ 74 | { 75 | "url": "https://teams.microsoft.com/l/channel/19%3ApO0102YGEBRSH6RziXCxEgB4mtb7-5hIlDzAjtxs_dg1%40thread.tacv2/G%C3%A9n%C3%A9ral?groupId=2670cf94-acf5-48f4-96d4-c58dd8937afc&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47" 76 | } 77 | ] 78 | }, 79 | { 80 | "name": "Email", 81 | "shared_mailbox": "sample@service.microsoft.com", 82 | "folders": [ 83 | { 84 | "folder_id": "sentitems" 85 | } 86 | ] 87 | }, 88 | { 89 | "name": "People" 90 | } 91 | ] 92 | } 93 | -------------------------------------------------------------------------------- /docs/includes/sample-manifests/declarative-agent-sample-manifest-1.4.json: -------------------------------------------------------------------------------- 1 | { 2 | "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.4/schema.json", 3 | "version": "v1.4", 4 | "name": "Teams Toolkit declarative agent", 5 | "description": "Declarative agent created with Teams Toolkit", 6 | "instructions": "You are a repairs expert agent. With the response from the listRepairs function, you **must** create a poem out of the repairs listed and always include their title and the assigned person. The poem **must** not use the quote markdown and use regular text. If the user is asking to create a new repair, use the createRepair function and do not add poems.", 7 | "sensitivity_label": { 8 | "id": "c7d25882-b276-4ad8-851b-f84cb0146605" 9 | }, 10 | "disclaimer": { 11 | "text": "This declarative agent is a fictional example. You should not take it seriously." 12 | }, 13 | "conversation_starters": [ 14 | { 15 | "title": "Getting Started", 16 | "text": "How can I get started with Teams Toolkit?" 17 | }, 18 | { 19 | "title": "Getting Help", 20 | "text": "How can I get help with Teams Toolkit?" 21 | } 22 | ], 23 | "actions": [ 24 | { 25 | "id": "repairsPlugin", 26 | "file": "repairs-hub-api-plugin.json" 27 | } 28 | ], 29 | "capabilities": [ 30 | { 31 | "name": "WebSearch", 32 | "sites": [ 33 | { 34 | "url": "https://contoso.com/projects/mark-8" 35 | } 36 | ] 37 | }, 38 | { 39 | "name": "OneDriveAndSharePoint", 40 | "items_by_url": [ 41 | { 42 | "url": "https://contoso.sharepoint.com/sites/ProductSupport" 43 | } 44 | ] 45 | }, 46 | { 47 | "name": "GraphConnectors", 48 | "connections": [ 49 | { 50 | "connection_id": "foodStore" 51 | } 52 | ] 53 | }, 54 | { 55 | "name": "GraphicArt" 56 | }, 57 | { 58 | "name": "CodeInterpreter" 59 | }, 60 | { 61 | "name": "Dataverse", 62 | "knowledge_sources": [ 63 | { 64 | "host_name": "organization.crm.dynamics.com", 65 | "skill": "DVCopilotSkillName", 66 | "tables": [ 67 | { 68 | "table_name": "account" 69 | }, 70 | { 71 | "table_name": "opportunity" 72 | } 73 | ] 74 | } 75 | ] 76 | }, 77 | { 78 | "name": "TeamsMessages", 79 | "urls": [ 80 | { 81 | "url": "https://teams.microsoft.com/l/channel/19%3ApO0102YGEBRSH6RziXCxEgB4mtb7-5hIlDzAjtxs_dg1%40thread.tacv2/G%C3%A9n%C3%A9ral?groupId=2670cf94-acf5-48f4-96d4-c58dd8937afc&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47" 82 | } 83 | ] 84 | }, 85 | { 86 | "name": "Email", 87 | "shared_mailbox": "sample@service.microsoft.com", 88 | "folders": [ 89 | { 90 | "folder_id": "inbox" 91 | } 92 | ] 93 | }, 94 | { 95 | "name": "People" 96 | }, 97 | { 98 | "name": "ScenarioModels", 99 | "models": [ 100 | { 101 | "id": "model_id" 102 | } 103 | ] 104 | } 105 | ] 106 | } 107 | -------------------------------------------------------------------------------- /docs/includes/security-on-das-note.md: -------------------------------------------------------------------------------- 1 | --- 2 | author: isvargasmsft 3 | ms.topic: include 4 | ms.localizationpriority: medium 5 | --- 6 | 7 | 8 | 9 | ### Ensuring a secure implementation of declarative agents in Microsoft 365 10 | 11 | Microsoft 365 customers and partners can build declarative agents that extend Microsoft 365 Copilot with custom instructions, grounding knowledge, and actions invoked via REST API descriptions configured by the declarative agent. At runtime, Microsoft 365 Copilot reasons over a combination of the user's prompt, custom instructions that are part of the declarative agent, and data provided by custom actions. All of this data might influence the behavior of the system, and such processing comes with security risks. Specifically, if a custom action can provide data from untrusted sources (such as emails or support tickets), an attacker might be able to craft a message payload that causes your agent to behave in a way that the attacker controls, such as incorrectly answering questions or even invoking custom actions. Microsoft takes many measures to prevent such attacks. In addition, organizations should only enable declarative agents that use trusted knowledge sources and connect to trusted REST APIs via custom actions. If the use of untrusted data sources is necessary, design the declarative agent with the possibility of breach in mind and don't give it the ability to perform sensitive operations without careful human intervention. 12 | 13 | Microsoft 365 provides organizations with extensive controls that govern who can acquire and use integrated apps and which apps are enabled for groups or individuals within a Microsoft 365 tenant, including apps that use declarative agents. Tools like Copilot Studio, which enable users to create their own declarative agents, also include extensive controls that allow admins to govern connectors used for both knowledge and custom actions. -------------------------------------------------------------------------------- /docs/includes/toolkit-version-note.md: -------------------------------------------------------------------------------- 1 | --- 2 | author: jasonjoh 3 | ms.topic: include 4 | ms.localizationpriority: medium 5 | --- 6 | 7 | 8 | 9 | > [!NOTE] 10 | > The screenshots and references to user interface of the Microsoft 365 Agents Toolkit ([an evolution of Teams Toolkit](https://aka.ms/M365AgentsToolkit)) in this document were generated using the latest **Release** version, 6.0. Pre-Release versions of Agents Toolkit may differ from the user interface in this document. 11 | -------------------------------------------------------------------------------- /docs/m365-agents-sdk.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Build custom engine agents with Microsoft 365 Agents SDK 3 | description: Introduction of Microsoft 365 Agents SDK to build custom engine agents 4 | author: girliemac 5 | ms.author: timura 6 | ms.localizationpriority: medium 7 | ms.date: 05/19/2025 8 | ms.topic: overview 9 | --- 10 | 11 | # Build custom engine agents with Microsoft 365 Agents SDK 12 | 13 | **Microsoft 365 Agents SDK** is a comprehensive framework for building full-stack, multi-channel agents that operate seamlessly across Microsoft 365 Copilot, Teams, third-party platforms, custom applications, and websites. It integrates effortlessly with AI services like Azure AI Foundry and orchestration layers such as Semantic Kernel. 14 | 15 | :::image type="content" source="assets/images/build-with-agents-sdk.png" alt-text="Visual representation of a user input and a bot response." lightbox="assets/images/build-with-agents-sdk.png"::: 16 | 17 | This SDK is best suited if you need highly tailored agents with advanced capabilities and the ability to operate across multiple channels. 18 | 19 | ## When to use Microsoft 365 Agents SDK 20 | 21 | - You need fine-grained control over model and orchestrator selection. 22 | - You want to leverage your prior experience with the Bot Framework. 23 | - You’re familiar with orchestration frameworks like [Semantic Kernel](/semantic-kernel/overview/) or [Langchain](https://www.langchain.com/). 24 | 25 | ## Next step 26 | 27 | Ready to build your first agent with the Microsoft 365 Agents SDK? Kick off your journey now: 28 | 29 | > [!div class="nextstepaction"] 30 | > [Microsoft 365 Agents SDK documentation (preview)](/microsoft-365/agents-sdk/agents-sdk-overview) 31 | -------------------------------------------------------------------------------- /docs/optimize-sharepoint-content.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Optimize SharePoint Content Retrieval in Your Agent 3 | description: Find best practices to optimize how your agent in Microsoft 365 Copilot retrieves content from SharePoint. 4 | author: lauragra 5 | ms.author: lauragra 6 | ms.topic: best-practice 7 | ms.date: 01/31/2025 8 | --- 9 | 10 | # Optimize SharePoint content retrieval 11 | 12 | Declarative agents extend Microsoft 365 Copilot to customize the experience for users. When you build declarative agents, you can add SharePoint content as a knowledge source. This article describes the best practices to apply to optimize how your agent returns data from SharePoint knowledge sources. 13 | 14 | > [!NOTE] 15 | > Agents grounded in SharePoint data are only available to users in tenants that have Copilot Studio metering enabled or users who have Microsoft 365 Copilot licenses. For details, see [Agent capabilities for Microsoft 365 users](prerequisites.md#agent-capabilities-for-microsoft-365-users). 16 | 17 | ## Reference only relevant SharePoint files 18 | 19 | You can reference specific SharePoint files via the `OneDriveAndSharePoint` object in the [agent manifest](declarative-agent-manifest-1.4.md#onedrive-and-sharepoint-object), either by URL or by ID. 20 | 21 | When you specify up to 20 files, Copilot searches the full contents of all files. Copilot will have full access to all the file content and returns the appropriate content to the user based on their query. If you specify more than 20 SharePoint files, Copilot chooses content from the most relevant 20 files, rather than searching all the files specified, and only returns content from those files. 22 | 23 | To optimize the content that Copilot returns, choose the most relevant SharePoint files to specify in your manifest. For example, if a folder contains eight files and only five are relevant to the users' task, specify the five files individually instead of referencing the folder. As a best practice to ensure that Copilot searches the full file contents, strive to limit the total page count of the relevant files that you specify to no more than 300 pages. 24 | 25 | ## Limit SharePoint file size 26 | 27 | When you reference SharePoint sites or folders by URL in your [agent manifest](declarative-agent-manifest-1.4.md#onedrive-and-sharepoint-object), Copilot might have trouble identifying the right content to return to the user when the files included in the site or folder are large. To reduce the risk that Copilot won't find the right content in the sites or folders you reference, strive to keep your SharePoint files to a maximum of 36,000 characters (approximately 15-20 pages). If your files are larger than 36,000 characters, consider breaking them up into separate shorter files to help Copilot scan the full contents. 28 | 29 | Alternatively, you can reference specific SharePoint files by ID. Copilot will search the full contents if you specify five or fewer files, or it will search the five most relevant files if you specify more than five files. 30 | 31 | ## Remove special formatting 32 | 33 | Copilot is currently unable to parse tables and other special formatting in SharePoint content. To ensure that Copilot can consume your SharePoint content, remove tables or other special formatting from the content before you reference it in your agent manifest. 34 | 35 | ## Related content 36 | 37 | - [Declarative agents overview](overview-declarative-agent.md) 38 | - [Known issues](known-issues.md) 39 | 40 | -------------------------------------------------------------------------------- /docs/overview-message-extension-bot.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Build message extensions for Microsoft 365 Copilot 3 | description: Introducing message extensions as plugins for Microsoft 365 Copilot 4 | author: girliemac 5 | ms.author: timura 6 | ms.topic: overview 7 | ms.localizationpriority: medium 8 | ms.date: 12/09/2024 9 | --- 10 | 11 | # Message extensions for Microsoft 365 Copilot 12 | 13 | Message extensions are a powerful feature in Microsoft Teams and Outlook that are designed to facilitate user engagement with your web service. Additionally, they allow users to interact with your app directly from the chat interface. 14 | 15 | These interactions are typically triggered via buttons and forms within Microsoft Teams and Outlook clients. This mechanism allows users to search or initiate actions in an external system, right from the compose message area, or even directly from a message. The outcomes of these interactions are delivered back to the client in the form of a richly formatted card. 16 | 17 | > [!IMPORTANT] 18 | > Message extensions are available in [Government Community Cloud (GCC), GCC-High, and Department of Defense (DOD)](/microsoftteams/platform/concepts/app-fundamentals-overview#government-community-cloud?context=/microsoft-365-copilot/extensibility/context) environments. 19 | 20 | ## Message extension with Copilot 21 | 22 | With the introduction of Microsoft 365 Copilot, the game has changed. Users can now use natural language input to invoke a message extension's search function, bypassing the need for specific UI commands. In essence, your users' words become the catalyst for Copilot's actions to call the appropriate plugin for their request. 23 | 24 | [!INCLUDE [preview-disclaimer for ME](includes/preview-disclaimer-me.md)] 25 | 26 | The following illustration shows how a user interaction with a message extension differs in the Teams client and Microsoft 365 Copilot. 27 | 28 | :::image type="content" source="assets/images/message-extensions-ux.png" alt-text="Illustration of two different user experiences for message extensions, one way is to invoke from Teams client and another is with Copilot" lightbox="assets/images/message-extensions-ux.png"::: 29 | 30 | Your users can do much more than just search queries. With the integration of message extensions and Microsoft 365 Copilot, they can ask all sorts of follow-up questions. Because Copilot is powered by Generative AI, it can understand, summarize, predict, and generate content across many Microsoft 365 applications, thereby boosting user productivity and creativity. 31 | 32 | A user can ask Copilot what products are in stock, and then, for example, she can also ask Copilot to populate a table with various products. She can then instruct Copilot to draft an email summarizing the inventory as a reminder for the supplier. 33 | 34 | ## Build message extensions using Bot Framework 35 | 36 | There are a few ways to build [message extensions](/microsoftteams/platform/messaging-extensions/what-are-messaging-extensions), but to extend the capabilities for Copilot, you need to build your extension with [Bot Framework](https://dev.botframework.com/) SDK, which is used to create various bots, including Teams bots. 37 | 38 | For development, you can use Microsoft 365 Agents Toolkit ([an evolution of Teams Toolkit](https://aka.ms/M365AgentsToolkit)) for Visual Studio Code to build your message extensions. The toolkit helps you to create a project by scaffolding a template that suits your needs. 39 | 40 | ## Related content 41 | 42 | [Teams message extensions overview video](https://www.youtube.com/embed/vvNFCagkdcE) 43 | -------------------------------------------------------------------------------- /docs/teams-ai-library.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Build custom engine agents with Teams AI Library 3 | description: Introduction of Teams AI Library v2 SDK to build custom engine agents 4 | author: girliemac 5 | ms.author: timura 6 | ms.localizationpriority: medium 7 | ms.date: 05/19/2025 8 | ms.topic: overview 9 | --- 10 | 11 | # Build custom engine agents with Teams AI Library 12 | 13 | **Teams AI library** is a Teams-centric interface for integrating GPT-based language models and user intent engines. It includes a built-in action planner orchestrator and simplifies the development process by reducing the need to write and maintain complex conversational bot logic. 14 | 15 | :::image type="content" source="assets/images/build-with-teams-ai-library.png" alt-text="Visual representation of a user input and a bot response." lightbox="assets/images/build-with-teams-ai-library.png"::: 16 | 17 | Now with the new v2 SDK, it supports Agent2Agent (A2A) for multi-agent collaboration and Model Context Protocol (MCP) for shared memory and tools. 18 | 19 | ## When to use Teams AI Library v2 20 | 21 | - You're looking to tailor model selection, but want to use an orchestrator provided by SDK. 22 | - You want to apply your prior experience with Teams bot development. 23 | - You want to make your agents available to all Microsoft 365 users. 24 | - You want your agents interact in real time with users in a collaborative team-based environment. 25 | 26 | ## Next step 27 | 28 | Ready to build your first agent with the Teams AI Library v2? Let's get started now! 29 | 30 | > [!div class="nextstepaction"] 31 | > [Teams AI Library v2 documentation (preview)](/microsoftteams/platform/teams-ai-library/welcome) 32 | -------------------------------------------------------------------------------- /docs/transparency-faq-declarative-agent.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Declarative Agents in Microsoft 365 Copilot FAQ 3 | description: The transparency FAQ for declarative agents provides detailed information about what declarative agents are, their intended uses, and how they're evaluated. 4 | author: simranajwani 5 | ms.author: simranajwani 6 | ms.topic: faq 7 | ms.localizationpriority: medium 8 | ms.date: 12/04/2024 9 | --- 10 | 11 | # Declarative agents FAQ 12 | 13 | This FAQ answers common questions about what declarative agents for Microsoft 365 Copilot are, their intended uses, and how they're evaluated. 14 | 15 | ## What are declarative agents? 16 | 17 | Declarative agents are customized versions of Microsoft 365 Copilot that enable customers to create personalized experiences that run in Microsoft 365 Copilot. This feature builds on the Microsoft 365 Copilot system. Users can build declarative agents with capabilities and instructions that define the agent's purpose and behavior. Users can also add the option to access enterprise knowledge (including SharePoint and Microsoft 365 Copilot connectors - formerly Microsoft Graph connectors). To learn more, see [Declarative agents for Microsoft 365](/microsoft-365-copilot/extensibility/overview-declarative-agent). 18 | 19 | ## What can declarative agents do? 20 | 21 | Declarative agents provide a custom chat experience without a need to write imperative code. They can be created and used privately or published to make them available to other users. Users can see declarative agents on the right side panel in Microsoft 365 Copilot and in the Copilot experiences in Teams, Word, and PowerPoint. 22 | 23 | ## What are declarative agents intended uses? 24 | 25 | Declarative agents provide a custom chat experience based on the power of Microsoft 365 Copilot. Users are familiar with the idea of asking an expert; equipped with appropriate instructions, connectors, and actions, declarative agents can become experts with a minimum of development effort. 26 | 27 | For more information about how you can tailor your declarative agents, see [Declarative agents for Microsoft 365](overview-declarative-agent.md#tailor-declarative-agents-for-your-scenario). 28 | 29 | ## How were declarative agents evaluated? What metrics are used to measure performance? 30 | 31 | All response generation features of agents are tested, measured, and validated internally before they are released. Such evaluations are done using extensive experimentation to ensure accurate, grounded, and responsible responses that align with human preferences. 32 | 33 | For each capability that is supported in declarative agents, we conduct several tests to validate Microsoft 365 Copilot. In addition to all Microsoft 365 Copilot related capabilities, Responsible AI (RAI) testing was performed on different harm types to evaluate defect rates. The defect scores are then used to improve the model and mitigate the harm. It's important to keep in mind that the system was designed to mimic natural human communication, but the output can be inaccurate, incorrect, or out of date. 34 | 35 | ## What are the limitations of declarative agents and how can users minimize the effects? 36 | 37 | Disclaimers with terms and privacy commitments for users appear on the home page for each declarative agent. For line-of-business developers and IT admins, Copilot extensibility solutions are managed in the Microsoft 365 admin center. For more information about how Microsoft 365 Copilot uses, protects, and shares organizational information to power extensibility, see [Data, Privacy, and Security for Microsoft 365 Copilot](/copilot/microsoft-365/microsoft-365-copilot-privacy). 38 | -------------------------------------------------------------------------------- /docs/whats-new-history.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: What's New Archive for Microsoft 365 Copilot Extensibility 3 | description: Find out what's new in Microsoft 365 Copilot extensibility, including plugins, declarative agents, custom engine agents, connectors, and more. 4 | author: lauragra 5 | ms.author: lauragra 6 | ms.localizationpriority: medium 7 | ms.date: 06/03/2025 8 | ms.topic: overview 9 | --- 10 | 11 | # What's new history for Microsoft 365 Copilot extensibility 12 | 13 | Find historical information about additions and updates to Microsoft 365 Copilot extensibility options. 14 | 15 | For the current what's new information, see [What's new in Microsoft 365 Copilot extensibility](whats-new.md). 16 | 17 | ## December 2024 18 | 19 | ### Add code interpreter to your declarative agent 20 | 21 | Add the code interpreter capability to your declarative agent by using the Copilot Studio agent builder or Agents Toolkit. To learn more, see [Add capabilities to your declarative agent](code-interpreter.md). 22 | 23 | ## November 2024 24 | 25 | ### Add image generator to your declarative agent 26 | 27 | Add the image generator capability to your declarative agent by using the Copilot Studio agent builder or Agents Toolkit.. To learn more, see [Add capabilities to your declarative agent](image-generator.md). 28 | 29 | ### Declarative agent manifest version 1.2 30 | 31 | A new version of the declarative agent manifest schema has been released. Version 1.2 adds support for scoped web search and the new code interpreter and image generator capabilities. To learn more, see [Declarative agent schema 1.2 for Microsoft 365 Copilot](declarative-agent-manifest-1.2.md). 32 | 33 | ### API plugin manifest version 2.2 34 | 35 | A new version of the API plugin manifest schema has been released. Version 2.2 adds support for data handling attestation. To learn more, see [API plugin manifest schema 2.2 for Microsoft 365 Copilot](api-plugin-manifest-2.2.md). 36 | 37 | ## October 2024 38 | 39 | ### Use the Copilot Studio agent builder to build declarative agents 40 | 41 | Use the Copilot Studio agent builder to create and customize agents for your specific scenarios. With the agent builder, you can use natural language to describe your agent, or you can build it manually via a rich authoring experience. To learn more, see [Overview of Copilot Studio agent builder](copilot-studio-agent-builder.md). 42 | 43 | ## September 2024 44 | 45 | ### Build your own agent 46 | 47 | You can build your own agents to focus on your specific use cases. Provide custom instructions to tailor responses, ground agents in your organization's data, and add more skills with actions. 48 | 49 | You can build agents in two ways: 50 | 51 | - [Build declarative agents](overview-declarative-agent.md) by using the Microsoft 365 Copilot orchestrator and foundation models. You can use Visual Studio Code or the Copilot Studio agent builder. 52 | - [Build custom engine agents](overview-custom-engine-agent.md) with your custom orchestrator and foundation models by using Azure AI Foundry and Visual Studio Code. 53 | -------------------------------------------------------------------------------- /redirects/.openpublishing.redirection.december-2024.json: -------------------------------------------------------------------------------- 1 | { 2 | "redirections": [ 3 | { 4 | "source_path_from_root": "/docs/prerequisites-message-extension-bot.md", 5 | "redirect_url": "/microsoft-365-copilot/extensibility/prerequisites", 6 | "redirect_document_id": false 7 | } 8 | ] 9 | } 10 | -------------------------------------------------------------------------------- /redirects/.openpublishing.redirection.march-2025.json: -------------------------------------------------------------------------------- 1 | { 2 | "redirections": [ 3 | { 4 | "source_path_from_root": "/docs/debugging-copilot-plugin.md", 5 | "redirect_url": "/microsoft-365-copilot/extensibility/debugging-copilot-agent", 6 | "redirect_document_id": false 7 | } 8 | ] 9 | } -------------------------------------------------------------------------------- /redirects/.openpublishing.redirection.may-2025.json: -------------------------------------------------------------------------------- 1 | { 2 | "redirections": [ 3 | { 4 | "source_path_from_root": "/docs/add-agent-capabilities.md", 5 | "redirect_url": "/microsoft-365-copilot/extensibility/knowledge-sources", 6 | "redirect_document_id": false 7 | }, 8 | { 9 | "source_path_from_root": "/docs/overview-graph-connector.md", 10 | "redirect_url": "/microsoft-365-copilot/extensibility/overview-copilot-connector", 11 | "redirect_document_id": false 12 | }, 13 | { 14 | "source_path_from_root": "/docs/decision-guide.md", 15 | "redirect_url": "/microsoft-365-copilot/extensibility/agents-overview", 16 | "redirect_document_id": false 17 | } 18 | ] 19 | } 20 | -------------------------------------------------------------------------------- /redirects/.openpublishing.redirection.november-2024.json: -------------------------------------------------------------------------------- 1 | { 2 | "redirections": [ 3 | { 4 | "source_path_from_root": "/docs/declarative-agent-manifest.md", 5 | "redirect_url": "/microsoft-365-copilot/extensibility/declarative-agent-manifest-1.2", 6 | "redirect_document_id": false 7 | }, 8 | { 9 | "source_path_from_root": "/docs/api-plugin-manifest.md", 10 | "redirect_url": "/microsoft-365-copilot/extensibility/api-plugin-manifest-2.2", 11 | "redirect_document_id": false 12 | } 13 | ] 14 | } 15 | -------------------------------------------------------------------------------- /redirects/.openpublishing.redirection.september-2024.json: -------------------------------------------------------------------------------- 1 | { 2 | "redirections": [ 3 | { 4 | "source_path_from_root": "/docs/plugins-are-apps.md", 5 | "redirect_url": "/microsoft-365-copilot/extensibility/agents-are-apps", 6 | "redirect_document_id": true 7 | }, 8 | { 9 | "source_path_from_root": "/docs/ttk-declarative-copilot-getting-started.md", 10 | "redirect_url": "/microsoft-365-copilot/extensibility/build-declarative-agents", 11 | "redirect_document_id": true 12 | }, 13 | { 14 | "source_path_from_root": "/docs/overview-declarative-copilot.md", 15 | "redirect_url": "/microsoft-365-copilot/extensibility/overview-declarative-agent", 16 | "redirect_document_id": true 17 | }, 18 | { 19 | "source_path_from_root": "/docs/overview-custom-engine-copilot.md", 20 | "redirect_url": "/microsoft-365-copilot/extensibility/overview-custom-engine-agent", 21 | "redirect_document_id": true 22 | } 23 | , 24 | { 25 | "source_path_from_root": "/docs/build-or-extend.md", 26 | "redirect_url": "/microsoft-365-copilot/extensibility/agents-overview", 27 | "redirect_document_id": false 28 | } 29 | ] 30 | } 31 | -------------------------------------------------------------------------------- /scripts/CleanupUnusedImages.ps1: -------------------------------------------------------------------------------- 1 | # Get all files in the images directory and subdirectories 2 | $images = Get-ChildItem -Path "./docs/assets/images" -Recurse | Where-Object { -not $_.PSIsContainer } 3 | 4 | Write-Host "Found" $images.Length "image files" 5 | 6 | $unusedFileCount = 0 7 | 8 | foreach($file in $images) 9 | { 10 | # This command finds any lines in any text file that contains the file name 11 | $references = Get-ChildItem -Path "./docs" -Recurse | Select-String $file.Name 12 | 13 | # If there's at least one hit, keep the file 14 | if ($references.Length -gt 0) 15 | { 16 | Write-Host -ForegroundColor Green $file.Name "found in" $references.Length "files" 17 | } 18 | else 19 | { 20 | Write-Host -ForegroundColor Red $file.Name "found in 0 files" 21 | $unusedFileCount++ 22 | Remove-Item -Path $file 23 | } 24 | } 25 | 26 | Write-Host -ForegroundColor Cyan "Total unused files:" $unusedFileCount 27 | --------------------------------------------------------------------------------