Agents Overview

What Are You.com Agents?

You.com Agents are AI-powered assistants that combine real-time web search, reasoning capabilities, and specialized tools to provide comprehensive answers to complex queries. Unlike simple search APIs that return raw results, Agents synthesize information, cite sources, and can deliver structured responses tailored to your needs.

Agents turn search results into actionable answers. We offer 3 kinds: Express for fast responses, Advanced for in-depth research and Custom for domain-specific workflows.

Agent Types

Express Agent

Purpose: Fast, reliable answers with citations optimized for speed and efficiency.

The Express Agent is designed to balance speed and depth. It searches the web, processes results, and delivers a concise answer with relevant citations—typically within 2-3 seconds.

When to use:

• Chatbots requiring quick responses
• FAQ answering systems
• Real-time information lookup
• Applications where latency matters

Example use case: A customer support bot that answers “What are your business hours?” by searching your website and returning a formatted answer with a link to your hours page.

Learn more: Express Agent API

1
from youdotcom import You
2
from youdotcom.types.typesafe_models import (
3
    AgentType,
4
    stream_text_tokens
5
)
6
7
with You(
8
    api_key_auth="Your You.com API Key",
9
) as you:
10
    res = you.agents.runs.create(
11
        agent=AgentType.EXPRESS,
12
        input="Teach me how to make an omelet",
13
        stream=True,
14
    )
15
16
    # A built-in helper to handle streamed responses
17
    stream_text_tokens(res)

Advanced Agent

Purpose: Deep research with extensive citations and comprehensive analysis.

The Advanced Agent is built for thorough investigations. It uses multiple tools—web search, research capabilities, and compute functions—to gather information, synthesize findings, and produce detailed reports with extensive citations.

When to use:

• Market research reports
• Competitive analysis
• Academic research assistance
• Complex technical explanations
• Multi-step reasoning tasks

Example use case: A research platform that generates comprehensive reports on emerging technologies, complete with data analysis, trend identification, and cited sources.

Available tools:

• Research Tool: Deep investigation with source analysis
• Compute Tool: Data processing and calculations

Learn more: Advanced Agent API

1
from youdotcom import You
2
from youdotcom.models import ComputeTool, ResearchTool
3
from youdotcom.types.typesafe_models import (
4
    AgentType,
5
    SearchEffort,
6
    Verbosity,
7
    stream_text_tokens,
8
)
9
10
with You(
11
    api_key_auth="Your You.com API Key",
12
) as you:
13
    res = you.agents.runs.create(
14
            agent=AgentType.ADVANCED,
15
            input="Analyze the impact of microplastics on marine ecosystems.",
16
            stream=True,
17
            tools=[
18
                ResearchTool(
19
                    search_effort=SearchEffort.HIGH,
20
                    report_verbosity=Verbosity.HIGH,
21
                ),
22
            ]
23
    )
24
25
    # A built-in helper to handle streamed responses
26
    stream_text_tokens(res)

Custom Agent

Purpose: Personalized AI agents with custom instructions and tailored capabilities.

Custom Agents let you define your own system instructions, choose which tools to enable, and configure behavior for specific domains or workflows. Create specialized assistants for legal research, medical information, code review, or any domain where you need consistent, customized responses.

When to use:

• Domain-specific applications (legal, medical, financial)
• Branded AI assistants with specific tone/style
• Workflows requiring consistent instructions
• Applications needing tool control (enable/disable search, research, compute)

Example use case: A legal research assistant that searches case law, follows specific citation formats, and applies jurisdictional constraints based on your custom instructions.

Customization options:

• Custom Instructions: Define personality, expertise, output format
• Model Choice: Select underlying LLM (subject to availability)
• Response Style: Control verbosity, tone, and formatting

Learn more: Custom Agent API

1
from youdotcom import You
2
from youdotcom.types.typesafe_models import stream_text_tokens
3
4
# Initialize the SDK with your API key
5
with You(api_key_auth="your-api-key-here") as you:
6
    # Create a custom agent run and stream the response
7
    res = you.agents.runs.create(
8
        # This is a custom agent we've created for you to try
9
        # Replace it with your own
10
        agent="63773261-b4de-4d8f-9dfd-cff206a5cb51",
11
        input="Teach me how to make an omelet",
12
        stream=True,
13
    )
14
15
    # A built-in helper to handle streamed responses
16
    stream_text_tokens(res)

Common features across all Agents

Streaming responses

All agents support streaming via Server-Sent Events (SSE), allowing you to process responses incrementally as they’re generated. This provides a better user experience with real-time feedback.

Stream event types:

• response.created - Agent started processing
• response.starting - Response generation beginning
• response.output_item.added - New output item created
• response.output_text.delta - Text chunk available
• response.output_item.done - Output item complete
• response.done - Full response complete

Citations & Sources

All agents provide citations with their responses, including:

• Source URLs
• Page titles
• Relevant snippets
• Favicon URLs
• Page age/freshness

Error Handling

Agents return standard HTTP error codes and structured error responses. See Error Reference for details.

Choosing the Right Agent

Pricing & Rate limits

Agent pricing varies by type and usage. Express agents are optimized for cost-efficiency, while Advanced agents consume more resources due to their comprehensive research capabilities. Custom agents fall in between.

For detailed pricing information and rate limits, visit you.com/pricing or contact [email protected].

Next Steps