Guida utente di QuickEngineering
QuickEngineering trasforma un obiettivo in un flusso collegato di task espliciti, istruzioni, worker, input, risultati, revisioni e artifact pubblicabili.
Per iniziare
- Crea un progetto e scegli un workspace solo quando il flusso richiede file o codice.
- Crea un Flow, quindi aggiungi task con Instructions e nomi dei Result espliciti.
- Scegli un Agent per ogni task e mappa i risultati precedenti negli input successivi.
- Aggiungi gate di revisione, umani, di invio dati, di budget o di pubblicazione dove l'impatto lo richiede.
- Esegui il flusso, segui Runs e Agent Queue, quindi esamina Artifacts e History.
Suggerimento: Assegna a ogni Result un nome chiaro, così le mappature a valle restano comprensibili.
Panoramica dell'interfaccia
| Area | Scopo |
|---|---|
| Progetti | Il contenitore di origine .qeng per flussi, artifact, snapshot, importazioni e cestino. |
| Flow Editor | Grafo dei task, mappature, condizioni, contratti, gate, budget e avvio delle esecuzioni. |
| Prompt Workspace | Prompt, variabili, varianti, matrici, valutazione e asset riutilizzabili. |
| Runs e Agent Queue | Esecuzione, approvazioni, task presi in carico, avanzamento, nuovi tentativi, revisione e stato finale. |
| Artifacts e History | Output tipizzati, versioni, provenienza, commenti, confronto, rollback, esportazione, pubblicazione e audit. |
Task → Instructions → Agent → Result
Il Flow Editor mantiene visibili lo scopo di ogni task, il prompt, il worker, il contratto di input, il contratto di output e il confine di revisione, invece di nascondere l'orchestrazione in un'unica chat.
- Flow Editor: Collega task, input, risultati, mappature, contratti, condizioni, budget e gate.
- Prompt Workspace: Gestisci prompt riutilizzabili, variabili, varianti, matrici, valutazioni e asset di prompt con versioni.
- Instradamento degli Agent: Usa System AI, modelli locali, agent MCP, provider cloud configurati o passaggi umani.
- Run persistenti: Tieni traccia del lavoro in coda, attivo, in pausa, in attesa, fallito, revisionato e completato, con limiti ai nuovi tentativi.
- Agent Queue e MCP: Consenti ad agent esterni con ambito definito di prendere in carico il lavoro, ricevere il contesto e restituire avanzamento e risultati.
- Artifacts e revisione: Conserva output tipizzati, provenienza, versioni, commenti, confronti, rollback, esportazioni, pubblicazioni e cronologia di controllo.
Nota: Agent esterni, provider, comandi e servizi collegati possono modificare file e sistemi. Controlla ambiti, destinazioni e output prima di approvare.
Impostazioni
Apri le Impostazioni per rivedere i seguenti controlli specifici dell'app:
- Agent, provider IA, connessioni, MCP Host e autorizzazioni del workspace
- Criteri di approvazione, invio dati, budget, revisione e pubblicazione
- Scorciatoie da tastiera, aspetto, diagnostica e ripristino
- Comportamento di progetti, artifact, trigger, Knowledge e Agent Memory
Versione di prova, Free e Pro offrono lo stesso insieme di funzioni. Pro rimuove gli annunci su mobile e il promemoria di supporto giornaliero su desktop.
Scorciatoie da tastiera
Sulle piattaforme Apple usa Comando dove l'app mappa una scorciatoia mostrata come Ctrl sul modificatore principale della piattaforma. La pagina delle scorciatoie nell'app resta il riferimento autorevole.
| Scorciatoia | Azione |
|---|---|
| F2 / Enter | Rinomina o modifica l'elemento variabile del prompt selezionato |
| F4 | Attiva/disattiva la modalità percorso della variabile del prompt selezionata |
| Tab / Freccia destra | Passa al segmento successivo della variabile del prompt |
| Freccia sinistra | Torna al segmento precedente della variabile del prompt |
| Escape | Annulla la modifica del prompt in linea |
| Impostazioni > Scorciatoie da tastiera | Consulta le azioni globali attualmente registrate |
Consigli & trucchi
Assegna a ogni Result un nome chiaro, così le mappature a valle restano comprensibili.
Inizia con System AI e un breve flusso manuale prima di aggiungere Agent esterni o trigger.
Usa l'accesso mediato da VFS o solo tramite Patch quando l'accesso diretto al workspace dell'agent non supera la verifica.
Mantieni i segreti come riferimenti e controlla la Data Send Preview prima di ogni trasmissione esterna.
Risoluzione dei problemi
| Problema | Cosa controllare |
|---|---|
| Un Agent non è disponibile | Apri Agents e Connections; verifica installazione, accesso, modalità di consegna, listener, workspace e stato della verifica. |
| Un Run è in attesa | Controlla lo stato del task, l'approvazione, la revisione dell'invio dati, il gate umano, il budget o un input mancante. |
| Un risultato non può essere applicato | Verifica il contratto dell'artifact, la revisione di origine, le capacità del workspace e la decisione di Review/Gate. |
| Un listener in background non prende in carico i task | Conferma MCP Host, l'instradamento del progetto, il processo listener, l'Agent esatto e il percorso corrente del workspace. |
Privacy
- I segreti restano riferimenti e non vengono espansi nel testo del progetto.
- La Data Send Preview mostra la destinazione e il payload selezionato prima della trasmissione esterna.
- L'accesso di Agent e MCP ha un ambito definito, viene verificato nelle capacità e passa attraverso i confini di revisione.
- L'Audit History registra decisioni e risultati senza esporre intenzionalmente credenziali in chiaro.
La tua responsabilità: Usa solo provider, workspace, host, account e strumenti autorizzati; non aggirare i controlli di approvazione, audit o sicurezza.