Live training: next batches coming soon. Join the waitlist:Waitlists open:Developer Training →Developer →Copilot Studio Training →Copilot Studio →

How to Add Trigger Phrases and Triggers in Copilot Studio

You open a topic in Copilot Studio to add trigger phrases, and the phrase box simply isn’t there. The trigger reads “The agent chooses” and asks for a description instead.

In this tutorial, we’ll show you how to add trigger phrases in Copilot Studio, why a new agent hides them, and how to add or change any other trigger on a topic. Everything here comes from a real Reset Password topic we built and tested today.

Quick answer: Trigger phrases only exist with classic orchestration. Go to Settings > Generative AI, set orchestration to No, open the topic, select Edit on the User says a phrase trigger, add 5-10 short phrases and save. With generative orchestration (the default), you write a topic description for The agent chooses instead.

What You Need Before You Start

  • A Copilot Studio license and maker access to an environment (ours is called Live Training).
  • A standard agent. Agents built on the new GitHub Copilot harness have Build and Preview tabs but no Topics page.
  • One topic idea with a clear purpose. We used password resets for an IT help desk agent.

We used our SPGuides IT Help Desk – SharePoint agent. If you don’t have one yet, follow our guide to create a new agent in Copilot Studio first.

Step 1: Create a Topic From Blank

Open the agent and go to Topics. Select + Add a topic and pick From blank (the other choice is Add from description with Copilot):

Add a topic menu on the Copilot Studio Topics page with From blank highlighted

The new Untitled topic opens with a Trigger node set to The agent chooses and a box labeled Describe what the topic does. There’s no place for phrases because the agent uses generative orchestration:

New topic trigger node showing The agent chooses and the topic description box

Select the Untitled name and rename it. We called ours Reset Password (Learn warns against periods in topic names). For more ways to build one, see our post on how to create a custom topic in Copilot Studio.

Step 2: Write the Description for The Agent Chooses

With generative orchestration, the agent compares the topic’s name and description with each message. So the description does the job trigger phrases used to do. We typed this one:

This topic helps SPGuides employees reset a forgotten Microsoft 365 password or unlock their account. Use it when someone says they forgot their password, are locked out, or can't sign in.

Then we added + > Send a message with the reset steps and an email for helpdesk@spguides.com, and selected Save. The banner said “Topic Saved!”

In the test pane, we typed “I can’t log in to Outlook, I think I forgot my password.” The topic fired, and the activity map explained why:

Test pane and activity map showing the agent picked the Reset Password topic

The map said the agent “determined that the Reset Password topic was relevant” and finished in 0.04 seconds. Agent-wide behavior belongs in agent instructions and conversation starters, not in topic descriptions.

Step 3: Change the Trigger on a Topic

This is how you add a different trigger to a topic. Hover over the Trigger node box and select the Change trigger icon:

Change trigger icon on the Trigger node of the Reset Password topic

The list shows every trigger type your orchestration mode allows. Pick one, then select Edit on the trigger to set its properties:

Change trigger list in Copilot Studio with The agent chooses at the top

Our generative agent listed ten types, and User says a phrase wasn’t one of them. Edit opens On Recognized Intent properties, where you can add a Condition (Builder or a Power Fx Formula) and a Priority.

Event-driven triggers deserve their own walkthrough, which we cover in add event triggers in Copilot Studio.

Copilot Studio Trigger Types Cheat Sheet

Here’s every trigger type from Microsoft Learn, with the orchestration mode it needs:

TriggerFires whenOrchestration
The agent choosesTopic name and description match the messageGenerative only
User says a phraseA trigger phrase closely matches the messageClassic only
A message is receivedAny user message arrivesBoth
A custom client event occursAn event activity arrives (filter by Event name)Both
An activity occursAny activity type arrivesBoth
The conversation changesUsers join or leave, such as in TeamsBoth
It’s invokedAn invoke activity arrives, like a Teams button clickBoth
It’s redirected toAnother topic calls this oneBoth
The user is inactive for a whileNo reply after a set timeBoth
A plan completesThe agent finishes all planned stepsGenerative only
An AI-generated response is about to be sentRight before a generated answer goes outGenerative only

When several triggers qualify, An activity occurs runs first, then the message, event, conversation and invoke triggers, and The agent chooses or User says a phrase runs last.

Step 4: Switch the Agent to Classic Orchestration

To get phrases, open Settings > Generative AI. Orchestration is set to Yes by default:

