Pular para o conteúdo principal

Noções básicas sobre Knowledge

Knowledge é a melhor forma de compartilhar contexto em nível de codebase (vs. nível de tarefa) que pode ajudar o Devin ao trabalhar na sua base de código. Alguns exemplos de informações para colocar no Knowledge do Devin incluem práticas de conformidade de código, fluxos de implantação, convenções de nomenclatura de PRs, fluxos de testes, como interagir com ferramentas proprietárias e muito mais. Alguns pontos importantes sobre Knowledge:
  • O Devin irá gerar automaticamente Knowledge do repositório com base nos READMEs existentes, na estrutura de arquivos e no conteúdo dos repositórios conectados. Observe que, se você não der acesso do Devin ao repositório, ele não gerará nenhum Knowledge associado.
  • O Knowledge é recuperado com base no Trigger que você definir. Quanto mais específico o trigger (por exemplo, em qual arquivo, repositório ou tipo de tarefa o Knowledge se aplica), melhor será a recuperação. Você pode encontrar mais detalhes aqui.
  • O Devin informará, em uma sessão, qual Knowledge foi usado; você pode ver isso em “Accessed Knowledge” no chat da sessão.
  • O Devin irá automaticamente buscar e atualizar Knowledge com base em arquivos especializados na sua codebase, incluindo .rules, .mdc, .cursorrules e .windsurf. Observe que o Devin não buscará automaticamente tipos de arquivos mais gerais como .md.

Boas práticas de onboarding do Knowledge

Vale a pena investir um pouco de tempo no início para deixar o Devin por dentro do contexto. Assim como com uma nova pessoa contratada, compartilhar informações relevantes sobre a base de código e os fluxos de trabalho que a equipe de engenharia segue fará muita diferença para tornar o Devin mais eficaz. Aqui estão algumas etapas recomendadas para quando você estiver configurando o Knowledge do Devin pela primeira vez:
  1. Revise qualquer Knowledge gerado automaticamente e verifique (a) a integridade e (b) a precisão.
  2. Se você quiser que o Devin consulte a nota de Knowledge sempre que estiver trabalhando em uma sessão, certifique-se de fixá-la em todos os repositórios. Caso contrário, você pode fixá-la em um repositório específico se a informação for relevante apenas nesse contexto. Se o Knowledge não estiver fixado, ele só será usado quando acionado, então garanta que a sua Trigger Description esteja clara.
  3. Se você não tiver um arquivo centralizado de documentação especializada na sua base de código, recomendamos fortemente configurar um, com uma extensão de arquivo específica para isso.
Visite o guia de produto do Knowledge para mais detalhes.