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

Resumo

Happycapy é um computador nativo de agentes que funciona inteiramente no seu navegador — sem instalação, sem configuração, sem necessidade de programação. Neste tutorial vai criar o seu primeiro Desktop, colocar em funcionamento um agente de IA, instalar uma Skill e executar a sua primeira tarefa automatizada, tudo em menos de 30 minutos. No final, terá uma configuração funcional à qual pode entregar tarefas antes de ir dormir e verificar os resultados ao pequeno-almoço.

O Que Vai Construir

Ao seguir estes seis passos, terá um espaço de trabalho pessoal de IA totalmente operacional. Concretamente, isso significa:

• Um Desktop com nome, a funcionar como o centro de ficheiros 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 ampliar as capacidades predefinidas do seu agente.
• Uma tarefa automatizada — um trabalho de processamento de ficheiros agendado — em execução sem qualquer acionamento manual.

Esta configuração reflete o que um utilizador profissional do Happycapy executa no primeiro dia. Tudo reside na sandbox na cloud, pelo que pode fechar o portátil e o trabalho continua.

Pré-requisitos

Antes de começar, confirme o seguinte:

O plano Free oferece uma utilização mensal limitada nos modelos Haiku e MiniMax — suficiente para completar todos os passos deste tutorial. Se quiser seguir o tutorial com os modelos Opus ou Sonnet, uma subscrição Pro ou Max desbloqueia limites de tokens mais elevados.

Passo 1: Crie a Sua Conta e Explore a Interface

Aceda a https://happycapy.ai/signup e crie a sua conta com um endereço de email. Depois de confirmar o email e iniciar sessão, chega ao painel Home. Reserve 60 segundos para se orientar antes de tocar em qualquer coisa.

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

• Desktops — os seus espaços de trabalho de projeto, com nome.
• Agents — as personas de IA que configura e reutiliza.
• Skills — os plugins de capacidades que os seus agentes podem invocar.

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

Passo 2: Crie o Seu Primeiro Desktop

Os Desktops são espaços de trabalho de projeto, com nome, com um diretório partilhado persistente em ~/a0/workspace/<desktop-id>/. Todos os ficheiros que o seu agente cria ou lê residem aqui, e várias sessões podem ser executadas em paralelo sobre os mesmos ficheiros — o que torna o Happycapy fundamentalmente diferente de uma janela de chat.

Para criar o seu primeiro Desktop:

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

Agora tem um ambiente de ficheiros isolado. Pense nele como uma pasta de projeto num computador na cloud que nunca desliga. A página de funcionalidades dos Desktops aborda opções avançadas, como partilhar um Desktop entre vários agentes e configurar workflows paralelos — guarde essa página para depois de terminar este tutorial.

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

Passo 3: Construa o Seu Primeiro Agente de IA

Um Agente de IA no Happycapy é uma persona personalizável, definida por cinco ficheiros de configuração em Markdown: SOUL, USER, IDENTITY, MEMORY e AGENTS. Não precisa de editar todos os cinco no primeiro dia — o Happycapy fornece predefinições sensatas para cada um.

Eis o que cada ficheiro controla:

Para criar o seu primeiro agente:

1. Clique em "+ New Agent" na barra lateral.
2. Dê-lhe um nome (por exemplo, Research Assistant).
3. Selecione um modelo — utilize Haiku 4.5 para este tutorial.
4. No ficheiro USER, adicione uma linha a descrever-se: I am a [your role] who needs help with [your main task type].
5. Deixe todos os outros ficheiros com as predefinições.
6. Clique em Save Agent.

Pode ler mais sobre a configuração de agentes na página de funcionalidades dos AI Agents, que aborda o empilhamento avançado de personas e o encaminhamento multimodelo.

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

Passo 4: Instale a Sua Primeira Skill

As Skills são plugins leves — tipicamente com o tamanho de alguns kilobytes — que ampliam o que o seu agente consegue fazer. O Happycapy suporta o protocolo MCP e tem mais de 300 000 Skills disponíveis. Instalar uma demora cerca de 20 segundos.

Para este tutorial, instale uma Skill de gestão de ficheiros para que o seu agente consiga ler, escrever e organizar ficheiros no espaço de trabalho do seu Desktop:

1. Aceda a Skills na barra lateral.
2. Utilize a barra de pesquisa para encontrar File Manager (ou qualquer Skill relevante para o seu trabalho).
3. Clique em Install.
4. No ecrã de confirmação, atribua a Skill ao seu agente Research Assistant.
5. Clique em Confirm.

Depois da instalação, abra uma sessão com o seu agente e escreva:

List all files currently in my workspace.

O seu agente irá invocar a Skill File Manager, analisar ~/a0/workspace/<desktop-id>/ e devolver a lista de ficheiros. Se o espaço de trabalho estiver vazio, dirá isso mesmo — esse é o resultado correto nesta fase.

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

Passo 5: Execute a Sua Primeira Tarefa Automatizada

Agora que o seu Desktop, agente e Skill estão prontos, é altura de automatizar algo. Neste passo, vai atribuir ao seu agente uma tarefa com várias partes, usando linguagem simples — sem código, sem criador de workflows.

No chat da sessão, escreva o seguinte (adapte o tema a algo relevante para si):

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 a percorrer cada instrução sequencialmente. Vai:

1. Criar o ficheiro Markdown no diretório partilhado do seu Desktop.
2. Escrever a estrutura pedida.
3. Guardar e confirmar a conclusão.

