Primeiros passos
Escolha um resultado, conclua-o e guarde identificadores e evidências antes de acrescentar complexidade. O caminho inicial mais curto e confiável é um build hospedado de imagem pequena com testes explícitos.
Pré-requisitos
- um navegador atual;
- uma conta OpenFactory para conversas salvas e builds no escopo do proprietário;
- uma distribuição alvo e uso pretendido claros;
- uma lista curta de pacotes ou serviços necessários;
- uma ou mais verificações observáveis que definam sucesso.
Não coloque senhas, chaves privadas, tokens ou credenciais de repositório privado em um prompt de chat ou receita salva.
Caminho inicial recomendado
- Crie sua conta.
- Siga Seu primeiro build com um SO, um usuário e um conjunto pequeno de pacotes.
- Compare a receita normalizada com o pedido original.
- Acompanhe o ID de build pela fila, build, finalização e testes selecionados.
- Baixe somente após a finalização do artefato e inspecione o checksum e as evidências fornecidas.
- Adicione uma alteração e verifique se a receita ativa preservou os requisitos anteriores do chat.
Outros caminhos
| Objetivo | Comece aqui | Limite |
|---|---|---|
| Entender uma receita antes de construir | Entendendo receitas | Validação não é prova de build |
| Usar campos JSON exatos | Recipe Schema | Campos desconhecidos podem ser ignorados; inspecione a saída normalizada |
| Adicionar asserções em VM | Testes | Verificações automatizadas cobrem apenas as observações declaradas |
| Conectar um assistente | Integração MCP | Mantenha chaves privadas e verifique os efeitos das ferramentas |
| Avaliar gerenciamento KVM local | Console de VM self-hosted | O caminho Compose público não é o builder hospedado nem um plano de controle de produção |
Um prompt inicial útil
Build a Debian 13 server image with OpenSSH and curl.
Create a password-locked deploy user in the sudo group.
Verify boot, the deploy user, the enabled SSH service, and the curl package.
Do not add Docker, a desktop, an installer, or external repositories.Este prompt nomeia o resultado, requisitos positivos, verificações observáveis e exclusões explícitas. É mais fácil de revisar do que “build me a secure server”, que deixa escopo de segurança e evidência indefinidos.
Quando parar e investigar
Pare antes de tentar de novo quando a receita omitir intenção explícita, nenhum ID de build aparecer, o build aguardar recuperação, o progresso ficar inalterado sem atividade nos logs, testes e status de build divergirem, ou um download reportar not found/forbidden/package creation failure. Preserve o ID da conversa, ID de build, timestamp e estado exato para que a falha original permaneça diagnosticável.