Tool Connectors

Connect your AI agent to external services like databases, web search, and project management tools. Instead of just writing code in a vacuum, the agent can fetch real-time data, browse the web, and manage your workflows directly.

1. Accessing the Services Modal

To connect an agent to a tool, use the Services configuration:

1. Navigate to the Task Form on the homepage.
2. Click the Cable/Plug Icon next to the prompt input.
3. The Services dialog will open.

2. Connecting a Service

You can use pre-configured presets or add custom tool connections.

Presets

We have built-in support for tools like Context7, Browserbase, Supabase, and Linear.

1. Select a preset in the dialog.
2. Configuration:
   • For Cloud Services, click Connect.
   • For Local Tools, provide your API keys (like BROWSERBASE_API_KEY).
3. Click Save. The status will update to Connected.

Custom Tool Connections

If you have a specific tool or a custom server:

1. Click + Add Custom.
2. Type:
   • Remote: Use this for services hosted on a URL.
   • Local: Use this for tools that should run directly in your sandbox.
3. Details: Enter the name and the connection URL or command.
4. Credentials: Add any API keys required to authenticate.

3. How to Use Tools in a Task

Connected tools are available to the agent automatically. You just need to reference them in your prompt.

Research & Data Fetching

If you need the agent to look something up:

1. Connect a search service like Context7.
2. Ask the agent to research a topic before writing code.
3. The agent will use the tool to find the information and then apply it to your files.

Database Operations

To manage data or migrations:

1. Connect a Postgres or Supabase service.
2. Ask the agent to inspect a table or write a query.
3. The agent will fetch the schema and generate code that matches your actual database structure.

Best Practices

Keep it Focused

Only connect the tools you actually need for the task. Each connected service adds context that the agent has to process. Fewer tools mean faster, more accurate results.

Be Explicit

If you have multiple tools with similar functions, tell the agent which one to use by name. For example, "Use Context7 to find the documentation" or "Use Browserbase to scrape the pricing page."

Troubleshooting

• Connection Errors: Check the Logs tab in your task. Most errors are caused by missing or incorrect API keys.
• Agent Ignoring Tools: Mention the tool specifically in your prompt if the agent isn't picking it up automatically.
• Authentication: For cloud services, make sure you've completed the required OAuth or API key setup in the modal.