Primeiros Passos com o Happycapy: Tutorial Completo para Iniciantes em 2026

Resumo

Happycapy é um computador nativo para agentes que roda inteiramente no seu navegador — sem instalação, sem configuração, sem necessidade de programação. Neste tutorial você vai criar seu primeiro Desktop, ativar um agente de IA, instalar uma Skill e executar sua primeira tarefa automatizada, tudo em menos de 30 minutos. Ao final, você terá uma configuração funcional para a qual pode delegar tarefas antes de dormir e conferir os resultados durante o café da manhã.

O Que Você Vai Construir

Seguindo estas seis etapas, você terá um espaço de trabalho pessoal de IA totalmente operacional. Concretamente, isso significa:

• Um Desktop nomeado, funcionando como o hub de arquivos persistente do seu projeto.
• Um Agente de IA personalizado com uma persona definida e um modelo de linguagem escolhido.
• Pelo menos uma Skill instalada para estender as capacidades padrão do seu agente.
• Uma tarefa automatizada — um trabalho agendado de processamento de arquivos — rodando sem qualquer acionamento manual.

Essa configuração reflete o que um usuário profissional do Happycapy executa no primeiro dia. Tudo acontece no sandbox na nuvem, então você pode fechar seu laptop e o trabalho continua.

Pré-requisitos

Antes de começar, confirme o seguinte:

O plano gratuito oferece uso mensal limitado nos modelos Haiku e MiniMax — suficiente para concluir todas as etapas deste tutorial. Se quiser acompanhar usando os modelos Opus ou Sonnet, uma assinatura Pro ou Max libera limites de tokens maiores.

Etapa 1: Crie Sua Conta e Explore a Interface

Acesse https://happycapy.ai/signup e crie sua conta com um endereço de e-mail. Depois de confirmar seu e-mail e fazer login, você chega ao painel Home. Reserve 60 segundos para se orientar antes de tocar em qualquer coisa.

A barra lateral esquerda contém três seções principais:

• Desktops — seus espaços de trabalho de projeto nomeados.
• Agents — as personas de IA que você configura e reutiliza.
• Skills — os plugins de capacidade que seus agentes podem acionar.

A barra superior mostra seu saldo de créditos atual e o seletor de modelo. Os créditos são consumidos por token, e o custo varia conforme o modelo: o Opus consome mais, enquanto Haiku e MiniMax consomem menos. Para este tutorial, deixe o modelo no padrão (Haiku 4.5) para economizar créditos.

Etapa 2: Crie Seu Primeiro Desktop

Desktops são espaços de trabalho de projeto nomeados, com um diretório compartilhado persistente em ~/a0/workspace/<desktop-id>/. Todo arquivo que seu agente cria ou lê fica armazenado ali, e várias sessões podem rodar em paralelo sobre os mesmos arquivos — o que torna o Happycapy fundamentalmente diferente de uma janela de chat.

Para criar seu primeiro Desktop:

1. Clique em "+ New Desktop" na barra lateral esquerda.
2. Dê um nome descritivo, por exemplo my-first-project.
3. Clique em Create.

Agora você tem um ambiente de arquivos isolado. Pense nele como uma pasta de projeto em um computador na nuvem que nunca desliga. A página de recursos dos Desktops aborda opções avançadas, como compartilhar um Desktop entre vários agentes e configurar fluxos de trabalho paralelos — guarde esse link para depois de terminar este tutorial.

Resultado esperado: Seu novo Desktop aparece na barra lateral. Ao clicar nele, abre-se a visualização do espaço de trabalho, com uma árvore de arquivos vazia à esquerda e um painel de sessão à direita.

Etapa 3: Construa Seu Primeiro Agente de IA

Um Agente de IA no Happycapy é uma persona personalizável, definida por cinco arquivos de configuração em Markdown: SOUL, USER, IDENTITY, MEMORY e AGENTS. Não é necessário editar todos os cinco logo no primeiro dia — o Happycapy vem com padrões sensatos para cada um.

Veja o que cada arquivo controla:

Para criar seu primeiro agente:

1. Clique em "+ New Agent" na barra lateral.
2. Dê um nome a ele (por exemplo, Research Assistant).
3. Selecione um modelo — use Haiku 4.5 para este tutorial.
4. No arquivo USER, adicione uma linha descrevendo você: I am a [seu papel] who needs help with [seu principal tipo de tarefa].
5. Deixe todos os outros arquivos com os valores padrão.
6. Clique em Save Agent.

