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 Cherri Code tenha o ambiente configurado. Assim como um desenvolvedor humano, o Cherri Code 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. Faça commit das skills do projeto no repositório, sincronize skills pessoais para seus próprios agentes em nuvem ou publique uma skill para que os membros da equipe possam instalá-la.

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 Cherri Code, 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 Cherri Code 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 Cherri Code 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.