Sua primeira sessão

Inicie sua primeira sessão e veja do que o Devin é capaz

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 a sua base de 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.

Prefere trabalhar no terminal? O Devin CLI permite iniciar sessões diretamente pela linha de comando. Instale em 2 minutos com curl -fsSL https://cli.devin.ai/install.sh | bash.

​

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.

​

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.

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.

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:

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.

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.

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.

Os agentes disponíveis incluem:

• Devin (padrão) — Um engenheiro de software de IA de propósito geral para criar recursos, corrigir bugs, refatorar código e executar a maioria das tarefas de desenvolvimento.
• Modo Rápido — Um modo otimizado para tarefas rápidas e bem delimitadas.
• Dana — Um agente analista de dados otimizado para consultar bancos de dados, analisar dados e criar visualizações.

Se você não tiver certeza de qual agente usar, o agente padrão do Devin funciona bem para a maioria das tarefas.

Você não precisa iniciar uma nova sessão para mudar de modo. Você pode alternar o agente no meio da sessão usando o controle de agente ao lado da caixa de mensagem na página da sessão — a mudança entra em vigor na sua próxima mensagem. No Slack, você pode alternar modos no meio da sessão começando uma mensagem com !ultra, !fast, !lite, !fusion, !swe ou !normal (consulte palavras-chave de modo no Slack).

​

Usando menções com @

Use menções com @ para dar ao Devin 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 do Knowledge
• @Playbooks - Referencie um playbook da equipe ou da comunidade, que são templates de prompt detalhados que podem ser usados para orientar o comportamento do Devin
• @Skills - Referencie uma skill definida no seu repositório (procedimentos reutilizáveis versionados como arquivos SKILL.md)
• @Secrets - Referencie um secret específico (por exemplo, Chaves de API, credenciais etc.) do gerenciador de sessões do Devin
• @Sessions - Referencie uma sessão anterior do Devin para dar contexto

Menções com @ ajudam o Devin a entender exatamente com o 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 de que ele precisa — 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 corrigir pequenos bugs até refatorações direcionadas, migrações em larga escala e criar recursos inteiros 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 Devins gerenciados.

​

Ideias de primeiros prompts

Adicionar um novo endpoint de API

Pequenos recursos de front-end

Escrever testes unitários

Migração ou refatoração de código existente

Atualizar APIs ou consultas ao banco de dados

Crie um PR rápido (recomendamos usar este prompt em um Playbook)

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

Explorar casos de uso

Explore exemplos práticos em fluxos de trabalho de engenharia — cada um inclui prompts que você pode experimentar imediatamente.

​

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:

Integrações

Conecte o Devin às suas ferramentas existentes, como GitHub, Slack, Jira e muito mais.

Playbooks

Aprenda a usar Playbooks para realizar tarefas.

Knowledge

Adicione Knowledge para ajudar o Devin a entender melhor as práticas da sua equipe.