Você pode ler mais sobre a configuração de agentes na página de recursos dos AI Agents, que aborda empilhamento avançado de personas e roteamento entre múltiplos modelos.

Resultado esperado: Seu agente aparece na lista de Agents. Ao selecioná-lo e abrir uma sessão, você verá uma interface de chat pré-carregada com o contexto da sua persona.

Etapa 4: Instale Sua Primeira Skill

Skills são plugins leves — geralmente de poucos kilobytes — que estendem o que seu agente pode fazer. O Happycapy suporta o protocolo MCP e conta com mais de 300.000 Skills disponíveis. Instalar uma leva cerca de 20 segundos.

Para este tutorial, instale uma Skill de gerenciamento de arquivos para que seu agente possa ler, escrever e organizar arquivos no espaço de trabalho do seu Desktop:

1. Navegue até Skills na barra lateral.
2. Use a barra de busca para encontrar File Manager (ou qualquer Skill relevante para o seu trabalho).
3. Clique em Install.
4. Na tela de confirmação, atribua a Skill ao seu agente Research Assistant.
5. Clique em Confirm.

Após a instalação, abra uma sessão com seu agente e digite:

List all files currently in my workspace.

Seu agente vai acionar a Skill File Manager, escanear ~/a0/workspace/<desktop-id>/ e retornar a lista de arquivos. Se o espaço de trabalho estiver vazio, ele informará isso — esse é o resultado correto nesta etapa.

Resultado esperado: O agente responde com uma listagem de arquivos (ou confirma que o espaço de trabalho está vazio) sem pedir nenhuma configuração adicional.

Etapa 5: Execute Sua Primeira Tarefa Automatizada

Agora que seu Desktop, agente e Skill estão prontos, é hora de automatizar algo. Nesta etapa, você vai dar ao seu agente uma tarefa com várias partes usando linguagem simples — sem código, sem construtor de fluxo de trabalho.

No chat da sessão, digite o seguinte (adapte o tópico para algo relevante para você):

Create a file called weekly-summary.md in my workspace.
Add a section called "Key Findings" with three placeholder bullet points.
Then add a section called "Next Actions" with two placeholder items.
Save the file when done.

Observe o agente trabalhar em cada instrução sequencialmente. Ele irá:

1. Criar o arquivo Markdown no diretório compartilhado do seu Desktop.
2. Escrever a estrutura solicitada.
3. Salvar e confirmar a conclusão.

Este é um exemplo simples, mas o mesmo padrão se aplica a fluxos de trabalho complexos: resumir uma pasta de PDFs, gerar um relatório semanal a partir de um CSV ou redigir e enviar e-mails. O limite de capacidade é o que um ser humano consegue fazer com um computador — não um menu fixo de ações predefinidas.

Resultado esperado: Um arquivo chamado weekly-summary.md aparece na árvore de arquivos do seu espaço de trabalho com a estrutura que você descreveu.

Etapa 6: Agende uma Automação Recorrente

A etapa final leva você de tarefas sob demanda para uma operação verdadeiramente 24/7. O Happycapy permite agendar sessões para que seu agente rode em um horário definido sem que você precise estar presente.

Para agendar uma tarefa diária:

1. Abra seu Desktop e clique em "Schedule" na barra de ferramentas do painel de sessão.
2. Defina a frequência (por exemplo, Daily at 08:00 UTC).
3. No campo de prompt da tarefa, insira a instrução que deseja que o agente execute — por exemplo:

Check the workspace for any new .csv files.
If found, summarize each file into a new .md report.
Name each report summary-<original-filename>.md.

4. Atribua seu agente Research Assistant.
5. Clique em Save Schedule.

A partir deste ponto, o agente vai "acordar" às 08:00 UTC, verificar o espaço de trabalho e processar quaisquer arquivos novos que encontrar — estando você online ou não.

Resultado esperado: O agendamento aparece na lista de agendamentos do seu Desktop, com um horário de "Next run". Você pode desativá-lo ou editá-lo a qualquer momento.

Verificação — Confirmando Que Tudo Funciona

Depois de concluir as seis etapas, execute esta checklist rápida:

☐ Seu Desktop está visível na barra lateral e tem uma árvore de arquivos não vazia (pelo menos weekly-summary.md). ☐ Seu agente está listado em Agents com um modelo atribuído. ☐ A Skill File Manager (ou a Skill escolhida por você) mostra o status "Installed" sob o agente. ☐ Abrir uma nova sessão e digitar list files retorna um resultado sem erros. ☐ O trabalho agendado mostra um horário futuro de "Next run" no painel de agendamentos do Desktop.

