Tools

Tools Overview

Give your AI agents the ability to take actions, fetch data, and interact with external services using tools.

Tools

Tools are the capabilities you give your AI agents. They allow agents to go beyond conversation — searching the web, reading spreadsheets, sending emails, booking appointments, and interacting with any external API.

How Tools Work

When you assign tools to an agent, here's what happens during a conversation:

  1. The agent receives a message from a user or caller.
  2. The agent decides whether it needs to use a tool to answer the question or complete a task.
  3. The agent calls the tool with the appropriate parameters.
  4. The tool executes — making an API call, querying a database, or performing an action.
  5. The agent receives the result and uses it to formulate its response.

The agent handles all of this automatically. You just need to assign the right tools and the agent figures out when and how to use them.

Assigning Tools to an Agent

From the Dashboard

  1. Navigate to Agents and select your agent (or create a new one).
  2. Scroll to the Tools section.
  3. Click Add Tool to browse available tools.
  4. Select a tool, configure its settings (API keys, permissions, etc.).
  5. Save the agent.

Your agent can have multiple tools assigned simultaneously. It will choose the right tool based on the conversation context.

Via the API

You can also assign tools when creating or updating an agent through the API:

curl -X POST https://api.thinnest.ai/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Assistant",
    "instructions": "You help users research topics using web search and Wikipedia.",
    "tools": [
      { "type": "duckduckgo" },
      { "type": "wikipedia" }
    ]
  }'

Tool Execution Flow

User asks: "What's the weather in Tokyo?"


┌─────────────────────┐
│  Agent processes     │
│  the message         │
└─────────┬───────────┘
          │ Agent decides it needs weather data

┌─────────────────────┐
│  Agent calls the     │
│  OpenWeather tool    │
│  with city: "Tokyo"  │
└─────────┬───────────┘
          │ Tool returns weather data

┌─────────────────────┐
│  Agent formats the   │
│  response naturally  │
│  "It's 22°C in       │
│   Tokyo today..."    │
└─────────────────────┘

Tool Categories

thinnestAI provides a wide range of built-in tools organized by category:

CategoryToolsUse Cases
SearchDuckDuckGo, Tavily, Exa, SerpAPI, Wikipedia, PubMed, ArXivWeb research, fact checking, academic research
Web ScrapingFirecrawl, Crawl4AI, JinaReader, Spider, NewspaperExtracting content from websites
Data & AnalyticsDash, DuckDB, CSV, SQL, PostgreSQL, BigQuery, PandasSelf-learning database queries, analyzing data
FinanceYFinance, OpenBBStock prices, financial data, market analysis
AI GenerationDALL-E 3, ElevenLabs TTS, Replicate, FALImage generation, text-to-speech, AI models
ProductivityGitHub, Linear, Todoist, Confluence, ClickUp, Cal.comProject management, task tracking, scheduling
CommunicationSlack, Discord, Telegram, MS Teams, Zoom, SMSMessaging, notifications, meeting management
CRMHubSpot, Salesforce, LinkedIn, Apollo, ActiveCampaignContact management, lead tracking, outreach
CloudAWS Lambda, AWS SES, Apify, E2BServerless functions, email delivery, web scraping
Google SuiteGmail, Google Calendar, Google SheetsEmail, scheduling, spreadsheets
OtherGoogle Maps, OpenWeather, Calculator, File operationsLocation, weather, math, file handling

What's Next

  • Built-in Tools — Browse all available tools and what they do.
  • Custom Tools — Create your own tools with custom API endpoints.
  • Google Calendar — Set up appointment booking.
  • Gmail — Automate email workflows.
  • SMS — Send text messages from your agents.
  • CRM & Webhooks — Connect to CRMs and external systems.

On this page