O que é o Knowledge?
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 Conteúdo deve conter algumas frases com informações relevantes.Macros
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.Sugestões de Knowledge
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.
Dicas e truques
- 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.
Promovendo o Organization Knowledge para o Enterprise
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.
Perguntas frequentes sobre a migração de Knowledge para Skills
As notas do Knowledge estão sendo descontinuadas e substituídas pelas Skills, a forma padrão de fornecer instruções reutilizáveis ao Devin. O próprio Devin está migrando suas notas para skills. Nada muda para sua equipe no dia da transição, e você não precisa fazer nada.Como uma nota é convertida em uma skill
Por exemplo, esta nota:
se torna esta skill:
SKILL.md
Perguntas frequentes
O Devin se comporta de forma diferente?
O Devin se comporta de forma diferente?
Não. As skills migradas são carregadas com base na descrição, assim como as notas eram carregadas com base no gatilho.
Onde encontro as skills migradas?
Onde encontro as skills migradas?
No app do Devin, em Customize → Plugins → Knowledge, agrupadas de acordo com as suas pastas originais.
Onde as skills ficam armazenadas?
Onde as skills ficam armazenadas?
No Devin, assim como as suas notas. Diferentemente das skills que você comita em um repositório como arquivos
SKILL.md, as skills migradas ficam em plugins gerenciados pelo Devin, e não nos seus repositórios. Nada é comitado nos seus repositórios, e você não precisa adicionar nem manter nenhum arquivo.Como edito uma skill migrada?
Como edito uma skill migrada?
Acesse Customize → Skills e abra a skill para editá-la. As skills da organização podem ser editadas por administradores da organização e por membros com a permissão Manage Knowledge; as skills do Enterprise, por administradores do Enterprise.
Como devo adicionar orientações daqui para frente?
Como devo adicionar orientações daqui para frente?
Escreva Skills. Elas funcionam em qualquer lugar onde o Devin é executado: no web app, na CLI e no Devin Desktop.
Para usuários da API
Quais endpoints da API são afetados?
Quais endpoints da API são afetados?
Os endpoints de notas do Knowledge
/v3/organizations/{org_id}/knowledge/notes[/{note_id}] e /v3/enterprise/knowledge/notes[/{note_id}], além dos endpoints /knowledge/folders correspondentes.O que os substitui?
O que os substitui?
No caso das notas, os endpoints de skills (v3 beta), em
/v3beta1/organizations/{org_id}/managed-plugins e /v3beta1/enterprise/managed-plugins:Os endpoints de listagem são paginados com
first e after, assim como os demais endpoints v3.Como acesso uma nota migrada pela API?
Como acesso uma nota migrada pela API?
As notas migradas ficam no pacote
knowledge, identificadas pelo slug. Liste todas com GET .../managed-plugins/bundles/knowledge/skills ou obtenha uma específica com GET .../managed-plugins/bundles/knowledge/skills/deploying-to-staging.