Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

Para ver boas práticas abrangentes, consulte também Instruindo Devin com eficácia e Boas vs. Más Instruções.
Devin precisa de orientação sobre quais são suas preferências e como verificar se está na direção certa. Se nada for especificado, Devin tomará suas próprias decisões. Recomendamos seguir uma estrutura simples nos seus prompts para garantir que Devin permaneça no caminho certo e verifique seu próprio trabalho:

O quê

Descreva a tarefa que você quer que Devin conclua.Exemplo: Atualizar meu projeto de Java 7 para Java 8.

Como

Descreva algumas orientações de boas práticas e o que evitar para Devin ao concluir a tarefa (por exemplo, fazer deploy usando Modal etc.).Exemplo: Identificar e substituir APIs obsoletas do Java 7 por seus equivalentes no Java 8. Analisar a base de código em busca de possíveis melhorias usando recursos de linguagem e APIs do Java 8.

Resultado

Descreva os resultados ou comportamentos esperados que Devin deve testar para saber quando a tarefa está completa.Exemplo: Executar a suíte de testes e verificar se todos os testes passam com sucesso. Fazer o build do projeto usando a configuração atualizada do Java 8 e verificar se a aplicação está no ar e em execução.

​
Escolhendo as Tarefas Certas

Ao decidir o que delegar ao Devin, procure tarefas que tenham:
  1. Critérios de Sucesso Claros
    • Tarefas em que o sucesso pode ser validado automaticamente
    • Ciclos de feedback integrados (testes, compilação, verificações de lint)
    • Medidas objetivas de qualidade
  2. Escopo Adequado
    • Limites bem definidos e requisitos claros
    • Padrões claros a seguir na sua codebase
    • Como regra geral, tarefas que levariam três horas ou menos para você são uma ótima opção
  3. Elementos Repetitivos
    • Tarefas que exigem mudanças semelhantes aplicadas muitas vezes
    • Variações que dificultam o uso de scripts simples
    • Exemplos existentes a serem seguidos
  4. Exemplos Comuns
    • Atualizações de versão em vários pacotes
    • Adicionar cobertura de testes a módulos sem testes
    • Converter arquivos para usar novos padrões
    • Implementar componentes de UI padronizados

​
Divida tarefas complexas em subtarefas mais simples, ao longo de várias sessões

O Devin tem mais chances de sucesso se projetos complexos forem divididos em subtarefas claras. Por exemplo, em vez de pedir ao Devin para atualizar o código da sua aplicação, a suíte de testes e a configuração de CI em uma única sessão, pode ser melhor dividir isso em três sessões separadas. Você pode executá-las em paralelo pedindo ao Devin para delegar para Devins gerenciados. Para tarefas particularmente complexas, recomendamos trabalhar com o Devin em várias sessões separadas, já que o desempenho do Devin às vezes pode piorar à medida que a sessão fica mais longa.

​
Diga ao Devin como verificar seu progresso

O Devin tem o melhor desempenho quando recebe etapas de verificação claras para validar seu trabalho. Isso ajuda a garantir que a tarefa seja concluída corretamente e permite que o Devin identifique possíveis problemas cedo. Aqui está uma lista não exaustiva de maneiras de ajudar o Devin a verificar seu trabalho:
  1. Especifique os requisitos de teste
    • Peça ao Devin para executar suítes de teste específicas
    • Defina quais testes devem passar
    • Solicite métricas de cobertura de testes, se relevante
  2. Defina checkpoints e subtarefas claros
    • Divida tarefas complexas em subtarefas verificáveis e inicie uma sessão do Devin para cada subtarefa
    • Defina o que caracteriza o sucesso para cada subtarefa e, opcionalmente, checkpoints dentro de cada subtarefa
    • Peça ao Devin para informar o progresso após concluir cada checkpoint / subtarefa
  3. Explique ao Devin como revisar o próprio trabalho Especifique como o Devin pode verificar se está no caminho certo. Por exemplo:
    • Ao trabalhar com conjuntos de dados: “Verifique se o conjunto de dados tem pelo menos 500 linhas e contém as colunas X, Y, Z”
    • Ao modificar APIs: “Confirme se o endpoint retorna código de status 200 e inclui todos os campos obrigatórios”
    • Ao atualizar a interface: “Verifique se o componente é renderizado sem erros no console e corresponde à especificação de design”
Quanto mais específico você for em relação aos requisitos de validação, com mais confiança o Devin poderá seguir com a tarefa sem intervenção.

​
Seja claro e específico

Forneça instruções e requisitos claros e detalhados para o Devin. Por exemplo:
  1. Especifique as principais etapas necessárias para concluir uma tarefa
  2. Indique repositórios, bibliotecas, branches etc. específicos com os quais você quer que o Devin trabalhe
Nada é “óbvio demais” para o Devin, mas ele fará o possível para esclarecer e fazer perguntas ao longo do processo.

​
Use Playbooks

Para tarefas repetitivas ou complexas, recomendamos usar e iterar em Playbooks. Playbooks são prompts fáceis de reutilizar e compartilhar. Por exemplo, se você quiser que Devin trate falhas recorrentes em builds de CI, pode criar um playbook que inclua as etapas gerais que Devin deve seguir sempre para resolver o problema, sem precisar incluí-las em cada prompt.

​
Forneça referências ou exemplos

Quando possível, inclua links para documentação ou exemplos relevantes para a tarefa. Se você não fornecer nenhum recurso, o Devin poderá procurar a documentação por conta própria.

​
Comece agora!

Faça perguntas ao Devin e dê instruções enquanto ele trabalha, assim como você faria com qualquer outro colega de equipe!