Technik:Appsettings.json und CoPlanner Agent Konfiguration

appsettings.json Konfiguration

Bei Verwendung von https wird in dieser Datei angegeben, woher das Zertifikat bezogen werden soll.

Das Zertifikat kann entweder als Datei abgespeichert oder aus dem Zertifikatsspeicher bezogen werden. Bei Pfadangaben müssen immer zwei \ und nicht nur einer verwendet werden (z.B. D:\\MyCertFolder\\MyCert.pfx).

Erlaubte Hostnamen

Mit "AllowedHosts" werden die Hostnamen eingeschränkt, unter denen der Server erreichbar ist. Mehrere Hostnamen können durch Strichpunkte getrennt angegeben werden.

{
    "AllowedHosts": "servername.coplanner.com;localhost"
}

Beispiel appsettings.json

{
  "Agent": {
    "ModelId": "gpt-5.4-mini",
    "ApiKey": "sk-...",
  },
  "WebConfig": {
    "JwtBearerIssuer": "YOURCERTIFIKATIONAUTHORITY",
    "JwtBearerIssuerKey": "YOURKEY",
    "ForwardedSecret": "YOUURSECRET"
  },
  "Kestrel": {
    "Certificates": {
      "Default": {
        "Subject": "YOURSUBJECT", //// Issued to (Ausgestellt für) field
        "Store": "MY", //// possible values "MY", "Root", "Trust", "CA" -> https://learn.microsoft.com/en-us/windows/win32/seccrypto/system-store-locations
        "Location": "YOURLOCATION", //// possible values "CurrentUser", "LocalMachine" -> https://learn.microsoft.com/en-us/aspnet/core/fundamentals/servers/kestrel/endpoints?view=aspnetcore-7.0
        "AllowInvalid": "false"
      }
      //"Default": {
      //  "Path": "<path to .pfx file>",
      //  "Password": "<certificate password>"
      //}
      // or
      //"Default": {
      //  "Path": "<path to .pem/.crt file>",
      //  "KeyPath": "<path to .key file>",
      //  "Password": "<certificate password>"
      //}
      // or
      //"Default": {
      //  "Thumbprint": "<thumbprint; required>",
      //  "Store": "<certificate store; required>", //// possible values "MY", "Root", "Trust", "CA" -> https://learn.microsoft.com/en-us/windows/win32/seccrypto/system-store-locations
      //  "Location": "<location; defaults to CurrentUser>", //// possible values "CurrentUser", "LocalMachine" -> https://learn.microsoft.com/en-us/aspnet/core/fundamentals/servers/kestrel/endpoints?view=aspnetcore-7.0
      //  "AllowInvalid": "<true or false; defaults to false>"
      //}
    }
  }
}

CoPlanner Agent einrichten (LLM Anbindung)

Der CoPlanner Agent ist vorbehaltlich ab CoPlanner 11 Release 3 2026 verfügbar

Der CoPlanner Agent beantwortet Fragen zur offenen Planungsmaske und steuert sie per Chat (aktueller Stand: Nullwertunterdrückung, weitere Kommandos in Arbeit). Die Anbindung läuft über die OpenAI-Plattform.

Voraussetzungen

• CoPlanner-Lizenz mit NeoFeatures-Flag – ohne das Flag wird der Agent im Client nicht angeboten.
• OpenAI-API-Key (siehe nächster Abschnitt).
• Der CoPlanner-Server braucht ausgehenden HTTPS-Zugriff auf api.openai.com.

OpenAI-Konto und API-Key

Ein API-Key ist ein persönlicher Zugangsschlüssel (beginnt mit sk-...), mit dem der CoPlanner-Server Anfragen an OpenAI stellt – vergleichbar mit einem Passwort für den Programmzugriff. Ein ChatGPT-Abo ist dafür nicht nötig, die API wird separat und rein nach Verbrauch abgerechnet.

So kommt man zum Key:

1. Auf platform.openai.com ein Konto anlegen (E-Mail oder bestehendes Microsoft-/Google-Konto).
2. Unter Billing eine Zahlungsmethode hinterlegen und ein Startguthaben aufladen (z. B. 10 USD – Prepaid, es entsteht kein Abo).
3. Unter API Keys mit Create new secret key einen Key erzeugen. Der Key wird nur einmal angezeigt – direkt kopieren und sicher ablegen.

Zu den Kosten: Abgerechnet wird nur die tatsächliche Nutzung (nach verarbeiteter Textmenge). Eine typische Agent-Anfrage mit dem Standardmodell kostet Bruchteile eines Cents – normale Nutzung bleibt damit im Bereich weniger Euro pro Monat. Unter Limits lässt sich zusätzlich ein Monatsbudget festlegen, mehr als das kann nie anfallen.

Den Key wie ein Passwort behandeln: nicht weitergeben, gut aufbewahren und nur in der Server-Konfiguration eintragen.

Server-Konfiguration

In der appsettings.json im Server-Verzeichnis (neben der Server-Exe) den Abschnitt Agent ergänzen:

"Agent": {
  "ApiKey": "sk-...",
  "ModelId": "gpt-5.4-mini"
}

• ApiKey – Pflicht. Ohne Key (oder leer) meldet der CopServer dem Client enableAiAgent=false, der Agent-Eintrag erscheint dann gar nicht.
• ModelId – optional, Standardwert: gpt-5.4-mini.
• Nach Änderungen CopServer neu starten – die Datei wird nur beim Start gelesen.

Modelle

Der Endpunkt ist fest die OpenAI-Plattform (kein Azure OpenAI, kein eigener Endpunkt). Konfigurierbar ist jedes OpenAI-Chat-Modell, das Tool-Calling unterstützt – Modellnamen laut OpenAI-Dokumentation.

ModelId	Einordnung
gpt-5.4-mini	Standardmodell – schnell und kostengünstig, für die Maskensteuerung ausreichend
gpt-5.4	Höhere Antwortqualität bei komplexeren Fragen, aber spürbar teurer

Reasoning-Modelle (o-Serie) sind nicht getestet.

Wo finde ich den Agenten?

Web-Client, Planungsmaske im Pivot-Modus: im vertikalen Maskenmenü der Eintrag CoPlanner Agent (KI-Funken-Icon). Der Klick öffnet den Chat-Dialog, erneuter Klick schließt ihn.

Der Eintrag erscheint nur, wenn alle Voraussetzungen erfüllt sind:

• Maske im Pivot-Modus (nicht Tabellen-/Zeilensicht)
• Lizenz mit NeoFeatures-Flag
• API-Key am Server konfiguriert