Skip to content
Ishvana Ishvana Docs

Synthesize Sources

POST
/api/agents/research/synthesize

Synthesize analysis across multiple sources.

Routes through :class:LaganResearchSynthesizeHandler after Phase A12 of the M15 migration; the legacy Lagan-LLM fallback was retired with the LLM provider stack.

Request Body required

Section titled “Request Body required ”
SynthesizeSourcesRequest

Request to synthesize multiple sources.

Synthesizes information from multiple sources to find agreements, disagreements, and unique insights across sources.

Fields:

  • sources: List of sources to synthesize (required, minimum 2)
  • synthesis_goal: Goal of synthesis (compare viewpoints, find consensus, etc.)

Synthesis Goals:

  • Compare viewpoints: Identify different perspectives
  • Find consensus: Identify agreed-upon points
  • Identify gaps: Find information gaps
  • Extract patterns: Find common patterns

Usage: Used to synthesize multiple research sources.

Integration:

  • ResearchRoutes: Request validation for /research/synthesize endpoint
  • LaganAgent: Multi-source synthesis processing
object
sources
required
Sources

Sources to synthesize (must have ‘content’ field)

Array<object>
>= 2 items
object
key
additional properties
string
synthesisGoal
required
Synthesisgoal

Goal of synthesis (e.g., ‘compare viewpoints’, ‘find consensus’)

string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

SynthesizeSourcesResponse

Response with synthesized analysis across sources.

Provides synthesized analysis including points of agreement, disagreement, and unique insights from each source.

Fields:

  • success: Whether synthesis was successful
  • synthesis: Main synthesized analysis text
  • agreements: Points of agreement across sources
  • disagreements: Points of disagreement between sources
  • unique_insights: Unique insights from individual sources
  • confidence: Synthesis quality confidence score (0.0-1.0)

Usage: Returned by source synthesis endpoints.

Integration:

  • ResearchRoutes: Response model for /research/synthesize endpoint
  • Frontend: Synthesis results display
object
success
required
Success

Whether synthesis was successful

boolean
synthesis
required
Synthesis

Synthesized analysis across all sources

string
agreements
Agreements

Points of agreement

Array<string>
disagreements
Disagreements

Points of disagreement

Array<string>
uniqueInsights
Uniqueinsights

Unique insights from each source

Array<string>
confidence
required
Confidence

Synthesis confidence

number
<= 1

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object