Cherri Code agente

O agente é o assistente do Cherri Code que pode concluir tarefas complexas de programação de forma independente, executar comandos de terminal e editar código. Acesse-o no painel lateral com Cmd+ICtrl+I.

Saiba mais sobre como os agentes funcionam e desenvolva mais rápido.

Para um volume maior de trabalho, como uma funcionalidade ou uma migração, crie um Project: um agente coordenador planeja o trabalho e o delega a outros agentes.

Como o agente funciona

Um agente é composto por três componentes:

1. Instruções: O prompt do sistema e as regras que orientam o comportamento do agente
2. Ferramentas: Edição de arquivos, busca na base de código, execução no terminal e muito mais
3. Modelo: O modelo de agente escolhido para a tarefa

O agente do Cherri Code orquestra esses componentes para cada modelo compatível, ajustando as instruções e as ferramentas para cada modelo de ponta. À medida que novos modelos são lançados, você pode se concentrar no desenvolvimento de software enquanto o Cherri Code cuida das otimizações específicas de cada modelo.

Ferramentas

As ferramentas são os componentes básicos do agente. Elas permitem pesquisar na sua base de código e na web, encontrar informações relevantes, editar arquivos, executar comandos de terminal e muito mais.

Para entender como as chamadas de ferramenta funcionam internamente, consulte os fundamentos de chamadas de ferramenta.

Não há limite para o número de chamadas de ferramenta que o agente pode fazer durante uma tarefa.

Checkpoints

Os checkpoints salvam snapshots da sua base de código durante uma sessão do agente. O agente os cria automaticamente antes de fazer alterações significativas, registrando o estado de todos os arquivos modificados.

Se o agente seguir pelo caminho errado, clique em qualquer checkpoint na linha do tempo do chat para visualizar seus arquivos naquele momento e, em seguida, restaure-os para reverter todos os arquivos àquele estado. Você também pode restaurar usando o botão Restore Checkpoint em solicitações anteriores ou o botão + ao passar o cursor sobre uma mensagem. Restaurar um checkpoint reverte apenas os arquivos; isso não remove mensagens da conversa.

Os checkpoints são úteis para trabalho exploratório, refatorações complexas e desenvolvimento iterativo, quando você precisa de pontos seguros para reverter alterações.

Mensagens enfileiradas

Você pode falar com um agente de duas maneiras enquanto ele trabalha. Enfileire uma mensagem para que ela aguarde a conclusão da tarefa atual. Enviar uma mensagem de acompanhamento agora direciona o turno ativo na próxima chamada de ferramenta do agente.

Como usar a fila

1. Enquanto o agente estiver trabalhando, digite sua próxima instrução
2. Pressione Enter para adicioná-la à fila
3. As mensagens aparecem em ordem abaixo da tarefa ativa
4. Arraste as mensagens na fila para reordená-las conforme necessário
5. O agente as processará em sequência após concluir a tarefa

Atalhos de teclado

Enquanto o agente estiver trabalhando:

• Pressione Enter para enfileirar sua mensagem (ela será enviada quando o agente concluir a tarefa atual)
• Pressione Cmd+EnterCtrl+Enter para enviar imediatamente, sem passar pela fila

Mensagens imediatas

Ao usar Cmd+EnterCtrl+Enter para enviar uma mensagem imediatamente, ela é adicionada à mensagem de usuário mais recente no chat e processada na hora, sem entrar na fila.

• Sua mensagem é anexada aos resultados das ferramentas e enviada imediatamente
• Isso proporciona uma experiência mais ágil para mensagens de acompanhamento urgentes
• Use esta opção quando precisar interromper ou redirecionar o trabalho atual do agente

Steer um agente em execução

Você pode enviar uma mensagem de acompanhamento para redirecionar o agente enquanto ele trabalha, sem interrompê-lo. Digite uma mensagem de acompanhamento e clique em Enviar agora ou pressione Enter duas vezes. A mensagem é entregue na próxima chamada de ferramenta do agente, em vez de interromper o trabalho no meio de uma ação, preservando o trabalho em andamento e mantendo o agente focado na tarefa.

Isso já está disponível em cursor.com/agents e está sendo disponibilizado gradualmente na Janela de Agentes. Para colocar a mensagem na fila para depois do turno, pressione Tab.

Na CLI, pressionar Enter enquanto o agente trabalha redireciona a execução ativa em um ponto seguro; pressionar Enter novamente interrompe o turno.

Chats laterais

Abra um chat lateral para fazer uma pergunta ou explorar um assunto paralelo sem interromper a conversa principal. Digite /side ou /btw no campo de mensagem do chat, seguido da sua pergunta (opcional), ou use o botão de mais no topo do painel de chat.

Um chat lateral é uma conversa de agente duradoura. Ele usa a thread pai como contexto de referência oculto e mantém seu próprio transcript. Faça uma @-menção ao chat lateral na thread principal para trazer esse contexto de volta.

Busca em conversas

Busque transcrições anteriores de agentes na Janela de Agentes. Pressione CmdCtrl+K no Mac ou Ctrl+K no Windows e Linux para abrir a Paleta de Comandos e, em seguida, busque em todas as conversas. O Cherri Code cria um índice de busca local.

Para encontrar texto na conversa aberta, pressione CmdCtrl+F no Mac ou Ctrl+F no Windows e Linux.

Metas com /goal

O agente trata cada mensagem como uma nova tarefa. Use /goal para dar ao agente um objetivo de longa duração em que trabalhar até que esteja totalmente concluído:

/goal corrija todos os testes instáveis e deixe o CI verde

Na CLI, Ctrl+C pausa a meta. Combine uma meta com um Modo personalizado quando quiser que o agente siga um guia, ou com a skill integrada /loop para executar um prompt ou uma skill em um intervalo recorrente ou variável. Se você não especificar um intervalo fixo, o agente escolhe quando acordar. Pare o loop quando quiser que ele termine.