Submit a Deep Research Request to Perplexity
perplexity_deep_research(
.llm,
.background = FALSE,
.reasoning_effort = "medium",
.search_context_size = "medium",
.search_domain_filter = NULL,
.search_language_filter = NULL,
.language_preference = NULL,
.search_recency_filter = NULL,
.search_mode = NULL,
.search_after_date_filter = NULL,
.search_before_date_filter = NULL,
.last_updated_after_filter = NULL,
.last_updated_before_filter = NULL,
.user_location = NULL,
.json_schema = NULL,
.idempotency_key = NULL,
.api_key = Sys.getenv("PERPLEXITY_API_KEY"),
.timeout = 300,
.max_tries = 3
)If .background = FALSE, an updated LLMMessage with the research reply.
If .background = TRUE, a tidyllm_research_job object.
An LLMMessage object containing the research question.
Logical; if TRUE, returns a tidyllm_research_job immediately without waiting (default: FALSE).
Reasoning level: "low", "medium" (default), or "high".
Amount of search context: "low", "medium" (default), or "high".
Character vector of domains to allowlist/denylist (max 10; prefix with "-" to denylist).
ISO 639-1 language code to restrict search results (e.g. "en", "de").
ISO 639-1 code for preferred response language.
Restrict search to recent results: "hour", "day", "week", "month", or "year".
Search index to use: "web" (default), "academic", or "sec".
Only include content published after this date (MM/DD/YYYY).
Only include content published before this date (MM/DD/YYYY).
Only include content last updated after this date (MM/DD/YYYY).
Only include content last updated before this date (MM/DD/YYYY).
Named list for geographic search personalisation (fields: country, city, region, latitude, longitude).
A tidyllm schema created with tidyllm_schema() for structured JSON output (optional).
Optional string; unique key to prevent duplicate submissions.
Character; Perplexity API key (default: from environment variable).
Integer; request timeout in seconds for blocking polling (default: 300).
Integer; maximum retries (default: 3).