🤖 Explicar com IA

4Geeks AI Studio¶

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

Não é um chatbot, nem uma ferramenta que você precisa ficar comandando com prompts. É um serviço de entrega com um plano mensal, uma wallet pré-paga e uma pessoa responsável pelo resultado.

O que o AI Studio entrega¶

Um pod pega um resultado — uma funcionalidade, um bugfix, um conjunto de documentação, uma auditoria, uma passada de QA, uma atualização de dependências ou uma migração de banco de dados — e o transforma em um plano, tarefas, código, testes e um merge request pronto para o seu time revisar.

• Uma pessoa responsável. Cada pod tem um pod lead da 4Geeks que revisa o escopo, responde perguntas e escala quando o trabalho está travado.
• Uma unidade de trabalho e cobrança. O pod é dono do seu plano, tarefas, repositório, ferramentas, wallet e timeline.
• Progresso honesto. O progresso é ponderado pelas tarefas concluídas e limitado por fase. Nunca é um cronômetro.
• Evidências, não promessas. Um pod não pode ser marcado como entregue sem um build e uma execução de testes verdes quando o quality gate está ativo.
• Seu repositório continua seu. O pod trabalha em um branch e abre um merge request. Ele nunca faz push no seu branch protegido.

Como funciona¶

flowchart LR
    A[Escolha um resultado] --> B[Responda a um formulário curto]
    B --> C[O pod lead revisa o escopo]
    C --> D[Você aprova o plano]
    D --> E[O pod constrói e testa]
    E --> F[Você revisa o merge request]

1. Escolha um resultado. Escolha o que você precisa em linguagem de negócio: lançar a primeira fatia de um produto, adicionar uma funcionalidade, corrigir um bug, auditar o código, migrar um banco de dados, documentar o sistema, melhorar os testes ou atualizar dependências.
2. Responda a um formulário curto. Cinco perguntas com as suas palavras. Não é preciso fazer prompt engineering nem escrever uma especificação técnica.
3. Aprove o plano. O pod lead transforma as respostas em um plano com tarefas, critérios de aceitação, premissas, riscos e o que está fora do escopo.
4. Acompanhe a construção. O pod trabalha em um sandbox no seu repositório. Quando precisa de uma decisão, ela aparece em Precisamos de você.
5. Revise o merge request. O pod abre um branch e um MR com testes. Seu time revisa e faz o merge; o pod não faz deploy em produção.

Guia visual¶

Sua lista de pods, plano e saldo¶

A tela inicial é ordenada pelo que você pode fazer: Precisamos de você, Em andamento e Concluídos. O cartão Plano e saldo mostra a franquia mensal, o saldo pré-pago e o limite de pods simultâneos. Novo pod inicia o assistente.

Planos e preços¶

O plano é a base: a cada período de cobrança ele inclui uma bolsa de tarefas e horas de pod lead. O trabalho acima da bolsa é pago pela wallet pré-paga, nunca como uma fatura surpresa. Os tokens são rastreados para custo e suporte, mas não são uma cota do cliente.

• Só o trabalho entregue é cobrável. Uma tentativa falha e um retry são absorvidos pela 4Geeks.
• A bolsa é reiniciada a cada período. O uso é contado dentro do período de cobrança atual; nada se acumula.
• Você pode limitar o gasto. Um pod pausa e pede uma recarga antes de ultrapassar seu orçamento.
• Os planos são self-serve. O owner da organização ou um admin pode comprar ou trocar o plano no AI Studio; as mudanças são proporcionais.

Veja como funcionam o uso, os planos e a wallet

O que um pod pode entregar¶

O assistente transforma um resultado em um playbook: o time, as capacidades, os tipos de tarefa e os entregáveis esperados.

Veja cada caso de uso com seu processo, resultados e entregáveis

Capacidades¶

Uma capacidade não é um rótulo: ela ativa as skills, toolchains, tipos de tarefa e artefatos que o pod consegue produzir de fato. O plano é validado contra elas.

Você escolhe as capacidades ao criar o pod. Depois que o plano é aprovado, elas ficam bloqueadas, porque o plano, a imagem e as tarefas dependem delas.

O pod lead¶

O pod lead é um engenheiro da 4Geeks, não um agente de IA. Ele revisa o escopo antes de você aprová-lo, responde perguntas na sala do pod, desbloqueia o pod quando ele trava e decide quando uma entrega está pronta para revisão.

• Horas incluídas: o Starter inclui 2 h/mês e o Pro inclui 6 h/mês. O Lite funciona sob demanda.
• Sob demanda: o tempo extra de pod lead é cobrado a $75/h da wallet.
• SLA: cada pod mostra seu tempo-alvo de resposta em horas úteis.
• Peça ajuda: se você não tem certeza do que precisa, escolha Não tenho certeza, quero ajuda no assistente. Um pod lead lê suas respostas e entra em contato.

Uma solicitação de ajuda precisa de um plano ativo, minutos de pod lead disponíveis no período e um cartão cadastrado. Um programa (XL) é diferente: é pré-venda, então qualquer membro ativo pode pedir uma cotação e um pod lead prepara a fase 1 antes de você aprovar qualquer coisa.

Pod ou programa?¶

O assistente estima o tamanho do brief e explica o caminho. O tamanho nunca é perguntado; ele é derivado do que o resultado precisa.

Segurança e controle¶

• O acesso ao repositório é delimitado. As credenciais ficam no vault e são usadas apenas pelo sandbox do pod. Um pod trabalha em um branch e abre um MR; nunca faz push em um branch protegido.
• O sandbox é isolado. Cada pod roda em seu próprio ambiente com a imagem de runtime que seu stack precisa.
• A marca que você vê é a 4Geeks. O roteamento de modelos é um detalhe de implementação: o console e a timeline mostram 4Geeks Fast/Strong, nunca o nome de um provedor.
• A trilha de auditoria é exportável. A timeline do pod registra tarefas, checagens, aprovações e mensagens, com credenciais ocultadas.
• O quality gate é aplicado no servidor. Build, testes e E2E de navegador são verificados antes da entrega; uma exceção exige justificativa por escrito e fica auditada.

Boas práticas¶

1. Descreva o resultado, não os passos. “Os clientes podem pagar com um cartão salvo” é melhor que “adicione uma tabela e um endpoint”.
2. Escolha um resultado por pod. Trabalho do tamanho de um produto pertence a um pod L faseado ou a um programa.
3. Conecte o repositório que seu time realmente usa. O branch e o merge request são a entrega.
4. Escreva os critérios de aceitação no formulário inicial. Quanto mais claro for o “pronto”, menos rodadas o plano vai precisar.
5. Aprove o plano antes de a construção começar. O plano é o contrato; mudar o escopo depois da aprovação custa uma nova tarefa.
6. Responda rápido a “Precisamos de você”. O pod pausa em uma decisão, não em segundo plano.
7. Use o pod lead. Ele está incluído por um motivo: escopo, risco e trabalho bloqueado são a função dele.
8. Revise o MR, não a transcrição. O merge request é o entregável; a timeline é a evidência.

Perguntas frequentes¶

Próximos passos¶

• Ver os casos de uso do AI Studio
• Criar um pod passo a passo
• Entender o uso, os planos e a wallet
• Ler sobre o Private AI Gateway
• Explorar as perguntas frequentes do AI Studio

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