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": false
>}'
1{
2  "agent": "advanced",
3  "input": [
4    {
5      "role": "user",
6      "content": "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"
7    }
8  ],
9  "output": [
10    {
11      "type": "web_search.results",
12      "content": [
13        {
14          "source_type": "web_search",
15          "citation_uri": "https://www.sciencedirect.com/science/article/abs/pii/S0301479725018912",
16          "title": "Microplastics as an emerging threat to human health: An overview of potential health impacts - ScienceDirect",
17          "snippet": "To provide a clear and transparent foundation for this review, we conducted a systematic search and analysis of the relevant scientific literature searched from multiple databases, including Web of Science, PubMed, ScienceDirect, China...",
18          "url": "https://www.sciencedirect.com/science/article/abs/pii/S0301479725018912#:~:text=To%20provide%20a%20clear,health%2C%20and%20their%20underlying",
19          "provider": null,
20          "thumbnail_url": "https://imgs.you.com/-ZIpMRKJqV3PF_i-oob-q-p7b_TXVimtAjVYV_Kfa40/rs:fit:200:200:1:0/g:ce/aHR0cHM6Ly9hcnMu/ZWxzLWNkbi5jb20v/Y29udGVudC9pbWFn/ZS8xLXMyLjAtUzAz/MDE0Nzk3MjVYMDAx/M1gtY292MTUwaC5n/aWY.jpeg"
21        },
22        {
23          "source_type": "web_search",
24          "citation_uri": "https://www.nature.com/articles/s41370-023-00634-x#:~:text=To%20fully%20understand%20the,in%20air%2C%20health%20impacts/effects",
25          "title": "Systematic review of microplastics and nanoplastics in indoor and outdoor air: identifying a framework and data needs for quantifying human inhalation exposures | Journal of Exposure Science & Environmental Epidemiology",
26          "snippet": "To fully understand the possible impacts of MPs on human health, it is necessary to quantify MP exposure and identify what critical data gaps exist. The current paper provides a human exposure assessment of microplastics in the air using systematically reviewed literature that provided concentration of MPs in air as well as doses used in toxicology studies to calculate inhalation exposure dose.\nHumans are likely exposed to microplastics (MPs) in a variety of places including indoor and outdoor air. Research to better understand how exposure to MPs correlates to health is growing. To fully understand the possible impacts of MPs on human health, it is necessary to quantify MP exposure and identify what critical data gaps exist.\nTo fully understand the possible impacts of MPs on human health, it is necessary to quantify MP exposure and identify what critical data gaps exist. The current paper provides a human exposure assessment of microplastics in the air using systematically reviewed literature that provided concentration of MPs in air as well as doses used in toxicology studies to calculate inhalation exposure dose.\nThe initial inclusion criteria for abstract screening were literature that included information about MPs in outdoor or indoor air (from now on referred to as *air*), human exposure to MPs in air, pathways of human exposure to MPs in air, health impacts/effects fr",
27          "url": "https://www.nature.com/articles/s41370-023-00634-x#:~:text=To%20fully%20understand%20the,in%20air%2C%20health%20impacts/effects",
28          "provider": null,
29          "thumbnail_url": "https://imgs.you.com/WcAkItsaQb3_BlMRzhL2LzEztqAgazk7mhI8KVQIt3Q/rs:fit:200:200:1:0/g:ce/aHR0cHM6Ly9tZWRp/YS5zcHJpbmdlcm5h/dHVyZS5jb20vbTY4/NS9zcHJpbmdlci1z/dGF0aWMvaW1hZ2Uv/YXJ0JTNBMTAuMTAz/OCUyRnM0MTM3MC0w/MjMtMDA2MzQteC9N/ZWRpYU9iamVjdHMv/NDEzNzBfMjAyM182/MzRfRmlnMV9IVE1M/LnBuZw"
30        },
31        {
32          "source_type": "web_search",
33          "citation_uri": "https://www.frontiersin.org/journals/environmental-science/articles/10.3389/fenvs.2025.1606332/full#:~:text=Adverse%20health%20effects%20linked,systematic%20review%20of%20the",
34          "title": "Frontiers | A review of microplastic pollution and human health risk assessment: current knowledge and future outlook",
35          "snippet": "The Global Average Rate of Microplastic Ingestion (GARMI) is increasingly referenced to support risk assessment efforts related to MP pollution (Senathirajah et al., 2021). Therefore, this review consolidates current knowledge on microplastic (MP) concentrations in aquatic environments, their pathways of exposure, including ingestion, inhalation, and dermal contact, and the mechanisms underlying their toxicity.\nDeveloping standardized methods for characterizing, analyzing, quantifying, and assessing potential human health risks from microplastic pollution. • The implications of microplastic exposure on human health are profound, necessitating urgent attention from researchers, policymakers, and healthcare providers to develop strategies for mitigation and prevention. Understanding the mechanisms of toxicity is crucial for establishing effective public health guidelines and protective measures against this pervasive environmental issue.\nSocio-economic status also affects dietary habits and access to safe food and water, with disadvantaged populations more likely to consume contaminated sources and have less awareness of MP risks (Prata et al., 2020). These factors underscore the need for context-specific exposure assessments and interventions. There are several critical concerns raised by microplastics in aquatic ecosystems including envirnmental health effects, bioaccumulation, ecological eff",
36          "url": "https://www.frontiersin.org/journals/environmental-science/articles/10.3389/fenvs.2025.1606332/full#:~:text=Adverse%20health%20effects%20linked,systematic%20review%20of%20the",
37          "provider": "null,",
38          "thumbnail_url": "https://imgs.you.com/vYsfI0InMCDjPJYRqSj0n8SapkmYY5HSSmD2nE4ooYw/rs:fit:200:200:1:0/g:ce/aHR0cHM6Ly9pbWFn/ZXMtcHJvdmlkZXIu/ZnJvbnRpZXJzaW4u/b3JnL2FwaS9pcHgv/dz0xMjAwJmY9cG5n/L2h0dHBzOi8vd3d3/LmZyb250aWVyc2lu/Lm9yZy9maWxlcy9B/cnRpY2xlcy8xNjA2/MzMyL2ZlbnZzLTEz/LTE2MDYzMzItSFRN/TC1yMS9pbWFnZV9t/L2ZlbnZzLTEzLTE2/MDYzMzItZzAwMS5q/cGc"
39        },
40        {
41          "source_type": "web_search",
42          "citation_uri": "https://www.ncbi.nlm.nih.gov/pmc/articles/PMC10902512/#:~:text=However%2C%20available%20evidence%20from,is%20needed%20to%20provide",
43          "title": "A systematic review of the impacts of exposure to micro- and nano-plastics on human tissue accumulation and health - PMC",
44          "snippet": "However, available evidence from in vitro studies using human cells and in vivo studies using animal models, such as mice and rats, indicates that exposure to MNPs may induce inflammation, oxidative stress, cytotoxicity, and respiratory disease ...\nHowever, available evidence from in vitro studies using human cells and in vivo studies using animal models, such as mice and rats, indicates that exposure to MNPs may induce inflammation, oxidative stress, cytotoxicity, and respiratory disease [24,25]. Moreover, it is important to note that MNPs not only contain a range of plastic additives, including dyes, plasticizers, and antioxidants but also serve as carriers of persistent organic chemicals, heavy metals, and pathogenic microorganisms, all of which can be toxic and have potential carcinogenic and mutagenic effects on human health [20,26]\nMicro- and nano-plastics (MNPs) pollution has become a pressing global environmental issue, with growing concerns regarding its impact on human health. However, evidence on the effects of MNPs on human health remains limited. This paper reviews the three ...\nHowever, direct evidence for the effects of MNPs on human health is still scarce, and future research in this area is needed to provide quan",
45          "url": "https://www.ncbi.nlm.nih.gov/pmc/articles/PMC10902512/#:~:text=However%2C%20available%20evidence%20from,is%20needed%20to%20provide",
46          "provider": "null,",
47          "thumbnail_url": "https://imgs.you.com/SjK8crmwMZfjntZZIyw-TTlcRNgju1jCxJbwmyjJT_k/rs:fit:200:200:1:0/g:ce/aHR0cHM6Ly93d3cu/bmNiaS5ubG0ubmlo/Lmdvdi9jb3JlaHRt/bC9wbWMvcG1jZ2lm/cy9wbWMtY2FyZC1z/aGFyZS5qcGc_Xz0w"
48        },
49        {
50          "source_type": "web_search",
51          "citation_uri": "https://pmc.ncbi.nlm.nih.gov/articles/PMC12197308/#:~:text=Since%202014%2C%20research%20on,limited%20ingestion%20of%20PS%E2%80%94since",
52          "title": "Risk Assessment of Microplastics in Humans: Distribution, Exposure, and Toxicological Effects - PMC",
53          "snippet": "Public health policies should prioritize minimizing detachable plastics in medical devices and food packaging, promote the application and validation of biodegradable polymers (e.g., PLA), and strengthen educational campaigns to curb everyday exposure. However, the ecological safety of biodegradable plastics must be comprehensively evaluated, since their degradation products can form microplastics with toxicity profiles comparable to those of conventional polymers. Moreover, health risk assessments of microplastics should evolve from single-polymer examinations to mixed-exposure scenarios, with attention directed to synergistic interactions involving per- and polyfluoroalkyl substances (PFOS, PFOA), endocrine-disrupting chemicals (EDCs), pharmaceuticals and personal care products (PPCPs), carcinogenic polycyclic aromatic hydrocarbons (PAHs), and brominated flame retardants.\nModule 4 (red cluster)—the group most closely connected to “microplastics/nanoplastics”—indicates that these “emerging pollutants/contaminants” threaten “human health (risk)” through “human exposure.” This exposure pathway involves “drinking water” and the “food chain,” resulting in “trophic transfer” and “bioaccumulation.” Overall, although human-related microplastic research spans topics such as sources, distribution, and morphology, its principal focus remains the assessment and elucidation of risks to human health and safety.\nPublic health policies should prioritize minimizing detachable plastics in medical devices and food packaging, promote the application and validation of biodegradable polymers (e.g., PLA), and strengthen educational campaigns to curb everyday exposure. However, the ecological safety of biodegradable plastics must be comprehensively evaluated, since their degradation products can form microplastics with toxicity profiles comparable to those of conventional poly",
54          "url": "https://pmc.ncbi.nlm.nih.gov/articles/PMC12197308/#:~:text=Since%202014%2C%20research%20on,limited%20ingestion%20of%20PS%E2%80%94since",
55          "provider": "null,",
56          "thumbnail_url": ""
57        },
58        {
59          "source_type": "web_search",
60          "citation_uri": "https://www.sciencedirect.com/science/article/pii/S004896972205210X#:~:text=This%20systematic%20review%20aims,lack%20of%20comparability%20between",
61          "title": "A review of potential human health impacts of micro- and nanoplastics exposure - ScienceDirect",
62          "snippet": "This systematic review aims to summarize the current knowledge on biological effects of micro- and nanoplastics (MNPs) on human health based on mammal…\nPotential human health impact of MNPs is reviewed and summarized from 133 articles. ... Most studies (105 articles) used PS spheres for research due to the availability. ... Limitations that hinder reaching firm conclusions are highlighted. This systematic review aims to summarize the current knowledge on biological effects of micro- and nanoplastics (MNPs) on human health based on mammalian systems.\nIn contrast, the remaining 16 studies indicated an insignificant impact of MNPs on humans. A few studies attempted to investigate the mechanisms or factors driving the toxicity of MNPs and identified several determining factors including size, concentration, shape, surface charge, attached pollutants and weathering process, which, however, were not benchmarked or considered by most studies. This review demonstrates that there are still many inconsistencies in the evaluation of the potential health effects of MNPs due to the lack of comparability between studies.",
63          "url": "https://www.sciencedirect.com/science/article/pii/S004896972205210X#:~:text=This%20systematic%20review%20aims,lack%20of%20comparability%20between",
64          "provider": "null,",
65          "thumbnail_url": "https://imgs.you.com/76W2dRcLAIlejPQmV5mh-z6WwZxbfp2HS7qcH7JtndE/rs:fit:200:200:1:0/g:ce/aHR0cHM6Ly9hcnMu/ZWxzLWNkbi5jb20v/Y29udGVudC9pbWFn/ZS8xLXMyLjAtUzAw/NDg5Njk3MjIwNTIx/MFgtZ2ExLmpwZw"
66        },
67        {
68          "source_type": "web_search",
69          "citation_uri": "https://pmc.ncbi.nlm.nih.gov/articles/PMC11504192/#:~:text=Experiments%20show%20that%20the,identification%2C%20toxicity%2C%20and%20health",
70          "title": "Potential Health Impact of Microplastics: A Review of Environmental Distribution, Human Exposure, and Toxic Effects - PMC",
71          "snippet": "Experiments show that the exposure to microplastics induces a variety of toxic effects, including oxidative stress, metabolic disorder, immune response, neurotoxicity, as well as reproductive and developmental toxicity.17 However, limited by the existing technical methods, there is no systematic ...\nExperiments show that the exposure to microplastics induces a variety of toxic effects, including oxidative stress, metabolic disorder, immune response, neurotoxicity, as well as reproductive and developmental toxicity.17 However, limited by the existing technical methods, there is no systematic research on the absorption, metabolism, migration, transformation, and accumulation of microplastics. The knowledge gap also exists in potential toxic effects and health hazards, e.g., the key factors determining the toxic effects of microplastics. This review briefly summarizes the pathways of human exposure to microplastics and the detection of microplastics in organisms and human bodies and focuses on the current research progress of the toxicity of microplastics.\nMicroplastics are ubiquitous in the global environment. As a typical emerging pollutant, its potential health hazards have been widely concerning. In this brief paper, we introduce the source, identification, toxicity, and health h",
72          "url": "https://pmc.ncbi.nlm.nih.gov/articles/PMC11504192/#:~:text=Experiments%20show%20that%20the,identification%2C%20toxicity%2C%20and%20health",
73          "provider": "null,",
74          "thumbnail_url": ""
75        }
76      ]
77    },
78    {
79      "type": "message.answer",
80      "text": "## Microplastics: Technical Overview, Health Impacts, Exposure, and Safety Strategies\n\n> **Key Findings:**  \n> - **Microplastics** are synthetic polymer particles 1 µm–5 mm in size, found in water, food, air, and consumer products.  \n> - **Human exposure** is widespread, with ingestion and inhalation as primary pathways."
81    }
82  ]
83}
This endpoint engages advanced agents that use tools, multi-turn reasoning, and planning to solve complex queries. The agents break down each query into a workflow, execute the steps iteratively, and reflect on the findings before generating a final response. Use it for answering complex questions that require in depth responses. The data returns as a JSON payload with a `application/json` content type. <Info>The call only returns when the agent has finished fully responding to the input question.</Info>
Was this page helpful?
Built with

This endpoint engages advanced agents that use tools, multi-turn reasoning, and planning to solve complex queries. The agents break down each query into a workflow, execute the steps iteratively, and reflect on the findings before generating a final response.

Use it for answering complex questions that require in depth responses.

The data returns as a JSON payload with a application/json content type.

The call only returns when the agent has finished fully responding to the input question.

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
streamfalseRequired

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

agentstring
The id of the agent populated in the request.
inputlist of objects
The users access role and question you asked the agent
outputlist of objects
The agent's response items

Errors

401
Advanced Agent Runs Request Unauthorized Error
422
Advanced Agent Runs 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.