Häufig gestellte Fragen¶

Schnelle Antworten auf häufige Fragen zu DeskAgent.

Allgemein¶

Was ist DeskAgent?¶

DeskAgent ist ein KI-gestützter Desktop-Assistent, der Büroaufgaben automatisiert. Er verbindet sich mit deinen Tools (E-Mail, Rechnungsstellung, Support-Tickets) und erledigt wiederkehrende Arbeit wie Posteingang-Organisation, Angebotserstellung und Rechnungsverarbeitung.

Wie funktioniert es?¶

1. Du klickst auf eine Agent-Kachel oder tippst eine Anfrage im Chat
2. Die KI versteht, was du brauchst und plant die Schritte
3. DeskAgent führt die Aktionen mit deinen verbundenen Tools aus
4. Du prüfst die Ergebnisse bevor etwas gesendet wird

Werden meine Daten in die Cloud gesendet?¶

Nur KI-Prompts werden an den KI-Anbieter (Anthropic/Google) gesendet. Deine eigentlichen E-Mails, Dokumente und Geschäftsdaten bleiben auf deinem lokalen Rechner. Die KI sieht den Inhalt, den sie verarbeiten muss, aber:

• Dateien werden in keinen Cloud-Speicher hochgeladen
• Sensible Daten können vor der KI-Verarbeitung anonymisiert werden
• Du kannst lokale KI-Modelle (Ollama) für vollständige Privatsphäre nutzen

Welche KI-Anbieter werden unterstützt?¶

E-Mail¶

Funktioniert es mit meinem E-Mail-Anbieter?¶

DeskAgent nutzt Microsoft Outlook. Es funktioniert mit jedem in Outlook konfigurierten E-Mail-Konto:

• Microsoft 365 / Office 365
• Exchange Server
• Outlook.com
• Gmail (über Outlook)
• IMAP/POP-Konten (über Outlook)

Muss Outlook geöffnet sein?¶

Ja. DeskAgent kommuniziert mit Outlook über Windows COM-Automatisierung, was erfordert, dass Outlook läuft.

Kann DeskAgent automatisch E-Mails senden?¶

Standardmäßig erstellt DeskAgent Entwürfe, keine gesendeten E-Mails. Du prüfst immer vor dem Senden. Das ist ein Sicherheitsfeature. Automatisches Senden kann für bestimmte Agents aktiviert werden, falls nötig.

Abrechnung & Rechnungsstellung¶

Welche Abrechnungssysteme werden unterstützt?¶

• Billomat - Deutsche Online-Rechnungsstellung
• Lexware Office - Deutsche Buchhaltungssoftware

Beide können gleichzeitig verwendet werden.

Kann ich andere Abrechnungssysteme hinzufügen?¶

Ja, DeskAgent ist erweiterbar. Neue Abrechnungs-Integrationen können durch Erstellen eines MCP-Servers hinzugefügt werden. Siehe Agents erstellen für den technischen Ansatz.

Was ist mit DSGVO?¶

DeskAgent ist für EU-Konformität konzipiert: - Daten bleiben auf deinem lokalen Rechner - Personenbezogene Daten können vor der KI-Verarbeitung anonymisiert werden - Du kontrollierst, welche Daten verarbeitet werden - Keine Daten werden in externen Systemen gespeichert (über das hinaus, was die KI-Anbieter in ihren Richtlinien angeben)

Installation & Updates¶

Der Installer schlägt fehl - was soll ich tun?¶

1. Als Administrator ausführen - Rechtsklick → "Als Administrator ausführen"
2. Antivirus prüfen - Windows Defender temporär deaktivieren oder Installer freigeben
3. Internet prüfen - Der Installer lädt Abhängigkeiten herunter
4. Logs prüfen - Schau in setup.log im Installationsverzeichnis

Wie aktualisiere ich DeskAgent?¶

Führe das Update-Skript aus:

.\deskagent\update.bat

Dies holt den neuesten Code und aktualisiert Abhängigkeiten.

Kann ich DeskAgent auf Mac oder Linux nutzen?¶

Aktuell nur Windows, weil Outlook COM-Automatisierung Windows-spezifisch ist. Eine plattformübergreifende Version mit Microsoft Graph API ist geplant.

Konfiguration¶

Wo werden meine API-Keys gespeichert?¶

Im config/ Ordner: - config/backends.json - KI-Anbieter Keys (Anthropic, Google) - config/apis.json - Service-Zugangsdaten (Billomat, UserEcho, etc.)

Diese Dateien sind in .gitignore und werden nie versioniert.

Kann ich mehrere KI-Backends nutzen?¶

Ja! Konfiguriere verschiedene Backends in backends.json und weise sie bestimmten Agents zu:

// In agents.json
"daily_check": {
  "ai": "gemini"      // Gemini für Routineaufgaben
},
"create_offer": {
  "ai": "claude_sdk"  // Claude für kundenorientierte Inhalte
}

Wie wechsle ich zwischen Backends?¶

Entweder: 1. Ändere den Standard in backends.json, oder 2. Weise bestimmte Backends bestimmten Agents in agents.json zu

Agents¶

Wie erstelle ich einen eigenen Agent?¶

1. Erstelle eine Markdown-Datei in agents/ die den Workflow beschreibt
2. Füge Konfiguration in config/agents.json hinzu
3. Starte DeskAgent neu

Siehe Agents erstellen für einen vollständigen Guide.

Ein Agent ist fehlgeschlagen - wie debugge ich?¶

1. Prüfe das System-Log: workspace/.logs/system.log
2. Prüfe das Agent-Log: workspace/.logs/agent_latest.txt
3. Versuche schrittweise: Führe jeden Schritt manuell im Chat-Modus aus

Können Agents automatisch laufen?¶

Ja, auf drei Wegen:

Sicherheit¶

Ist DeskAgent sicher?¶

DeskAgent implementiert mehrschichtige Sicherheit:

Kann ich einschränken, was ein Agent tun kann?¶

Ja, mit allowed_mcp und allowed_tools:

"my_agent": {
  "allowed_mcp": "outlook|clipboard",
  "allowed_tools": ["get_selected_email", "set_clipboard"]
}

Dieser Agent kann nur E-Mails lesen und die Zwischenablage nutzen - sonst nichts.

Siehe Sicherheits-Guide für Details.

Fehlerbehebung¶

DeskAgent startet nicht¶

Outlook-Tools funktionieren nicht¶

KI-Antworten sind langsam¶

Weitere Lösungen im Fehlerbehebungs-Guide.

Kosten¶

Wie viel kostet es?¶

DeskAgent selbst ist kostenlos und Open Source. Du zahlst für die KI-API-Nutzung:

Wie kann ich KI-Kosten reduzieren?¶

1. Gemini für Routineaufgaben nutzen - 60% günstiger als Claude
2. Lokale Modelle nutzen - Kostenlos, aber weniger leistungsfähig
3. Kontext limitieren - Nutze knowledge Pattern in Agent-Konfiguration
4. Tool-Beschreibungen reduzieren - Nutze allowed_mcp um nur benötigte Tools zu laden

Hilfe bekommen¶

Wo bekomme ich Support?¶

• Forum: forum.realvirtual.io
• E-Mail: support@deskagent.de
• GitHub: github.com/game4automation/aiassistant

Wo kann ich Bugs melden?¶

Öffne ein Issue auf GitHub oder poste im Forum mit: 1. Was du versucht hast zu tun 2. Was stattdessen passiert ist 3. Inhalt von workspace/.logs/system.log