Choose the plugin tools an agent can use

Purpose

Kian has connected the inventory plugin, but the support assistant cannot use it until he says so. Give the agent access to your connected plugins, and limit it to the tools you want it to use.

Before you start

The custom agent must belong to your current workspace, you need permission to manage agents, and the plugin must be connected for you first (see "Connect a plugin"). Workspace rules decide which plugins you can connect.

Steps

1. Open "Agents", find the agent under "My agents" and select it. In the window, open "Agent actions" (the three dots) and choose "Edit agent".
2. Open "Plugins". If it says "No connected plugins", connect one from the Plugins page first. Use "Search plugins or tools" to find a plugin by name, developer, capability or tool.
3. Under "Connected plugins", switch on each plugin the agent may use. A plugin you added yourself carries the "Personal" badge. A switched-on plugin shows "All tools enabled" by default.
4. To allow only some tools, select "Choose tools" and tick the ones to allow. At least one tool always stays ticked. A saved configuration can hold up to 50 plugins, and up to 200 explicitly chosen tools per plugin ("All tools enabled" is not counted against the 200). "Use all" brings back the full list, and "Hide tools" closes the list.
5. Switch a plugin off to give the agent none of its tools.
6. Below the list, "Tool middleware" holds retries, the tool call limit and the tool selector (see "Set agent execution limits").
7. Select "Save" and test with a request that needs one of the allowed tools.

Expected result

The agent can use only the tools you left ticked, and only while the plugin stays connected for you.

Troubleshooting