Perplexity Search

Perplexity Search lets a Hive Agent call Perplexity’s standalone Search API regardless of whether the agent model is OpenAI, Anthropic, xAI, Gemini, or Perplexity. The model sees a function named search_perplexity and supplies only a required query. All search options are saved on the tool and cannot be overridden by the model.

Configuration

Add Perplexity Search from the agent tool selector.
Set Maximum results from 1 to 20. The default is 10.
Choose a country, or No country restriction.
Choose Search context size (Low, Medium, or High), or select Custom token limits and set the optional total and per-page token limits. Perplexity does not accept a context preset together with token limits.
Optionally select up to 20 search languages.
Optionally set updated-after, updated-before, published-after, and published-before dates.
Optionally restrict publication recency to the past hour, day, week, month, or year.
Choose the agent’s credential mode. Hosted mode uses Fetch Hive’s key; personal mode requires the workspace’s enabled Perplexity integration.

Token limits accept values from 1 to 1,000,000. Date fields are sent to Perplexity in MM/DD/YYYY format. For each date window, the after date must be earlier than the before date. The tool can be selected at the same time as Sonar Web Search. They remain separate tools.

Result and billing behavior

Each model invocation returns the query and a normalized results array. Completed calls render with the standard search-result cards. Every actual invocation consumes one provider-tool limit unit. If the model never calls the function, no unit is consumed. Successful hosted calls use the fixed Search API cost plus platform markup; successful personal calls use one platform task. Failed calls are not billed.