You.com connects to a Nagent workspace with an API key. Once it is connected, agents can call 1 You.com action: "You.com Web Search". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against You.com, with input parameters and output schema.
YOUSEARCH_YOU_SEARCHSearch the web using You.com's search API. Returns LLM-ready web results and news articles based on your query. Supports advanced filtering by country, language, freshness, and content safety.
Input parameters
Maximum number of search results to return per section (web/news). Valid range: 1-20.
Search query string. Supports search operators for refined searches.
Pagination offset in multiples of count. For example, if count=10 and offset=1, returns results 10-20. Valid range: 0-9.
Country code for localized results (ISO 3166-1 alpha-2 format).
Language code in BCP 47 format (e.g., EN, FR, DE, ES, ZH-HANS, JA).
Filter results by recency. Options: 'day', 'week', 'month', 'year', or date range in format 'YYYY-MM-DDtoYYYY-MM-DD'.
Content filtering level. Options: 'off', 'moderate', 'strict'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 1 You.com action on Nagent: "You.com Web Search". You.com Web Search: Search the web using You.com's search API. Each action is listed on this page with its input parameters and its output.
You.com connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
You.com Web Search takes 1 required input: query. It also takes 6 optional inputs: count, offset, country, language, freshness and safesearch. It returns data, error and successful.