Este é um exemplo simples, mas o mesmo padrão é aplicável a workflows complexos: resumir uma pasta de PDFs, gerar um relatório semanal a partir de um CSV, ou redigir e enviar emails. O limite das capacidades é o que um ser humano consegue fazer com um computador — não um menu fixo de ações predefinidas.

Resultado esperado: Um ficheiro chamado weekly-summary.md aparece na árvore de ficheiros do seu espaço de trabalho, com a estrutura que descreveu.

Passo 6: Agende uma Automação Recorrente

O último passo leva-o de tarefas pontuais para uma verdadeira operação 24 horas por dia, 7 dias por semana. O Happycapy permite-lhe agendar sessões para que o seu agente seja executado numa hora definida, sem que esteja presente.

Para agendar uma tarefa diária:

1. Abra o 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, introduza a instrução que quer 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 o seu agente Research Assistant.
5. Clique em Save Schedule.

A partir deste momento, o agente irá "acordar" às 08:00 UTC, verificar o espaço de trabalho e processar quaisquer ficheiros novos que encontrar — quer esteja online ou não.

Resultado esperado: O agendamento aparece na lista de agendamentos do seu Desktop, com uma indicação de hora "Next run". Pode desativá-lo ou editá-lo a qualquer momento.

Verificação — Confirmar Que Tudo Funciona

Depois de concluir todos os seis passos, faça esta lista de verificação rápida:

☐ O seu Desktop está visível na barra lateral e tem uma árvore de ficheiros não vazia (pelo menos weekly-summary.md). ☐ O seu agente está listado em Agents com um modelo atribuído. ☐ A Skill File Manager (ou a Skill escolhida) mostra o estado "Installed" no agente. ☐ Ao abrir uma nova sessão e escrever list files, obtém um resultado sem erros. ☐ O trabalho agendado mostra uma hora futura de "Next run" no painel de agendamento do Desktop.

Se todas as cinco caixas estiverem verificadas, o seu espaço de trabalho Happycapy está totalmente operacional.

Problemas Comuns

P: O meu agente diz que não consegue aceder aos ficheiros no espaço de trabalho. R: Confirme que a Skill File Manager está atribuída a esse agente específico, e não apenas instalada globalmente. Vá a Skills → Installed → assign to agent.

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

P: O trabalho agendado não foi executado à hora esperada. R: Verifique se o agendamento está definido para UTC, e não para o seu fuso horário local. Por predefinição, os agendamentos do Happycapy são executados em UTC.

P: O meu agente está a repetir informação que não pedi. R: Abra o ficheiro de configuração SOUL do seu agente e adicione uma linha: Be concise. Answer only what is asked. Guarde e inicie uma nova sessão.

P: Criei um Desktop mas não consigo encontrar os ficheiros da minha sessão. R: Os ficheiros são escritos em ~/a0/workspace/<desktop-id>/. Certifique-se de que abriu a sessão a partir de dentro do Desktop correto, e não a partir de uma sessão de agente autónoma.

Ir Além Deste Tutorial

Depois de consolidar o básico, eis três passos naturais a seguir:

1. Execute workflows em paralelo — crie um segundo Desktop para um projeto diferente e execute ambos os agentes em simultâneo. Cada Desktop tem o seu próprio sistema de ficheiros isolado, pelo que não há contaminação cruzada. Consulte a página de funcionalidades dos Desktops para configurar sessões em paralelo.
2. Instale uma Skill de media — o Happycapy suporta modelos de geração de media, incluindo o Gemini e o Seedream. Adicione uma Skill de geração de imagens ao seu agente e peça-lhe para produzir imagens de capa juntamente com relatórios escritos.
3. Explore a documentação completa de introdução — o guia de introdução aborda atalhos de teclado, pesquisa no histórico de sessões e como exportar ficheiros do espaço de trabalho para a sua máquina local.

Em Números

Perguntas Frequentes

P: Preciso de saber programar para usar o Happycapy? R: Não. O Happycapy foi concebido para todos — descreve o que precisa em linguagem simples e o agente trata da execução. O conhecimento de programação é opcional e só é necessário se 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 ficheiros partilhado que se mantém entre sessões. Uma sessão é uma única conversa executada com um agente dentro desse Desktop. Várias sessões podem partilhar os mesmos ficheiros do Desktop em simultâneo.

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

P: Em que é que o Happycapy difere do ChatGPT ou de outras IAs de chat? R: O Happycapy executa um computador completo na cloud — não é apenas uma interface de chat. Pode assumir o controlo do ambiente na cloud, gerir ficheiros, executar scripts, agendar tarefas recorrentes e operar 24 horas por dia, 7 dias por semana, sem que esteja presente. As IAs conversacionais respondem a prompts; o Happycapy executa trabalho autónomo em várias etapas.

P: Quantos agentes posso criar?

P: Posso partilhar um Desktop com um colega de equipa?

Próximos Passos — Comece a Sua Conta Gratuita

Agora tem tudo o que precisa para colocar o Happycapy a trabalhar: um Desktop para armazenamento persistente de ficheiros, um agente de IA configurado, uma Skill instalada e uma automação agendada em execução contínua. A forma mais rápida de tornar isto real é começar com uma tarefa que faz manualmente todas as semanas — um relatório, um resumo, um briefing de investigação — e entregá-la hoje ao seu agente. Crie a sua conta gratuita do Happycapy em /signup e execute a sua primeira automação antes do final do dia.