Orientando agentes

Oriente o agente com prompts de texto no campo de mensagem do chat. Você pode anexar contexto, imagens e voz, além de trocar de modelo a qualquer momento.

menções com @

Digite @ no campo de mensagem do chat para anexar um contexto específico ao prompt. Comece a digitar após @, e o Cherri Code mostrará sugestões correspondentes.

• Arquivos e pastas: @auth.ts ou @src/components/ para incluir arquivos ou pastas (digite / após selecionar uma pasta para navegar mais profundamente)
• Terminais: @Terminals para incluir a saída do terminal como contexto
• Chats: @Chats para referenciar o contexto de uma conversa anterior
• Diffs do Git: @Commit (Diff of Working State) para alterações não commitadas ou @Branch (Diff with Main) para o diff completo da branch
• Navegador: @Browser para anexar contexto do navegador integrado

Use menções com @ quando souber quais arquivos são relevantes. Se não tiver certeza de quais arquivos importam, não as use — o agente encontra arquivos relevantes por conta própria.

Modos personalizados

Digite / no campo de mensagem do chat para acionar uma habilidade. Ao pressionar Enter, a habilidade é anexada a uma mensagem e desaparece à medida que a conversa avança. Use qualquer habilidade como Modo personalizado para manter o agente focado nela enquanto trabalha.

Selecione a habilidade no menu / e pressione Option+EnterAlt+Enter (Mac) ou Alt+Enter (Windows). Você também pode selecionar Usar como modo na entrada da habilidade. Em um modo, a habilidade permanece no contexto a cada turno, mesmo enquanto o agente trabalha por horas, até que você saia do modo.

Modos personalizados funcionam bem para habilidades que descrevem como trabalhar, em vez de uma tarefa pontual. Mantenha uma lista de verificação para revisão de código ativa enquanto percorre vários arquivos ou deixe um guia da equipe, como /tdd, ativo durante toda uma funcionalidade.

Modos personalizados estão disponíveis na Janela de Agentes e na CLI. Qualquer habilidade com um bloco de frontmatter válido pode servir de base para um modo, e os campos opcionais de frontmatter icon e color definem o estilo do selo do modo. Consulte Usar uma habilidade como Modo personalizado.

Entrada de imagens

Anexe imagens ao prompt para fornecer contexto visual para trabalho com UI, depuração e implementação de designs.

• Arraste e solte um arquivo de imagem no campo de mensagem do chat
• Cole da área de transferência com Cmd+VCtrl+V, incluindo capturas de tela

Isso é útil para implementar mockups de design, depurar problemas visuais e consultar mensagens de erro ou stack traces sem precisar transcrevê-los manualmente.

Entrada de voz

Clique no ícone de microfone no campo de mensagem do chat para ditar seu prompt em vez de digitá-lo. Fale naturalmente, inclua detalhes técnicos, como nomes de arquivos e funções, e revise a transcrição antes de enviar.

Uso do contexto

Cada chat compartilha uma janela de contexto fixa com o modelo. À medida que você adiciona arquivos, executa ferramentas e troca mensagens, esses tokens ocupam espaço. Quando a janela fica quase cheia, o Cherri Code compacta partes mais antigas da conversa em um resumo para liberar espaço para novas mensagens.

O anel de contexto ao lado do campo de entrada do prompt mostra rapidamente o quanto da janela está preenchido. Clique no anel para abrir o painel de detalhamento, que mostra o total de tokens usados por categoria:

• Prompt do sistema: instruções integradas do Cherri Code para o modelo
• Ferramentas: definições de todas as ferramentas disponíveis para o agente
• Regras: regras do projeto e do usuário incluídas no prompt
• Habilidades: descrições de habilidades inseridas no contexto do sistema
• MCP: instruções e catálogo dos servidores MCP conectados
• Subagentes: documentação sobre os tipos de subagentes que o agente pode iniciar
• Conversa resumida: resumos compactados de turnos anteriores
• Conversa: suas mensagens, as respostas do agente e os resultados das ferramentas

Passe o cursor sobre um segmento da barra ou uma linha da lista para destacar essa categoria.

Alterar modelos

Use o menu suspenso do seletor de modelos na parte superior do campo de mensagem do chat para mudar de modelo ou pressione Cmd /Ctrl / para alternar entre os modelos. A alteração se aplica à conversa atual a partir desse momento. Defina um modelo padrão em Cherri Code Settings > Modelos.

• Modelos mais rápidos funcionam bem para edições rápidas e tarefas rotineiras
• Modelos mais avançados são melhores para raciocínios complexos e refatoração em vários arquivos

Você pode mudar de modelo no meio da conversa, por exemplo, quando um modelo mais rápido foi usado para explorar o código, mas você precisa de um raciocínio mais aprofundado para a implementação. Consulte Modelos e preços para ver a lista completa.