Primeira execução com modelos gratuitos

Você não precisa de uma chave paga para testar o Perfica. A primeira tela do passo a passo de configuração faz uma pergunta: Começar de graça ou Tenho uma chave.

Começar de graça

O recurso Começar de graça configura você em modelos gratuitos em cerca de dois minutos. Ele pede duas chaves gratuitas, cada uma criada no site do próprio provedor, e nenhuma delas precisa de cartão:

• OpenRouter. Entre em openrouter.ai, clique em Create Key e copie a chave exibida uma única vez.
• Google Gemini. Entre com uma conta do Google em aistudio.google.com, clique em Create API key e copie-a.

Cole cada chave em sua linha e clique em Salvar. As chaves ficam no seu computador. Uma chave basta para começar; com ambas, o Perfica muda para o outro provedor quando o primeiro esgota o limite do dia.

Quando você clica em Continuar, o Perfica coloca os modelos gratuitos em um pool, Free models, e o define como seu modelo padrão. Cada bubble que você coloca começa nele, assim como o Manager. O pool contém:

• Laguna S 2.1 e Nemotron 3 Ultra no OpenRouter. Estes são os modelos gratuitos que a verificação de modelos própria do Perfica encontrou usando suas ferramentas corretamente.
• Gemini 3.8 Flash e Gemini 3.5 Flash-Lite no nível gratuito do Google.

O recurso Começar de graça fica em Settings (a engrenagem, no canto superior direito) › APIs › Free models, e no prompt de chave do modo simples, caso você o pule agora.

O resto do passo a passo

1. Language. O idioma em que o aplicativo é exibido para você, quando o aplicativo oferece mais de um.
2. Um modelo. Começar de graça ou Tenho uma chave: adicione uma chave para um provedor que você já paga (ou escolha um executor local) e escolha o default model. Veja Adicionar uma chave de provedor.
3. Seu primeiro loop. Dê um nome a ele, escolha um formato inicial e selecione a pasta do projeto em que ele trabalha. A pasta é opcional, mas sem ela os agentes podem conversar com modelos e não podem tocar em arquivos. Se a pasta ainda não for um repositório git, o passo a passo avisa que o Perfica tornará um.
4. O Manager. Escolha o modo em que o chat abre.

Um primeiro loop que funciona

Seu primeiro loop é a sua própria ideia:

1. Abra o Manager em Plan e descreva o que você quer, em uma frase ou duas.
2. Responda às perguntas dele. Nos modelos gratuitos, o Manager planeja uma primeira versão pequena, no máximo cinco cartões, que pode ser executada de ponta a ponta hoje, e ele diz o que deixou para depois. Assim que você concorda, ele grava os cartões no Task Book como Approved.
3. Mude para Build. O Manager propõe um loop com dois ou três bubbles; clique em Build it.
4. Clique em Play. Assista aos bubbles se revezarem; a aba Log do Manager mostra cada passada.

Quando um nível gratuito se esgota

Os níveis gratuitos permitem algumas dúzias de solicitações por dia. Quando um se esgota no meio de uma execução:

1. O Perfica muda para o outro provedor gratuito, caso você tenha adicionado ambas as chaves.
2. Quando ambos se esgotam, o loop pausa onde parou, e um aviso diz quando ele tentará novamente. Nenhum erro é contabilizado e nada é perdido.
3. O loop então recomeça sozinho: no horário que o provedor fornece para sua reinicialização, ou após 5, 10, 20 e 40 minutos e depois a cada hora. Ele continua tentando enquanto você deixar o quadro sozinho, de modo que uma execução deixada durante a noite continua quando a franquia retorna. Pausar ou parar o loop interrompe as novas tentativas.
4. O aviso tem um botão Add a paid key, e Play tenta novamente de imediato.

O Perfica continua rodando enquanto sua janela está fechada, a partir da bandeja. Fechar o aplicativo interrompe as novas tentativas; clique em Play quando abri-lo novamente.

Modelos menores

Modelos gratuitos e locais são menores do que os de fronteira pagos. Dê a eles cartões pequenos e bem descritos, e mantenha um loop curto no início. Você pode mover um único bubble para um modelo mais forte mais tarde sem alterar o resto.