Guide: Web Tools

Give your Flapjack agent the ability to search, research, read, and crawl the web during conversations.

Available Web Tools

Tool	Description	Powered By
web_search	Search the web for a query	Perplexity
web_research	Extended research with multiple queries	Perplexity
web_read	Read a specific URL and extract content	Firecrawl
web_crawl	Crawl a website and extract content from multiple pages	Firecrawl

Enabling Web Tools

Via Dashboard

1. Go to Agents → Select your agent
2. Click Web in the sidebar
3. Toggle individual tools on/off

Via API

curl -X PUT https://api.flapjack.dev/api/agents/{agentId}/web \
  -H "Authorization: Bearer fj_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "searchEnabled": true,
    "researchEnabled": true,
    "readEnabled": true,
    "crawlEnabled": false
  }'

📋 Copy as prompt

Enable web search, research, and read tools for my Flapjack agent. PUT to /api/agents/{agentId}/web with boolean flags for each tool.

Use Cases

Web Search

Best for: Quick factual lookups, current events, general questions

"What's the current price of Bitcoin?" "Who won the latest Formula 1 race?"

Web Research

Best for: In-depth research that requires synthesizing multiple sources

"Compare the top 3 project management tools for small teams" "What are the latest best practices for API rate limiting?"

Web Read

Best for: Extracting content from a specific known URL

"Read the documentation at https://example.com/docs and summarize it" "What does this blog post say? https://blog.example.com/post-1"

Web Crawl

Best for: Gathering content across multiple pages of a website

"Crawl the Acme support docs and create a FAQ"

How the Agent Decides

The agent sees tool descriptions and decides when to use web tools based on the conversation. You can guide this behavior in the system prompt:

You have access to web tools. Use web_search for factual questions about current events.
Use web_read when the user provides a specific URL. Prefer your knowledge base over web
search when the answer is likely in your uploaded documents.

Next Steps

• Concepts: Tools — tool system overview
• Concepts: Knowledge — RAG as an alternative to web search
• Concepts: Agents — system prompt guidance