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 reflects the classic experience in Microsoft Copilot Studio. The classic experience includes the classic authoring experiences for both agents and workflows. Learn about the two agent experiences in Classic vs. new agent experience. Learn about the two workflow experiences in Workflows overview.
Agent flows can be added to agents as tools to create larger agent-based automation scenarios.
To add a flow as a tool to an agent, the flow must satisfy the following criteria:
- Have the When an agent calls the flow trigger and a Respond to the agent action.
- Be configured to respond in real time, not asynchronously. The Asynchronous response toggle must be set to Off under Networking in the Respond to the agent action settings.
- Be published.
- Respond to the agent within the 100-second action limit. Optimize the flow logic, queries, and the amount of data returned so that a typical run is below this 100-second limit.
If you don't already have an agent flow configured for use with an agent, create one using natural language or the designer.
You can add an existing agent flow that satisfies these criteria to an agent at either the agent level or the topic level.
Add an agent flow to an agent as an agent-level tool
When you add a flow at the agent level, the agent orchestrator can trigger it directly at runtime. To add a flow to an agent as an agent-level tool:
In Copilot Studio, select Agents, and then select the agent that you want to add a flow to.
Go to the Tools page and select Add a tool. The Add tool panel appears.
To list the flows that are available as tools, select Flow.
If the flow you want to add isn't listed, make sure that it has the When an agent calls the flow trigger and a Respond to the agent action. If it doesn't, it can't be added as a tool to an agent.
Select the flow.
Select Add and configure. The flow is added as a tool to the agent, and the flow configuration panel appears.
Modify the flow configuration as needed. For example, you can update the description to help your agent understand the flow's purpose.
Select Save as needed to save configuration changes.
The flow should appear in the agent's list of tools.
Add a flow to a topic as a topic-level tool
When you add an existing flow to a topic, it only becomes available to that topic.
To add a flow to a topic as a topic-level tool:
In Copilot Studio, select Agents, and then select the agent that you want to add a flow to.
Go to the Topics page and select the topic that you want to add a flow to.
Select the Add node icon
below any node, and select Add a tool.Select the flow you want to add. A new Action node appears in the topic.