Cloud Agents
Os agentes funcionam em ambientes isolados na nuvem, em vez de na sua máquina local.
O que os agentes na nuvem podem fazer?
Os agentes na nuvem executam tarefas de programação sem que você precise acompanhar o processo. Eles podem desenvolver funcionalidades, corrigir bugs, escrever testes, abrir PRs e compartilhar um vídeo mostrando tudo funcionando. Cada tarefa começa em um ambiente em nuvem configurado com os repositórios, dependências, segredos e acesso à rede de que o agente precisa.
Os agentes na nuvem também podem usar ambientes com vários repositórios. Isso permite que um agente trabalhe em repositórios de frontend, backend, infraestrutura ou bibliotecas compartilhadas na mesma execução.
Como "Move to Cloud" lida com o estado dos meus arquivos?
"Move to Cloud" não cria um snapshot das suas alterações locais sem commit. O Cloud Agent começa a partir de um estado limpo do git no repositório remoto. Ele transfere seu histórico de conversa e contexto, mas não arquivos com alterações pendentes nem edições sem commit. Faça commit ou stash das suas alterações antes de mover uma conversa para a nuvem se quiser que o agente trabalhe a partir do seu estado mais recente.
Os agentes conseguem testar meu app em um navegador?
Sim. Cada agente é executado em sua própria VM isolada, com um ambiente de desktop completo. Os agentes usam mouse e teclado para controlar o desktop e o navegador, da mesma forma que um desenvolvedor humano faria.
Isso significa que os agentes podem iniciar servidores de desenvolvimento, abrir o app em um navegador, navegar pelos fluxos da UI com cliques e verificar se as alterações funcionam antes de enviar uma PR.
Como os Cloud Agents mostram o que fizeram?
Os agentes anexam capturas de tela, vídeos e referências de logs ao PR para que você possa validar as alterações sem precisar fazer checkout da branch.
Os agentes na nuvem podem usar minhas skills pessoais?
Sim. Ative Sync Skills for agentes na nuvem em Settings → Agents para copiar ~/.cursor/skills/ para os seus próprios agentes na nuvem. As skills sincronizadas continuam privadas. Veja Usar skills pessoais com agentes na nuvem.
As skills de projeto no repositório estão sempre disponíveis. Para compartilhar uma skill com os membros da equipe, publique-a no marketplace da sua equipe.
Os agentes na nuvem podem usar ferramentas MCP?
Sim. Adicione e gerencie servidores MCP pelo menu suspenso do MCP em cursor.com/agents. Isso dá aos agentes acesso a bancos de dados, APIs e serviços de terceiros durante a execução.
Os agentes na nuvem oferecem suporte a servidores HTTP e stdio, além de OAuth para servidores que precisarem disso. Consulte a página de Recursos do Cloud Agent para detalhes de configuração.
Em Self-Hosted Machines, o comportamento do MCP é diferente. Consulte Self-Hosted Machines.
Os agentes na nuvem executam hooks?
Sim. Os agentes na nuvem executam hooks baseados em comandos de .cursor/hooks.json no seu repositório. Nos planos Enterprise, eles também executam hooks de equipe e hooks gerenciados pela empresa.
Os hooks compatíveis incluem hooks de ferramenta e arquivo (beforeShellExecution, afterShellExecution, beforeReadFile, afterFileEdit, preToolUse, postToolUse, postToolUseFailure) e hooks de ciclo de vida no nível da conversa, como beforeSubmitPrompt, afterAgentResponse, afterAgentThought, stop, subagentStart, subagentStop e preCompact.
Os hooks no nível da conversa permitem observar prompts, respostas e raciocínio; controlar subagentes; reagir à compactação; e executar lógica quando uma interação é concluída. Você pode usá-los para criar loops de autocorreção em torno da saída e do raciocínio do agente.
Os hooks começam assim que o agente tem um ambiente com escrita habilitada. Hooks específicos da IDE, como hooks do Tab e workspaceOpen, não se aplicam. sessionEnd não se aplica nos agentes na nuvem gerenciados pela Cherri Code, porque eles não têm um limite de sessão vinculado ao tempo de vida do editor. Em workers de Self-Hosted Machines, sessionStart e sessionEnd são executados quando uma sessão reserva o worker e quando essa reserva é liberada. Hooks baseados em prompt também não são compatíveis com os agentes na nuvem. Hooks de nível do usuário em ~/.cursor/hooks.json não são carregados, já que a VM não tem acesso à sua configuração local.
Consulte a matriz completa de suporte a hooks para mais detalhes.
Em Self-Hosted Machines, o suporte a hooks corresponde ao dos Cloud Agents gerenciados, com algumas diferenças. Consulte Self-Hosted Machines.
Os agentes na nuvem podem corrigir falhas de CI?
Sim. Os agentes na nuvem tentam corrigir automaticamente falhas do GitHub Actions em PRs que eles criam. Eles ignoram verificações que também estão falhando na branch base. No momento, esse recurso está disponível nos planos Teams.
Para desativar isso em uma PR específica, comente @cursor autofix off. Para reativar, comente @cursor autofix on. Você também pode desativar isso globalmente no Cherri Code Dashboard > Cloud Agents > My Settings.
O que preciso para usar agentes na nuvem?
Os agentes na nuvem estão disponíveis em todos os planos pagos do Cherri Code.
Como faço para configurar agentes na nuvem?
Crie um novo ambiente no dashboard de agentes na nuvem. Você vai conectar sua conta do GitHub, GitLab, Azure DevOps ou Bitbucket Cloud, selecionar um ou mais repositórios, adicionar segredos ou variáveis de ambiente e verificar a configuração. Consulte o guia completo de configuração para ambientes multi-repo, segredos com escopo de ambiente, acesso à rede e Dockerfiles.
Como faço para usar o seletor redesenhado de projetos e repositórios?
O seletor de projetos reúne etapas comuns de configuração em um só lugar. Você pode:
- Criar um projeto sem sair do seletor
- Conectar GitHub, GitLab ou Azure DevOps no próprio seletor
- Pesquisar projetos por local: Este Computador, Cloud ou uma máquina remota
- Remover um projeto de Recentes com um clique
As Máquinas Remotas foram integradas ao mesmo fluxo do seletor, para que você possa abrir trabalho local, na Cloud e remoto em um só lugar.
Como faço para iniciar uma tarefa de agente em nuvem?
- No Cherri Code: Selecione Cloud no menu suspenso abaixo do campo de entrada do agente
- Na web: Acesse cursor.com/agents
- Via Slack: Use @Cherri Code
- No GitHub: Comente @cursor em uma PR ou issue
- No Bitbucket Cloud: Comente @cursor em uma PR
- No Linear: Use @Cherri Code em uma issue
- Via API: Use a API do agente em nuvem
Quais são os limites de anexos para agentes na nuvem na web?
Em cursor.com/agents, documentos e imagens têm um limite de 4 MB por arquivo. Vídeos têm um limite separado de 15 MB por arquivo. O navegador rejeita arquivos acima desses limites antes do upload, portanto alterar a janela de contexto do modelo ou ativar o Max Mode não aumenta o limite de anexos.
Os formatos de documento suportados incluem PDF, Markdown (.md e .markdown), texto simples (.txt), CSV, JSON, HAR, XML, YAML (.yaml e .yml), TOML, INI e arquivos de log (.log).
Se um arquivo for grande demais:
- Mantenha apenas o conteúdo de que o agente precisa ou divida o arquivo em partes de 4 MB ou menos
- Para logs e textos estruturados como JSON, CSV, XML ou HAR, mantenha apenas o intervalo de tempo e as solicitações relevantes, em vez da captura completa
- Inicie o agente em nuvem pelo Cherri Code desktop e anexe o arquivo por lá, já que os limites de anexo podem ser diferentes dos do app web
- Para arquivos não sensíveis que já estejam no source control, peça ao agente que os leia do repositório com checkout feito
Arquivos ZIP não são suportados como anexos de documento na web. Antes de anexar arquivos de diagnóstico, remova credenciais, cookies, headers, source code e dados pessoais que você não queira compartilhar.
Como é cobrado o uso do agente em nuvem?
O uso dos agentes em nuvem é cobrado conforme os preços da API do modelo selecionado. Você pode selecionar o tamanho da janela de contexto para os modelos compatíveis. Uma janela de contexto maior pode aumentar o uso de tokens e os custos.
Posso executar agentes de nuvem automaticamente ou com um cron?
Sim. Use Automations para executar agentes de nuvem em uma programação agendada ou com base em eventos no GitHub, Slack, Linear, PagerDuty ou webhooks. Configure tudo em cursor.com/automations. Consulte a documentação do Automations para ver os tipos de gatilho e os modelos.
O Modo de Privacidade funciona com os agentes de nuvem?
Sim. Os agentes de nuvem estão disponíveis no Modo de Privacidade. Consulte a página de segurança do agente de nuvem para mais detalhes.
Os agentes em nuvem podem federar com a AWS ou outras nuvens sem chaves de longa duração?
Sim. As VMs de agente em nuvem gerenciadas pelo Cherri Code podem emitir JWTs OIDC de curta duração por meio de um socket local. Os verificadores usam os endpoints públicos de descoberta e JWKS do Cherri Code para verificar a assinatura e autorizar com base em claims como sub, team_id e cloud_agent_id.
Os agente na nuvem podem ler seu próprio ID, proprietário ou turno atual na VM?
Sim. As VMs de agente em nuvem gerenciadas pelo Cherri Code disponibilizam uma API de metadados do agente no mesmo socket local dos Tokens OIDC. Uma solicitação GET a um caminho como /v1/meta-data/agent/id retorna o valor puro como texto.