🔧
PipesHub Toolsets
Give your AI agents the ability to interact with external applications
What are Toolsets?
Toolsets are collections of tools that enable AI agents to interact with external applications. Each toolset provides a set of actions (tools) that agents can use to read data, create content, and perform operations in connected services. Unlike Connectors (which sync and index data for search), Toolsets provide real-time API access for performing actions.| Feature | Connectors | Toolsets |
|---|---|---|
| Purpose | Sync and index data for search | Perform actions via API |
| Data Flow | One-way (import) | Two-way (read/write) |
| Use Case | Knowledge retrieval | Agent actions |
| Real-time | Periodic sync | Instant API calls |
Available Toolsets
Google Workspace
Atlassian
| Toolset | Description | Auth Type |
|---|---|---|
| Jira | Issue tracking and project management | OAuth 2.0 |
| Confluence | Wiki and documentation | OAuth 2.0 |
Slack
| Toolset | Description | Auth Type |
|---|---|---|
| Slack | Team messaging and collaboration | OAuth 2.0 |
Configuring Toolsets
Step 1: Navigate to Toolsets Settings
- Click on your Connector Settings in the navigation
- Go to Settings in the sidebar
- Click Toolsets
Step 2: Browse Available Toolsets
The Toolsets page has two tabs:- My Toolsets - Toolsets you’ve already configured
- Available - All available toolsets ready to configure
Step 3: Configure a Toolset
- Find the toolset you want to configure in the Available tab
- Click the “Configure” button on the toolset card
- The Configuration Dialog will open
Step 4: Authenticate
Follow the authentication flow for the toolset:- Enter the required credentials in the configuration dialog (e.g., Client ID and Client Secret)
- Click “Authenticate”
- If prompted, a popup window will open for authorization
- Grant the requested permissions
- You’ll be redirected back to PipesHub with authentication confirmed
Each toolset may have different authentication requirements. See individual toolset documentation for specific setup steps and credentials needed.
Step 5: Verify Configuration
Once configured, the toolset will appear in your My Toolsets tab with an “Authenticated” status.
Managing Toolset Configuration
You can manage your toolset by clicking on it in the My Toolsets tab to open the configuration dialog. Available actions:- Update Configuration - Modify credentials or settings
- Reauthenticate - Refresh authentication if it expires or encounters issues
- Delete - Remove the toolset configuration entirely
Using Toolsets in Agents
Once a toolset is configured, it becomes available in the Agent Builder:- Open the Agent Builder (create new or edit existing agent)
- In the left sidebar, expand the “Tools” section
- Find your configured toolset and drag it onto the canvas
- Connect it to your agent flow
Authentication Types
OAuth 2.0
OAuth 2.0 is the recommended authentication method for most toolsets. It provides:- Secure token-based access - No passwords stored
- Automatic token refresh - Tokens are refreshed automatically
- Granular permissions - Only request necessary scopes
- User authorization - Users explicitly grant access
- Create an OAuth application in the service’s developer console
- Configure redirect URI (provided by PipesHub)
- Obtain Client ID and Client Secret
Troubleshooting
OAuth authentication failing
OAuth authentication failing
Possible causes:
- Incorrect Client ID or Client Secret
- Redirect URI mismatch
- OAuth application not properly configured
- Verify Client ID and Secret are correct (no extra spaces)
- Check that the Redirect URI in PipesHub matches exactly what’s configured in the OAuth app
- Ensure the OAuth application is active/enabled
Toolset not appearing in Agent Builder
Toolset not appearing in Agent Builder
Possible causes:
- Toolset not authenticated
- Authentication expired
- Browser cache issue
- Go to Settings > Toolsets and check the toolset status
- If not authenticated, click “Configure” and complete authentication
- If expired, click “Reauthenticate”
- Try refreshing the Agent Builder page
Tools returning errors
Tools returning errors
Possible causes:
- Insufficient permissions for the action
- Service API rate limits
- Check that the OAuth app or API token has write permissions if needed
- Wait and retry if rate limited