Pular para o conteúdo principal
Antes de iniciar sua primeira sessão, verifique se você já indexou e configurou seus repositórios. Essas são as etapas fundamentais que ajudam o Devin a entender e trabalhar com o seu código.
Agora que você já concluiu a configuração, inicie sua primeira sessão com o Devin! Este guia vai mostrar a nova interface de sessão e ajudar você a entender as melhores formas de interagir com o Devin.

Entendendo a página de sessão do Devin

Quando você inicia uma nova sessão, verá dois modos principais: Ask e Agent.
A menos que você já tenha um plano totalmente definido, recomendamos começar com Ask para elaborar o plano junto com o Devin e, em seguida, mudar para o modo Agent para executá-lo.

Ask Mode

Ask Devin é um modo simples para explorar sua base de código e planejar tarefas com o Devin, sem alterar o código em si. Agora, o Ask Devin oferece suporte tanto a fazer perguntas quanto a planejar:
  • Fazer perguntas sobre como seu código funciona. Usa busca avançada em código para produzir respostas detalhadas, precisas e bem fundamentadas, com boas referências.
  • Planejar tarefas definindo escopo e planejando o trabalho antes da implementação. O Devin gera prompts ricos em contexto para sessões do Agent.
Quando você inicia uma sessão do Devin a partir do Ask Devin, o status da sessão é exibido diretamente na conversa.
Ask Mode

Ativando o modo Ask

Você pode ativar o modo Ask a partir da página principal ou de uma página do DeepWiki. Para usar o modo Ask a partir da página principal, alterne para o modo Ask e selecione o(s) repositório(s) sobre o(s) qual(is) você quer perguntar.
Modo Ask a partir da página principal
Para usar o modo Ask a partir de uma página do DeepWiki, digite uma pergunta no campo de chat na parte inferior da página e clique em Ask. Isso restringirá automaticamente o Knowledge do Devin a esse repositório específico.
Modo Ask a partir do DeepWiki
Saiba mais em nosso guia Ask Devin. Depois de trabalhar com o Devin para entender o problema e criar um plano, você estará pronto para alternar para o modo Agent.

Modo Agent

O modo Agent é o modo totalmente autônomo do Devin, em que ele pode escrever código, executar comandos, navegar na web e concluir tarefas complexas de ponta a ponta. Use o modo Agent quando estiver pronto para:
  • Implementar recursos ou corrigir bugs
  • Criar pull requests
  • Executar testes e depurar problemas
  • Realizar tarefas em várias etapas que exigem alterações de código

Acionando o Agent mode

Você pode acionar o Agent mode a partir da página principal ou de uma sessão de Ask Devin. Quando uma sessão é iniciada a partir do Ask Devin, o status dela é exibido na própria conversa do Ask Devin, para que você possa acompanhar o andamento. Para tarefas que não estão totalmente definidas, recomendamos:
  • Comece no Ask mode para planejar a tarefa
  • Construa um Devin Prompt, que usará sua sessão de Ask para criar um plano bem definido
  • Clique em Send to Devin para passar para o Agent mode e executar a tarefa
Esse fluxo é mostrado abaixo:
Ask Mode to Agent Mode
Para usar o Agent mode a partir da página principal, alterne para o Agent mode e selecione os repositórios com os quais você quer trabalhar.
Agent Mode
Ao iniciar uma sessão em Agent mode, você configurará algumas opções: selecionar um repositório e selecionar um agente.

Selecionando um repositório

Selecione o repositório no qual você deseja que o Devin trabalhe. Clique no seletor de repositório para ver todos os repositórios que foram adicionados à máquina do Devin.
Repository Selector
Selecionar um repositório garante que o Devin:
  • Tenha acesso à sua base de código e possa fazer alterações
  • Use a branch correta como ponto de partida
  • Possa criar pull requests para o repositório correto

Selecionando um agente

Você pode escolher qual configuração de agente o Devin usará na sua sessão. Diferentes agentes podem ter capacidades distintas ou ser otimizados para tipos específicos de tarefas. Atualmente, temos um agente padrão que funciona bem para a maioria das tarefas e um agente de análise de dados chamado Dana, que é otimizado para tarefas de análise de dados.
Agent Selector
Se você não tiver certeza de qual agente usar, o agente padrão funciona bem para a maioria das tarefas.

Usando menções com @

Use menções com @ para fornecer ao Devin um contexto específico sobre arquivos, repositórios ou outros recursos. Quando você digitar @ no campo de entrada do chat, verá um menu suspenso com as menções disponíveis:
  • @Repos - Referencie um repositório específico
  • @Files - Referencie um arquivo específico na sua base de código
  • @Macros - Referencie uma macro para uma entrada de Knowledge
  • @Playbooks - Referencie um playbook de equipe ou da comunidade, que são modelos de prompts detalhados que podem ser usados para guiar o comportamento do Devin.
  • @Secrets - Referencie um segredo específico (por exemplo, chaves de API, credenciais, etc.) do gerenciador de sessão do Devin
Menções com @
Menções com @ ajudam o Devin a entender exatamente em que você está trabalhando e reduzem a ambiguidade nos seus prompts.

Definindo o Escopo da Sua Primeira Sessão

Comece com tarefas que tenham critérios de sucesso claros e forneçam ao Devin o contexto necessário — assim como você faria ao repassar trabalho para um colega de equipe. À medida que for se acostumando, experimente tarefas progressivamente mais complexas. Já vimos usuários trabalharem com o Devin em tudo, desde correção de pequenos bugs até refatorações direcionadas, migrações em larga escala e criação de funcionalidades inteiras do zero.
Como regra geral: se uma tarefa levaria até três horas para você, o Devin provavelmente consegue executá-la. Para projetos maiores, divida-os em sessões focadas e execute-as em paralelo com sessões em lote.

Ideias de primeiros prompts

Se você quiser se aprofundar em exemplos mais detalhados do que o Devin pode fazer (e como), confira nossos casos de uso.

Após sua sessão

Quando Devin terminar, abra o Session Insights e clique em Gerar análise — você verá uma linha do tempo do que aconteceu, recomendações práticas e um prompt aprimorado para usar em tarefas semelhantes no futuro.

Próximos passos

Quando estiver familiarizado com sessões básicas, explore estes recursos para tirar ainda mais proveito do Devin: