Adding Tools to an Agent Group

Your agent can only use tools that are in its Agent Group. Here's how to add them.

Before You Enable

• Confirm the tool or workflow is needed for the agent's current job.
• Review the input/output contract so the agent can call it with predictable fields.
• Check whether the tool requires an external credential.
• Set or review the Agent Group spending cap before enabling paid actions.
• For workflows, inspect required tool dependencies before adding the workflow.

Add a Single Tool

1. Find the tool

   Browse the marketplace or search for a specific tool.

2. Click Enable

   On the tool's card or detail page, click the Enable button.

3. Select an Agent Group

   Choose which Agent Group to add the tool to. If the tool requires credentials, you'll be prompted to set them up.

Add a Workflow

Workflows are added the same way as tools:

1. Find a workflow in the marketplace
2. Click Enable
3. Select the Agent Group

The workflow's required tools are shown on its detail page. Make sure those tools are also in your Agent Group, or the workflow won't be able to execute all its steps.

After You Enable

1. List tools from the agent

   Confirm the tool or workflow appears in the connected agent's catalog.

2. Run a small verification call

   Use known inputs and confirm the result, status, and credit usage are expected.

3. Review Agent Activity

   Check Control Center for the request, selected credential, status, and execution metadata.

Least-Privilege Credentials and Caps

Use credentials that expose only the external account access the tool needs. Keep caps low when introducing a new tool, then raise them only after you have reviewed normal call volume and activity records.

Workflow Dependencies

If a workflow depends on tools that are not enabled for the group, the agent may discover the workflow but fail during execution. Enable each dependency deliberately, connect the required credentials, and test the workflow end to end.

Bulk Add

From the Control Center → Agent Groups subtab, you can bulk-add multiple tools at once:

1. Open your Agent Group settings
2. Click Bulk Add
3. Select the tools you want
4. Confirm

Removing Tools

From your Agent Group settings, you can remove individual tools or workflows at any time. Removing a tool immediately prevents your agent from using it.

Before removing a tool, check whether any enabled workflows depend on it. If removal breaks a workflow, either disable the workflow too or replace the dependency and run another verification call. Re-enable the prior tool if rollback is needed.

Troubleshooting