Curso
Building AI Agents with Google ADK
1 h
3.3K
Se você clicou neste artigo, provavelmente usa um dos agentes de codificação com inteligência artificial já existentes e quer ver como o Roo Code se sai. Bom, se eu tivesse que resumir o Roo Code em poucas palavras, seria:
- Código aberto
- Vários modos de interação e personagens
- Tarefas boomerang
- Sistema de pontos de verificação tipo Git
- Personalização profunda
- Gerenciamento avançado de contexto
Essas são as vantagens que o Roo Code tem além dos recursos comuns que todos os agentes de codificação de IA oferecem, como suporte a MCP, chat de base de código, execução de comandos de terminal e edições de arquivos.
Neste tutorial, vamos explorar o Roo Code e todos os seus recursos mencionados em profundidade e compará-lo com o Cline. Vamos ver exemplos práticos e como seus diferentes modos de interação fazem com que ele se destaque no concorrido mercado de agentes de IA.
O que é o Roo Code e o que ele faz?
O Roo Code é um assistente de codificação de IA de código aberto que funciona como uma extensão do VS Code. Diferente das ferramentas típicas de preenchimento automático, ela funciona como um parceiro de desenvolvimento personalizável que pode criar arquivos, executar comandos de terminal, navegar em sites e lidar com tarefas de várias etapas em modos especializados. Você tem controle detalhado sobre tudo, desde permissões de aprovação automática até provedores de indexação de código-fonte.
A ferramenta dá suporte a vários provedores de IA, incluindo Anthropic, OpenAI, Google Gemini, AWS Bedrock e modelos locais por meio do Ollama. Ele entende grandes bases de código por meio de indexação semântica configurável e inclui automação de navegador, suporte a protocolos MCP e condensação de contexto inteligente para projetos complexos.
É isso que faz o Roo Code ser diferente:
- Vários modos de interação: Alterne entre os modos Arquiteto (planejamento), Código (implementação), Perguntar (perguntas), Depuração (resolução de problemas) e modos personalizados para diferentes fases de desenvolvimento.
- Perfis de configuração: Atribua diferentes modelos e configurações de IA a modos específicos, como usar o o3 para planejamento de arquitetura e o Claude Sonnet 4 para execução de código.
- Tarefas do Boomerang: Coordenar fluxos de trabalho complexos que mudam automaticamente entre diferentes modos e personas
- Gerenciamento avançado de contexto: Configure limites de contexto, habilite a condensação automática e controle exatamente quais informações serão incluídas em cada conversa.
- Indexação personalizável da base de código: Escolha seus próprios provedores de incorporação e bancos de dados vetoriais para pesquisa semântica de código, com controle total sobre o comportamento da pesquisa e a privacidade.
Essa combinação transforma o Roo Code de um simples assistente em um ambiente de desenvolvimento configurável que se adapta aos seus padrões de fluxo de trabalho e se ajusta aos requisitos do projeto.
Instalando e configurando o Roo Code
O Roo Code pode ser instalado facilmente através do marketplace de extensões do VS Code:
Depois de instalar, reinicie o VS Code (ou o Cursor, Windsurf) e a extensão Roo Code aparecerá na barra lateral esquerda. Clique nele e siga as instruções na tela que vão te guiar pela criação da conta e configuração inicial. Você deve ver essa interface:
Depois, você vai precisar escolher um provedor de modelo nas configurações, já que o Roo Code é de código aberto e não inclui créditos pré-pagos:
A Roo Code trabalha com todos os principais fornecedores de IA, grandes e pequenos. Embora eu pessoalmente use exclusivamente modelos Claude, você pode escolher roteadores de terceiros, como OpenRouter, Requesty, ou soluções empresariais, como Google Vertex e AWS Bedrock. Eu sugiro começar com o OpenRouter.
O Roo Code dá um crédito de US$ 5, e você pode configurar com só uma chave API e ter acesso a todos os modelos que o OpenRouter oferece (quase todos os modelos que você imaginar). Depois de configurar a chave API do OpenRouter, não esqueça de rolar a página de configurações e ativar o raciocínio para o modelo que você escolheu (vamos usar o Claude 4 Sonnet neste tutorial):
Agora você está pronto para começar a usar o Roo Code!
Como usar o código Roo: 7 exemplos práticos
Nesta seção, vamos explorar todos os principais recursos do Roo Code enquanto criamos um jogo simples de jogo da velha 4x4. Esse exemplo é simples o suficiente pra manter os custos da API baixos pra experimentação, ao mesmo tempo que é completo o suficiente pra mostrar todos os recursos.
Vamos começar!
Configurando a aprovação automática
No começo, falamos que o Roo Code dá um controle quase total sobre o que o agente de codificação faz. Essa afirmação se reflete em todos os recursos que o Roo Code tem a oferecer, começando pelas configurações de aprovação automática:
O controle detalhado das configurações de aprovação automática é importante porque permite que você decida exatamente quais ações da IA acontecem automaticamente e quais precisam da sua aprovação antes. Você pode deixar tarefas rotineiras, como edições rápidas de código, rolarem sem parar, enquanto mantém ações maiores, como exclusões de arquivos ou comandos de terminal, sob revisão manual para evitar surpresas indesejadas.
Usando diferentes modos no Roo Code
O Roo Code tem uma abordagem cuidadosa ao desenvolvimento baseado em IA, o que o diferencia de ferramentas como o Cursor ou o Windsurf. Enquanto a maioria dos IDEs agenticos te levam direto para o modo de execução assim que você descreve o que quer, o Roo Code entende que começar a codificar sem um planejamento adequado muitas vezes leva a problemas.
Quero criar um jogo da velha 4x4 em Python com uma interface de terminal simples.
O jogo deve permitir que dois jogadores joguem por turnos, detectar vitórias em linhas, colunas,
e diagonais, e puxões de alça. Deve ter elementos coloridos, não só preto e branco, mas o esquema de cores precisa ser bem simples.
Pense nas desvantagens da execução imediata: código que não se alinha à sua arquitetura mais ampla, implementações apressadas que criam dívida técnica e soluções que deixam passar casos extremos porque não houve tempo para pensar nos requisitos. Esses problemas se acumulam com o tempo, criando dores de cabeça com a manutenção e te obrigando a revisar trabalhos que já estavam “concluídos”.
É por isso que o Roo Code oferece diferentes modos de interação para diferentes fases do desenvolvimento de software:
- Modo Arquiteto: Planeje e projete antes de implementar
- Modo de código: Escrever, modificar e refatorar código
- Modo de pergunta: Receba respostas e explicações
- Modo de depuração: Diagnosticar e resolver problemas de software
- Modo Orquestrador ( ): Coordenar tarefas em vários modos
- Modos personalizados: Crie suas próprias personas especializadas, como redator de documentação ou especialista em refatoração.
Você pode trocar de modo no menu suspenso no canto inferior esquerdo ou usar comandos como /ask, /architect, /debug, /code na caixa de bate-papo. Eu curto muito ter um modo dedicado pra fazer perguntas que não afetam seu projeto ou seu código — algo que eu faço o tempo todo nos meus projetos. Em outros IDEs, isso significa mudar para um novo tópico de chat ou usar o chatGPT/Anthropic, o que sempre atrapalha meu fluxo de trabalho.
Esses modos não são só variações de um único agente com diferentes comandos. Cada modo vem com ferramentas pré-definidas e permissões de acesso definidas pela equipe do Roo Code. Por exemplo, enquanto o modo Arquiteto é só para leitura no seu projeto, o modo Código tem acesso a todas as ferramentas, como edição, comandos de terminal e MCPs.
O modo de depuração merece destaque porque usa uma abordagem matemática para reduzir as possibilidades de erros, com instruções personalizadas para refletir, destilar possibilidades, adicionar registros (algo que os LLMs raramente fazem, a menos que sejam explicitamente instruídos) e confirmar antes de corrigir.
Recursos adicionais do modo que os tornam poderosos:
- Modelos fixos: Você pode atribuir a cada modo um modelo de IA diferente, como o3 para Architect e Claude Sonnet 4 para execução de código (uma combinação poderosa). Esses modelos atribuídos continuam mesmo quando você troca de modo ou reinicia o VS Code.
- Comutação sensível ao contexto: O Roo pode pedir permissão para mudar de modo no meio de uma tarefa, dependendo do contexto, garantindo que você esteja sempre usando a ferramenta certa para o trabalho.
- Personalização total: Se os modos integrados não atenderem às suas necessidades, você pode ajustar as solicitações do sistema (embora isso não seja recomendado), adicionar instruções personalizadas ou criar modos totalmente personalizados para suas tarefas específicas. Dá uma olhada na documentação sobre modos personalizados para ver instruções detalhadas sobre como criar suas próprias personas especializadas.
Jogo final criado pelo Roo. A grade de referência de posição parece errada porque todos os LLMs têm problemas com a contagem e o alinhamento da saída no terminal.
Usando perfis de configuração
Outra coisa legal do Roo Code é poder criar perfis de configuração personalizados. Enquanto os modos de interação determinam o comportamento do agente, os perfis de configuração permitem personalizá-lo no nível da API, criando várias configurações LLM com diferentes definições de modelo.
Depois de configurar um provedor como o OpenRouter, você vai ver um perfil padrão ao lado do modo de interação no canto inferior esquerdo da interface. Ao abrir as configurações, você vai ver que esse perfil padrão tem ajustes específicos para o modelo que você escolheu, tipo Claude 4 Sonnet, com limites de raciocínio, limites de taxa e parâmetros de temperatura específicos.
Ao clicar no ícone de mais, você pode criar perfis de configuração adicionais que podem ser atribuídos posteriormente a diferentes modos de interação. Isso abre algumas possibilidades interessantes:
- Para um modo personalizado de redator de documentação, você pode escolher o Gemini 2.0 Flash com baixa temperatura para criar documentação rapidamente.
- Crie outro perfil com o máximo de fichas de pensamento para o modo arquiteto ou modo de depuração quando precisar de planos estratégicos complexos ou correções persistentes de bugs.
- Defina configurações de temperatura diferentes para tarefas criativas e trabalhos analíticos.
- Configure perfis especializados para diferentes provedores de modelos, alternando entre OpenAI, Anthropic ou modelos locais com base na tarefa.
A possibilidade de combinar modelos e configurações específicas com modos de interação específicos te dá um controle que você não encontra em outras plataformas de agentes. Você pode usar o o3 mini para cuidar do planejamento arquitetônico enquanto o Claude Sonnet 4 executa o código de verdade, cada um com suas próprias configurações otimizadas.
Configuração de indexação da base de código
O Roo Code permite que você configure outro aspecto que a maioria das plataformas de codificação mantém escondido: a indexação da base de código. Esse recurso permite fazer perguntas em linguagem natural, tipo “Como funciona a autenticação?” ou “Mostre onde apagamos os registros dos clientes”, mesmo quando você não sabe as funções específicas ou os nomes dos arquivos.
Enquanto outros IDEs escondem seus provedores de incorporação dos usuários, o Roo Code te dá controle total sobre como sua base de código é indexada e pesquisada. Essa transparência é importante porque diferentes modelos de incorporação se destacam em diferentes tarefas, e você pode querer processamento local para projetos confidenciais ou soluções em nuvem por conveniência.
O sistema precisa de dois componentes para funcionar:
- Um provedor de incorporação para transformar código em vetores pesquisáveis
- Um banco de dados vetorial para guardar e procurar esses vetores
Para o provedor de incorporação, você pode escolher entre:
- Google Gemini (agora de graça e recomendado pra quem tá começando)
- OpenAI (modelos de incorporação de texto)
- Ollama (para operação totalmente local)
- Provedores compatíveis com OpenAI (como implantações do Azure)
Para o banco de dados vetorial, suas opções incluem:
- Qdrant Nuvem com um plano gratuito para experimentação
- Qdrant local rodando no Docker para total privacidade
Não custa nada experimentar as duas configurações.
Além de escolher seus provedores, o Roo Code permite que você ajuste o comportamento da pesquisa:
- Limite da pontuação da pesquisa: Controla o quanto o código precisa ser parecido com a sua consulta. Valores mais baixos (0,15–0,3) trazem resultados mais amplos, bons para explorar, enquanto valores mais altos (0,6–0,8) só mostram correspondências precisas. O padrão de 0,4 equilibra precisão e cobertura.
- Resultados máximos da pesquisa: Define quantos trechos de código são retornados em uma única pesquisa para controlar o contexto sem sobrecarregar a IA.
A flexibilidade de configuração traz várias vantagens:
- Pesquisa semântica: Encontre o código pelo significado, em vez de palavras-chave exatas
- Descoberta entre projetos: Pesquise em todos os arquivos, não só nos que estão abertos agora.
- : reconhecimento de padrões: Encontre implementações e padrões de código parecidos no seu projeto
- Controle de privacidade: Mantenha tudo local com Ollama e Docker Qdrant, ou use provedores de nuvem por conveniência
O sistema de indexação respeita os padrões de ignorar do seu projeto de .gitignore e .rooignore, então não vai perder tempo processando pastas de dependências como node_modules. Ele também fica de olho nas mudanças nos arquivos e atualiza o índice automaticamente, pra que suas pesquisas fiquem atualizadas enquanto você programa.
Configurando o contexto
A janela de contexto é talvez a restrição mais importante dos modelos de codificação. O tamanho da janela determina a quantidade de informações que a IA pode considerar de uma só vez, afetando diretamente sua capacidade de entender seu projeto e tomar decisões informadas em vários arquivos.
É por isso que a engenharia de contexto é super importante, que é o processo de projetar o fluxo de informações que entra no contexto do modelo. Mais uma vez, o Roo Code permite que você tenha controle de baixo nível sobre o que entra no contexto e o que não entra.
Nas configurações, tem um painel separado pra configurar o contexto. A partir daí, você pode ver as opções para configurar:
- Limite de contexto das guias abertas: Controla quantos arquivos abertos são incluídos automaticamente
- Limite de contexto dos arquivos do espaço de trabalho: Define o número máximo de arquivos da área de trabalho que podem ser lidos.
- Limite de leituras simultâneas de arquivos: Controla quantos arquivos podem ser processados ao mesmo tempo
- Linhas lidas por arquivo: Limita o número de linhas lidas de cada arquivo (-1 para o arquivo inteiro)
Se você rolar para baixo no mesmo painel, verá outra opção para ativar automaticamente a condensação inteligente de contexto. O que isso faz é que, quando a janela de contexto atinge um certo limite, um prompt de resumo personalizado (você mesmo pode escrevê-lo) é acionado. Isso resume o contexto apenas ao resumo, liberando espaço para continuar a conversa e o seu trabalho.
Em IDEs como Cursor ou Windsurf, você precisa mudar para um novo tópico de bate-papo quando atingir os limites de contexto. Ao fazer isso, as informações da conversa atual vão se perder ou você vai ter que fazer um trabalho manual para mover as informações para a nova conversa.
Execução e configuração de comandos no terminal
O Roo Code pode se conectar automaticamente ao terminal interno do VS Code, executar comandos e ler resultados em tempo real. Se preferir, também tem uma opção de terminal embutido mais rápido que mostra os resultados direto na interface do chat.
Embora a execução do terminal exista em outras plataformas de agentes, as opções de personalização do Roo Code o diferenciam. O sistema de integração de shell funciona automaticamente, sem precisar de configuração, e oferece várias funcionalidades:
- Execute comandos e leia a saída sem precisar copiar e colar manualmente
- Detecta e corrige automaticamente erros em aplicativos em execução
- Programa os códigos de saída dos comandos e as alterações no diretório de trabalho
- Pare de executar comandos diretamente da interface de chat
Você pode configurar várias opções específicas do terminal nas configurações:
- Limite de saída do terminal: Controla a quantidade de saída do comando que é capturada e adicionada ao contexto (padrão: 500 linhas)
- Comprimir a saída da barra de progresso: Processa saídas dinâmicas, como barras de progresso, de forma mais clara, mostrando só o estado final em vez de cada atualização.
- Desative a integração do shell do terminal: Quando marcado (recomendado), o Roo usa seu terminal embutido. Quando desmarcado, ele executa comandos dentro do painel do terminal do VS Code.
O sistema também lida bem com configurações complexas de shell. Se você estiver usando o ZSH com o Oh My Zsh e o powerlevel10k, ou outras configurações personalizadas, o Roo Code oferece soluções alternativas específicas e configurações de tempo limite para shells que demoram mais para inicializar. Também tem opções específicas para quem usa o PowerShell no Windows e nas configurações WSL.
Recursos de qualidade de vida
Além dos principais recursos que abordamos, o Roo Code inclui muitas melhorias bem pensadas que tornam o desenvolvimento diário mais suave e produtivo.
@menções de contexto para uma coleta de informações completa
As @menções de contexto são uma maneira incrível de incluir informações específicas direto nas suas conversas. Você pode fazer referência a arquivos, pastas, saída do terminal, commits do git, problemas do VS Code e até imagens usando o símbolo @ na caixa de entrada do chat. Isso facilita dar ao Roo Code exatamente o contexto que ele precisa, sem precisar copiar e colar manualmente.
Integração do MCP com o mercado de um clique
O Roo Code oferece uma integração robusta com o integração com MCP (Model Context Protocol) com um mercado dedicado para instalação de servidor com um clique. Embora o mercado tenha opções limitadas no momento, você pode ajudar abrindo pull requests para adicionar servidores MCP oficiais ao repositório repositório Roo Code. Isso abre o acesso a ferramentas e serviços externos especializados que ampliam as capacidades do Roo Code muito além dos recursos integrados.
Gerenciamento de pontos de verificação com Git sombra
A gestão de pontos de verificação funciona por meio de um repositório Git paralelo que é executado junto com o seu código existente. Isso dá uma segurança pro seu trabalho, permitindo que você crie pontos de restauração e acompanhe as mudanças sem mexer no seu fluxo normal de trabalho do Git. Você pode facilmente voltar aos estados anteriores se algo der errado durante o desenvolvimento.
Gerenciamento de bate-papo e acompanhamento de custos
Uma janela dedicada ao gerenciamento de bate-papos ajuda você a organizar suas conversas, filtrando-as com base no espaço de trabalho, data de criação, uso de tokens, consumo da janela de contexto e custos reais da API. Essa visibilidade dos padrões de uso e despesas ajuda você a entender e controlar seus custos de desenvolvimento de IA, mantendo seu trabalho organizado.
Modo importação/exportação e marketplace
Você pode importar e exportar modos personalizados como arquivos de texto, facilitando o compartilhamento de práticas de codificação entre os membros da equipe. Também tem um mercado separado para modos, onde você pode compartilhar seus modos personalizados para outras pessoas usarem com importações de um clique. Isso ajuda a padronizar as abordagens entre as equipes e compartilhar fluxos de trabalho comprovados.
Otimização rápida integrada
Um botão sempre visível no campo de entrada do chat permite que você otimize e melhore suas mensagens antes de enviá-las. Você pode até escrever seu próprio prompt “otimizador de prompt” na página de configurações dedicada, adaptando o processo de otimização às suas necessidades e estilo específicos.
Ações do navegador através do uso do computador
Você pode ativar as ações do navegador através dos recursos de uso do computador nas configurações. Isso permite que o Roo Code interaja diretamente com aplicativos da web, abrindo possibilidades para testes, web scraping e interações automatizadas com ferramentas baseadas em navegador.
Para mais dicas sobre como aproveitar ao máximo esses recursos, dá uma olhada na página de dicas e truques na documentação do Roo Code.
Cline contra. Código Roo
Roo Code e Cline têm o mesmo DNA, mas evoluíram em direções diferentes. O Roo Code começou como “Roo Cline”, um fork do projeto Cline original. Os desenvolvedores por trás do Roo Code viram potencial na base do Cline, mas queriam ir além — afastando-se das dependências do LangChain, melhorando o desempenho e adicionando recursos como vários modos de interação e opções de personalização avançadas. A mudança da marca para “Roo Code” mostrou essa visão mais ampla e um foco mais claro nos desenvolvedores.
Enquanto Cline dá ênfase à simplicidade e à parceria, a Roo Code aposta no controle e na flexibilidade. A abordagem “human-in-the-loop” da Cline significa que toda ação precisa ser aprovada — perfeita para desenvolvedores que querem estar envolvidos em cada decisão. O Roo Code segue um caminho diferente com seu sistema de modos, permitindo que você alterne entre o modo Arquiteto, que é só para planejar, o modo Código, que é mais focado na execução, ou o modo Depuração, que é mais especializado. Esse controle detalhado vai desde provedores de indexação de código até limites de saída do terminal.
Os conjuntos de recursos refletem essas diferentes filosofias:
- Pontos fortes de Cline: Separação entre planejamento e ação, sistema de banco de memória, configuração mais simples, integração ativa com o mercado MCP, gerenciamento de pontos de verificação após cada chamada de ferramenta
- Pontos fortes do Roo Code: Vários modos de interação, perfis de configuração, indexação personalizável da base de código, tarefas boomerang para fluxos de trabalho complexos, condensação de contexto
- Recursos compartilhados: Código aberto, suporte MCP, controle de pontos de verificação/versões, regras personalizadas, preço por uso
Escolha de acordo com o seu estilo de desenvolvimento e necessidades. O Cline funciona melhor quando você quer um parceiro de IA direto que te mantém informado sobre todas as mudanças — ideal para um desenvolvimento cuidadoso e metódico ou quando se trabalha com bases de código críticas. O Roo Code é ideal para desenvolvedores que querem ajustar o comportamento do seu assistente de IA, experimentar diferentes modos de funcionamento ou precisam de configurações específicas para diferentes tipos de projetos. Ambas as ferramentas respeitam o seu controle sobre o processo de desenvolvimento; elas só oferecem diferentes níveis de personalização para alcançá-lo.
Conclusão e recursos adicionais
O Roo Code é feito pra quem trabalha com projetos grandes e complexos que precisam de um gerenciamento cuidadoso do contexto e um controle preciso do comportamento dos agentes. Para projetos pequenos a médios ou prototipagem rápida, os requisitos de configuração do Roo Code podem ser excessivos. Se você está começando a programar com IA, recomendo começar com Cline por sua abordagem mais simples, ou até mesmo com o Cursor, que é um chatGPT avançado diretamente no seu VS Code.
O Roo Code funciona melhor quando você é um usuário experiente que já entende de agentes de codificação com inteligência artificial e quer ter controle total sobre seus fluxos de trabalho. O tempo que você gasta aprendendo os sistemas de configuração vale a pena quando você precisa de recursos como atribuições de modelos específicos para cada modo, indexação personalizada da base de código ou coordenação de tarefas boomerang.
Pra mais recursos sobre assistentes de codificação de IA, dá uma olhada nesses recursos:
