Melhores práticas

Use estas recomendações para tornar as execuções do Cloud Agent mais confiáveis.

Configure o ambiente primeiro

Use Configuração do agente em nuvem para que o Cursor tenha o ambiente configurado. Assim como um desenvolvedor humano, o Cursor trabalha melhor quando o ambiente está configurado corretamente.

Garanta que o agente possa acessar o que precisa

Antes de executar um agente em nuvem, verifique estes pré-requisitos:

• Secrets: Certifique-se de que o agente tenha acesso aos secrets necessários (chaves de API, credenciais de banco de dados etc.) pela aba Secrets no seu dashboard. Para funções em nuvem, prefira tokens OIDC a chaves de acesso de longa duração.
• Controles de saída: Se você tiver restrições de acesso à rede ativadas, garanta que todas as URLs necessárias para o seu desenvolvimento local estejam na lista de permissões.
• Testabilidade local: Seu repositório deve estar configurado para funcionar bem localmente, sem exigir serviços externos que não possam ser acessados a partir de uma VM. Se for difícil para um desenvolvedor humano testar localmente, também será difícil para um agente.

Use skills e agents.md para configurar seu agente

Se o agente em nuvem estiver com dificuldade para testar suas alterações, recomendamos usar skills e agents.md para configurar seu agente.

Pense no agente como um desenvolvedor humano inteligente, mas com pouco contexto. A melhor forma de garantir que ele faça a coisa certa é dar a ele o contexto necessário para entender o que precisa ser feito.

Por exemplo, na Cursor, nosso agents.md lista dicas para executar e depurar os microsserviços mais usados no nosso monorepo. Também temos várias skills sobre como testar e depurar serviços principais, cada uma com instruções claras sobre quando usar a skill.

As skills contêm detalhes completos, como depurar um microsserviço específico ou configurar uma dependência de terceiros quando necessário para testes.

Use regras para fazer cumprir convenções

agentes na nuvem podem ler e seguir Regras em três níveis:

• Regras do Usuário: Definidas em Cursor Settings, elas se aplicam às suas sessões em todos os repositórios. Ideal para regras que você quer aplicar apenas para si.
• Regras da equipe: Definidas no dashboard de Regras, Comandos e Hooks, elas se aplicam a todos os membros da equipe em todos os repositórios. Ideal para convenções válidas para toda a organização.
• Regras do repositório: arquivos .cursor/rules/*.mdc versionados no repositório; elas se aplicam a todos os agentes que usam esse repositório. Ideal para convenções específicas do repositório/projeto.

Dê ao agente as ferramentas de que ele precisa

Com frequência percebemos que os agentes são limitados pelas ferramentas às quais têm acesso. Recomendamos usar MCP e criar ferramentas personalizadas para que o agente tenha acesso aos mesmos sistemas que um desenvolvedor humano teria.

Adapte as ferramentas ao agente

É importante criar ferramentas que o agente consiga usar bem. Recomendamos criar ferramentas e iterar com base nas observações de como o agente as utiliza.

Por exemplo, na Cursor criamos uma CLI personalizada para o modelo executar microsserviços na nossa base de código. Descobrimos que, ao executar comandos de desenvolvimento personalizados, por exemplo a partir de um arquivo package.json, alguns modelos esqueciam argumentos ou os agentes se distraíam com logs de build ruidosos que desenvolvedores humanos sabiam ignorar.