Configurações do agente na nuvem
Os administradores do espaço de trabalho podem configurar o agente na nuvem no dashboard do agente na nuvem.
Gerenciamento de ambientes
A visualização Ambientes lista os ambientes salvos disponíveis para sua equipe. Os ambientes podem ser associados a um repositório ou a um grupo de repositórios.
Abra um ambiente para revisar:
- Os repositórios aos quais ele se aplica
- Se ele usa um snapshot ou
.cursor/environment.json - O script de instalação executado durante as Builds
- Segredos de tempo de execução e segredos de build
- Configurações de acesso à rede
- Histórico de versões, Builds e execuções de configuração
Use Atualizar com Agente quando quiser que o Cherri Code inspecione o ambiente atual e proponha uma nova configuração. Use Nova Execução de Configuração quando quiser que o Cherri Code configure o ambiente do zero. Use Restaurar no histórico de versões para reativar uma versão anterior do ambiente.
A aba Builds mostra as versões preparadas do ambiente disponíveis para agentes na nuvem. Você pode inspecionar logs, acionar uma Build, escolher ou fixar a Build ativa e iniciar um agente a partir de uma Build específica. Consulte Cloud Agent Builds para mais detalhes.
Configurações padrão
- Modelo padrão – o modelo usado quando uma execução não especifica um. Escolha qualquer modelo disponível para agentes em nuvem.
- Repositório padrão – se estiver vazio, os agentes pedirão ao usuário que escolha um repositório. Informar um repositório aqui permite pular essa etapa.
- Branch base – a branch da qual os agentes fazem fork ao criar pull requests. Deixe em branco para usar a branch padrão do repositório.
Configurações de acesso à rede
Defina quais recursos de rede os agentes na nuvem podem acessar. As configurações de usuário e equipe incluem três modos:
- Permitir todo o acesso à rede – sem restrições de domínio.
- Padrão + lista de permissão – os domínios padrão e todos os domínios que você adicionar.
- Somente lista de permissão – apenas os domínios que você adicionar explicitamente.
Usuários, Admins da equipe e proprietários de ambientes podem configurar o acesso à rede. As configurações de ambiente podem herdar a política do usuário ou da equipe, adicionar uma lista de permissão do ambiente ou definir seu próprio modo de acesso. Consulte Acesso à rede para mais detalhes.
Configurações de segurança
Todas as opções de segurança exigem privilégios de administrador.
- Exibir resumo do agente – controla se o Cherri Code mostra imagens de diff de arquivos e trechos de código do agente. Desative esta opção se preferir não exibir caminhos de arquivos ou código na barra lateral.
- Exibir resumo do agente em canais externos – amplia a opção anterior para o Slack ou qualquer canal externo conectado.
- Mensagens de acompanhamento da equipe – controla se membros da equipe podem enviar mensagens de acompanhamento a agentes em nuvem criados por outros usuários da equipe. Consulte mensagens de acompanhamento da equipe abaixo.
Configurações de funcionalidades da equipe
Admins da equipe podem ativar ou desativar estas funcionalidades para a equipe:
- Agentes de longa execução – controla se os membros da equipe podem executar agentes por períodos prolongados. Admins podem ativar ou restringir esse recurso no nível da equipe. A execução prolongada ainda não está disponível para ambientes multirrepositório. Selecionar um ambiente multirrepositório desativa o toggle.
- Uso do computador – controla se os agentes podem usar recursos de interação com o computador (disponível apenas para equipes corporativas).
As alterações são salvas instantaneamente e afetam novos agentes imediatamente.
Mensagens de acompanhamento da equipe
Os membros da equipe podem enviar mensagens de acompanhamento para agentes em nuvem criados por outros usuários da mesma equipe. Isso é útil quando um colega inicia um agente e você precisa redirecioná-lo, adicionar contexto ou continuar o trabalho enquanto ele estiver indisponível.
As mensagens de acompanhamento dependem da visibilidade do agente. Um colega precisa conseguir visualizar o agente antes de enviar mensagens de acompanhamento: ele deve pertencer à mesma equipe do Cherri Code e ter seu próprio acesso ao repositório do agente. Consulte Compartilhe agentes com sua equipe.
Os admins da equipe controlam esse comportamento nas configurações de segurança do agente na nuvem, com três opções:
| Configuração | Comportamento |
|---|---|
| Desativado | Apenas o criador original pode enviar mensagens de acompanhamento para seu agente. Mensagens de acompanhamento da equipe não são permitidas. |
| Somente contas de serviço | Os membros da equipe podem enviar mensagens de acompanhamento para agentes criados por uma conta de serviço, mas não para agentes criados por outros usuários humanos. |
| Todos | Qualquer membro da equipe pode enviar mensagens de acompanhamento para qualquer agente da equipe, independentemente de quem o criou. |
Ativar as mensagens de acompanhamento da equipe significa que um usuário pode influenciar a execução de um agente em nuvem que usa os segredos e as credenciais de outro usuário. Uma mensagem de acompanhamento pode instruir o agente a ler variáveis de ambiente, imprimir segredos nos logs, enviar credenciais para um endpoint externo ou executar ações usando os tokens de acesso do criador original.
Um membro da equipe com permissões limitadas pode elevar seu nível de acesso ao direcionar um agente que possui os segredos de um usuário com mais privilégios. Trate essa configuração com o mesmo cuidado que teria com chaves SSH compartilhadas ou credenciais de serviço.