Finance Agent

Analyze finance/regulatory questions with evidence-bound synthesis

Deterministic finance workflow for VNBs: query planning → knowledge-rag retrieval → L1/L2 evidence arbitration → guarded synthesis. Default mode is rule_plus_hyde. No claim is emitted without source evidence.

post/api/finance-agent/analyze

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/finance-agent/analyze
  • Auth: none declared

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Request body

querystring required
mode'rule_only' | 'rule_plus_hyde'
profileIdstring

Optional CYA profile id to inject target layer awareness into retrieval planning.

topKinteger
minScorenumber
includeTraceboolean
sessionIdstring

Optional session identifier for A2A/memory-aware finance analysis.

datapointContextstring[]

Optional list of datapoint names to preload as L1 working memory facts.

includeMemoryContextboolean
includeA2AContextboolean
includeDatapointsContextboolean
contextLimitinteger
persistMemoryboolean
persistDatapointsboolean

Persist derived finance scenario output as datapoint when calculations are performed.

allowHypotheticalsboolean

Allow hypothetical scenario synthesis if no L1 evidence is found after multi-hop retrieval.

collectionstring

Optional knowledge collection name for RAG retrieval. Defaults to central Landside collection cernion_knowledge_v1. Tenant/custom collections are only used when explicitly provided.

tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "query": "Wie verhalten sich CAPEX, OPEX und TOTEX je 1 EUR Investition in der 5. Regulierungsperiode?",
  "profileId": "stadtwerk_regulierung",
  "sessionId": "finance-session-2026-05-04",
  "datapointContext": [
    "finance-capex-baseline-2025",
    "finance-interest-rate-history"
  ]
}

Response

Finance analysis with evidence list and guarded synthesis

Changes

No recorded changes to this operation across all 2 revisions of this API.