Tools
Let the AI agent call your own API mid-conversation — look up an order, issue a refund, reset a password — reaching only the endpoints you configure with only the inputs you declare.
Where to find it
Open Tools
Sidebar → AI Agents → Tools
Direct link: https://app.productbridge.io/dashboard/support/workflows/agent/tools
In-app path: Sidebar → AI Agents → Tools
Requires: workflow:manage to add, edit, or delete a tool.
What a Tool Is
A tool is one of your own HTTP endpoints, described to the agent so it knows when to call it and what to send. The agent only ever reaches the endpoints you configure here, with the inputs you declare — nothing else.
| Tool type | What it's for | Example |
|---|---|---|
| API data source | The agent fetches content from your API and answers from it | An order status, a subscription, an account detail |
| API action | The agent changes something on your side | Issue a refund, reset a password, update a record |
An API action lets the agent change real data on your systems. Scope the endpoint tightly, authenticate it, and make it idempotent where you can — the agent decides when to call it.
Add a Tool
Open Tools
Go to AI Agents → Tools.
Choose the type
Click Add tool and pick API data source or API action.
Describe the endpoint
Give the tool a name, the URL and method, any authentication headers, and declare each input the agent may supply. The description you write is what the agent reads to decide whether the tool fits the question — make it specific.
Set access
Choose whether agents may use the tool directly, or whether it is Workflows only — reachable from a workflow step but never picked by an agent on its own.
Access Levels
The catalog shows each tool's Access:
| Access | Meaning |
|---|---|
| Off | Nothing can call it |
| Workflows only | Only a workflow step that explicitly selects it |
| (available) | Agents may reach it, subject to each agent's own tool selection |
Two layers gate a tool: the org-wide Access setting here, and each agent's own tool list. An agent that lists no tools gets everything marked usable directly.
Deleting a Tool
Deleting a tool stops the agent using it immediately. Workflow steps that had picked only that tool fall back to the default tool set rather than breaking.