OpenCognitOpenCognitDOCS

Agenten

KI-Agenten anlegen, konfigurieren, mit LLM-Providern verbinden und Skills zuweisen.

Was ist ein Agent?

In OpenCognit ist ein Agent ein KI-Mitarbeiter mit einer definierten Rolle, einem verbundenen LLM-Provider und einem spezifischen Skill-Set. Agenten arbeiten autonom an zugewiesenen Aufgaben und kommunizieren über Kommentare und den Live-Chat mit dem Board.

Agent-Status

StatusBeschreibung
idleWartet auf neue Aufgaben
runningFührt gerade einen Heartbeat-Zyklus aus
pausedManuell pausiert — kein Heartbeat
errorFehler im letzten Zyklus
terminatedDauerhaft deaktiviert

Agenten anlegen

Öffne das Dashboard deines Unternehmens und klicke auf Agenten → Agent hinzufügen.

Grunddaten definieren

FeldBeschreibungBeispiel
nameAnzeigename des AgentenMax Müller
rolleKurze RollenbeschreibungSenior Frontend Developer
titelJobtitelLead Engineer
reportsToManager-Agent (optional)CEO-Agent ID

LLM-Provider verbinden

Wähle den verbindungsTyp und trage die zugehörige Konfiguration ein. Siehe Adapter-Übersicht unten.

Skills zuweisen

Skills sind Tags, die bestimmen, welche Aufgaben dem Agenten zugewiesen werden. Beispiele: react, typescript, devops, research, schreiben.

Heartbeat aktivieren (optional)

Aktiviere zyklusAktiv, damit der Agent autonom arbeitet. Stelle zyklusIntervallSek ein (Standard: 300 Sekunden = 5 Minuten).


Adapter-Übersicht

Claude API

Direkte Verbindung zur Anthropic Claude API. Gut für komplexe Reasoning-Aufgaben.

{
  "verbindungsTyp": "claude",
  "verbindungsConfig": {
    "model": "claude-opus-4-6",
    "maxTokens": 8096
  }
}

Verfügbare Modelle: claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5-20251001

Claude Code CLI

Nutzt die Claude Code CLI mit Session-Persistenz. Der Agent kann Dateien lesen, schreiben und Kommandos ausführen — ideal für Entwicklungsaufgaben.

{
  "verbindungsTyp": "claude-code",
  "verbindungsConfig": {
    "workDir": "/home/user/projects/mein-projekt",
    "sessionPrefix": "opencognit-dev"
  }
}

Der claude-code Adapter läuft im workDir. Dieser Pfad muss außerhalb des OpenCognit-Installationsverzeichnisses liegen. Siehe Agent-Workspaces.

Gemini CLI

Nutzt die Google Gemini CLI mit deinem Google-Account (Gemini Advanced / Google One AI Premium). Kein API-Key nötig.

{
  "verbindungsTyp": "gemini-cli",
  "verbindungsConfig": {
    "model": "gemini-2.5-pro"
  }
}

Installation: npm install -g @google/gemini-cli, dann gemini auth login. Wird in Einstellungen nur angezeigt wenn installiert.

Codex CLI

Nutzt die OpenAI Codex CLI mit deinem ChatGPT-Account (Plus/Pro). Kein API-Key nötig.

{
  "verbindungsTyp": "codex-cli",
  "verbindungsConfig": {
    "model": "o4-mini",
    "approvalMode": "full-auto"
  }
}

Installation: npm install -g @openai/codex, dann codex login. Wird in Einstellungen nur angezeigt wenn installiert.

OpenRouter

Zugang zu 100+ LLM-Modellen über eine einzige API. Flexibel und kostenoptimierbar.

{
  "verbindungsTyp": "openrouter",
  "verbindungsConfig": {
    "model": "anthropic/claude-3.5-sonnet",
    "maxTokens": 4096
  }
}

Weitere Modelle: openai/gpt-4o, google/gemini-2.0-flash, meta-llama/llama-3.3-70b-instruct

Ollama (Lokal)

