For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Go to Platform
HomeSDKs & toolsAPI referencePricing
  • API reference
      • GETSearch
      • POSTSearch
      • POSTContents
      • POSTResearch
      • POSTFinance Research
  • Error handling
    • Error code reference
        • GETLive News
        • GETImages
          • STREAMExpress Agent
          • STREAMCustom Agent
          • STREAMAdvanced Agent
LogoLogo
HomeSDKs & toolsAPI referencePricing
LogoLogo
Go to Platform
Custom solutionsAgents

Advanced Agent

Beta
|View as Markdown|Open in Claude|
POST
https://api.you.com/v1/agents/runs
POST
/v1/agents/runs
$curl -X POST https://api.you.com/v1/agents/runs \
> -H "Authorization: Bearer <token>" \
> -H "Content-Type: application/json" \
> -d '{
> "agent": "advanced",
> "input": "You are a biologist studying the impacts of microplastics. Explain what microplastics are to a group of engineers, explain the impacts of microplastics on the body, and what the common sources and dosages of microplastics are. Highlight what a safe dosage might be and how to achieve it",
> "stream": true
>}'

This endpoint answers the user’s query with an LLM. Optionally, you can ground the answer using web results (max 1 web search).

Use it for answering simple questions that require a low latency response.

The data returns as SSE (Server-Side Events) with the text/event-stream content type in the response header. It streams data in while the agent is responding.

Was this page helpful?
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
agentenumRequired
Setting this value to "advanced" is mandatory to use the advanced agent.
Allowed values:
inputstringRequired
The question you'd like to ask the agent
streamtrueRequired

Must be set to true when you want to stream the agent response as its being generated, and false when you want the response to return after the agent has finished.

toolslist of objectsOptional
The advanced agent accepts either `compute` or `research` tools <Note> Compute allows your agent to use a Python code interpreter for tasks such as data analysis, mathematical calculations, and plot generation.<br><br> Research iteratively searches the web, analyzes the results, and stops when finished. It then provides a comprehensive report to your agent with current, cited information.</Note>
verbosityenumOptional

Controls the level of detail provided by the agent’s response. Choosing high maps to a long-form report while medium maps to a medium verbosity report that captures most details but is less comprehensive.

Allowed values:
workflow_configobjectOptional

Defines the maximum number of steps the agent uses in its workflow plan to answer your query. Higher values allow for more tool calls, but it takes longer for the agent to provide the response. For instance, setting max_workflow_steps=5 could allow the agent to call the research tool 3 times and the compute tool 2 times.

Response

response.createdobject
SSE event signifying the response stream has been created
OR
response.startingobject
SSE event signifying the response is starting
OR
response.output_item.addedobject
SSE event signifying an output item has been added
OR
response.output_content.fullobject
OR
response.output_item.doneobject
OR
response.output_text.deltaobject
OR
response.doneobject

Errors

401
Advanced Agent Runs Stream Request Unauthorized Error
422
Advanced Agent Runs Stream Request Unprocessable Entity Error

The advanced agent accepts either compute or research tools

Compute allows your agent to use a Python code interpreter for tasks such as data analysis, mathematical calculations, and plot generation.

Research iteratively searches the web, analyzes the results, and stops when finished. It then provides a comprehensive report to your agent with current, cited information.