Zielnetzplanung (ZNP)

Ingest a natural-language planning assumption into the graph (AI)

Uses Gemini (structured JSON schema) to extract asset type, capacity (kW), status, and §14a flex-NAV flag from free-text German input. Inserts a StrategicAssumption node at layer=2.5 and a CONTRIBUTES_LOAD edge to SUB_1. In calculateGFactor, nodes with hasFlexibleNav=true are throttled to a realistic emergency minimum (legally curtailable under §14a EnWG — g=0.45). On success, backend emits znp.project.updated with payload { type: "assumption-confirmed", data: { id: "<assumptionId>", text: "<originalText>" } } for NovaFeedStore/SSE consumers. Requires GEMINI_API_KEY — returns HTTP 503 if not configured.

post/api/znp/projects/:projectId/assumptions

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/znp/projects/:projectId/assumptions
  • Auth: none declared

Path parameters

projectIdstring required

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

textstring required
tokenstring

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

Example request

{
  "text": "Wir planen einen 5 MW Speicher mit flexiblem NAV am Brückweg."
}

Response

Assumption node inserted

projectIdstring
assumptionIdstring
nodeKeystring
extractedobject
hasFlexibleNavboolean
graphStatsobject

Changes

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