CINXE.COM

<!DOCTYPE html><html class="hasSidebar hasPageActions hasBreadcrumb conceptual has-default-focus theme-light" lang="en-us" dir="ltr" data-authenticated="false" data-auth-status-determined="false" data-target="docs" x-ms-format-detection="none"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta property="og:title" content="Quickstart: Create and deploy an agent - Microsoft Copilot Studio" /> <meta property="og:type" content="website" /> <meta property="og:url" content="https://learn.microsoft.com/en-us/microsoft-copilot-studio/fundamentals-get-started" /><meta property="og:description" content="Create and publish a Microsoft Copilot Studio agent on the online portal in minutes." /><meta property="og:image" content="https://learn.microsoft.com/en-us/media/open-graph-image.png" /> <meta property="og:image:alt" content="Microsoft Learn" /> <meta name="twitter:card" content="summary_large_image" /> <meta name="twitter:site" content="@MicrosoftLearn" /> <meta name="color-scheme" content="light dark"><meta name="author" content="iaanw" /> <meta name="breadcrumb_path" content="/microsoft-copilot-studio/breadcrumb/toc.json" /> <meta name="depot_name" content="Learn.copilot-studio" /> <meta name="description" content="Create and publish a Microsoft Copilot Studio agent on the online portal in minutes." /> <meta name="document_id" content="ed7e0683-eb1e-64b3-2d5e-ec62373d42ea" /> <meta name="document_version_independent_id" content="ed7e0683-eb1e-64b3-2d5e-ec62373d42ea" /> <meta name="feedback_help_link_type" content="" /> <meta name="feedback_help_link_url" content="" /> <meta name="feedback_product_url" content="https://powerusers.microsoft.com/t5/Power-Virtual-Agents-Community/ct-p/PVACommunity" /> <meta name="feedback_system" content="Standard" /> <meta name="git_commit_id" content="ee0325b0718953fe57db9d3b6241eb93ef43d86f" /> <meta name="gitcommit" content="https://github.com/MicrosoftDocs/businessapps-copilot-docs-pr/blob/ee0325b0718953fe57db9d3b6241eb93ef43d86f/copilot-studio/fundamentals-get-started.md" /> <meta name="locale" content="en-us" /> <meta name="manager" content="kjette" /> <meta name="ms.author" content="ggupta" /> <meta name="ms.collection" content="bap-ai-copilot" /> <meta name="ms.custom" content="fundamentals, portal, ceX" /> <meta name="ms.date" content="10/10/2024" /> <meta name="ms.reviewer" content="cchew" /> <meta name="ms.service" content="copilot-studio" /> <meta name="ms.topic" content="article" /> <meta name="original_content_git_url" content="https://github.com/MicrosoftDocs/businessapps-copilot-docs-pr/blob/live/copilot-studio/fundamentals-get-started.md" /> <meta name="page_type" content="conceptual" /> <meta name="recommendations" content="true" /> <meta name="schema" content="Conceptual" /> <meta name="search.app" content="capaedac-pva" /> <meta name="search.app" content="powervirtualagents-docs" /> <meta name="site_name" content="Docs" /> <meta name="toc_rel" content="toc.json" /> <meta name="uhfHeaderId" content="MSDocsHeader-MicrosoftCopilotStudio" /> <meta name="updated_at" content="2024-11-19 01:01 PM" /> <meta name="word_count" content="3550" /> <meta name="persistent_id" content="f68cc002-3ef3-ed76-9cd5-ef9c5dc80e55" /> <meta name="cmProducts" content="https://authoring-docs-microsoft.poolparty.biz/devrel/63959238-cb90-4871-a33d-4a5519097e47" data-source="generated" /> <meta name="cmProducts" content="https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/46e3c7c4-fe77-4a6e-b40a-44c569819fa5" data-source="generated" /> <meta name="cmProducts" content="https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/c389ea6b-b6a0-46df-93a1-1e21f25e19e7" data-source="generated" /> <meta name="spProducts" content="https://authoring-docs-microsoft.poolparty.biz/devrel/78d87f42-5582-4a6b-90be-7db2f12b34e6" data-source="generated" /> <meta name="spProducts" content="https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/d0c6fab8-2d7d-4bb0-bf40-589e08d7c132" data-source="generated" /> <meta name="spProducts" content="https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/19ada1b6-705b-4ed7-aad0-bffd1bd03dfa" data-source="generated" /> <meta name="scope" content="Microsoft Copilot Studio" /><meta name="github_feedback_content_git_url" content="https://github.com/MicrosoftDocs/businessapps-copilot-docs-pr/blob/live/copilot-studio/fundamentals-get-started.md" /><link href="https://learn.microsoft.com/en-us/microsoft-copilot-studio/fundamentals-get-started" rel="canonical"><title>Quickstart: Create and deploy an agent - Microsoft Copilot Studio | Microsoft Learn</title><link rel="stylesheet" href="/static/assets/0.4.028726178/styles/site-ltr.css"> <script id="msdocs-script"> var msDocs = {environment: { supportLevel: 'production', accessLevel: 'online', reviewFeatures: false, systemContent: true, azurePortalHostname: 'portal.azure.com', legacyHosting: false, siteName: 'learn', },data: { timeOrigin: Date.now(), contentLocale: 'en-us', contentDir: 'ltr', userLocale: 'en-us', userDir: 'ltr', pageTemplate: 'Conceptual', brand: '', context: {}, hasBinaryRating: true, feedbackHelpLinkType:'', feedbackHelpLinkUrl:'', standardFeedback: true, showFeedbackReport: false, enableTutorialFeedback: false, feedbackSystem: 'Standard', feedbackGitHubRepo: '', feedbackProductUrl: 'https://powerusers.microsoft.com/t5/Power-Virtual-Agents-Community/ct-p/PVACommunity',extendBreadcrumb: false,isEditDisplayable: false, hideViewSource: false, hasPageActions: true, hasPrintButton: true, hasBookmark: true, hasShare: true, isPermissioned: false, isPrivateUnauthorized: false,hasRecommendations: true,contributors: [{ name: "iaanw", url: "https://github.com/iaanw" },{ name: "steph-kent", url: "https://github.com/steph-kent" },{ name: "sad-cl0wn", url: "https://github.com/sad-cl0wn" },{ name: "steph-kent-ms", url: "https://github.com/steph-kent-ms" },{ name: "jhaskett-msft", url: "https://github.com/jhaskett-msft" },{ name: "Eric-tw-convAI", url: "https://github.com/Eric-tw-convAI" },{ name: "bolducs", url: "https://github.com/bolducs" },{ name: "GitikaG", url: "https://github.com/GitikaG" },{ name: "peterswimm", url: "https://github.com/peterswimm" },{ name: "svnielse", url: "https://github.com/svnielse" }],}, functions:{} }; </script><script src="https://wcpstatic.microsoft.com/mscc/lib/v2/wcp-consent.js"></script> <script src="https://js.monitor.azure.com/scripts/c/ms.jsll-4.min.js"></script><script src="/static/assets/0.4.028726178/global/deprecation.js"></script><script src="/static/assets/0.4.028726178/scripts/en-us/index-docs.js"></script></head> <body lang="en-us" dir="ltr"> <div class="header-holder has-default-focus"> <a href="#main" style="z-index: 1070" class="outline-color-text visually-hidden-until-focused position-fixed inner-focus focus-visible top-0 left-0 right-0 padding-xs text-align-center has-body-background" tabindex="1">Skip to main content</a><div hidden id="cookie-consent-holder" data-test-id="cookie-consent-container"></div> <div id="unsupported-browser" style=" background-color: white; color: black; padding: 16px; border-bottom: 1px solid grey;" hidden > <div style="max-width: 800px; margin: 0 auto;"> <p style="font-size: 24px">This browser is no longer supported.</p> <p style="font-size: 16px; margin-top: 16px;">Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.</p> <div style="margin-top: 12px;"> <a href="https://go.microsoft.com/fwlink/p/?LinkID=2092881 " style=" background-color: #0078d4; border: 1px solid #0078d4; color: white; padding: 6px 12px; border-radius: 2px; display: inline-block; ">Download Microsoft Edge</a> <a href="https://learn.microsoft.com/en-us/lifecycle/faq/internet-explorer-microsoft-edge" style=" background-color: white; padding: 6px 12px; border: 1px solid #505050; color: #171717; border-radius: 2px; display: inline-block; ">More info about Internet Explorer and Microsoft Edge</a> </div> </div> </div>   <header id="ms--site-header" data-test-id="site-header-wrapper" role="banner" itemscope="itemscope" itemtype="http://schema.org/Organization"> <div id="ms--mobile-nav" class="site-header display-none-tablet padding-inline-none gap-none" data-bi-name="mobile-header" data-test-id="mobile-header"></div> <div id="ms--primary-nav" class="site-header display-none display-flex-tablet" data-bi-name="L1-header" data-test-id="primary-header"></div> <div id="ms--secondary-nav" class="site-header display-none display-flex-tablet" data-bi-name="L2-header" data-test-id="secondary-header"></div> </header><div id="content-header" class="content-header uhf-container has-padding has-default-focus border-bottom-none" data-bi-name="content-header"> <div class="content-header-controls margin-xxs margin-inline-sm-tablet"> <button type="button" class="contents-button button button-sm margin-right-xxs" data-bi-name="contents-expand" aria-haspopup="true" data-contents-button> <span class="icon"><span class="docon docon-menu" aria-hidden="true"></span></span> <span class="contents-expand-title">Table of contents</span> </button> <button type="button" class="ap-collapse-behavior ap-expanded button button-sm" data-bi-name="ap-collapse" aria-controls="action-panel"> <span class="icon"><span class="docon docon-exit-mode" aria-hidden="true"></span></span> <span>Exit focus mode</span> </button> </div> </div><div id="disclaimer-holder" class="has-overflow-hidden has-default-focus">  </div> </div> <div class="mainContainer uhf-container has-default-focus" data-bi-name="body"> <div class="columns has-large-gaps is-gapless-mobile "><div id="left-container" class="left-container is-hidden-mobile column is-one-third-tablet is-one-quarter-desktop"> <nav id="affixed-left-container" class="margin-top-sm-tablet position-sticky display-flex flex-direction-column" aria-label="Primary"></nav> </div> <section class="primary-holder column is-two-thirds-tablet is-three-quarters-desktop">  <div class="columns is-gapless-mobile has-large-gaps "><div id="main-column" class="column is-full is-8-desktop"> <main id="main" class="" role="main" data-bi-name="content" lang="en-us" dir="ltr"> <div id="article-header" class="background-color-body margin-top-sm-tablet margin-bottom-xs display-none-print"> <div class="display-flex align-items-center "><details id="article-header-breadcrumbs-overflow-popover" class="popover" data-for="article-header-breadcrumbs"> <summary class="button button-clear button-primary button-sm inner-focus" aria-label="All breadcrumbs"> <span class="icon"> <span class="docon docon-more"></span> </span> </summary> <div id="article-header-breadcrumbs-overflow" class="popover-content padding-none"> </div> </details> <bread-crumbs id="article-header-breadcrumbs" data-test-id="article-header-breadcrumbs" class="overflow-hidden flex-grow-1 margin-right-sm margin-right-md-tablet margin-right-lg-desktop margin-left-negative-xxs padding-left-xxs"></bread-crumbs><div id="article-header-page-actions" class="opacity-none margin-left-auto display-flex flex-wrap-no-wrap align-items-stretch"><a id="lang-link-tablet" class="button button-primary button-clear button-sm display-none display-inline-flex-tablet" title="Read in English" data-bi-name="language-toggle" data-read-in-link hidden> <span class="icon margin-none" aria-hidden="true" data-read-in-link-icon> <span class="docon docon-locale-globe"></span> </span> <span class="is-visually-hidden" data-read-in-link-text>Read in English</span> </a><button type="button" class="collection button button-clear button-sm button-primary display-none display-inline-flex-tablet" data-list-type="collection" data-bi-name="collection" title="Add to collection"> <span class="icon margin-none" aria-hidden="true"> <span class="docon docon-circle-addition"></span> </span> <span class="collection-status is-visually-hidden">Save</span> </button><a data-contenteditbtn class="button button-clear button-sm text-decoration-none button-primary display-none display-inline-flex-tablet" aria-label="Edit" title="Edit This Document" data-bi-name="edit" hidden href="https://github.com/MicrosoftDocs/businessapps-copilot-docs-pr/blob/live/copilot-studio/fundamentals-get-started.md"> <span class="icon margin-none" aria-hidden="true"> <span class="docon docon-edit-outline"></span> </span> </a> <details class="popover popover-right" id="article-header-page-actions-overflow"> <summary class="justify-content-flex-start button button-clear button-sm button-primary" aria-label="More actions" title="More actions"> <span class="icon" aria-hidden="true"> <span class="docon docon-more-vertical"></span> </span> </summary> <div class="popover-content padding-xs"><button data-page-action-item="overflow-mobile" type="button" class="justify-content-flex-start button-block button-sm has-inner-focus button button-clear display-none-tablet" data-bi-name="contents-expand" data-contents-button data-popover-close> <span class="icon"> <span class="docon docon-editor-list-bullet" aria-hidden="true"></span> </span><span class="contents-expand-title">Table of contents</span></button><a id="lang-link-overflow" class="justify-content-flex-start button-sm has-inner-focus button button-clear button-block display-none-tablet" title="Read in English" data-bi-name="language-toggle" data-page-action-item="overflow-mobile" data-check-hidden="true" data-read-in-link hidden > <span class="icon" aria-hidden="true" data-read-in-link-icon> <span class="docon docon-locale-globe"></span> </span> <span data-read-in-link-text>Read in English</span> </a><button type="button" class="collection justify-content-flex-start button button-clear button-sm has-inner-focus button-block display-none-tablet" data-list-type="collection" data-bi-name="collection" title="Save" data-page-action-item="overflow-mobile" data-check-hidden="true" data-popover-close> <span class="icon" aria-hidden="true"> <span class="docon docon-circle-addition"></span> </span> <span class="collection-status">Save</span> </button> <button type="button" class="collection justify-content-flex-start button button-clear button-sm has-inner-focus button-block display-none-tablet" data-list-type="plan" data-bi-name="plan" title="Add to Plan" data-page-action-item="overflow-mobile" data-check-hidden="true" data-popover-close hidden> <span class="icon" aria-hidden="true"> <span class="docon docon-circle-addition"></span> </span> <span class="plan-status">Add to Plan</span> </button><a data-contenteditbtn class="button button-clear button-block button-sm has-inner-focus justify-content-flex-start text-decoration-none display-none-tablet" aria-label="Edit" title="Edit This Document" data-bi-name="edit" hidden href="https://github.com/MicrosoftDocs/businessapps-copilot-docs-pr/blob/live/copilot-studio/fundamentals-get-started.md"> <span class="icon" aria-hidden="true"> <span class="docon docon-edit-outline"></span> </span> <span>Edit</span> </a><div aria-hidden="true" class="margin-none" data-page-action-item="overflow-all"></div> <hr class="display-none-tablet margin-bottom-xxs margin-top-xxs" /> <h4 class="font-size-sm padding-left-xxs">Share via</h4> <a class="button button-clear button-sm button-block has-inner-focus text-decoration-none justify-content-flex-start share-facebook" data-bi-name="facebook" data-page-action-item="overflow-all"> <span class="icon" aria-hidden="true"> <span class="docon docon-facebook-share font-size-md color-primary"></span> </span> <span class="margin-left-xxs">Facebook</span> </a> <a class="button button-clear button-sm has-inner-focus button-block text-decoration-none justify-content-flex-start share-twitter" data-bi-name="twitter" data-page-action-item="overflow-all"> <span class="icon" aria-hidden="true"> <span class="docon docon-xlogo-share font-size-xxs"></span> </span> <span class="margin-left-xxs">x.com</span> </a> <a class="button button-clear button-sm has-inner-focus button-block text-decoration-none justify-content-flex-start share-linkedin" data-bi-name="linkedin" data-page-action-item="overflow-all"> <span class="icon" aria-hidden="true"> <span class="docon docon-linked-in-logo font-size-sm color-primary"></span> </span> <span class="margin-left-xxs">LinkedIn</span> </a> <a class="button button-clear button-sm button-block has-inner-focus text-decoration-none justify-content-flex-start margin-bottom-xxs share-email" data-bi-name="email" data-page-action-item="overflow-all"> <span class="icon" aria-hidden="true"> <span class="docon docon-mail-message font-size-sm color-primary"></span> </span> <span class="margin-left-xxs">Email</span> </a><hr /> <button class="button button-block button-clear button-sm justify-content-flex-start has-inner-focus margin-top-xxs" title="Print" type="button" aria-label="Print" data-bi-name="print" data-page-action-item="overflow-all" data-popover-close data-print-page data-check-hidden="true"> <span class="icon" aria-hidden="true"> <span class="docon docon-print font-size-sm color-primary"></span> </span> <span class="margin-left-xxs">Print</span> </button> </div> </details> </div></div> </div> <div> <button type="button" class="border contents-button button button-clear button-sm is-hidden-tablet has-inner-focus" data-bi-name="contents-expand" data-contents-button hidden> <span class="icon"> <span class="docon docon-editor-list-bullet" aria-hidden="true"></span> </span><span class="contents-expand-title">Table of contents</span></button> </div> <div class="content "><h1 id="quickstart-create-and-deploy-an-agent">Quickstart: Create and deploy an agent</h1><div class="display-flex justify-content-space-between align-items-center flex-wrap-wrap page-metadata-container"> <div class="margin-right-xxs"> <ul class="metadata page-metadata" data-bi-name="page info" lang="en-us" dir="ltr"><li>Article</li><li class="visibility-hidden-visual-diff"><time class="is-invisible" data-article-date aria-label="Article review date" datetime="2024-11-19T13:01:00Z" data-article-date-source="calculated">11/19/2024</time> </li><li class="contributors-holder display-none-print"> <button aria-label="View all contributors" class="contributors-button link-button" data-bi-name="contributors" title="View all contributors">10 contributors</button> </li></ul> </div> <div id="user-feedback" class="margin-block-xxs display-none-print" data-hide-on-archived> <button id="user-feedback-button" data-test-id="conceptual-feedback-button" class="button button-sm button-clear button-primary" type="button" data-bi-name="user-feedback-button" data-user-feedback-button > <span class="icon" aria-hidden="true"> <span class="docon docon-like"></span> </span> <span>Feedback</span> </button> </div></div><nav id="center-doc-outline" class="doc-outline is-hidden-desktop display-none-print margin-bottom-sm" data-bi-name="intopic toc" aria-label="In this article"> <h2 id="ms--in-this-article" class="title is-6 margin-block-xs">In this article</h2> </nav><p>Copilot Studio empowers teams to quickly and easily create powerful agents using a guided, no-code graphical experience without needing data scientists or developers.</p> <p>This quickstart article helps you create an agent for the first time. Learn how to add knowledge to your agent, test content changes in real time, and deploy your agent to a test page you can share with others.</p> <div class="tabGroup" id="tabgroup_1"> <ul role="tablist"> <li role="presentation"> <a href="#tabpanel_1_web" role="tab" aria-controls="tabpanel_1_web" data-tab="web" tabindex="0" aria-selected="true" data-linktype="self-bookmark">Web app</a> </li> <li role="presentation"> <a href="#tabpanel_1_teams" role="tab" aria-controls="tabpanel_1_teams" data-tab="teams" tabindex="-1" data-linktype="self-bookmark">Teams</a> </li> </ul> <section id="tabpanel_1_web" role="tabpanel" data-tab="web"> <h2 id="create-an-agent">Create an agent</h2> <p>When you create an agent, you can describe what you want your agent to be and do, or add those details as separate pieces of information.</p> <p>The examples in this quickstart create an agent called the Friendly Agent Tutor to help users learn about Copilot Studio. However, you can create your own unique agent using a publicly available website.</p> <ol> <li><p>After <a href="sign-up-individual" data-linktype="relative-path">logging in or signing up</a> for Copilot Studio, you land on the <strong>Home</strong> page. Select <strong>Create</strong> in the left navigation.</p> <p><span class="mx-imgBorder"> <img src="media/fundamentals-get-started/get-started-home.png" alt="Screenshot of the Create button location on the Copilot Studio Home page." data-linktype="relative-path"> </span> </p> </li> <li><p>On the <strong>Create</strong> page, select <strong>New agent</strong>.</p> </li> <li><p>Use the chat to describe your agent, using the provided questions for guidance.</p> <p>Keep your description simple for now, but make sure you include information about what your agent helps users do and what conversation style and tone it uses. Copilot Studio uses your responses to fill in the details in name, description, instructions, and knowledge that define your agent.</p> <p>For example: _Your name is Friendly Agent Tutor. You will help users learn how to create agents. You should talk to users like a kind, patient teacher.</p> <div class="TIP"> <p>Tip</p> <p>Instructions determine the goals, tone, and limitations of your agent. When writing instructions, make sure you:</p> <ul> <li>Use conversational language with a full description of how you want your agent to behave. Avoid single-word responses, because they do not give the agent enough information or context.</li> <li>Provide details about the specific goal you want your agent to help users achieve. For example, <em>Create an agent for topics related to Human Resources and employee benefits.</em></li> <li>Describe the tone as how you would want a person to respond in a conversion. You can use words and phrases like <em>casual</em>, <em>formal</em>, and <em>understandable for children in grade three</em>.</li> </ul> </div> </li> <li><p>Add an image to represent your agent.</p> <ol> <li><p>Select the agent icon in the top bar.</p> </li> <li><p>Select <strong>Change icon</strong>.</p> </li> <li><p>Choose an image from your device. The image file must be in PNG format and less than 30 KB in size.</p> </li> <li><p>Select <strong>Save</strong>.</p> </li> </ol> </li> <li><p>After you have a name, icon, description, and instructions, your agent is ready. Select <strong>Create</strong>. The <strong>Overview</strong> tab for your agent appears.</p> </li> </ol> <p>You now have an agent you can start testing! You can chat with your agent in the <strong>Test your agent</strong> chat.</p> <h2 id="improve-your-agent">Improve your agent</h2> <p>Now that you have an agent, you can start testing and improving it.</p> <p>To open your agent, in the left navigation select <strong>Agents</strong>, then select your agent.</p> <p>You need the <strong>Overview</strong> tab for most of the actions in this section.</p> <h3 id="test-changes-to-your-agent">Test changes to your agent</h3> <p>The best way to improve your agent? Test it. Make some changes. Test it again. Repeat.</p> <p>In this section, you'll test how changing your agent's knowledge sources affects how your agent responds to users.</p> <ol> <li><p>Start by testing how your agent currently responds in the <strong>Test your agent</strong> chat. Ask your agent a question. For example, ask how to create an agent.</p> <p><span class="mx-imgBorder"> <img src="media/fundamentals-get-started/quickstart-test-copilot-knowledge-source.png" alt="Screenshot of a test question in the Test your agent chat." data-linktype="relative-path"> </span> </p> </li> <li><p>In this example, the agent's instructions are to <em>talk to users like a kind, patient teacher.</em> What if you give your agent different instructions?</p> <p>In the <strong>Details</strong> card, select <strong>Edit.</strong> Change your agent's instructions to use a different tone, like <em>talk to users like Jane Austen.</em></p> </li> <li><p>Test your agent's new instructions with another question. How has the response changed?</p> </li> </ol> <h3 id="change-your-agents-introduction">Change your agent's introduction</h3> <p>Help your agent make a great first impression with a new introductory message. This first message lets users know what your agent does and encourages them to interact with your agent.</p> <ol> <li><p>In the <strong>Test your agent</strong> chat, select on your agent's introductory message. This opens the message in the <strong>Topics</strong> tab.</p> <p>If you can't see the introductory message, select <strong>Refresh</strong> at the top of the test chat panel to restart the conversation.</p> </li> <li><p>In the <strong>Message</strong> box, select the text of the message.</p> <p><span class="mx-imgBorder"> <img src="media/fundamentals-get-started/quickstart-topic-introduction-message-content.png" alt="Screenshot of the location of the message content to edit the introduction message." data-linktype="relative-path"> </span> </p> </li> <li><p>Delete the default message and add your own. In the introduction message, your agent should greet users, tell them what your agent does, and tell them how to start interacting with your agent. You can also give users an example question or prompt.</p> <p>For the Friendly Agent Tutor, the introduction message says <em>Hello, I'm here to help you learn how to use Microsoft Copilot Studio. You can ask me all about agents: "What is an agent?" "How do I make an agent?" "How do agents work?"</em></p> </li> <li><p>Select <strong>Save</strong>.</p> <p><span class="mx-imgBorder"> <img src="media/fundamentals-get-started/quickstart-topic-save.png" alt="Screenshot of the location of the Save button in the Topics tab." data-linktype="relative-path"> </span> </p> </li> </ol> <p>To test this change, select <strong>Refresh</strong> in the <strong>Test your agent</strong> chat panel.</p> <h3 id="edit-your-agents-basics">Edit your agent's basics</h3> <p>You can change your agent's name, description, instructions, and knowledge sources after creating it. Remember to test your changes as you go!</p> <p>To update your agent's name, description, or instructions:</p> <ol> <li><p>In the <strong>Overview</strong> tab's <strong>Details</strong> section, select <strong>Edit</strong>.</p> </li> <li><p>Make your changes.</p> </li> <li><p>Select <strong>Save</strong>. Remember, editing the instructions changes how your agent engages with users. Make sure to test your changes.</p> </li> </ol> <p>To add a knowledge source:</p> <ol> <li><p>In the <strong>Overview</strong> tab's <strong>Knowledge</strong> section, select <strong>Add knowledge</strong>.</p> <p><span class="mx-imgBorder"> <img src="media/fundamentals-get-started/quickstart-add-knowledge-button.png" alt="Screenshot of the location of the Add knowledge button in the Overview tab." data-linktype="relative-path"> </span> </p> </li> <li><p>Select the type of knowledge. This quickstart uses <strong>Public websites</strong> sources.</p> </li> <li><p>Enter the URL for the website, then select <strong>Add</strong> beside the textbox.</p> </li> <li><p>Name and describe the knowledge source so you can keep track of all your agent's sources.</p> <p><span class="mx-imgBorder"> <img src="media/fundamentals-get-started/quickstart-add-knowledge-naming.png" alt="Screenshot of the location for naming new knowledge sources in the Overview tab." data-linktype="relative-path"> </span> </p> </li> <li><p>Select <strong>Add</strong>.</p> </li> </ol> <p>To change existing knowledge sources:</p> <ol> <li><p>In the <strong>Overview</strong> tab's <strong>Knowledge</strong> section, select the overflow menu.</p> </li> <li><p>Select <strong>Edit</strong> to change the knowledge source, or <strong>Delete</strong> to remove it from your agent's sources.</p> </li> </ol> <p>You now have an agent you can start testing! You can chat with your agent in the <strong>Test your agent</strong> chat.</p> <h2 id="publish-your-agent">Publish your agent</h2> <p>Once you're happy with the content authored in your agent, you can publish your agent to a website.</p> <div class="NOTE"> <p>Note</p> <p>You may need to change the authentication for your demo website, depending on who you want to access your agent. Go to <a href="publication-fundamentals-publish-channels" data-linktype="relative-path">Key concepts - Publish and deploy your agent</a> for information on authentication levels and how to change them.</p> </div> <ol> <li><p>At the top of the page, select <strong>Publish</strong>, and then select <strong>Publish</strong> again in the <strong>Publish this agent</strong> confirmation message. If the publish is successful, you see a green banner on the top of the page.</p> </li> <li><p>At the top of the page, select <strong>Go to demo website</strong> in the overflow menu.</p> </li> <li><p>Send the URL to others to demonstrate it.</p> </li> </ol> <div class="NOTE"> <p>Note</p> <p>For more information on publishing your agent to other channels, see <a href="publication-fundamentals-publish-channels#configure-channels" data-linktype="relative-path">Key concepts - Publish and deploy your agent</a>.</p> </div> </section> <section id="tabpanel_1_teams" role="tabpanel" data-tab="teams" aria-hidden="true" hidden="hidden"> <p>Copilot Studio empowers anyone in the organization to build agents in Microsoft Teams. The agent has built-in natural language processing (NLP) and a no-code graphical interface. With our latest Teams integration, you can create, author, test, and publish your agent into Teams within the Microsoft Teams interface.</p> <p>When you create an agent, consider:</p> <ul> <li>The types of questions someone might ask</li> <li>The different ways a question is asked</li> <li>The expected answers</li> <li>Whether or not a user has follow-up questions or concerns</li> </ul> <p>To help you get started making human resource (HR) agents, this quickstart guides you through:</p> <ul> <li>How to map your scenario and needs to align with what an agent can do</li> <li>How to create an agent in the Copilot Studio app in Teams</li> <li>How to build and enhance topics that answer common HR-style questions</li> <li>How to test, publish, and share the agent with your organization</li> </ul> <p><strong>HR Support Agent</strong> is a friendly question and answer agent that brings a support professional expert from the HR team, when HR personnel are unable to help. An employee can ask the agent a question and the agent responds with an answer if the agent has content for it.</p> <p>If the agent doesn't have an answer, the employee can submit a query. The query is sent to a preconfigured team of experts who respond to a query notification.</p> <h3 id="scenario">Scenario</h3> <p>You work in human resources (HR) at Contoso and need to build an HR support agent in Microsoft Teams. The agent answers common HR questions, such as employee time-off, with relevant information from the company's internal knowledge base. The agent contacts human HR experts and notifies them that an employee needs assistance for uncommon scenarios.</p> <p>Once the agent is published, Contoso employees can access HR information in Teams without needing to search the company's intranet.</p> <h3 id="install-the-copilot-studio-app-in-microsoft-teams">Install the Copilot Studio app in Microsoft Teams</h3> <p>Start by launching the Copilot Studio app in Teams:</p> <ol> <li><p>Go to the Teams app store and search for <em>MicrosoftCopilot Studio</em>.</p> </li> <li><p>Select <strong>Add</strong> or <strong>Open</strong>, if you already added it, for the Microsoft Copilot Studio app.</p> <p><span class="mx-imgBorder"> <a href="media/fundamentals-get-started/get-started-install-app.png#lightbox" data-linktype="relative-path"> <img src="media/fundamentals-get-started/get-started-install-app.png" alt="Screenshot that shows an open Copilot Studio app." data-linktype="relative-path"> </a> </span> </p> </li> </ol> <p>The app opens to the Copilot Studio home page. Teams users can build agents here without leaving the Teams app.</p> <div class="TIP"> <p>Tip</p> <p>Select "<strong>...</strong>" in the side bar of Teams to show your added apps. Select and hold (or right-click) the Power Virtual Agents icon and select <strong>Pin</strong>. The Power Virtual Agents app appears in your side bar. You can now return to the app more easily.</p> <p><span class="mx-imgBorder"> <img src="media/fundamentals-get-started/first-bot-pin.png" alt="A menu pops up with options to learn about the app, Pin it or uninstall it" data-linktype="relative-path"> </span> </p> </div> <h3 id="create-a-new-agent-in-a-team">Create a new agent in a team</h3> <ol> <li><p>Select <strong>Start now</strong> on the Home page.</p> </li> <li><p>Pick which team manages the agent. You can <a href="https://support.microsoft.com/en-us/office/set-up-groups-and-teams-a79afa20-aa01-44a3-b33d-5eaa72f6404f" data-linktype="external">create a new team</a> if necessary, before you add an agent to it.</p> </li> <li><p>Fill in the agent name and language in the agent creation window. For more information about choosing a language, see <a href="authoring-language-support" data-linktype="relative-path">Language support</a>.</p> </li> <li><p>Select <strong>Create</strong>.</p> <p><span class="mx-imgBorder"> <a href="media/fundamentals-get-started/get-started-create.png#lightbox" data-linktype="relative-path"> <img src="media/fundamentals-get-started/get-started-create.png" alt="Screenshot that shows how to create a new agent." data-linktype="relative-path"> </a> </span> </p> </li> </ol> <h3 id="build-an-employee-time-off-topic-for-common-time-off-queries">Build an employee time-off topic for common time-off queries</h3> <p>Go to the topic list by selecting <strong>Topics</strong> in the navigation menu.</p> <p>An agent comes with a collection of topics that defines the agent's interaction with end users. Let's build a topic to answer employee questions about taking time-off.</p> <ol> <li><p>Select <strong>+ New topic</strong> > <strong>From blank</strong> on the menu bar to create a new topic.</p> <p><span class="mx-imgBorder"> <a href="media/fundamentals-get-started/create-new-topic.png#lightbox" data-linktype="relative-path"> <img src="media/fundamentals-get-started/create-new-topic.png" alt="Screenshot that shows how to create a new topic." data-linktype="relative-path"> </a> </span> </p> </li> <li><p>Select <strong>Details</strong> on the <strong>Overview</strong> menu and name the topic <strong>Employee time off</strong>. Give it an appropriate description.</p> </li> <li><p>Select <strong>Save</strong> at the top. Close your <strong>Details</strong> pane.</p> </li> <li><p>Select the <strong>Trigger Phrases</strong> box to add phrases.</p> <p><span class="mx-imgBorder"> <a href="media/fundamentals-get-started/select-trigger-phrases.png#lightbox" data-linktype="relative-path"> <img src="media/fundamentals-get-started/select-trigger-phrases.png" alt="Screenshot that shows where to select the Trigger Phrases box." data-linktype="relative-path"> </a> </span> </p> </li> <li><p>Create several trigger phrases in the <strong>Add phrases</strong> fields:</p> <ul> <li>Need information on time off</li> <li>I need help with time off</li> <li>How many days of paid vacation do I have</li> <li>What are the national holidays</li> <li>I need extended leave</li> </ul> <p>Trigger phrases for each topic define the ways users ask questions about that topic. These phrases are how we expect employees to ask about time off.</p> <p>Copilot Studio comes with built-in natural language capabilities. You only need to define a few trigger phrases about time-off and the agent can accurately trigger the topic based on the employee's input.</p> </li> <li><p>Select <strong>Save</strong> to add the phrases to your topic list.</p> </li> </ol> <h3 id="define-the-agents-interaction-with-a-user-topic">Define the agent's interaction with a user topic</h3> <p>Give the employee a message that the agent is here to help with time-off questions using a message node.</p> <ol> <li><p>Enter the text in the existing message node <em>I can help with questions related to time-off</em>.</p> <p>As an HR employee, you know the most common time-off questions are about paid vacation time and national holidays. When a question node with user response options is added, the topic automatically gets a forked branch for each response.</p> </li> <li><p>Select the (<strong>+</strong>) icon below the message node, then select <strong>Ask a question</strong> to add a question node to the topic.</p> </li> <li><p>Enter <em>What information are you looking for?</em> in the <strong>Ask a question</strong> text box. The employee might ask this question.</p> </li> <li><p>Under <strong>Options for user</strong>, add <em>Paid vacation</em> and <em>National Holidays</em> as two options.</p> <p><span class="mx-imgBorder"> <a href="media/fundamentals-get-started/get-started-save.png#lightbox" data-linktype="relative-path"> <img src="media/fundamentals-get-started/get-started-save.png" alt="Add options for paid vacation and national holidays." data-linktype="relative-path"> </a> </span> </p> <p>User choices are stored in a variable and the topic branches off, based on the option the user chooses. You can rename the variable to track it better in the topic.</p> </li> <li><p>On the variable, under <strong>Save response as</strong>, select the pencil icon to edit the variable properties.</p> </li> <li><p>The <strong>Variable properties</strong> pane opens. Rename the variable to <em>TimeoffType</em>. Close the <strong>Variable properties</strong> pane and you see the changes reflected in the authoring canvas.</p> <p><span class="mx-imgBorder"> <a href="media/fundamentals-get-started/get-started-options.png#lightbox" data-linktype="relative-path"> <img src="media/fundamentals-get-started/get-started-options.png" alt="Multiple options are shown after a question node." data-linktype="relative-path"> </a> </span> </p> <p>You can add different responses for each option. For <em>paid vacation</em>, the agent can point employees to an internal HR website to look up paid time-off policies.</p> </li> <li><p>Add a message node for the <em>Paid vacation</em> branch with this message to the user: <em>For paid vacation time-off, go to <a href="https://www.contoso.com/HR/PaidTimeOff" data-linktype="external">www.contoso.com/HR/PaidTimeOff</a> to submit time-off requests.</em></p> </li> <li><p>Add a node by selecting the (<strong>+</strong>) icon to end the conversation with a survey. Select <strong>End the conversation</strong>, then <strong>End with survey</strong>. This survey is the <a href="analytics-csat" data-linktype="relative-path">customer satisfaction survey</a> prebuilt in the agent for use in topics.</p> </li> <li><p>In the <em>National Holidays</em> path, add a message node with the following text:</p> <pre><code class="lang-text">National holidays for 2020: - New Year's Day: January 1st - Memorial Day: May 25th - Independence day: July 4th - Labor Day: September 7th - Thanksgiving: November 26th - 27th - Christmas Eve and Christmas Day: December 24th - 25th </code></pre> </li> <li><p>End this path in the topic with a survey as well. Add a node by selecting the (<strong>+</strong>) icon then <strong>End the conversation</strong> and <strong>End with survey</strong>.</p> </li> </ol> <p><span class="mx-imgBorder"> <a href="media/fundamentals-get-started/get-started-options-filled.png#lightbox" data-linktype="relative-path"> <img src="media/fundamentals-get-started/get-started-options-filled.png" alt=" Screenshot that shows the topic has an introductory message, followed by a question node with two options. Each option ends with a message and then a survey." data-linktype="relative-path"> </a> </span> </p> <h3 id="test-agent-for-expected-behavior">Test agent for expected behavior</h3> <p>Copilot Studio comes with a built-in test agent that lets you test the agent in real time. You can test the agent by launching the test agent canvas and providing the employee's input. When you save the topic, the test agent is refreshed with the latest content.</p> <ol> <li><p>To launch the test agent canvas, select the agent icon at the bottom of the screen.</p> </li> <li><p>Type <em>I need time off information</em> into the agent chat.</p> <p>Even though <em>I need time off information</em> doesn't match the trigger phrases exactly, Copilot Studio processes the user's input and triggers the employee time off topic.</p> <p>As you chat with the agent in the test agent canvas, you see where the agent is in the conversation in real-time by following the green highlights.</p> </li> <li><p>Select <strong>Paid vacation</strong>.</p> <p>The topic branches off based on the user's response. You can open the <em>TimeoffType</em> variable to see the value of <strong>Paid time-off</strong> by the user. However, what happens if the user is looking for national holidays in their inquiry? The user might feel annoyed if the agent asks them to repeat themselves. Let's give it a try.</p> </li> <li><p>Above the test agent pane, select <strong>Reset</strong>.</p> </li> <li><p>Enter <em>Need information on national holidays</em>.</p> <p>The agent bypasses its response question on vacation type and directly provides information on national holidays. This choice is because Copilot Studio supports <a href="advanced-entities-slot-filling" data-linktype="relative-path">entity extraction</a> and can determine that the user asks about national holidays.</p> <p><span class="mx-imgBorder"> <a href="media/fundamentals-get-started/get-started-test-bot.png#lightbox" data-linktype="relative-path"> <img src="media/fundamentals-get-started/get-started-test-bot.png" alt="Screenshot that shows how the test agent AI knows what the user is asking." data-linktype="relative-path"> </a> </span> </p> </li> </ol> <h3 id="enhance-topic-to-handle-complex-queries-by-escalating-to-hr-experts">Enhance topic to handle complex queries by escalating to HR experts</h3> <p>Now that you performed the basics, you can add a more complex option to the topic of <em>extended leave</em>.</p> <ol> <li><p>Return to the topic you created, and then go to the authoring canvas.</p> </li> <li><p>In the <strong>Question</strong> node, add an option named <em>Extended leave</em>.</p> <p><span class="mx-imgBorder"> <a href="media/fundamentals-get-started/get-started-add-option.png#lightbox" data-linktype="relative-path"> <img src="media/fundamentals-get-started/get-started-add-option.png" alt="Screenshot that shows how to add an option to the question node." data-linktype="relative-path"> </a> </span> </p> <p>Since each employee's personal situation is different, questions about extended leave require a discussion with an HR expert You can build the agent to connect HR experts with your employees.</p> </li> <li><p>Add a message node that says <em>Extended leave needs HR expert approval. Let me connect you with them.</em></p> <p>Copilot Studio agents can take actions by <a href="advanced-plugin-actions" data-linktype="relative-path">adding actions into a topic</a>. In this example, you add a previous basic action that notifies an HR expert. This basic action sends an adaptive card to the HR expert channel in Teams to let experts know a user needs them to reach out.</p> <p>You can create the basic action to send a message to a Teams channel and then call it with the appropriate input.</p> </li> <li><p>Add a question node asking for a description for the issue and add the text <em>How would you describe the issue?</em></p> </li> <li><p>Save the description in a variable named <em>Description</em>.</p> <p><span class="mx-imgBorder"> <a href="media/fundamentals-get-started/get-started-variable-description.png#lightbox" data-linktype="relative-path"> <img src="media/fundamentals-get-started/get-started-variable-description.png" alt="Screenshot that shows how to add a question node with the answer as a variable called Description." data-linktype="relative-path"> </a> </span> </p> </li> <li><p>Add a node under the question and select <strong>Call an action</strong>.</p> </li> <li><p>Select <strong>Basic action</strong> and then <strong>create new flow</strong>, which launches Power Automate.</p> </li> <li><p>Choose the template <strong>Send a message to a Teams channel</strong>, then select <strong>Continue</strong>.</p> <p>The flow template takes in two inputs from the agent, the <strong>Subject</strong> (title for the message) and <strong>Message text</strong> (actual message) to post to the channel.</p> <ol> <li><p>Under the <strong>Post a message (v3)</strong> flow definition, select the <strong>Team ID</strong> and the <strong>Team channel ID</strong> where the message should be posted.</p> </li> <li><p>(Optional) Add text to the message, in addition to the description entered by the user, and complete the <strong>Message</strong> field.</p> </li> <li><p>Give the flow a name and save it.</p> </li> <li><p>Close the flow authoring canvas.</p> </li> </ol> <p>You return to the authoring canvas. You can now add an action and call this newly created flow.</p> </li> <li><p>Pass in the variable you created earlier called <em>TimeOffType</em> for the <strong>Subject</strong> and the <strong>Description</strong> gathered in the chat. When the flow posts a message on the Expert channel, it shows <strong>Extended leave</strong> as the title and the message defined in the flow.</p> <div class="TIP"> <p>Tip</p> <p>Copilot Studio is directly integrated with Teams, so the agent knows which user from Teams it's chatting with. This feature allows agent authors to build personal and customized agent responses.</p> <p>To use the name of the person chatting with the agent, there's a predefined variable named <em>bot.UserDisplayName</em> that be used <a href="authoring-variables" data-linktype="relative-path">like any other variable</a>.</p> </div> <p>You can let the employee know their request notified the experts, who will reach out to them soon.</p> </li> <li><p>Add a message node with the message <em>We notified the expert. They'll reach out shortly.</em></p> </li> <li><p>End the conversation with a survey.</p> </li> <li><p>Save the topic.</p> </li> </ol> <p>You can add more topics so that HR Agent can answer more questions from Contoso employees.</p> <div class="TIP"> <p>Tip</p> <p>Always test your agent to ensure it's working as expected for the best employee experience. You see a message posted to the Teams channel when the flow executes in the test canvas.</p> </div> <h3 id="publish-your-agent-1">Publish your agent</h3> <p>Publishing the agent makes the latest updates available to end users.</p> <p>In the navigation menu, select <strong>Publish</strong>. Select <strong>Publish</strong> again.</p> <p>You need to do a few more actions to make the agent available to employees.</p> <div class="TIP"> <p>Tip</p> <p>If you're already in a conversation with the agent, you can type <em>start over</em> after publishing your latest agent content. This restarts the conversation with the latest content published.</p> </div> <h3 id="make-your-agent-available-to-other-employees">Make your agent available to other employees</h3> <ol> <li><p>On the <strong>Publish</strong> page, find the option to <strong>Open the agent</strong>. You can test your agent before sharing it.</p> </li> <li><p>Select <strong>Share the bot</strong>, which opens a pane of customization options.</p> </li> </ol> <p>Employees can now find your published agent in the Teams app store.</p> <h3 id="edit-agent-details">Edit agent details</h3> <p>In the customization pane, you can edit the agent icon that displays in Teams and change the short and long descriptions for your agent. These settings are prepopulated with starter content, but can be customized.</p> <p><span class="mx-imgBorder"> <a href="media/fundamentals-get-started/get-started-edit.png#lightbox" data-linktype="relative-path"> <img src="media/fundamentals-get-started/get-started-edit.png" alt="Screenshot that shows where to edit the agent details." data-linktype="relative-path"> </a> </span> </p> <h3 id="share-your-agent-with-your-team">Share your agent with your team</h3> <p>You can add your agent to the <a href="publication-add-bot-to-microsoft-teams#show-an-agent-in-the-teams-app-store" data-linktype="relative-path">Agent extensions</a> section of the Teams app store.</p> <p>Select <strong>Add to Teams</strong>. You see a checkmark indicating the agent was added to Teams.</p> <p>Viewing the agent in the app store is a workaround to test it, since admin approval isn't required and avoids any spam to the admin. Once you're fully satisfied, <a href="#share-your-agent-with-your-organization" data-linktype="self-bookmark">share the agent with your organization</a>, which requires admin approval.</p> <p><span class="mx-imgBorder"> <img src="media/fundamentals-get-started/get-started-edited.png" alt="The agent's icon is now a briefcase with a pink background." data-linktype="relative-path"> </span> </p> <h3 id="share-your-agent-with-your-organization">Share your agent with your organization</h3> <p>Sharing your agent with the entire organization makes it appear <a href="publication-add-bot-to-microsoft-teams#show-an-agent-in-the-teams-app-store" data-linktype="relative-path">in the Built for your org section of the Teams app store</a>. Access requires admin approval.</p> <ol> <li><p>Select <strong>Submit for admin approval</strong>.</p> </li> <li><p>Confirm the agent icon, short description, and long description are correct.</p> </li> <li><p>Confirm you want to share the agent with everyone in the organization.</p> </li> <li><p>Submit for admin approval. This part of the process can't be completed right away and requires follow up with the admin for approval.</p> </li> </ol> <h3 id="find-your-agent-in-the-teams-app-store">Find your agent in the Teams app store</h3> <p>An employee named Melissa can find the agent you built in the Teams app store.</p> <p>Depending on how you shared your agent, Melissa can find it either in the <strong>Agent extensions</strong> section or the <strong>Built for your org</strong> section of the Teams app store. For an agent to appear in the <strong>Built for your org</strong> section, it must be approved by an admin first.</p> <p>Melissa selects the agent app and selects <strong>Add for me</strong>. The agent appears in the Teams side bar.</p> <p>The <strong>Greeting</strong> topic automatically welcomes Melissa.</p> <div class="TIP"> <p>Tip</p> <p>You can <a href="configure-bot-greeting" data-linktype="relative-path">edit the Greeting topic</a> to have a custom welcome message.</p> </div> <h3 id="employee-chats-with-the-agent-to-ask-about-time-off">Employee chats with the agent to ask about time-off</h3> <p>Melissa needs time-off in July and August for personal reasons and enters <em>Need time-off information</em>. Melissa selects <strong>Paid vacation</strong> and a website appears where she can learn more about paid time-off.</p> <p>The agent then gathers customer satisfaction data and ends the conversation.</p> <p><span class="mx-imgBorder"> <a href="media/fundamentals-get-started/get-started-chat.png#lightbox" data-linktype="relative-path"> <img src="media/fundamentals-get-started/get-started-chat.png" alt="Screenshot shows how the user can talk with the agent, similarly to a Teams chat." data-linktype="relative-path"> </a> </span> </p> <p>Melissa reviews the HR site for paid time-off and understands she needs an extended leave. Melissa returns to the agent and types <em>I need extended leave.</em></p> <p>The agent lets Melissa know that an HR expert is needed for the extended leave request and asks Melissa for a description of the issue.</p> <p>The agent notifies an expert, who will reach out to Melissa shortly.</p> <h3 id="return-to-the-authors-view-and-go-to-the-hr-teams-experts-channel">Return to the author's view and go to the HR team's experts channel</h3> <p>You see the agent ran the flow you added earlier and posted Melissa's request to the channel.</p> <p><span class="mx-imgBorder"> <a href="media/fundamentals-get-started/get-started-channel.png#lightbox" data-linktype="relative-path"> <img src="media/fundamentals-get-started/get-started-channel.png" alt="Screenshot that shows the agent output a message into the Teams channel about extended leave." data-linktype="relative-path"> </a> </span> </p> </section> </div> <h2 id="whats-next">What's next?</h2> <p>You created an agent, tested it out, and published it to a demo site. Congratulations! Your agent has many more capabilities, so try it out and play with the advanced features.</p> <p>For questions not covered in the documentation or for feature ideas, <a href="https://aka.ms/PowerVirtualAgentsForum" data-linktype="external">visit our community</a> and post questions.</p> <p>We'd love to hear your ideas on Copilot Studio. <a href="https://aka.ms/PowerVirtualAgentsIdeas" data-linktype="external">Visit our Ideas board</a> and post your ideas.</p> </div><div id="ms--inline-notifications" class="margin-block-xs" data-bi-name="inline-notification"></div><div id="assertive-live-region" role="alert" aria-live="assertive" class="visually-hidden" aria-relevant="additions" aria-atomic="true"></div> <div id="polite-live-region" role="status" aria-live="polite" class="visually-hidden" aria-relevant="additions" aria-atomic="true"></div>  </main> <section id="site-user-feedback-footer" class="font-size-sm margin-top-md" data-test-id="site-user-feedback-footer" data-bi-name="site-feedback-section"> <hr class="hr" /> <h2 id="feedback" class="title is-3">Feedback</h2> <div class="display-flex flex-wrap-wrap align-items-center"> <p class="font-weight-semibold margin-xxs margin-left-none">Was this page helpful?</p> <div class="buttons"> <button class="thumb-rating-button like button button-primary button-sm" data-test-id="footer-rating-yes" data-binary-rating-response="rating-yes" type="button" title="This article is helpful" data-bi-name="button-rating-yes" aria-pressed="false" > <span class="icon" aria-hidden="true"> <span class="docon docon-like"></span> </span> <span>Yes</span> </button> <button class="thumb-rating-button dislike button button-primary button-sm" data-test-id="footer-rating-no" data-binary-rating-response="rating-no" type="button" title="This article is not helpful" data-bi-name="button-rating-no" aria-pressed="false" > <span class="icon" aria-hidden="true"> <span class="docon docon-dislike"></span> </span> <span>No</span> </button> </div> </div><div class="display-flex flex-wrap-wrap margin-top-xxs"><div> <a data-bi-name="provide-feedback-cta" class="has-external-link-indicator" href="https://powerusers.microsoft.com/t5/Power-Virtual-Agents-Community/ct-p/PVACommunity" data-bi-name="product-feedback" > <span>Provide product feedback</span> </a></div></div> </section> <aside id="ms--additional-resources-mobile" aria-label="Additional resources" class="display-none-desktop display-none-print" > <hr class="hr" hidden /> <h2 id="ms--additional-resources-mobile-heading" class="title is-3" hidden>Additional resources</h2> <section id="right-rail-recommendations-mobile" data-bi-name="recommendations" hidden></section> <section id="right-rail-training-mobile" data-bi-name="learning-resources-card" hidden></section> <section id="right-rail-events-mobile" data-bi-name="events-card" hidden></section> <section id="right-rail-qna-mobile" data-bi-name="qna-link-card" hidden></section> </aside><div class="border-top is-visible-interactive has-default-focus margin-top-sm "><footer id="footer-interactive" data-bi-name="footer" class="footer-layout"><div class="display-flex gap-xs flex-wrap-wrap is-full-height padding-right-lg-desktop"><a data-mscc-ic="false" class="locale-selector-link button button-sm button-clear flex-shrink-0" href="#" data-bi-name="select-locale"> <span class="icon" aria-hidden="true"> <span class="docon docon-world"></span> </span> <span class="local-selector-link-text"></span></a><div class="ccpa-privacy-link" data-ccpa-privacy-link hidden> <a href="https://aka.ms/yourcaliforniaprivacychoices" class="button button-sm button-clear flex-shrink-0" data-mscc-ic="false" data-bi-name="your-privacy-choices" > <svg role="img" aria-label="California Consumer Privacy Act (CCPA) Opt-Out Icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 30 14" xml:space="preserve" height="16" width="43" focusable="false" > <title>California Consumer Privacy Act (CCPA) Opt-Out Icon</title> <path d="M7.4 12.8h6.8l3.1-11.6H7.4C4.2 1.2 1.6 3.8 1.6 7s2.6 5.8 5.8 5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#fff"></path> <path d="M22.6 0H7.4c-3.9 0-7 3.1-7 7s3.1 7 7 7h15.2c3.9 0 7-3.1 7-7s-3.2-7-7-7zm-21 7c0-3.2 2.6-5.8 5.8-5.8h9.9l-3.1 11.6H7.4c-3.2 0-5.8-2.6-5.8-5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#06f"></path> <path d="M24.6 4c.2.2.2.6 0 .8L22.5 7l2.2 2.2c.2.2.2.6 0 .8-.2.2-.6.2-.8 0l-2.2-2.2-2.2 2.2c-.2.2-.6.2-.8 0-.2-.2-.2-.6 0-.8L20.8 7l-2.2-2.2c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0l2.2 2.2L23.8 4c.2-.2.6-.2.8 0z" style="fill:#fff"></path> <path d="M12.7 4.1c.2.2.3.6.1.8L8.6 9.8c-.1.1-.2.2-.3.2-.2.1-.5.1-.7-.1L5.4 7.7c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0L8 8.6l3.8-4.5c.2-.2.6-.2.9 0z" style="fill:#06f"></path> </svg> <span>Your Privacy Choices</span> </a> </div> <div class="flex-shrink-0"> <div class="dropdown has-caret-up"> <button class="dropdown-trigger button button-clear button-sm has-inner-focus theme-dropdown-trigger" aria-controls="theme-menu-interactive" aria-expanded="false" title="Theme" data-bi-name="theme"> <span class="icon"> <span class="docon docon-sun" aria-hidden="true"></span> </span> <span>Theme</span> <span class="icon expanded-indicator" aria-hidden="true"> <span class="docon docon-chevron-down-light"></span> </span> </button> <div class="dropdown-menu" id="theme-menu-interactive" role="menu"> <ul class="theme-selector padding-xxs" role="none"> <li class="theme display-block" role="menuitem"> <button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="light"> <span class="theme-light margin-right-xxs"> <span class="theme-selector-icon border display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14"> <rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg> </span> </span> <span>Light</span> </button> </li> <li class="theme display-block" role="menuitem"> <button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="dark"> <span class="theme-dark margin-right-xxs"> <span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14"> <rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg> </span> </span> <span>Dark</span> </button> </li> <li class="theme display-block" role="menuitem"> <button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="high-contrast"> <span class="theme-high-contrast margin-right-xxs"> <span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14"> <rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg> </span> </span> <span>High contrast</span> </button> </li> </ul> </div> </div> </div> </div> <ul class="links" data-bi-name="footerlinks"> <li class="manage-cookies-holder" hidden></li><li><a class="external-link-indicator" data-mscc-ic="false" href="/en-us/previous-versions/" data-bi-name="archivelink">Previous Versions</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://techcommunity.microsoft.com/t5/microsoft-learn-blog/bg-p/MicrosoftLearnBlog" data-bi-name="bloglink">Blog</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="/en-us/contribute/" data-bi-name="contributorGuide">Contribute</a></li><li><a class="external-link-indicator" data-mscc-ic="false" href="https://go.microsoft.com/fwlink/?LinkId=521839" data-bi-name="privacy">Privacy</a></li><li><a class="external-link-indicator" data-mscc-ic="false" href="/en-us/legal/termsofuse" data-bi-name="termsofuse">Terms of Use</a></li><li><a class="external-link-indicator" data-mscc-ic="false" href="https://www.microsoft.com/legal/intellectualproperty/Trademarks/" data-bi-name="trademarks">Trademarks</a></li><li>© Microsoft 2024</li> </ul> </footer></div></div><div id="ms--additional-resources" class="right-container column is-4-desktop display-none display-block-desktop" data-bi-name="pageactions" role="complementary" aria-label="Additional resources" > <div id="affixed-right-container" class="margin-top-sm-tablet" data-bi-name="right-column"> <h2 id="ms--additional-resources-heading" class="title is-6 margin-top-md" hidden>Additional resources</h2> <section id="right-rail-events" data-bi-name="events-card" hidden></section> <section id="right-rail-training" data-bi-name="learning-resources-card" hidden></section> <section id="right-rail-recommendations" data-bi-name="recommendations" hidden></section> <nav id="side-doc-outline" class="doc-outline" data-bi-name="intopic toc" aria-label="In this article"> <h3>In this article</h3> </nav> <section id="right-rail-qna" class="margin-top-xxs" data-bi-name="qna-link-card" hidden></section> </div> </div></div>  </section>   <aside id="interactive-container" class="interactive-container is-visible-interactive column has-body-background-dark "> </aside>  </div> </div>  <section class="border-top has-default-focus is-hidden-interactive margin-top-sm "><footer id="footer" data-bi-name="footer" class="footer-layout uhf-container has-padding" role="contentinfo"><div class="display-flex gap-xs flex-wrap-wrap is-full-height padding-right-lg-desktop"><a data-mscc-ic="false" class="locale-selector-link button button-sm button-clear flex-shrink-0" href="#" data-bi-name="select-locale"> <span class="icon" aria-hidden="true"> <span class="docon docon-world"></span> </span> <span class="local-selector-link-text"></span></a><div class="ccpa-privacy-link" data-ccpa-privacy-link hidden> <a href="https://aka.ms/yourcaliforniaprivacychoices" class="button button-sm button-clear flex-shrink-0" data-mscc-ic="false" data-bi-name="your-privacy-choices" > <svg role="img" aria-label="California Consumer Privacy Act (CCPA) Opt-Out Icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 30 14" xml:space="preserve" height="16" width="43" focusable="false" > <title>California Consumer Privacy Act (CCPA) Opt-Out Icon</title> <path d="M7.4 12.8h6.8l3.1-11.6H7.4C4.2 1.2 1.6 3.8 1.6 7s2.6 5.8 5.8 5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#fff"></path> <path d="M22.6 0H7.4c-3.9 0-7 3.1-7 7s3.1 7 7 7h15.2c3.9 0 7-3.1 7-7s-3.2-7-7-7zm-21 7c0-3.2 2.6-5.8 5.8-5.8h9.9l-3.1 11.6H7.4c-3.2 0-5.8-2.6-5.8-5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#06f"></path> <path d="M24.6 4c.2.2.2.6 0 .8L22.5 7l2.2 2.2c.2.2.2.6 0 .8-.2.2-.6.2-.8 0l-2.2-2.2-2.2 2.2c-.2.2-.6.2-.8 0-.2-.2-.2-.6 0-.8L20.8 7l-2.2-2.2c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0l2.2 2.2L23.8 4c.2-.2.6-.2.8 0z" style="fill:#fff"></path> <path d="M12.7 4.1c.2.2.3.6.1.8L8.6 9.8c-.1.1-.2.2-.3.2-.2.1-.5.1-.7-.1L5.4 7.7c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0L8 8.6l3.8-4.5c.2-.2.6-.2.9 0z" style="fill:#06f"></path> </svg> <span>Your Privacy Choices</span> </a> </div> <div class="flex-shrink-0"> <div class="dropdown has-caret-up"> <button class="dropdown-trigger button button-clear button-sm has-inner-focus theme-dropdown-trigger" aria-controls="theme-menu" aria-expanded="false" title="Theme" data-bi-name="theme"> <span class="icon"> <span class="docon docon-sun" aria-hidden="true"></span> </span> <span>Theme</span> <span class="icon expanded-indicator" aria-hidden="true"> <span class="docon docon-chevron-down-light"></span> </span> </button> <div class="dropdown-menu" id="theme-menu" role="menu"> <ul class="theme-selector padding-xxs" role="none"> <li class="theme display-block" role="menuitem"> <button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="light"> <span class="theme-light margin-right-xxs"> <span class="theme-selector-icon border display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14"> <rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg> </span> </span> <span>Light</span> </button> </li> <li class="theme display-block" role="menuitem"> <button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="dark"> <span class="theme-dark margin-right-xxs"> <span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14"> <rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg> </span> </span> <span>Dark</span> </button> </li> <li class="theme display-block" role="menuitem"> <button class="button button-clear button-sm theme-control button-block justify-content-flex-start" data-theme-to="high-contrast"> <span class="theme-high-contrast margin-right-xxs"> <span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true"> <svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14"> <rect width="22" height="14" class="has-fill-body-background" /> <rect x="5" y="5" width="12" height="4" class="has-fill-secondary" /> <rect x="5" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="8" y="2" width="2" height="1" class="has-fill-secondary" /> <rect x="11" y="2" width="3" height="1" class="has-fill-secondary" /> <rect x="1" y="1" width="2" height="2" class="has-fill-secondary" /> <rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary" /> <rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary" /> </svg> </span> </span> <span>High contrast</span> </button> </li> </ul> </div> </div> </div> </div> <ul class="links" data-bi-name="footerlinks"> <li class="manage-cookies-holder" hidden></li><li><a class="external-link-indicator" data-mscc-ic="false" href="/en-us/previous-versions/" data-bi-name="archivelink">Previous Versions</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="https://techcommunity.microsoft.com/t5/microsoft-learn-blog/bg-p/MicrosoftLearnBlog" data-bi-name="bloglink">Blog</a></li> <li><a class="external-link-indicator" data-mscc-ic="false" href="/en-us/contribute/" data-bi-name="contributorGuide">Contribute</a></li><li><a class="external-link-indicator" data-mscc-ic="false" href="https://go.microsoft.com/fwlink/?LinkId=521839" data-bi-name="privacy">Privacy</a></li><li><a class="external-link-indicator" data-mscc-ic="false" href="/en-us/legal/termsofuse" data-bi-name="termsofuse">Terms of Use</a></li><li><a class="external-link-indicator" data-mscc-ic="false" href="https://www.microsoft.com/legal/intellectualproperty/Trademarks/" data-bi-name="trademarks">Trademarks</a></li><li>© Microsoft 2024</li> </ul> </footer> </section> <div id="action-panel" role="region" aria-label="Action Panel" class="action-panel has-default-focus" tabindex="-1"></div> </body> </html>