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, .windsurf, CLAUDE.md e AGENTS.md. Observe que o Devin não buscará automaticamente tipos de arquivos mais gerais como .md.

Melhores práticas para onboarding no Knowledge

Vale a pena investir um pouco de tempo no início para deixar o Devin bem contextualizado. Assim como acontece com uma nova pessoa contratada, compartilhar contexto relevante sobre a base de código e os fluxos de trabalho adotados pela equipe de engenharia contribuirá bastante 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 todo Knowledge gerado automaticamente e verifique (a) se está completo e (b) se as informações estão corretas.
  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 as informações forem relevantes apenas naquele contexto. Se o Knowledge não estiver fixado, ele só será usado quando acionado, então garanta que 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 criar um com uma extensão de arquivo especializada.
Visite o guia de produto do Knowledge para mais detalhes.