Schnellstart¶

DeskAgent in 5 Minuten zum Laufen bringen.

Bevor du beginnst¶

Stelle sicher, dass du hast:

• Windows 10 oder 11
• Microsoft Outlook installiert (optional, für E-Mail-Funktionen)
• Internetverbindung
• Einen KI-API-Key (Claude oder Gemini)

Installation¶

Der Installer enthält alles, was du brauchst - Python, Git und alle Abhängigkeiten.

1. Lade DeskAgent-Setup.exe von der Releases-Seite herunter

2. Führe den Installer aus

   • Rechtsklick → "Als Administrator ausführen" falls nötig
   • Akzeptiere den Standardpfad oder wähle deinen eigenen

3. Warte auf die Einrichtung (2-5 Minuten)

   • Python-Umgebung wird automatisch konfiguriert
   • Alle Abhängigkeiten werden installiert
   • Standard-Konfigurationsdateien werden erstellt

4. Überprüfe die Installation

   Eine DeskAgent-Verknüpfung erscheint auf deinem Desktop. Doppelklicke zum Starten.

Konfiguration¶

KI-API-Key hinzufügen¶

Der Installer erstellt die Konfigurationsdateien automatisch. Öffne config/backends.json mit deinem bevorzugten Texteditor:

{
  "claude_sdk": {
    "type": "claude_agent_sdk",
    "api_key": "sk-ant-api03-DEIN-KEY-HIER",
    "model": "claude-sonnet-4-20250514",
    "use_anonymization_proxy": true
  }
}

{
  "gemini": {
    "type": "gemini_adk",
    "api_key": "AIzaSy-DEIN-KEY-HIER",
    "model": "gemini-2.5-pro"
  }
}

Erweiterungen konfigurieren (Optional)¶

Für Abrechnung, Support oder Dokumentenverwaltung, bearbeite config/apis.json:

{
  "billomat": {
    "enabled": true,
    "id": "deine-konto-id",
    "api_key": "dein-api-key"
  },
  "userecho": {
    "enabled": true,
    "subdomain": "deine-subdomain",
    "api_key": "dein-api-key"
  }
}

DeskAgent starten¶

Mit der Verknüpfung¶

Doppelklicke die DeskAgent-Verknüpfung auf deinem Desktop.

Mit der Kommandozeile¶

cd deskagent
python server.py

Oder nutze das Start-Skript:

.\deskagent\start.bat

Was passiert¶

1. Der Server startet auf Port 5005
2. Ein natives Fenster öffnet sich (oder Browser-Tab wenn WebView deaktiviert ist)
3. Du siehst die DeskAgent-Oberfläche

Deine erste Aufgabe¶

Lass uns überprüfen, ob alles funktioniert, mit einem einfachen Test.

Test 1: Mit der KI chatten¶

1. Tippe im Chat:

   Was kannst du für mich tun?
   

2. Erwartetes Ergebnis: Die KI antwortet mit einer Liste ihrer Fähigkeiten.

Test 2: Einen Agent ausprobieren (Falls Outlook verfügbar ist)¶

1. Öffne Microsoft Outlook und wähle eine E-Mail aus
2. In DeskAgent, klicke Agents → E-Mail lesen
3. Erwartetes Ergebnis: DeskAgent liest und fasst die ausgewählte E-Mail zusammen

Test 3: Verfügbare Agents erkunden¶

1. Klicke Agents in der Seitenleiste
2. Durchstöbere die verfügbaren Agents
3. Fahre mit der Maus über jeden, um zu sehen, was er tut

Kurzreferenz¶

Starten & Stoppen¶

Konfigurationsdateien¶

Log-Speicherorte¶

Fehlerbehebung¶

DeskAgent startet nicht¶

KI antwortet nicht¶

Outlook-Probleme¶

Nächste Schritte¶