Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Note
This article applies to the Copilot Studio online portal. To create a chatbot in the Microsoft Copilot Studio app for Microsoft Teams, see Quickstart: Create a chatbot in Teams and deploy it.
Copilot Studio empowers teams to quickly and easily create powerful agents using a guided, no-code graphical experience without needing data scientists or developers.
This quickstart shows you how to create an agent for the first time. Learn how to:
- Add knowledge to your agent.
- Test content changes in real time.
- Publish your agent to a demo website you can share with others.
Create an agent
When you create an agent, you can describe everything you want your agent to be and do in your own words, or configure those details as separate pieces of information.
The examples in this quickstart create an agent called Friendly Tutor to help users learn about Copilot Studio using knowledge from the official Copilot Studio documentation. However, you can create your own agent using any publicly available website as a knowledge source.
Sign in to Copilot Studio, or sign up. You land on the Home page.
Enter a brief description of what you want your agent to be—for example, "Help users learn how to create agents with Copilot Studio." The description can have up to 1,000 characters.
A page appears with two panes where you can chat with Copilot on the left-hand side, and see your agent's details dynamically updated on the right-hand side.
Note
The conversational agent creation experience uses your browser language. If your browser language isn't in the list of supported languages for the conversational agent creation experience, only the more discrete configuration experience is available.
Chat with Copilot in the left pane to further define your agent. Copilot asks questions to guide you, and uses your responses to fill in the details, such as the name, description, instructions, and knowledge, that define your agent.
For this example scenario, tell Copilot you want to name your agent "Friendly Tutor." Notice the new name appears in the right-hand pane. The maximum length for the name is 30 characters.
If desired, refine the instructions Copilot generated for your agent but keep them simple for now. Just make sure you include information about what your agent helps users do.
Specify the desired conversation style and tone your agent should use—for example, "Friendly Tutor should talk to users like a kind, patient teacher."
Add knowledge to your agent, if desired. For Friendly Tutor, tell Copilot you want to use
https://learn.microsoft.com/microsoft-copilot-studio
as a knowledge source.
Make your agent unique with a distinctive icon:
Select the agent icon in the top bar.
Select Change icon.
Choose an image from your device. The image file must be in PNG format and less than 30 KB in size, with a maximum resolution of 192 × 192 pixels.
Select Save.
Optionally, select a solution and set the schema name for your agent:
Select the three dots in the upper right-corner and select Edit advanced settings.
Select the desired solution, if applicable.
Replace the default schema name with a distinctive name, if desired. You can't change the first part of the schema name, here: the selected solution determines this prefix.
Select Save.
After you have a name, icon, description, and instructions, your agent is ready.
Select Create. The Overview page for your agent appears. Now you can start testing and improving your agent.
Tip
Instructions determine the goals, tone, and limitations of your agent. When writing instructions, make sure you:
- Use conversational language with a full description of how you want your agent to behave. Avoid single-word responses, because they don't give the agent enough information or context.
- Provide details about the specific goal you want your agent to help users achieve. For example, Create an agent for topics related to Human Resources and employee benefits.
- Describe the tone as how you would want a person to respond in a conversation. You can use words and phrases like casual, formal, and understandable for children in grade three.
Improve your agent
Now that you have an agent, you can test it more and improve it.
To open your agent, select Agents in the left sidebar, then select your agent.
Test changes to your agent
The best way to improve your agent? Test it. Make some changes. Test it again. Repeat.
In this section, you test how changing your agent's knowledge sources affects how your agent responds to users.
Start by testing how your agent currently responds in the test chat. Ask your agent a question. For example, ask: "How do I add a knowledge source?"
In this example, the agent's instructions are to talk to users like a kind, patient teacher. What if you give your agent different instructions?
Go to the Overview page, and update the instructions for your agent to use a different tone, like talk to users like Jane Austen.
Test your agent's new instructions with another question. How has the response changed?
Change your agent's introduction
Help your agent make a great first impression with a new introductory message. This message lets users know what your agent does and encourages them to interact with your agent.
In the Test your agent chat, select your agent's introductory message. The Conversation Start topic opens, and the Message node for your introductory message is in focus.
Tip
If you can't see the introductory message in the test panel, select the Refresh icon at the top of the panel to restart the conversation.
In the Message box, select the text of the message.
Replace the default message with your own. In the introductory message, your agent should greet users, tell them what it does, and how to start interacting with it. You can also give users an example question or prompt.
For Friendly Tutor, update the introductory message to say:
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?"
Select Save.
To test this change, select the Refresh icon in the Test your agent chat panel.
Suggest ways of starting conversations
If your agent is meant to be used in Teams or Microsoft 365, you can configure up to six starter prompts to suggest ways your customers can start conversations with the agent. When you use the conversational agent creation experience, Copilot automatically generates starter prompts based on information in the description and instructions for the agent.
To add or update starter prompts:
On the Overview page, select the Edit icon
at the top of the Starter prompts section.
Revise or add titles and prompts, as desired, and select Save when you're done.
Note
Starter prompts are meant for Teams and Microsoft 365 Copilot Chat. They appear on the agent's welcome page, before you start a new chat. You can't see or use them when you test your agent in Copilot Studio, except in the initial creation experience. Learn more about configuring starter prompts.
Edit your agent's basics
You can change your agent's name, description, instructions, and knowledge sources after creating it. Remember to test your changes as you go!
To update your agent's name, description, or instructions:
On the Overview page, select Edit, at the top of the Details section.
Make your changes.
Select Save. Remember, editing the instructions changes how your agent engages with users. Make sure to test your changes.
To add a knowledge source:
On the Overview page, go to the Knowledge section, and select Add knowledge.
Select the desired type of knowledge. This quickstart uses Public websites sources.
Enter the URL for the website, then select Add beside the textbox.
Name and describe the knowledge source so you can keep track of all your agent's sources.
Select Add.
To change an existing knowledge source:
On the Overview page, go to the Knowledge section, and select the three dots (…) for the knowledge source.
Select Edit to change the knowledge source, or Delete to remove it from your agent's sources.
Publish your agent
Once you're happy with your agent, you can publish it to a website.
Note
You might need to change the authentication for your demo website, depending on who you want to access your agent. Go to Key concepts - Publish and deploy your agent for information on authentication levels and how to change them.
At the top of the page, select Publish, and then select Publish again in the Publish this agent confirmation message. If the publish is successful, you see a green banner on the top of the page.
At the top of the page, select the three dots (…) and select Go to demo website.
Send the URL to others to demonstrate it.
For more information about publishing your agent to other channels, see Key concepts - Publish and deploy your agent.
What's next?
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.
For questions not covered in the documentation or for feature ideas, visit our community and post questions.
We'd love to hear your ideas on Copilot Studio. Visit our Ideas board and post your ideas.