> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Conhecimento
> Compartilhe contextos e conhecimentos importantes para ajudar na integração do Devin
## 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é a aba **Knowledge** na página **Settings & Library** 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.
### 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.
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.
## Dicas e truques
1. 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.
2. 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.
3. 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.
4. 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 Enterprise
Para clientes Enterprise, a página Knowledge é dividida em abas separadas para ajudar você a gerenciar Knowledge em diferentes escopos:
* **Organization Knowledge** — Itens de Knowledge com escopo na sua organização atual. Eles são visíveis para todos os membros da organização e são o escopo padrão para novos itens de Knowledge.
* **Suggestions** — Sugestões de Knowledge geradas por IA com base nas suas interações na sessão (exibidas para organizações não primárias).
* **Enterprise Knowledge** — Itens de Knowledge que se aplicam a todas as organizações da sua Enterprise. Visível apenas quando você pertence a uma conta Enterprise. Admins Enterprise podem criar e gerenciar Knowledge em nível de Enterprise a partir dessa aba.
Usuários da organização primária veem uma única aba **Enterprise Knowledge**. Usuários de organizações não primárias com uma conta Enterprise veem as três abas, com Organization Knowledge como padrão. Usuários de organizações não primárias sem uma conta Enterprise veem apenas Organization Knowledge e Suggestions.
Itens de Enterprise Knowledge são particularmente úteis para compartilhar padrões de codificação em toda a empresa, diretrizes de arquitetura, procedimentos de implantação e outros contextos que devem ser aplicados de forma uniforme em todas as equipes e organizações.
### 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.