> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-staging.you.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-staging.you.com/_mcp/server.
# Advanced Agent
POST https://api.you.com/v1/agents/runs
Content-Type: application/json
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.
Reference: https://docs-staging.you.com/docs/custom-solutions/agents/advanced-agent/advanced-agent-runs
## OpenAPI Specification
```yaml
openapi: 3.1.0
info:
title: advanced
version: 1.0.0
paths:
/v1/agents/runs:
post:
operationId: advanced-agent-runs
summary: Advanced Agent
description: >-
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.
tags:
- ''
parameters:
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/type_:AdvancedAgentRunsBatchResponse'
'401':
description: The Authorization Bearer token was missing or invalid
content:
application/json:
schema:
$ref: '#/components/schemas/type_:AgentRuns401Response'
'422':
description: When the request data coming in is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/type_:AgentRuns422Response'
requestBody:
content:
application/json:
schema:
type: object
properties:
agent:
$ref: '#/components/schemas/type_:AdvancedAgentRunsRequestAgent'
description: >-
Setting this value to "advanced" is mandatory to use the
advanced agent.
input:
type: string
description: The question you'd like to ask the agent
stream:
type: boolean
enum:
- false
description: >-
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.
tools:
type: array
items:
$ref: >-
#/components/schemas/type_:AdvancedAgentRunsRequestToolsItem
description: >-
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.
verbosity:
$ref: '#/components/schemas/type_:AdvancedAgentRunsRequestVerbosity'
description: >-
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.
workflow_config:
$ref: >-
#/components/schemas/type_:AdvancedAgentRunsRequestWorkflowConfig
description: >-
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.
required:
- agent
- input
- stream
servers:
- url: https://api.you.com
description: Production
components:
schemas:
type_:AdvancedAgentRunsRequestAgent:
type: string
enum:
- advanced
description: Setting this value to "advanced" is mandatory to use the advanced agent.
title: AdvancedAgentRunsRequestAgent
type_:AdvancedAgentRunsRequestToolsItemResearchSearchEffort:
type: string
enum:
- auto
- low
- medium
- high
description: >-
This parameter maps to different configurations regarding the depth of
research the tool can perform. Its values range from `low`, `medium` to
`high`.
Alternatively, use `auto` mode for a more dynamic search approach,
allowing the tool the freedom to adjust its subparameters.
title: AdvancedAgentRunsRequestToolsItemResearchSearchEffort
type_:AdvancedAgentRunsRequestToolsItemResearchReportVerbosity:
type: string
enum:
- medium
- high
description: Select whether to receive a medium or high length model response.
title: AdvancedAgentRunsRequestToolsItemResearchReportVerbosity
type_:AdvancedAgentRunsRequestToolsItem:
oneOf:
- type: object
properties:
type:
type: string
enum:
- compute
description: 'Discriminator value: compute'
required:
- type
- type: object
properties:
type:
type: string
enum:
- research
description: 'Discriminator value: research'
search_effort:
$ref: >-
#/components/schemas/type_:AdvancedAgentRunsRequestToolsItemResearchSearchEffort
description: >-
This parameter maps to different configurations regarding the
depth of research the tool can perform. Its values range from
`low`, `medium` to `high`.
Alternatively, use `auto` mode for a more dynamic search
approach, allowing the tool the freedom to adjust its
subparameters.
report_verbosity:
$ref: >-
#/components/schemas/type_:AdvancedAgentRunsRequestToolsItemResearchReportVerbosity
description: >-
Select whether to receive a medium or high length model
response.
required:
- type
- search_effort
- report_verbosity
discriminator:
propertyName: type
title: AdvancedAgentRunsRequestToolsItem
type_:AdvancedAgentRunsRequestVerbosity:
type: string
enum:
- medium
- high
description: >-
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.
title: AdvancedAgentRunsRequestVerbosity
type_:AdvancedAgentRunsRequestWorkflowConfig:
type: object
properties:
max_workflow_steps:
type: integer
default: 10
required:
- max_workflow_steps
description: >-
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.
title: AdvancedAgentRunsRequestWorkflowConfig
type_:AdvancedAgentRunsBatchResponseInputItemRole:
type: string
enum:
- user
description: The access based role of the user
title: AdvancedAgentRunsBatchResponseInputItemRole
type_:AdvancedAgentRunsBatchResponseInputItem:
type: object
properties:
role:
$ref: >-
#/components/schemas/type_:AdvancedAgentRunsBatchResponseInputItemRole
description: The access based role of the user
content:
type: string
description: The question populated in the request payload
required:
- role
- content
title: AdvancedAgentRunsBatchResponseInputItem
type_:AdvancedAgentRunsResponseOutputType:
type: string
enum:
- message.answer
- web_search.results
description: >-
The type of output. This can either be:
* `message.answer` for text responses
* `web_search.results` for output that contains web links.
`web_search.results` only appear when you use the `research` tool
title: AdvancedAgentRunsResponseOutputType
type_:AgentRunsResponseWebSearchResultSourceType:
type: string
enum:
- web_search
description: The type of content the agent can return outside a text response
title: AgentRunsResponseWebSearchResultSourceType
type_:AgentRunsResponseWebSearchResult:
type: object
properties:
source_type:
$ref: >-
#/components/schemas/type_:AgentRunsResponseWebSearchResultSourceType
description: The type of content the agent can return outside a text response
citation_uri:
type: string
description: The web search result the agent returned along in its response
provider:
type: string
description: This is currently unused
title:
type: string
description: The title of the web site returned under url
snippet:
type: string
description: A textual portion of the web site returned under url
thumbnail_url:
type: string
description: The thumbnail image of the url
url:
type: string
description: The web search result the agent returned along in its response
required:
- source_type
- citation_uri
- title
- snippet
- url
description: >-
The text response of the agent. This field only returns when the type is
`web_search.results`
title: AgentRunsResponseWebSearchResult
type_:AdvancedAgentRunsResponseOutput:
type: object
properties:
text:
type: string
description: >-
The text response of the agent. This field returns when `type ==
message.answer`. The response returns as markdown formatted text.
For an overview of Markdown syntax, see the [Basic Syntax Markdown
Guide](https://www.markdownguide.org/basic-syntax/)
type:
$ref: '#/components/schemas/type_:AdvancedAgentRunsResponseOutputType'
description: >-
The type of output. This can either be:
* `message.answer` for text responses
* `web_search.results` for output that contains web links.
`web_search.results` only appear when you use the `research` tool
content:
type: array
items:
$ref: '#/components/schemas/type_:AgentRunsResponseWebSearchResult'
description: |-
The text response of the agent.
This field returns when `type == web_search.results`
required:
- type
description: The response populated by the agent.
title: AdvancedAgentRunsResponseOutput
type_:AdvancedAgentRunsBatchResponse:
type: object
properties:
agent:
type: string
description: The id of the agent populated in the request.
input:
type: array
items:
$ref: '#/components/schemas/type_:AdvancedAgentRunsBatchResponseInputItem'
description: The users access role and question you asked the agent
output:
type: array
items:
$ref: '#/components/schemas/type_:AdvancedAgentRunsResponseOutput'
description: The agent's response items
required:
- agent
- input
- output
description: The id of the agent populated in the request.
title: AdvancedAgentRunsBatchResponse
type_:AgentRuns401Response:
type: object
properties:
detail:
type: string
description: The message returned by the error
title: AgentRuns401Response
type_:AgentRuns422ResponseDetailItemLocItem:
oneOf:
- type: string
- type: integer
title: AgentRuns422ResponseDetailItemLocItem
type_:AgentRuns422ResponseDetailItem:
type: object
properties:
type:
type: string
loc:
type: array
items:
$ref: '#/components/schemas/type_:AgentRuns422ResponseDetailItemLocItem'
msg:
type: string
input:
type: string
required:
- type
- loc
- msg
- input
title: AgentRuns422ResponseDetailItem
type_:AgentRuns422Response:
type: object
properties:
detail:
type: array
items:
$ref: '#/components/schemas/type_:AgentRuns422ResponseDetailItem'
title: AgentRuns422Response
securitySchemes:
bearerAuth:
type: http
scheme: bearer
```
## Examples
**Request**
```json
{
"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
}
```
**Response**
```json
{
"agent": "advanced",
"input": [
{
"role": "user",
"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"
}
],
"output": [
{
"type": "web_search.results",
"content": [
{
"source_type": "web_search",
"citation_uri": "https://www.sciencedirect.com/science/article/abs/pii/S0301479725018912",
"title": "Microplastics as an emerging threat to human health: An overview of potential health impacts - ScienceDirect",
"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...",
"url": "https://www.sciencedirect.com/science/article/abs/pii/S0301479725018912#:~:text=To%20provide%20a%20clear,health%2C%20and%20their%20underlying",
"provider": null,
"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"
},
{
"source_type": "web_search",
"citation_uri": "https://www.nature.com/articles/s41370-023-00634-x#:~:text=To%20fully%20understand%20the,in%20air%2C%20health%20impacts/effects",
"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",
"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",
"url": "https://www.nature.com/articles/s41370-023-00634-x#:~:text=To%20fully%20understand%20the,in%20air%2C%20health%20impacts/effects",
"provider": null,
"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"
},
{
"source_type": "web_search",
"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",
"title": "Frontiers | A review of microplastic pollution and human health risk assessment: current knowledge and future outlook",
"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",
"url": "https://www.frontiersin.org/journals/environmental-science/articles/10.3389/fenvs.2025.1606332/full#:~:text=Adverse%20health%20effects%20linked,systematic%20review%20of%20the",
"provider": "null,",
"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"
},
{
"source_type": "web_search",
"citation_uri": "https://www.ncbi.nlm.nih.gov/pmc/articles/PMC10902512/#:~:text=However%2C%20available%20evidence%20from,is%20needed%20to%20provide",
"title": "A systematic review of the impacts of exposure to micro- and nano-plastics on human tissue accumulation and health - PMC",
"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",
"url": "https://www.ncbi.nlm.nih.gov/pmc/articles/PMC10902512/#:~:text=However%2C%20available%20evidence%20from,is%20needed%20to%20provide",
"provider": "null,",
"thumbnail_url": "https://imgs.you.com/SjK8crmwMZfjntZZIyw-TTlcRNgju1jCxJbwmyjJT_k/rs:fit:200:200:1:0/g:ce/aHR0cHM6Ly93d3cu/bmNiaS5ubG0ubmlo/Lmdvdi9jb3JlaHRt/bC9wbWMvcG1jZ2lm/cy9wbWMtY2FyZC1z/aGFyZS5qcGc_Xz0w"
},
{
"source_type": "web_search",
"citation_uri": "https://pmc.ncbi.nlm.nih.gov/articles/PMC12197308/#:~:text=Since%202014%2C%20research%20on,limited%20ingestion%20of%20PS%E2%80%94since",
"title": "Risk Assessment of Microplastics in Humans: Distribution, Exposure, and Toxicological Effects - PMC",
"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",
"url": "https://pmc.ncbi.nlm.nih.gov/articles/PMC12197308/#:~:text=Since%202014%2C%20research%20on,limited%20ingestion%20of%20PS%E2%80%94since",
"provider": "null,",
"thumbnail_url": ""
},
{
"source_type": "web_search",
"citation_uri": "https://www.sciencedirect.com/science/article/pii/S004896972205210X#:~:text=This%20systematic%20review%20aims,lack%20of%20comparability%20between",
"title": "A review of potential human health impacts of micro- and nanoplastics exposure - ScienceDirect",
"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.",
"url": "https://www.sciencedirect.com/science/article/pii/S004896972205210X#:~:text=This%20systematic%20review%20aims,lack%20of%20comparability%20between",
"provider": "null,",
"thumbnail_url": "https://imgs.you.com/76W2dRcLAIlejPQmV5mh-z6WwZxbfp2HS7qcH7JtndE/rs:fit:200:200:1:0/g:ce/aHR0cHM6Ly9hcnMu/ZWxzLWNkbi5jb20v/Y29udGVudC9pbWFn/ZS8xLXMyLjAtUzAw/NDg5Njk3MjIwNTIx/MFgtZ2ExLmpwZw"
},
{
"source_type": "web_search",
"citation_uri": "https://pmc.ncbi.nlm.nih.gov/articles/PMC11504192/#:~:text=Experiments%20show%20that%20the,identification%2C%20toxicity%2C%20and%20health",
"title": "Potential Health Impact of Microplastics: A Review of Environmental Distribution, Human Exposure, and Toxic Effects - PMC",
"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",
"url": "https://pmc.ncbi.nlm.nih.gov/articles/PMC11504192/#:~:text=Experiments%20show%20that%20the,identification%2C%20toxicity%2C%20and%20health",
"provider": "null,",
"thumbnail_url": ""
}
]
},
{
"type": "message.answer",
"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."
}
]
}
```
**SDK Code**
```python
# Use our official Python SDK to get an agent response
from youdotcom import You
from youdotcom.models import AdvancedAgentRunsRequest, AgentRunsBatchResponse
with You("api_key") as you:
response = you.agents.runs.create(
request=AdvancedAgentRunsRequest(
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
)
)
if isinstance(response, AgentRunsBatchResponse) and response.output:
for output in response.output:
if output.text:
print(output.text)
```
```typescript
// Use our official TypeScript SDK to get an agent response
import { You } from "@youdotcom-oss/sdk";
import type { AdvancedAgentRunsRequest } from "@youdotcom-oss/sdk/models";
const you = new You({ apiKeyAuth: "api_key" });
const request: AdvancedAgentRunsRequest = {
agent: "advanced",
stream: false,
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",
tools: [{
type: "research",
searchEffort: "low",
reportVerbosity: "medium",
}]
};
const result = await you.agentsRuns(request);
console.log(result);
```
```javascript
// Use our official JavaScript SDK to get an agent response
import { You } from "@youdotcom-oss/sdk";
const you = new You({ apiKeyAuth: "api_key" });
const request = {
agent: "advanced",
stream: false,
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",
tools: [{
type: "research",
searchEffort: "low",
reportVerbosity: "medium",
}]
};
const result = await you.agentsRuns(request);
console.log(result);
```
```go
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.you.com/v1/agents/runs"
payload := strings.NewReader("{\n \"agent\": \"advanced\",\n \"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\",\n \"stream\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer ")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
```
```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;
HttpResponse response = Unirest.post("https://api.you.com/v1/agents/runs")
.header("Authorization", "Bearer ")
.header("Content-Type", "application/json")
.body("{\n \"agent\": \"advanced\",\n \"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\",\n \"stream\": false\n}")
.asString();
```
```csharp
using RestSharp;
var client = new RestClient("https://api.you.com/v1/agents/runs");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer ");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n \"agent\": \"advanced\",\n \"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\",\n \"stream\": false\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```
```swift
import Foundation
let headers = [
"Authorization": "Bearer ",
"Content-Type": "application/json"
]
let parameters = [
"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
] as [String : Any]
let postData = JSONSerialization.data(withJSONObject: parameters, options: [])
let request = NSMutableURLRequest(url: NSURL(string: "https://api.you.com/v1/agents/runs")! as URL,
cachePolicy: .useProtocolCachePolicy,
timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data
let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error as Any)
} else {
let httpResponse = response as? HTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()
```