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
| Status | Beschreibung |
|---|---|
idle | Wartet auf neue Aufgaben |
running | Führt gerade einen Heartbeat-Zyklus aus |
paused | Manuell pausiert — kein Heartbeat |
error | Fehler im letzten Zyklus |
terminated | Dauerhaft deaktiviert |
Agenten anlegen
Navigiere zu Agenten
Öffne das Dashboard deines Unternehmens und klicke auf Agenten → Agent hinzufügen.
Grunddaten definieren
| Feld | Beschreibung | Beispiel |
|---|---|---|
name | Anzeigename des Agenten | Max Müller |
rolle | Kurze Rollenbeschreibung | Senior Frontend Developer |
titel | Jobtitel | Lead Engineer |
reportsTo | Manager-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.
| Feld | Beschreibung |
|---|---|
budgetMonatCent | Monatliches Limit in Cent (0 = kein Limit) |
verbrauchtMonatCent | Bisher 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/:skillIdOrganigramm
Das Dashboard enthält eine Organigramm-Ansicht, die die hierarchische Struktur aller Agenten eines Unternehmens visualisiert. Manager-Beziehungen werden über das Feld reportsTo definiert.