Guia do usuário do QuickEngineering
O QuickEngineering transforma um objetivo em um fluxo conectado de tarefas explícitas, instruções, trabalhadores, entradas, resultados, revisões e artefatos publicáveis.
Primeiros passos
- Crie um Projeto e escolha um workspace apenas quando o fluxo precisar de arquivos ou código.
- Crie um Fluxo e adicione tarefas com Instruções e nomes de Resultado explícitos.
- Escolha um Agent para cada tarefa e mapeie os resultados anteriores nas entradas seguintes.
- Adicione etapas de revisão, aprovação humana, envio de dados, orçamento ou publicação onde o impacto exigir.
- Execute o fluxo, acompanhe Runs e a Agent Queue e depois inspecione Artifacts e o histórico.
Dica: Dê a cada Resultado um nome claro, para que os mapeamentos seguintes continuem compreensíveis.
Visão geral da interface
| Área | Função |
|---|---|
| Projetos | O contêiner de origem .qeng para fluxos, artefatos, capturas, importações e lixeira. |
| Editor de fluxo | Grafo de tarefas, mapeamentos, condições, contratos, etapas de aprovação, orçamentos e entrada de execução. |
| Prompt Workspace | Prompts, variáveis, variantes, matrizes, avaliação e ativos reutilizáveis. |
| Runs e Agent Queue | Execução, aprovações, tarefas assumidas, progresso, repetição, revisão e estado final. |
| Artifacts e histórico | Saídas tipadas, versões, linhagem, comentários, comparação, reversão, exportação, publicação e auditoria. |
Tarefa → Instruções → Agent → Resultado
O Editor de fluxo mantém visíveis o propósito, o prompt, o trabalhador, o contrato de entrada, o contrato de saída e o limite de revisão de cada tarefa, em vez de esconder a orquestração dentro de uma única conversa.
- Editor de fluxo: Conecte tarefas, entradas, resultados, mapeamentos, contratos, condições, orçamentos e etapas de aprovação.
- Prompt Workspace: Gerencie prompts reutilizáveis, variáveis, variantes, matrizes, avaliação e ativos de prompt versionados.
- Roteamento de Agents: Use a IA do sistema, modelos locais, agentes MCP, provedores de nuvem configurados ou etapas humanas.
- Runs duráveis: Acompanhe o trabalho em fila, ativo, pausado, aguardando, com falha, revisado e concluído, com limites de repetição.
- Agent Queue e MCP: Permita que agentes externos com escopo definido assumam tarefas, recebam contexto e devolvam progresso e resultados.
- Artifacts e revisão: Mantenha saídas tipadas, linhagem, versões, comentários, comparações, reversão, exportação, publicação e histórico de auditoria.
Observação: Agentes externos, provedores, comandos e serviços conectados podem afetar arquivos e sistemas. Revise os escopos, os destinos e as saídas antes de aprovar.
Configurações
Abra as Configurações para consultar os seguintes controles específicos do aplicativo:
- Agents, provedores de IA, conexões, MCP Host e permissões de workspace
- Políticas de aprovação, envio de dados, orçamento, revisão e publicação
- Atalhos de teclado, aparência, diagnósticos e recuperação
- Comportamento de projeto, artefatos, gatilhos, Knowledge e Agent Memory
Teste, Free e Pro usam o mesmo conjunto funcional de recursos. O Pro remove os anúncios no celular e o lembrete diário de apoio no desktop.
Atalhos de teclado
Nas plataformas da Apple, use Command quando o aplicativo mapear um atalho exibido como Ctrl para o modificador principal da plataforma. A página de atalhos dentro do aplicativo continua sendo a referência definitiva.
| Atalho | Ação |
|---|---|
| F2 / Enter | Renomear ou editar o item de variável de prompt selecionado |
| F4 | Alternar o modo de caminho da variável de prompt selecionada |
| Tab / Seta para a direita | Avançar para o próximo segmento da variável de prompt |
| Seta para a esquerda | Voltar para o segmento anterior da variável de prompt |
| Escape | Cancelar a edição de prompt em linha |
| Configurações > Atalhos de teclado | Ver as ações globais registradas no momento |
Dicas & Truques
Dê a cada Resultado um nome claro, para que os mapeamentos seguintes continuem compreensíveis.
Comece com a IA do sistema e um fluxo manual curto antes de adicionar Agents externos ou gatilhos.
Use o acesso mediado por VFS ou somente por Patch quando o acesso direto ao workspace do agente não passar na verificação.
Mantenha os segredos como referências e inspecione a Data Send Preview antes de qualquer transmissão externa.
Solução de problemas
| Problema | O que verificar |
|---|---|
| Um Agent está indisponível | Abra Agents e Connections; verifique a instalação, o login, o modo de entrega, o listener, o workspace e o status da verificação. |
| Um Run está aguardando | Inspecione o status da tarefa, a aprovação, a revisão de envio de dados, a etapa humana, o orçamento ou uma entrada ausente. |
| Um resultado não pode ser aplicado | Revise o contrato do artefato, a revisão de origem, os recursos do workspace e a decisão de revisão/aprovação. |
| Um listener em segundo plano não está assumindo tarefas | Confirme o MCP Host, o roteamento do projeto, o processo do listener, o Agent exato e o caminho atual do workspace. |
Privacidade
- Os segredos continuam sendo referências, e não texto expandido dentro do projeto.
- A Data Send Preview mostra o destino e o conteúdo selecionado antes da transmissão externa.
- O acesso de Agents e MCP tem escopo definido, é testado quanto às capacidades e passa por limites de revisão.
- O histórico de auditoria registra decisões e resultados sem expor credenciais em texto puro de forma intencional.
Sua responsabilidade: Use apenas provedores, workspaces, hosts, contas e ferramentas autorizados; não contorne os controles de aprovação, auditoria ou segurança.