% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/llm_verbs.R
\name{deep_research}
\alias{deep_research}
\title{Run Deep Research via a Provider}
\usage{
deep_research(.llm, .provider, .background = FALSE, ...)
}
\arguments{
\item{.llm}{An \code{LLMMessage} object containing the research question.}

\item{.provider}{A function or function call specifying the provider (e.g., \code{perplexity()}).}

\item{.background}{Logical; if TRUE, returns a \code{tidyllm_research_job} immediately (default: FALSE).}

\item{...}{Additional arguments passed to the provider's deep research function.}
}
\value{
If \code{.background = FALSE}, an \code{LLMMessage} with the research reply.
If \code{.background = TRUE}, a \code{tidyllm_research_job} for use with \code{check_job()}/\code{fetch_job()}.
}
\description{
The \code{deep_research()} function sends a message to a provider's deep research endpoint.
Currently supported: Perplexity (\code{sonar-deep-research} via async API).
}
