Technik:Appsettings.json und CoPlanner Agent Konfiguration

Aus CoPlanner 11
Version vom 12. August 2026, 10:00 Uhr von S.jakobi (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „= CoPlanner LLM-Agent einrichten = 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…“)

Zur Navigation springenZur Suche springen

CoPlanner LLM-Agent einrichten

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
Abgerufen von „https://copsupport.coplanner.com/help11/index.php?title=Technik:Appsettings.json_und_CoPlanner_Agent_Konfiguration&oldid=23385“