Generative AI settings with generative orchestration set to Yes

Select No – Use classic orchestration and Save. The agent then answers only from what its topics define, plus knowledge when no topic matches:

Orchestration setting changed to No for classic orchestration in Copilot Studio

Important: picking No also turned Let other agents connect to and use this one from On to Off by itself. If you rely on that for multi-agent setups in Copilot Studio, turn it back on.

Step 5: Add Trigger Phrases to the Topic

Back on Topics, the Trigger column now reads Phrases for all five custom topics:

Topics list where the Trigger column shows Phrases after the switch

Open the topic. The trigger changed to User says a phrase, but it shows “No phrases to show.” Copilot Studio didn’t turn our description into phrases:

User says a phrase trigger with No phrases to show on the Reset Password topic

Select Edit to open the Phrases panel. It says the agent needs 5-10 short trigger phrases to start learning:

Phrases panel asking for 5 to 10 short trigger phrases with the Enter text box

Type a phrase and press Enter. To add several at once, press Shift+Enter between them, or paste line-separated phrases:

Several trigger phrases typed on separate lines with Shift+Enter

Note: after Enter, the cursor jumps into the phrase you just added. Typing again appends to that phrase, so click the Enter text box first.

You can also upload a text file (up to 3 MB) and pick Append or Replace. We saved seven phrases, and the node listed them on the canvas:

Trigger node listing the seven password trigger phrases on the canvas

Step 6: Test the Phrases and Fix a Miss

In a new test session, “I forgot my password again” fired Reset Password, and the path lit up on the canvas:

Test chat where a trigger phrase match fires the Reset Password topic

Then we tried “my password stopped working this morning.” No topic fired. The agent answered from its public website knowledge source with one Microsoft Support reference:

Agent answering from knowledge after a trigger phrase miss in the test pane

The fix took one phrase. We added “my password isn’t working,” saved, started a new test session, and the same message fired the topic:

New trigger phrase fixing the miss so the topic fires in the test chat

Here’s our final list of eight phrases:

reset my password
forgot password
I'm locked out of my account
can't sign in to Microsoft 365
change my password
password expired
unlock my account
my password isn't working

Common Mistakes to Avoid

  • Looking for phrases on a generative agent. They don’t exist there. Improve the description instead.
  • Expecting the description to convert. After the switch, every topic starts with no phrases.
  • Single-word phrases like “password.” Learn says they confuse similar topics. Keep phrases short but complete, under 10 words.
  • Ten versions of one sentence. Vary the verbs and nouns; the model already handles small variations.
  • Overlapping phrases across topics. They trigger the wrong topic or double replies. Balance phrase counts too.
  • Testing in an old session. Start a new test session after you save.

Do Trigger Phrases Work With Generative Orchestration?

No. Generative agents ignore phrases and route with The agent chooses. When we switched back to Yes, the topic returned to The agent chooses with our original description, so Copilot Studio stores both.

Our advice: keep generative orchestration and write sharp descriptions, unless you need predictable phrase matching. Remember to reset the Connected agents toggle after any switch.

Next Steps

Nothing reaches users until you republish the agent. For a web page, see how we publish an agent to a live or demo website, and our Copilot Studio tutorials page lists the rest.

Want a guided path instead? The Copilot Studio training course walks through topics, triggers and knowledge end to end.

We’d keep going with these Copilot Studio guides:

Frequently Asked Questions

How do I add trigger phrases in Copilot Studio?

Set orchestration to classic in Settings > Generative AI, open the topic, select Edit on the User says a phrase trigger, type 5-10 short phrases (Enter or Shift+Enter) and save the topic.

Why can’t I see trigger phrases in my Copilot Studio topic?

Your agent uses generative orchestration, the default. Its topics use The agent chooses with a description, and the User says a phrase trigger only appears with classic orchestration.

How do I add a trigger in Copilot Studio?

Hover over the Trigger node, select the Change trigger icon, and pick a type such as A message is received or The user is inactive for a while. Select Edit to set its condition and priority. See Set topic triggers on Microsoft Learn.

How many trigger phrases should a topic have?

Microsoft recommends 5-10 short phrases per topic, under 10 words each and never a single word, added to as you learn from real users. The details are in Design effective trigger phrases.

Can I upload trigger phrases from a file?

Yes. In the Phrases panel, select upload a file, choose Append or Replace, and drop a text file of up to 3 MB with one phrase per line. Download exports the current list.