Built-in Tools

The server's agent has 4 built-in tools that run automatically on the server side — no client execution required. The model calls them internally and the result is integrated into the final response.

Available built-in tools

Tool	Trigger	What it does
image_generation	"Generate an image of a sunset over the ocean"	Generates images; URL embedded in response as markdown
internet_search	"Latest news about AI", "What is today's date?"	Web search via Perplexity AI with citations
file_search	"Summarize the uploaded document"	Searches vector stores from uploaded files
url_content	"Summarize https://example.com/article"	Fetches and reads content from URLs

image generation

{
  "model": "google/gemini-2.5-flash",
  "messages": [
    { "role": "user", "content": "Generate an image of a futuristic city at sunset." }
  ]
}

The generated image URL is embedded as a markdown image inside content. Image cost is reported in usage.tool_cost_usd:

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "I've generated the image of a futuristic city at sunset.\n\n![Generated Image](https://cdn.example.com/gen/abc123.png)"
      },
      "finish_reason": "stop"
    }
  ]
}

File Search

The file_search tool lets the model search documents in pre-indexed file stores. Pass the store names in the request:

{  
  "model": "google/gemini-2.5-flash",
  "messages": [
    { "role": "user", "content": "Summarise the Q4 report" }
  ],
  "file_search_store_names": ["fileSearchStores/abc123"]
}  

The model will automatically call file_search with the provided store names when the query is relevant to the documents.

Store names are in the format fileSearchStores/{storeId}. You can pass multiple stores:

"file_search_store_names": [
  "fileSearchStores/abc123",
  "fileSearchStores/def456"
]

Internet Search

The internet_search tool queries the web via Perplexity AI and returns a synthesized, up-to-date answer with source citations. Use it for any question that requires current information beyond the model's training cutoff.

{
  "model": "google/gemini-2.5-flash",
  "messages": [
    {
      "role": "user",
      "content": "What are the latest AI news today?"
    }
  ],
  "stream": false
}

URL Content

The url_content tool fetches and processes the content of one or more URLs. It uses Gemini 2.5 Flash with Google's URL Context capability to retrieve, read, and reason over live web pages.

Use it when the user provides a specific link and asks questions about it — summarisation, extraction, comparison, Q&A over a page, etc.

{
  "model": "google/gemini-2.5-flash",
  "messages": [
    {
      "role": "user",
      "content": "Summarize this page and also team details: https://www.qolaba.ai/about-us"
    }
  ],
  "stream": false
}