In Copilot Studio, the flow designer is where you create and manage the automated processes that your agents will use. The agent flow designer has a similar building experience to Power Automate. For beginners, it can feel overwhelming at first, but once you know a few tricks, you will work faster and avoid common mistakes. Below are practical tips to help you get started with the agent flow designer.

Where to create a new agent flow

Go to Copilot Studio https://copilotstudio.microsoft.com/ and select Flows from the left hand side. Click +New agent flow.

Before building the flow, check that you have the correct environment selected in the top right hand side of the screen. Typically, you would build your flow in the same environment as your agent.

Screenshot of Copilot Studio showing the Agent flows interface with options to create a new agent flow, a list of existing flows, and the selected environment.

Building an agent flow does not automatically connect it to an agent. Once the flow is built you can add it to your agent as a tool or via topics.

Save as you go

Flows do not auto-save. Make it a habit to click Save draft regularly while editing. If you navigate away without saving, your changes will be lost.

Screenshot of Copilot Studio showing the flow designer interface for creating and managing automated processes. The interface includes options for saving drafts and publishing flows.

Moving around the designer

Click and drag around the whitespace of the screen to move around in your flow.

Screenshot of Copilot Studio's flow designer for 'Get Manager Approval' showing agent flow steps and workflow connections.

Toolbar

The toolbar provides quick-access controls for managing the flow design. The icons include:

  • Expand/collapse all actions: Hide or display the details of all steps
  • Zoom in
  • Zoom out
  • Fit to screen: Adjust the view to fit the entire flow
  • Minimap: Move around the minimap to navigate around the flow
  • Search: Find and open flow steps quickly
Screenshot of the Copilot Studio interface showing the 'Get Manager Approval' flow design. The left sidebar contains tools for managing flow actions, while the main area displays input fields for the approval type and details.

Rename a flow

Give your flows clear names so you can easily identify them later. Click the flow name at the top of the designer and type a name that reflects its purpose.

You will only be able to rename the flow after it has been saved.

Screenshot of Copilot Studio's flow designer with the title 'Get Manager Approval' highlighted. It shows the flow steps including 'When an agent calls the flow', 'Get manager (V2)', and 'Respond to the agent'.

Expand or collapse steps

You can click on an action to minimise or expand it on the screen. Click on the action name area at the top of the step to expand or minimise it.

Screenshot of Copilot Studio's designer interface displaying a 'Get Manager Approval' flow with user parameters and action steps outlined.

Insert dynamic content to use information from previous steps

Dynamic content lets you use information and outputs from previous steps in your flow. This is essential for passing data through your flow. For example, say you have inserted an action that retrieves a user’s details (Office 365 Connector). This action generates outputs such as the user’s name, phone number, birthday, address, office location and more.

Screenshot of the Copilot Studio flow designer interface showing a flow step to get user profile details, with fields for user email address and invalid connection notification.

In an action, look for the lightning bolt button to bring up dynamic content options.

Screenshot of the Copilot Studio flow designer interface showing actions to get a user's profile and send an email, along with error messages for invalid connection and parameters.

You will see a list of available dynamic content, sorted by the action it was generated from.

Screenshot of the Copilot Studio flow designer interface showing the parameters and actions for a user profile and email, including input fields and error messages.

Sometimes, not all dynamic content will be displayed in the list. Use the Search bar to find it.

Screenshot of Copilot Studio's flow designer interface, showcasing the 'get user profile' and 'send an email' actions along with parameter settings and a search bar.

Your actions can use a mix of static values and dynamic content. Insert the dynamic content in the correct position. For example, this email message below follows a standard template but will dynamically insert a user’s name and office location.

Screenshot of the Copilot Studio Designer interface, displaying an email action setup with fields for 'To', 'Subject', and 'Body'. The body includes dynamic content for user details like given name and office location.

The dynamic content (lightning bolt) button will may not appear immediately. You will need to click on the settings cog icon first.

Screenshot of the email action in a flow designer, showing fields for 'To', 'Subject', and 'Body' with an option to use dynamic content highlighted.

Copy and paste an action

Need to reuse an action? Right click on the action you want to copy, and select Copy.

Screenshot of the Copilot Studio flow designer showing the option to copy an action within an email sending task.

You can then paste it into another part of the flow. To paste the action, right click on the + new step icon. Select Paste an action.

Screenshot of the designer interface in Copilot Studio showing the creation of an approval flow. Includes an email action with fields for recipient and subject, along with options to add or paste actions.

This saves time when you have similar steps.

If you see errors appear in the copied action, remove then re-add any dynamic content in the action.

Reorder steps with drag and drop

You can change the order of steps by dragging and dropping them in the designer. “Drop” the step on the + icon of the new position. This is useful when you need to adjust the sequence without deleting and recreating actions.

Screenshot of Copilot Studio's flow designer interface showing the 'Get Manager Approval' flow with highlighted actions and connections.

If moving a step earlier in the flow, check that it does not use dynamic content from subsequent steps. Dynamic content can only be used in a flow if it comes from a previous step in the sequence. You will not be able to reorder the step if that is the case.

Rename a step

Just like flows, steps should have clear names. This does not functionally change anything in your flow, but can be helpful while building your flow, especially if it has many similar actions. Right click on the step name and select Rename. Edit it to describe what the step does. This makes your flow easier to read and maintain.

Screenshot of the Copilot Studio Designer interface, highlighting the option to rename an action in the approval workflow with a dropdown menu.

Test a flow

You can test a flow to ensure it is working as expecting.

Testing a flow will run the flow. This means that if your flow contains the sending of emails or notifications, these will actually be sent. Make sure you use test data in your flow (not actual customer details!)

Screenshot of Copilot Studio showcasing the 'Get Manager Approval' flow with sections for designer, activity, and analytics. Emphasizes options to test the flow manually or automatically.

When you click Test, you can run the test manually or automatically. Manually means that you will need to go and perform your flow’s trigger step before the flow runs.

If a flow has already been run, you can use the automatic test. This uses a triggering action from a previous flow run, which means that you do not need to go and perform the trigger again.

Restore a previous flow version

If something goes wrong, you can restore an earlier version of your flow. Go to the Versions tab to view and revert to previous saves.

Screenshot of the Copilot Studio interface displaying the 'Get Manager Approval' flow design. It features input fields for UserEmail, UserName, and RequestData, alongside options for version history and flow management.

Add a flow description

Use the Description field to explain what the flow does and any important details. This is helpful for anyone reviewing or maintaining the agent later. You can find the description in the Overview tab. Click on Edit in the Details area.

You can automatically generate a description too.

Leave a comment