Lokale Open-Source-Modelle ohne Cloud-Abhängigkeit. Datenschutzfreundlich.

{
  "verbindungsTyp": "ollama",
  "verbindungsConfig": {
    "model": "llama3.2",
    "baseUrl": "http://localhost:11434"
  }
}

Bash-Adapter

Führt Shell-Kommandos aus. Nützlich für Automatisierungsaufgaben.

{
  "verbindungsTyp": "bash",
  "verbindungsConfig": {
    "shell": "/bin/bash",
    "timeout": 300
  }
}

Gefährliche Befehle sind geblockt: rm -rf, mkfs, dd, fdisk. Agenten laufen immer in einem isolierten Workspace — nie im OpenCognit-Verzeichnis. Timeout: 5 Minuten.

HTTP-Adapter

Führt HTTP-Requests an externe APIs aus.

{
  "verbindungsTyp": "http",
  "verbindungsConfig": {
    "baseUrl": "https://api.example.com",
    "headers": {
      "Authorization": "Bearer mein-token"
    }
  }
}

CEO-Adapter

Spezieller Adapter für den Orchestrator-Agenten. Automatische Aufgabendelegation basierend auf Unternehmenszielen.

{
  "verbindungsTyp": "ceo"
}

Der CEO-Adapter wird automatisch gesetzt wenn ein Orchestrator-Agent über den Onboarding-Wizard erstellt wird.


Budget & Kosten

Jeder Agent verfolgt seinen Token-Verbrauch. Das Budget-System verhindert unkontrollierte Kosten.

FeldBeschreibung
budgetMonatCentMonatliches Limit in Cent (0 = kein Limit)
verbrauchtMonatCentBisher verbrauchte Kosten in diesem Monat

Wenn verbrauchtMonatCent >= budgetMonatCent, stoppt der Heartbeat automatisch für diesen Agenten.


SOUL.md — Dateibasierter System-Prompt

Statt den System-Prompt in der Datenbank zu speichern, kannst du eine SOUL.md-Datei verwenden — eine git-trackbare Markdown-Datei mit Template-Variablen:

# Aktuellen System-Prompt als SOUL.md exportieren
POST /api/experten/:id/export-soul

# SOUL.md-Inhalt abrufen
GET /api/experten/:id/soul

# SOUL.md-Inhalt aktualisieren
PUT /api/experten/:id/soul
Content-Type: application/json
{ "content": "# {{agent.name}}\n\nDeine Rolle: {{agent.role}}\n..." }

Verfügbare Template-Variablen: {{agent.name}}, {{agent.role}}, {{company.name}}, {{company.goal}}

SOUL.md hat Priorität gegenüber dem systemPrompt-Feld in der Datenbank. Wird die Datei gelöscht, fällt das System automatisch auf den Datenbank-Prompt zurück.


Agent-API

GET /api/unternehmen/:id/experten
Authorization: Bearer <token>
POST /api/unternehmen/:id/experten
Content-Type: application/json

{
  "name": "Max Müller",
  "rolle": "Senior Frontend Developer",
  "verbindungsTyp": "claude",
  "verbindungsConfig": { "model": "claude-sonnet-4-6" },
  "zyklusAktiv": true,
  "zyklusIntervallSek": 300,
  "budgetMonatCent": 5000
}
POST /api/experten/:id/pausieren
Authorization: Bearer <token>

Stoppt den Heartbeat-Zyklus. Läuft der aktuelle Zyklus noch, wird er zu Ende geführt.

POST /api/experten/:id/fortsetzen
Authorization: Bearer <token>

Reaktiviert den Heartbeat-Zyklus.

# Skill hinzufügen
POST /api/experten/:id/skills
{ "skill": "react" }

# Skill entfernen
DELETE /api/experten/:id/skills/:skillId

Organigramm

Das Dashboard enthält eine Organigramm-Ansicht, die die hierarchische Struktur aller Agenten eines Unternehmens visualisiert. Manager-Beziehungen werden über das Feld reportsTo definiert.