🤖 Explicar com IA

Primeiros passos com o 4Geeks AI Studio: Do console ao primeiro deploy¶

Visão geral¶

O 4Geeks AI Studio entrega software por meio de pods: um pod lead humano da 4Geeks mais uma pequena equipe de agentes de IA trabalhando no seu repositório. Você descreve o resultado, aprova um plano e revisa um merge request. O pod cuida do planejamento, do código, dos testes e das evidências.

Neste tutorial você vai:

• Escolher o plano que combina com sua carga de trabalho (Lite, Starter ou Pro)
• Criar seu primeiro pod pelo wizard
• Responder o intake e conectar seu repositório
• Aprovar o plano e acompanhar a construção
• Revisar e fazer o merge do que o pod entrega

Pré-requisitos¶

• Uma conta 4Geeks (cadastre-se em console.4geeks.io)
• Um repositório GitLab ou GitHub com um token de acesso que tenha permissão de escrita no projeto
• Um plano AI Studio ativo, ou um cartão cadastrado para iniciar um

Passo 1: Escolha seu plano¶

Abra AI Studio no console. O cartão Plano e saldo mostra seu plano atual, as tarefas e horas de pod lead usadas, o saldo pré-pago e o limite de pods simultâneos.

• Só o trabalho entregue é cobrado: uma tentativa falhada e um retry são absorvidos pela 4Geeks.
• O trabalho acima da bolsa mensal é pago pela carteira pré-pago, nunca por uma fatura surpresa.
• O dono da organização ou um admin pode comprar ou trocar o plano pelo AI Studio; as mudanças são rateadas.

Os tokens são medidos para custo e suporte, mas não são uma cota do cliente e nunca bloqueiam uma tarefa.

Passo 2: Abra o wizard¶

No AI Studio, clique em Novo pod. O wizard tem quatro passos: o que você precisa, algumas perguntas, o repositório e a confirmação.

Escolha o resultado mais próximo: primeira fatia do meu produto, adicionar uma funcionalidade, encontrar e corrigir um bug, auditar meu código, migrar meu banco de dados, documentar meu sistema, melhorar qualidade e testes, atualizar minhas dependências, ou um produto ou uma plataforma.

Se nenhum se encaixar, escolha Algo mais e descreva o objetivo você mesmo. Se preferir uma pessoa, escolha Não tenho certeza, quero ajuda e um pod lead lê suas respostas.

Passo 3: Responda o intake¶

O intake tem cinco perguntas em linguagem de negócio. Só as marcadas são obrigatórias.

Suas respostas se tornam o briefing que o pod lead revisa e que o planner usa para montar o plano.

Passo 4: Conecte o repositório¶

1. Escolha GitLab ou GitHub e informe a URL da instância (por exemplo https://gitlab.com).
2. Informe o caminho do projeto e o branch de onde o pod deve começar.
3. Cole um token de acesso com permissão de escrita naquele projeto. Ele fica criptografado na vault e é usado só pelo sandbox do pod.
4. Escolha a imagem de runtime: Base, Web, JVM ou Android. O wizard sugere uma quando consegue inspecionar o repositório.

O pod trabalha em um branch e abre um merge request. Ele nunca faz push no seu branch protegido.

Passo 5: Confirme e crie o pod¶

A tela de confirmação mostra o tamanho (S, M, L ou XL), o briefing, o playbook, o repositório, a imagem de runtime, as capacidades, as ferramentas, o saldo disponível e a primeira estimativa.

• Capacidades ativam o que o pod pode executar: docs, SCRUM, data, quality, E2E, security, design e preview. Você pode mudá-las até aprovar o plano.
• Ferramentas são Jira, Confluence, Notion ou um banco de dados somente leitura; você pode conectar credenciais depois.
• Estimativa e saldo: recarregue a carteira primeiro se o saldo estiver baixo.

Clique em Criar pod. O pod aparece na lista e, em seguida, o plano é gerado.

Passo 6: Aprove o plano¶

Quando o plano estiver pronto, o pod aparece em Precisamos de você. Revise o resumo, as tarefas e seus critérios de aceite, as suposições, os riscos e o que não está incluído.

Clique em Aprovar e iniciar para levar o pod à construção, ou Pedir mudanças para devolvê-lo com feedback. Aprovar o plano é o que inicia a construção.

Passo 7: Acompanhe a construção¶

A sala do pod é organizada de cima para baixo:

Enquanto o pod trabalha, o quality gate roda os próprios scripts de build e teste do seu repositório no sandbox. Um pod com Quality ou E2E não pode ser marcado como entregue sem uma corrida verde, então o merge request que chega já passou pelo QA.

Passo 8: Revisar e fazer merge¶

Quando o trabalho termina, o pod abre um merge request com testes e evidências:

1. Abra o merge request no seu repositório.
2. Revise o diff, os testes e as evidências anexadas ao pod.
3. Confira a timeline do pod se quiser o registro completo; ela é exportada como JSON com credenciais redigidas.
4. Faça o merge quando aprovar. Seu pipeline faz o deploy.

O pod nunca faz merge sozinho e nunca implanta em produção.

Melhores práticas¶

• Descreva o resultado, não os passos. “Clientes podem pagar com um cartão salvo” vale mais que “adicione uma tabela e um endpoint”.
• Escreva a definição de pronto no intake. Quanto mais claro for o “pronto”, menos rodadas o plano precisa.
• Responda rápido ao “Precisamos de você”. O pod pausa em uma decisão, não em segundo plano.
• Mantenha o quality gate ativo. Build e testes são o seguro mais barato contra um merge ruim.
• Recarregue antes da carteira esvaziar. Uma pausa por orçamento custa mais tempo que uma recarga.
• Use o pod lead. Ele está incluído para escopo, risco e trabalho bloqueado.

Próximos passos¶

• Leia sobre Entendendo o AI Factory: Orquestração Multi-Modelo para aprender como diferentes LLMs são usados
• Aprenda a Configurar Injeção de Contexto Inteligente para melhor geração de código
• Explore QA Automatizado e Barreiras de Segurança para entender os portões de qualidade
• Consulte a Referência da API para acesso programático

Precisa de ajuda?¶

• Documentação: docs.4geeks.io
• Discord: Discord
• Suporte: Disponível pelo painel do console
• Vendas: Fale conosco

Ainda tem dúvidas? Pergunte no Discord ou explore os tutoriais.