Share via


Use shared tools from the Tools page

The Tools page provides a centralized place for makers to create and manage functionality that can be used across agents within an environment. You can create, manage, and use tools across various agents within an environment, making tools into versatile and reusable components.

Note

The Tools page replaces the previous Library page.

You can access the Tools page in Microsoft Copilot Studio by selecting Tools in the left hand navigation.

When you go to the Tools page, you see a list of any tools that are already added. If no tools are added yet, you can add a new tool by selecting New tool. Each entry in the list of tools contains basic information about the tool, including name, type, creator, status, and the one or more agents on which the tool is added.

Tool details page

Select the name entry for one of the tools in the list to see a details page for the specific tool. From the details page, you can:

  • Edit the tool
  • Add the tool to one or more agents
  • Export the tool in a solution

You can choose one of the selectors above the list to filter by type of item (agent, connector, custom connector, prompt). You can also search for items by name.

Create a new tool

To create a new tool and add it to the Tools page:

  1. Select New tool. You're presented with several options:

    • Prompt: Create a new prompt tool using the embedded AI Builder prompt editor.
    • Agent flows: Streamline your business processes and automate repetitive tasks. Preconfigured to start with an agent trigger and end with a response back to your agent.
    • Custom Connectors: Bridge external systems that lack prebuilt connectors. Integrate REST or SOAP APIs with platforms like Logic Apps, Power Automate, Power Apps, or Copilot Studio.
    • REST APIs: Provide a guided experience for uploading Swagger files to create REST API tools. These are utilized to connect agents with external data sources or services not covered by prebuilt connectors.
    • Computer Use: Enable agents to automate tasks in apps and websites by clicking, typing, and navigating the interface. Computer use is ideal for scenarios like data entry, updating records in a web portal, or retrieving information from systems without APIs.
    • Model Context Protocol: Connect agents with existing knowledge servers and data sources to improve the use of structured and unstructured data within Copilot Studio.
  2. Select one of the options. You proceed to the creation flow for the tool. For some tools, creation occurs within the context of the Tool page, while for others, you are redirected to another entry point for creation.

Once a tool is created, it is listed on the Tools page. All tools within the selected environment are listed here if you are the maker of the tool or the maker shared the tool with you.

Add a tool to an agent

You can add a tool to an agent from the Tools page.

Note

When you add a tool to multiple agents, the underlying tool component (prompt, REST API, custom connector, agent flow, and so on) remains the same. Copilot Studio uses a wrapper around the tool. The wrapper lets you specify specific inputs/outputs and configurations specific to the implementation of that tool with the agent.

Select tool

  1. Select the ellipsis (...) next to the name of tool you want to add.

  2. Select Add to agent.

The next steps depend on the type of tool.

Add prompt as a tool to an agent

For prompts, you are taken to the tool details page, where you can add the prompt to an agent from the same page.

  1. Select Add.

  2. Select an agent from the list of agents.

  3. Select Add.

Add other tool types to an agent

  1. Select the agent to which you want to add the tool, and then select Add.

    You are redirected to the Add tool pane for the selected agent to add the tool.

  2. Select the specific tool.

    Depending on the tool, you may be asked to select or create a connection for the tool.

  3. Select Add to agent.

Tools vs Library comparison

The Tools page does not cover exactly the same functionality as the previous Library page.

Here is some information about where to find information previously available under the Library page.

  • Copilot agents/declarative agents: To create Copilot agents (also known as declarative agents) for Copilot for Microsoft 365, select Agents page > Copilot for Microsoft 365 > Agents. There, you can see all your existing Copilot agents, and also create new ones. You can also create declarative agents directly from Copilot for Microsoft 365 uisng the agent builder.
  • Prebuilt Power Platform connectors: The Tools page is a place where makers can create new tools from scratch. Prebuilt connectors do not fall into this category. You can view and add prebuilt connectors from within the context of an agent.
  • Component collections: Component You can view and create collections from within agent settings of the agent they are added to. Previously created component collections can also be found in the Solutions page.
  • Custom connectors: You can create custom connectors from the Tools page. For pre-built connectors, you can view and add from within the context of an agent.
  • Flow: Available within the Tools page.
  • Prompt: Available within the Tools page.
  • REST API: Available within the Tools page.

Known limitations

There are some known issues to be aware of on the Tools page. Some of these have mitigations you can use.

Issue Mitigation
Can't delete a tool from the Tools page If a tool is created and added to an agent, that tool can be removed from the agent by navigating to the agent.
Computer use tools are not listed on the Tools homepage If a computer use tool is created and added to an agent, it is listed in the Tools tab of that agent.
Prompts created in Power Apps, Power Automate, or within a topic are not visible in Copilot Studio. Create a new prompt in Tools. This issue is because the prompt artifact is wrapped in a plugin before it is added to an agent. Prompts created in Power Apps, Power Automate, and within the context of a topic are not wrapped in plugins. As a result, these prompts don't show up as an available tool to add on the *Tools page.
When you edit the title of a prompt tool, the new name doesn't show up under Tools. Edit the tool name under the Tools tab of the agent where it is added.
When you create a REST API tool, it also creates a custom connector. This is currently as designed. There are plans to combine the rest API and custom connector tool types.
Article Description
Extend Microsoft 365 Copilot with agents Extend Microsoft 365 Copilot with an agent built in Copilot Studio.
Use prompts to make your agent perform specific tasks Add prompts in Microsoft Copilot Studio using the embedded AI Builder prompt editor