QuickEngineering Benutzerhandbuch
QuickEngineering verwandelt ein Ziel in einen zusammenhängenden Ablauf aus expliziten Aufgaben, Anweisungen, Workern, Eingaben, Ergebnissen, Prüfungen und veröffentlichbaren Artefakten.
Erste Schritte
- Erstellen Sie ein Projekt und wählen Sie nur dann einen Workspace, wenn der Ablauf Dateien oder Code benötigt.
- Erstellen Sie einen Flow und fügen Sie dann Aufgaben mit expliziten Anweisungen und Ergebnisnamen hinzu.
- Wählen Sie für jede Aufgabe einen Agent und ordnen Sie frühere Ergebnisse späteren Eingaben zu.
- Fügen Sie Freigaben für Prüfung, Mensch, Datenversand, Budget oder Veröffentlichung dort ein, wo die Auswirkungen es erfordern.
- Führen Sie den Flow aus, verfolgen Sie Runs und Agent Queue und prüfen Sie anschließend Artefakte und Verlauf.
Tipp: Benennen Sie jedes Ergebnis eindeutig, damit nachgelagerte Zuordnungen verständlich bleiben.
Überblick über die Oberfläche
| Bereich | Zweck |
|---|---|
| Projekte | Der .qeng-Quellcontainer für Flows, Artefakte, Snapshots, Importe und den Papierkorb. |
| Flow Editor | Aufgabengraph, Zuordnungen, Bedingungen, Verträge, Freigaben, Budgets und Ausführungseinstieg. |
| Prompt Workspace | Prompts, Variablen, Varianten, Matrizen, Auswertung und wiederverwendbare Assets. |
| Runs und Agent Queue | Ausführung, Genehmigungen, übernommene Aufgaben, Fortschritt, Wiederholung, Prüfung und Endzustand. |
| Artefakte und Verlauf | Typisierte Ausgaben, Versionen, Herkunft, Kommentare, Diff, Rollback, Export, Veröffentlichung und Audit. |
Aufgabe → Anweisungen → Agent → Ergebnis
Der Flow Editor hält Zweck, Prompt, Worker, Eingabevertrag, Ausgabevertrag und Prüfgrenze jeder Aufgabe sichtbar, statt die Orchestrierung in einem einzigen Chat zu verstecken.
- Flow Editor: Verbinden Sie Aufgaben, Eingaben, Ergebnisse, Zuordnungen, Verträge, Bedingungen, Budgets und Freigaben.
- Prompt Workspace: Verwalten Sie wiederverwendbare Prompts, Variablen, Varianten, Matrizen, Auswertungen und versionierte Prompt-Assets.
- Agent-Routing: Nutzen Sie System AI, lokale Modelle, MCP-Agents, konfigurierte Cloud-Anbieter oder menschliche Schritte.
- Dauerhafte Runs: Verfolgen Sie wartende, aktive, pausierte, blockierte, fehlgeschlagene, geprüfte und abgeschlossene Arbeit mit klaren Wiederholungsgrenzen.
- Agent Queue und MCP: Lassen Sie eingegrenzte externe Agents Aufgaben übernehmen, Kontext erhalten sowie Fortschritt und Ergebnisse zurückmelden.
- Artefakte und Prüfung: Behalten Sie typisierte Ausgaben, Herkunft, Versionen, Kommentare, Diffs, Rollback, Export, Veröffentlichung und Audit-Verlauf.
Hinweis: Externe Agents, Anbieter, Befehle und verbundene Dienste können Dateien und Systeme verändern. Prüfen Sie Berechtigungsbereiche, Ziele und Ausgaben vor der Genehmigung.
Einstellungen
Öffnen Sie die Einstellungen, um die folgenden app-spezifischen Optionen zu prüfen:
- Agents, KI-Anbieter, Verbindungen, MCP Host und Workspace-Berechtigungen
- Richtlinien für Genehmigung, Datenversand, Budget, Prüfung und Veröffentlichung
- Tastenkürzel, Erscheinungsbild, Diagnose und Wiederherstellung
- Verhalten von Projekt, Artefakt, Trigger, Knowledge und Agent Memory
Testphase, Free und Pro bieten denselben Funktionsumfang. Pro entfernt mobile Werbung und den täglichen Unterstützungshinweis auf dem Desktop.
Tastenkürzel
Verwenden Sie auf Apple-Plattformen die Command-Taste, wo die App ein angezeigtes Ctrl-Kürzel auf den primären Modifikator der Plattform abbildet. Maßgeblich bleibt die Kurzbefehlsseite in der App.
| Kurzbefehl | Aktion |
|---|---|
| F2 / Enter | Ausgewähltes Prompt-Variablenelement umbenennen oder bearbeiten |
| F4 | Pfadmodus der ausgewählten Prompt-Variable umschalten |
| Tab / Pfeil rechts | Zum nächsten Segment der Prompt-Variable wechseln |
| Pfeil links | Zum vorherigen Segment der Prompt-Variable wechseln |
| Escape | Inline-Bearbeitung des Prompts abbrechen |
| Einstellungen > Tastenkürzel | Die aktuell registrierten globalen Aktionen prüfen |
Tipps & Tricks
Benennen Sie jedes Ergebnis eindeutig, damit nachgelagerte Zuordnungen verständlich bleiben.
Beginnen Sie mit System AI und einem kurzen manuellen Flow, bevor Sie externe Agents oder Trigger hinzufügen.
Nutzen Sie den VFS-vermittelten oder Patch-only-Zugriff, wenn der direkte Workspace-Zugriff eines Agents die Prüfung nicht besteht.
Halten Sie Geheimnisse als Referenzen und prüfen Sie die Data Send Preview vor jeder externen Übertragung.
Fehlerbehebung
| Problem | Was zu prüfen ist |
|---|---|
| Ein Agent ist nicht verfügbar | Öffnen Sie Agents und Verbindungen; prüfen Sie Installation, Anmeldung, Übertragungsmodus, Listener, Workspace und Prüfstatus. |
| Ein Run wartet | Prüfen Sie Aufgabenstatus, Genehmigung, Datenversandprüfung, menschliche Freigabe, Budget oder fehlende Eingaben. |
| Ein Ergebnis lässt sich nicht anwenden | Prüfen Sie den Artefaktvertrag, die Quellrevision, die Workspace-Fähigkeit und die Prüf- bzw. Freigabeentscheidung. |
| Ein Hintergrund-Listener übernimmt keine Aufgaben | Bestätigen Sie MCP Host, Projekt-Routing, Listener-Prozess, den genauen Agent und den aktuellen Workspace-Pfad. |
Datenschutz
- Geheimnisse bleiben Referenzen statt ausgeschriebener Projekttexte.
- Die Data Send Preview zeigt Ziel und ausgewählte Nutzdaten vor der externen Übertragung.
- Agent- und MCP-Zugriff ist eingegrenzt, auf Fähigkeiten geprüft und über Prüfgrenzen geführt.
- Der Audit-Verlauf hält Entscheidungen und Ergebnisse fest, ohne Zugangsdaten absichtlich offenzulegen.
Ihre Verantwortung: Verwenden Sie nur autorisierte Anbieter, Workspaces, Hosts, Konten und Werkzeuge; umgehen Sie keine Genehmigungs-, Audit- oder Sicherheitskontrollen.