Exa Deep Search

Exa Deep Search

Turn Exa search into a focused, source-backed research brief. This Skill calls the named Exa capabilities in [the SandBase API map](references/sandbase-api-map.md) through the SandBase MCP gateway. In a SandBase Agent, run the capabilities directly. In another compatible agent, require an authorized SandBase connection before starting; never request, print, or store an API key in the research output.

Read [example workflows](references/example-workflows.md) when the user needs a starting prompt or wants to understand the output.

Operating principles

• Start from the user's research question and decision context, not a generic search.
• Treat Exa results as evidence; treat model-generated synthesis, comparisons, and recommendations as judgment clearly separated from sources.
• Select search depth, time window, domains, and geography deliberately. State any assumption rather than silently defaulting.
• Optimize for source quality, recency, and relevance — not quantity.
• Cite every externally verifiable claim with a result URL and publication date (when available).
• Keep user research goals, company context, and strategy confidential unless sharing is explicitly requested.

Workflow

1. Frame the research question

Collect or infer: the topic or entity, time window, geography, trusted or excluded domains, audience for the deliverable, and how findings will be used. Classify the request as one or more of: landscape scan, deep evidence gathering, competitive intelligence, current news monitoring, or specific-source extraction.

When the research question is broad, propose 2–3 focused sub-queries and confirm scope before spending API calls.

2. Select and call SandBase capabilities

Read [the SandBase API map](references/sandbase-api-map.md) before selecting tools. Use the listed tool_name through the SandBase gateway:

1. Call sandbase_describe_tool for the selected tool_name and read its current input schema.
2. Call sandbase_call_tool with that exact tool_name and only schema-defined arguments.
3. Keep the tool name, query, search parameters, and result metadata with the returned data.

3. Search with Exa

Use exa_search with parameters matched to the research need:

| Research need | Recommended parameters | |---|---| | Current landscape | topic: "news", bounded start_published_date/end_published_date, include_highlights: true | | Deep evidence | search_depth: "advanced", include_summary: true, request full text only for selected sources | | Trusted sources only | include_domains for first-party, academic, or approved publishers | | Competitive research | exclude_domains for the target's own site; separate queries per competitor | | Validation or quick check | search_depth: "basic", num_results: 3–5 |

Tips:

• Write queries as natural-language statements of what a good result page would say, not short keyword strings. Exa responds best to semantic queries.
• Use category when available (e.g., "research paper", "company", "news") to narrow result types.
• Iterate: refine by entity, product, problem, event, or time period until evidence is sufficient.
• Request include_highlights: true to get relevant snippets without extracting full text for every result.

4. Extract selected sources

When deeper analysis of specific pages is needed, send selected URLs to exa_contents:

• Choose include_text: true for full page content when analyzing structure or extracting data.
• Choose include_highlights: true with a highlights_query to focus extraction on specific aspects.
• Choose include_summary: true for concise overviews when reviewing many pages.
• Use subpages only for explicit documentation, pricing, or API crawl tasks.
• Use max_age_hours: 0 only when freshness requires a live crawl; avoid for routine research.

If exa_contents is not yet available in the current Gateway, return the Search results and explicitly state that extraction is awaiting capability publication.

5. Synthesize findings

• Separate direct observations from interpretation.
• Group findings by theme, entity, or chronology as appropriate for the research question.
• Note disagreements between sources and evidence gaps.
• Propose follow-up queries for unresolved questions.

Query crafting tips

Good Exa queries describe the content of the ideal result page:

| Poor query | Better query | |---|---| | AI agents | How enterprises evaluate AI agent platforms for production deployment | | observability tools | Comparison of AI agent observability and tracing solutions 2025 | | competitor pricing | Pricing page for enterprise AI agent orchestration platform |

• Add temporal context: "in 2025", "since January", "latest announcement".
• Add specificity: mention the industry, company size, technology stack, or use case.
• Use exclude_domains to avoid results you already know about.

Output

Return a structured research brief:

Source map

| # | Title | URL | Published | Relevance | |---|---|---|---|---| | 1 | ... | ... | ... | ... |

Key findings

Numbered findings, each citing source(s) by number.

Disagreements and evidence gaps

What sources disagree on, and what questions remain unanswered.

Suggested next queries

Follow-up Exa queries or alternative research paths.

Evidence rules

• Cite a result URL for every externally verifiable claim.
• Label a result's publication date as "unavailable" when Exa does not return one.
• Do not treat an Exa summary as a source quote; use it as an aid to select evidence, then cite the original URL.
• Do not call Exa Answer or Exa Agent endpoints. The user's Agent/LLM synthesizes the evidence.
• Do not copy long source passages; paraphrase and cite.
• Mark clearly when a finding is inferred from multiple sources vs. directly stated in one.

Failure handling

• If SandBase is unavailable or unauthorized, report the failed capability and ask the user to connect or authorize SandBase; do not silently substitute a direct provider API.
• If exa_search returns few or no results, try: broader query, different search_depth, removed domain filters, or a wider date range. Report if the topic genuinely lacks public coverage.
• If exa_contents is unavailable, deliver search results with highlights and explicitly note the extraction gap.
• If results are low-quality or off-topic, refine the query before reporting; explain what was tried.

Example tasks

• "Find the last 30 days of reliable sources about AI agent observability. Give me a five-source brief with gaps."
• "Research how enterprise teams evaluate AI agents. Prefer company and academic sources; exclude vendor blogs."
• "Compare the public arguments for and against a retrieval architecture. Use advanced search and cite each source."
• "Find recent funding announcements in the AI developer tools space. Only include sources from the last 7 days."
• "Extract the pricing and feature comparison from these three competitor pages: [URLs]."

Quality gate

Before delivering, verify that:

• Every finding cites at least one source URL.
• Observations are separated from model-generated interpretations.
• The search parameters (depth, dates, domains) match the stated research need.
• Evidence gaps and low-confidence findings are explicitly labeled.
• The deliverable format matches what the user requested.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: sandbaseai
• Source: sandbaseai/sandbase-skills
• License: Apache-2.0
• Homepage: https://skills.sh/sandbaseai/sandbase-skills/multi-source-search

Install and usage instructions live in the source repository linked above.