Personal Agent

Ask Cernion for compact evidence, guardrails and process context

Read-only Copilot action. Returns compact structured evidence and guardrails from Cernion entity search, Knowledge RAG, datapoints and object-store context. It does not run the heavy Personal Agent chat path and does not execute, confirm, sign, delete or modify process data.

post/api/copilot/ask-cernion-agent

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/copilot/ask-cernion-agent
  • 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

questionstring required

User question to answer with Cernion evidence and process context.

sessionIdstring

Optional stable Copilot conversation/session identifier.

contextobject

Optional tenant, user, object, process or document context.

inputsobject

Optional canonical structured input values (e.g. assetType, location, minCapacity, maxCapacity, commissioningYear, limit) for Blueprint read-only REST-plan compilation. Separate from context.

domain'auto' | 'vnb' | 'vdmi' | 'znp' | 'grid-connection' | 'edm' | 'finance' | 'process'

Optional domain hint for routing.

mode'answer' | 'evidence' | 'process_check' | 'prepare_intent'

Controls whether the answer should focus on evidence or process checks.

maxEvidenceinteger

Maximum number of evidence items returned.

includeFederatedKnowledgeboolean

Opt-in only (default false, does not change the default evidence sources/output shape). When true, additionally queries knowledge-rag.federatedSearch (Marktkommunikation/regulatory collections) and includes it as an advisory evidenceBySource.federatedKnowledge entry.

tokenstring

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

Example request

{
  "question": "Welcher VNB ist in Wiesloch zuständig?",
  "inputs": {
    "assetType": "solar",
    "location": "69168",
    "minCapacity": 10,
    "maxCapacity": 13,
    "commissioningYear": 2025,
    "limit": 100
  }
}

Response

Compact Cernion answer for Copilot composition

successboolean required
sessionIdstring
questionstring
shortAnswerstring required
groundingAnswerstring required

Prompt-ready Cernion grounding package for Copilot composition. Contains user question, answer, evidence, guardrails, risks, open questions and answer rules in one text field.

consultingBriefstring

Optional backend-generated consulting brief for Copilot. It structures the evidence but is not a standalone source of facts.

confidence'high' | 'medium' | 'low'
processContextstring[] required
evidenceBySourceobject

Evidence grouped by source: entities, knowledge, datapoints, and object-store objects.

guardrailsstring[]

Instructions Copilot must apply before composing the final answer.

entitiesstring[]
risksstring[]
openQuestionsstring[] required
recommendedNextStepsstring[] required
allowedActionsstring[] required
forbiddenActionsstring[] required
routingobject
canonicalInputsobject

Normalized inputs used to compile the execution plan, if any.

noPlanReasonstring

Present when resolved.kind is "none" — explains why no executable read-only plan was available.

Example response

{
  "recommendedEndpoints": [
    {
      "method": "GET",
      "path": "/api/assets/solar",
      "resultSemantics": {
        "kind": "asset_list"
      }
    }
  ],
  "execution": {
    "mode": "read_only_rest_plan",
    "method": "GET",
    "path": "/api/assets/solar"
  }
}

Changes

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