​

Tools

​

How Tools Work

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.

​

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.

​

Via 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

​

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.
• WhatsApp — Send messages, interactive buttons, and media via WhatsApp Business.
• SMS — Send text messages from your agents.
• CRM & Webhooks — Connect to CRMs and external systems.