Thesis AI logoThesis AI/Docs

System

Agent Framework

Thesis uses five specialist AI agents, each responsible for a distinct dimension of investment analysis. An Investment Manager orchestrator routes requests to the right agents and synthesizes their structured outputs into a unified thesis.

The Investment Manager (Orchestrator)

The Investment Manager is the entry point for every research request. It receives the user's query plus contextual data — their portfolio holdings, watchlist symbols, and any active session context — and determines which specialist agents are relevant.

Routing decisions are based on intent detection: keywords and symbols in the query map to agent specialties. When the intent is ambiguous, the orchestrator runs the full default agent set. After all agents return, the Investment Manager aggregates their outputs into an evidence layer and produces the final synthesis.

Routing Logic

Keywords like "rates" or "inflation" route to Macro. "Why is it moving?" routes to News. Providing a ticker symbol triggers Price, Fundamentals, and News in parallel. No strong signal runs the full default stack.

Specialist Agents

Macro AgentMacro

Assesses the current macro regime using real-time economic data: Fed funds rate, CPI, unemployment, GDP growth, and Treasury yield curves. Identifies the dominant risk-on / risk-off environment and the 1–2 most important macro tailwinds or headwinds for the next 4–8 weeks.

ratesinflationpolicyregimeyield curve

Output: Macro regime summary + 3–5 signal bullets + key risk / key upside

Fundamentals AgentFundamentals

Reviews company-level valuation, profitability, and balance sheet health using earnings data, P/E ratios, ROE, debt-to-equity, and operating margins. Provides a structured three-part assessment without issuing buy or sell labels.

valuationearningsbalance sheetmarginsP/EROE

Output: Valuation / Profitability / Balance sheet summary + one strength + one risk

News AgentNews

Surfaces the most relevant headlines for the requested symbols and explains why they move the stock. Focuses on catalyst identification, sentiment directionality, and the "why now" context that retail investors typically lack.

headlinessentimentcatalystwhy is it moving

Output: 3–5 headline bullets with relevance notes + single-sentence synthesis

Price & Trend AgentTechnical

Evaluates recent price action and short-term momentum using OHLC bar data and technical indicators. Identifies whether a symbol is in an uptrend, downtrend, or range, and flags notable inflection points.

price actionmomentumtrendtechnicalchart

Output: 2–4 trend / momentum bullets + short-term directional outlook

Portfolio AgentPortfolio

Analyzes the user's current holdings for concentration risk, sector exposure imbalances, and today's most relevant risk callouts. Provides a portfolio-level read without individual trade instructions.

holdingsallocationconcentrationexposurerisk

Output: Top holding / sector exposure / risk callout + one monitoring recommendation

Prompt Framework

Every agent uses the same reusable prompt structure. This ensures consistency, auditability, and predictable output format across all agents — critical for downstream synthesis.

You are acting as [professional role].

Context:
[What exists today. Why this analysis matters.]

Objective:
[Exactly what needs to be accomplished.]

Deliverable:
[Specific output format, structure, length, and detail level.]

Constraints:
- Use only the provided data; do not invent figures.
- No trade recommendations or price targets.
- Keep horizon and scope within defined bounds.

Quality bar:
[Criteria for success: clarity, rigor, mobile-readability.]

Agent Output Contract

Every agent returns a structured object. The Investment Manager consumes these objects to build the evidence layer before synthesis.

FieldTypeDescription
summarystringSingle-sentence finding from this agent.
confidenceinteger 0–100Agent's confidence in its analysis given available data quality.
signalsstring[]2–5 structured bullet points representing the key signals found.
dataobjectStructured fields for downstream use by the synthesis engine.

Design Principles

  • No hallucination — Agents are constrained to only use provided data. They cannot invent statistics or price targets.
  • No trade instructions — Agents produce research, not execution signals. Output is always framed as analysis, never as advice.
  • Mobile-first output — Every agent targets under 120 words and bullet structure, optimized for reading on a small screen.
  • Source-aware — Each piece of analysis is tied to the data snapshot it was derived from, enabling full traceability.