Se todos os cinco itens estiverem marcados, seu espaço de trabalho Happycapy está totalmente operacional.

Problemas Comuns

P: Meu agente diz que não consegue acessar arquivos no espaço de trabalho. R: Confirme se a Skill File Manager está atribuída a esse agente específico, não apenas instalada globalmente. Vá em Skills → Installed → atribua ao agente.

P: Fiquei sem créditos no meio do tutorial. R: Mude o modelo da sessão para Haiku 4.5 ou MiniMax M2.7 — ambos usam a taxa de créditos mais baixa. Os créditos do plano gratuito são renovados mensalmente.

P: O trabalho agendado não rodou no horário esperado. R: Verifique se o agendamento está configurado em UTC, e não no seu fuso horário local. Por padrão, os agendamentos do Happycapy rodam em UTC.

P: Meu agente está repetindo informações que eu não pedi. R: Abra o arquivo de configuração SOUL do seu agente e adicione uma linha: Be concise. Answer only what is asked. Salve e inicie uma nova sessão.

P: Criei um Desktop, mas não encontro os arquivos da minha sessão. R: Os arquivos são gravados em ~/a0/workspace/<desktop-id>/. Certifique-se de ter aberto a sessão de dentro do Desktop correto, e não a partir de uma sessão de agente independente.

Expandindo Este Tutorial

Depois que o básico estiver consolidado, aqui estão três próximos passos naturais:

1. Execute fluxos de trabalho em paralelo — crie um segundo Desktop para um projeto diferente e rode ambos os agentes simultaneamente. Cada Desktop tem seu próprio sistema de arquivos isolado, então não há contaminação cruzada. Veja a página de recursos dos Desktops para configuração de sessões paralelas.
2. Instale uma Skill de mídia — o Happycapy suporta modelos de geração de mídia, incluindo Gemini e Seedream. Adicione uma Skill de geração de imagens ao seu agente e peça que ele produza imagens de capa junto com relatórios escritos.
3. Explore a documentação completa do quickstart — o guia de início rápido aborda atalhos de teclado, busca no histórico de sessões e como exportar arquivos do espaço de trabalho para sua máquina local.

Em Números

Perguntas Frequentes

P: Preciso saber programar para usar o Happycapy? R: Não. O Happycapy foi projetado para todos — você descreve o que precisa em linguagem simples e o agente cuida da execução. Conhecimento de programação é opcional e só é necessário se você quiser escrever Skills personalizadas.

P: Qual é a diferença entre um Desktop e uma sessão no Happycapy? R: Um Desktop é um espaço de trabalho de projeto persistente com um sistema de arquivos compartilhado que sobrevive entre sessões. Uma sessão é uma única execução de conversa com um agente dentro daquele Desktop. Várias sessões podem compartilhar os mesmos arquivos do Desktop simultaneamente.

P: Posso usar o Happycapy em uma conta gratuita para trabalho real? R: Sim. O plano Free oferece uso mensal limitado nos modelos de menor custo (Haiku 4.5 e MiniMax M2.7). Para uso profissional diário com volumes de tokens maiores ou suporte prioritário, os planos Pro e Max estão disponíveis.

P: Em que o Happycapy difere do ChatGPT ou de outras IAs de chat? R: O Happycapy roda um computador completo na nuvem — não apenas uma interface de chat. Ele pode assumir o controle do ambiente na nuvem, gerenciar arquivos, executar scripts, agendar trabalhos recorrentes e operar 24/7 sem que você esteja presente. IAs conversacionais respondem a prompts; o Happycapy executa trabalhos de múltiplas etapas de forma autônoma.

P: Quantos agentes posso criar?

P: Posso compartilhar um Desktop com um colega de equipe?

Próximos Passos — Comece Sua Conta Gratuita

Agora você tem tudo o que precisa para colocar o Happycapy para trabalhar: um Desktop para armazenamento persistente de arquivos, um agente de IA configurado, uma Skill instalada e uma automação agendada rodando o tempo todo. A forma mais rápida de tornar isso real é começar com uma tarefa que você faz manualmente toda semana — um relatório, um resumo, um briefing de pesquisa — e entregá-la ao seu agente hoje mesmo. Crie sua conta gratuita do Happycapy em /signup e execute sua primeira automação antes do fim do dia.