Configuring Agent Tools

Browse the tool catalog, bind schemas, configure credentials, and assign tools to agents

Overview

Tools are the capabilities you grant to agents. Each tool has a defined schema, required credentials, and specific behavior. OpenRails provides a built-in tool catalog that includes database access, web browsing, project management integrations, and more.

Tool Catalog

Tool Description Credentials Required
Vector DB Search Query vector collections for semantic document retrieval None (uses linked data lake)
Database SQL Execute SQL queries against configured databases Database connection string
Basecamp Access Basecamp projects, message boards, to-dos, and schedules Basecamp OAuth token
Azure DevOps Manage work items, track time, and access repositories Azure DevOps PAT or OAuth
Web Search Perform web searches and retrieve results Search API key
Automated Browser Navigate web pages, extract content, and interact with web applications None

Configure a Tool

Open Agent Settings

Navigate to your agent and click Settings, then select the Tools tab.

Browse the Tool Catalog

Click Add Tool to open the tool catalog. Browse or search for the tool you need.

Configure Tool Parameters

Each tool has specific configuration options. Fill in the required parameters:

  • Credentials — Provide API keys, connection strings, or OAuth tokens
  • Rate Limits — Optionally set per-tool rate limits

Test the Tool

Use the Test button to verify the tool works with the provided credentials and configuration.

Save Configuration

Click Save to bind the tool to your agent. The agent can now use this tool during execution.

Tip: Only assign tools that your agent actually needs. Fewer tools means the agent spends less time deciding which tool to use, resulting in faster and more accurate execution.
Important: The Database SQL tool allows agents to execute arbitrary SQL. Always use read-only database connections unless write access is explicitly required. Consider using HITL approval gates for write operations.

Next Steps