Research Parameters
Fine-tune Caesar’s research process for optimal results
Fine-tune Caesar’s research process for optimal results
Caesar’s research API provides several parameters to control the depth, speed, and nature of your research queries. Understanding these parameters helps you balance thoroughness, response time, and cost.
New to Caesar? Start with auto: true to let the system intelligently configure parameters based on your query.
Specifies one or more file collections to include in the research. When provided, the research pipeline will search across all files within the specified collections, enabling RAG-style queries over your uploaded documents.
Use when:
Example: Research across all quarterly reports in your “Financial Reports” collection
Use when:
Example: Analyze a single contract or research paper
You can combine collection_ids with files to include both collection-based and individual file sources in a single research request.
Controls the maximum number of iterative reasoning cycles Caesar performs. Each loop involves gathering information, analyzing findings, identifying gaps, and refining the response.
During each reasoning loop, Caesar:
Creates targeted queries based on the research question and current knowledge gaps.
The response includes reasoning_loops_consumed showing how many loops were actually executed. With allow_early_exit: true, this may be less than the maximum.
Performance on Humanity’s Last Exam (HLE) shows significant improvement from 1 to 3 loops (19.95% → 53.85%), with diminishing returns beyond 5 loops. The sweet spot for most queries is 2-4 loops.
Controls how long Caesar waits when fetching content from each source URL before moving on.
Use when:
Trade-off: May miss slow-loading sources
Use when:
Trade-off: Longer response times
Very low timeouts (under 10s) may result in incomplete source processing. The default of 60 seconds works well for most use cases.
Enables advanced reasoning models for deeper analysis and synthesis.
Permits the research process to complete before exhausting all reasoning loops if sufficient information has been gathered.
When enabled, Caesar evaluates after each loop whether:
If these conditions are met, the process completes early, saving time and resources.
With allow_early_exit: true, a simple query set to 5 loops might complete in just 1-2 loops. Check reasoning_loops_consumed in the response to see actual usage.
Excludes social media platforms (Twitter/X, YouTube) from search results.
Best for:
Best for:
Enables intelligent auto-configuration where Caesar analyzes your query and automatically determines optimal parameter values.
When auto: true, Caesar:
When auto: true, explicit parameter values you provide are overridden by the auto-detected optimal settings.
If query classification succeeds, parameters are set based on analysis. If classification fails, sensible defaults are used:
Fast response for simple queries:
The research response includes fields that reflect parameter usage:
Usage is based on reasoning_loops_consumed, not the reasoning_loops you request. This means only actual work performed counts toward your usage. If early exit completes a job in fewer loops, usage reflects that.
Use auto: true for your first queries. Review the results and fine-tune parameters only if needed.
Simple queries don’t need high loop counts. Save resources by matching parameters to query complexity.
Enable exclude_social for academic or technical research where authoritative sources matter.
Use allow_early_exit: true with higher loop counts to get thoroughness when needed without wasting time on simple queries.
Cost consideration: Higher reasoning_loops and reasoning_mode: true consume more resources. Monitor your usage and optimize parameters for your specific needs.