Knowledge está descontinuado e será removido em uma atualização futura. O Knowledge existente está sendo migrado automaticamente para Skills em Plugins — a migração está sendo liberada gradualmente e não exige nenhuma ação de sua parte. Use Skills para novas instruções e contexto que você queira compartilhar com Devin.
Assim como ao integrar um novo engenheiro, integrar o Devin exige um investimento inicial em transferência de conhecimento.
Knowledge é um conjunto de dicas, conselhos e instruções que o Devin pode consultar em todas as sessões. Você pode continuar adicionando ao repositório de Knowledge do Devin ao longo do tempo, e o Devin recuperará automaticamente o Knowledge relevante conforme necessário.
Use o recurso Knowledge para compartilhar documentação, dicas, bibliotecas internas personalizadas e outros materiais de que o Devin possa precisar.
Como crio um item do Knowledge?
Navegue até Settings → Resources → Knowledge e clique em Create knowledge no canto superior direito.
Sua Trigger Description ajudará o Devin a recuperar o Knowledge relevante nos momentos certos. Isso pode ser uma frase simples. Devin buscará um item do Knowledge quando o trabalho atual estiver relacionado aos gatilhos especificados, e todo item do Knowledge exige uma Trigger Description.
O Content deve conter algumas frases com informações relevantes.
Você pode atribuir uma macro a qualquer item do Knowledge — um identificador curto que começa com ! (por exemplo, !deploy-checklist). As macros permitem que você faça referência rapidamente ao Knowledge nos seus prompts digitando o nome da macro. As macros podem conter apenas letras, números e hífens, e devem ser exclusivas na sua organização.
Ativando e desativando o Knowledge
Cada item de Knowledge pode ser ativado ou desativado individualmente para cada usuário. Desativar um item de Knowledge impede que Devin o recupere nas suas sessões, sem excluí-lo da organização. Isso é útil quando um item de Knowledge não é relevante no momento para o seu trabalho, mas pode ser útil para colegas de equipe ou no futuro.
Devin irá sugerir automaticamente Knowledge para lembrar com base no seu feedback no chat. Edite o Knowledge sugerido antes de salvar ou descarte-o se ele não for útil.
Você também pode pedir para Devin regenerar uma sugestão de Knowledge com base no seu feedback. Isso pode facilitar a iteração sobre o Knowledge sugerido em vez de editá-lo manualmente. Devin também pode sugerir atualizações para itens de Knowledge existentes, além de sugerir novos itens de Knowledge.
O que deve ser incluído em Knowledge?
Recomendamos incluir os aspectos dos seus prompts ou playbooks que você costuma repetir com frequência. Exemplos incluem bugs comuns e suas soluções associadas, práticas de conformidade/padronização de código, fluxos de trabalho de implantação (deployment), fluxos de trabalho de teste, como interagir com ferramentas proprietárias, etc.
Organizando o Knowledge em pastas
Você pode organizar itens do Knowledge em pastas para facilitar o gerenciamento. As pastas oferecem suporte a:
- Hierarquia aninhada — Crie subpastas para build uma árvore de Knowledge estruturada.
- Ativação/desativação em massa — Ative ou desative uma pasta inteira. Quando uma pasta está desativada, todos os itens do Knowledge dentro dela ficam desativados para suas sessões.
- Mover itens — Arraste itens do Knowledge entre pastas ou use a ação de mover para reorganizar.
- Organização automática — Selecione vários itens do Knowledge e deixe o Devin classificá-los automaticamente em pastas lógicas.
As pastas são especialmente úteis quando sua organização tem um grande número de itens do Knowledge que abrangem diferentes equipes, projetos ou fluxos de trabalho.
- Crie Knowledge específicas voltadas para um único fluxo de trabalho ou ação. Devin lê todo o conteúdo da Knowledge, então mantenha tudo relevante e atualizado!
- Divida sua Knowledge em unidades menores sempre que possível. Devin é capaz de acessar vários “itens” de Knowledge ao mesmo tempo.
- Crie o hábito de adicionar e atualizar Knowledge. Elas são compartilhadas em toda a sua organização e melhorarão continuamente o Devin para sua equipe ao longo do tempo.
- Devin consulta Knowledge quando relevante, não todas de uma vez ou apenas no início. Certifique-se de que o gatilho de recuperação seja altamente relevante para o conteúdo.
- Use pastas para agrupar Knowledge relacionadas (por exemplo, por projeto, equipe ou fluxo de trabalho), para que você possa ativar ou desativar rapidamente conjuntos de Knowledge conforme seu foco muda.
Knowledge da organização e do Enterprise
O Knowledge pode ter escopo de uma única organização ou de todo o seu Enterprise. O que a página Knowledge exibe depende da organização em que você está:
- Organizações não primárias — A página Knowledge tem duas abas:
- Organização (padrão) — Itens de knowledge com escopo da sua organização atual. Eles ficam visíveis para todos os membros da organização e são o escopo padrão para novos itens de knowledge.
- Sugestões — Sugestões de knowledge geradas por IA com base nas suas interações nas sessões.
- Organização primária — A página Knowledge exibe uma única visualização do knowledge do Enterprise, sem abas. O knowledge do Enterprise se aplica a todas as organizações do seu Enterprise, e os admins do Enterprise o criam e gerenciam aqui.
Organizações não primárias não têm uma aba Enterprise. Se a sua organização pertence a um Enterprise, use o link Looking for enterprise knowledge? na página Knowledge para abrir o knowledge do Enterprise na organização primária do seu Enterprise.
Os itens de knowledge do Enterprise são especialmente úteis para compartilhar padrões de código válidos para toda a empresa, diretrizes de arquitetura, procedimentos de deployment e outros contextos que devem valer de forma uniforme para todas as equipes e organizações.
Se um item de Organization Knowledge no nível da organização se mostrar útil o suficiente para ser compartilhado em todo o seu Enterprise, você poderá promovê-lo diretamente no editor de conhecimento. Abra o item e clique em Promote to Enterprise na aba Details. O item é movido do escopo da organização para o escopo do Enterprise e fica disponível para todas as organizações no seu Enterprise.
A promoção exige permissões de gerenciamento de conhecimento do Enterprise e está disponível apenas para itens de conhecimento criados por usuários em organizações que pertencem a um Enterprise.
Fixando Knowledge em repositórios
Você pode escolher se o Knowledge se aplica a nenhum repositório, a um repositório específico ou a todos os repositórios:
- Fixando em nenhum repositório: o Knowledge só é usado quando o Devin decide que é relevante para o seu contexto atual.
- Fixando em um repositório específico: o Knowledge é sempre usado sempre que o Devin estiver trabalhando nesse repositório específico.
- Fixando em todos os repositórios: o Knowledge é aplicado automaticamente a todo repositório em que o Devin estiver trabalhando em qualquer sessão.