Base de conhecimento
Documentos em Markdown do workspace, ligados por wikilinks às tarefas e entre si, com versões, busca por significado e acesso dos agentes pelo MCP e pela CLI.
A base de conhecimento é a memória de longo prazo do workspace: documentos em Markdown que pessoas e agentes escrevem e consultam. É o lugar de uma decisão tomada, de uma investigação concluída, de uma convenção da equipe ou de um fato sobre o sistema que vale para tarefas futuras.
Diferente da memória de agentes, que é privada de cada agente, a base de conhecimento é compartilhada: todo documento é visível para todo o workspace.
Abrir a base de conhecimento
Abra Base de Conhecimento na barra lateral. A aba Páginas mostra a árvore de documentos; a aba Atividade mostra quem criou, editou, renomeou, moveu, restaurou ou excluiu cada documento, com filtros por autor e por ação.
Criar um documento
Escolha um modelo
Use Novo documento. Em Modelo, comece Em branco ou a partir de um dos quatro tipos, que já trazem a estrutura da página:
| Tipo | Para quê |
|---|---|
| Decisão | Uma escolha feita, o motivo e o que ela descarta. |
| Investigação | Uma pergunta pesquisada e o que foi encontrado. |
| Memória | Um fato durável sobre o sistema ou a equipe. |
| Convenção | Uma regra ou padrão que a equipe segue. |
Escolha onde ele fica
Em Página-pai, escolha um documento para que o novo fique dentro dele, ou deixe na raiz. Para mudar depois, use Mover para... no menu do documento.
Escreva em Markdown
O documento salva sozinho enquanto você escreve. No topo, defina o Tipo e as Tags, que servem de filtro na lista e na busca.
Ligar documentos e tarefas com wikilinks
Cite outro documento ou uma tarefa entre colchetes duplos:
| Escreva | Para ligar a |
|---|---|
[[Título do documento]] | Um documento, pelo título. |
[[Título do documento|texto do link]] | Um documento, mostrando outro texto. |
[[#42]] ou [[JIRA-42]] | Uma tarefa, pelo número ou pelo identificador com o prefixo do workspace. |
Os wikilinks também funcionam na descrição das tarefas. Cada documento mostra, no painel Links:
- Citado por: os documentos e as tarefas que apontam para ele;
- Links de saída: o que ele cita;
- Quebrados: links para um documento que não existe ou para uma tarefa excluída. Num link para documento inexistente, Criar documento cria a página com aquele título.
Na tarefa, a seção Base de conhecimento lista os documentos que citam a tarefa, e Novo documento ligado cria um documento já com o link.
Dica
Renomear um documento não quebra os links. O título antigo fica em Também conhecido como, e os wikilinks que usam o nome antigo continuam levando ao documento.
Buscar
A busca da base de conhecimento combina duas formas de encontrar um documento:
- por texto, com os termos que aparecem no título e no conteúdo;
- por significado, que encontra documentos sobre o mesmo assunto mesmo com outras palavras. Os resultados encontrados só assim aparecem marcados como Por significado.
Se a busca por significado não estiver disponível no momento, a busca segue só por texto, sem erro. Os filtros Autor, Tipo e Tags valem para a lista e para a busca.
Versões e conflitos
Cada gravação cria uma versão. Em Histórico, você vê as versões, quem fez cada uma e o que mudou, compara duas versões e usa Restaurar esta versão para trazer um conteúdo antigo de volta. A restauração cria uma versão nova: nada é apagado.
Se outra pessoa ou um agente alterar o documento enquanto você edita, um aviso aparece antes de sobrescrever. Em Comparar, escolha Usar a versão atual ou Manter a minha. Manter a sua grava por cima, e a versão da outra pessoa continua no histórico.
Excluir um documento
Ao excluir um documento, os subdocumentos sobem para a página-pai dele, ou para a raiz, em vez de serem excluídos. Os wikilinks que apontavam para ele passam a aparecer como quebrados.
O número de documentos pode ter um teto por workspace, em Documentos da base de conhecimento. Veja Limites do workspace.
Como os agentes usam a base
Em toda execução, o daemon entrega ao agente um servidor MCP local, jiraya-knowledge, com estas ferramentas:
| Ferramenta | O que faz |
|---|---|
knowledge_search | Busca documentos por texto, significado ou os dois, com filtros de tipo, tags e autor. |
knowledge_list | Lista documentos, dos atualizados mais recentemente para os mais antigos. |
knowledge_read | Lê um documento, com versão, tipo, tags, links e quem o cita. |
knowledge_write | Cria um documento ou atualiza um existente. |
knowledge_move | Move um documento para outra página-pai ou para a raiz. |
knowledge_history | Lista as versões de um documento. |
knowledge_restore | Restaura uma versão antiga como versão nova. |
knowledge_delete | Exclui um documento. |
Para atualizar, o agente informa a versão que leu com knowledge_read. Se o documento mudou nesse meio tempo, a gravação é recusada e o agente precisa ler de novo e juntar as mudanças, em vez de apagar o trabalho de outra pessoa.
As instruções do agente são o lugar para dizer quando consultar e o que registrar, por exemplo: "Antes de começar, busque na base de conhecimento por decisões sobre o módulo. Ao terminar uma investigação, registre o resultado como Investigação e cite a tarefa."
Pela CLI
Ferramentas de IA sem suporte a MCP usam jiraya knowledge, com as mesmas operações:
jiraya knowledge search "arredondamento do frete" --type decisionjiraya knowledge create --title "Arredondamento do frete" --type decision --tag frete --content-file ./decisao.mdjiraya knowledge update arredondamento-do-frete --content-file ./decisao.md --expected-revision 3| Comando | O que faz |
|---|---|
jiraya knowledge search <texto> | Busca. --mode escolhe text, semantic ou hybrid (padrão). |
jiraya knowledge list | Lista, com filtros --type, --tag, --author-type, --parent e --root. |
jiraya knowledge get <slug> | Mostra um documento; --revision mostra uma versão antiga. |
jiraya knowledge create --title <título> | Cria um documento; --template começa de um modelo. |
jiraya knowledge update <slug> | Altera título, conteúdo, tipo ou tags. |
jiraya knowledge move <slug> | Move para --parent <slug> ou para a raiz com --root. |
jiraya knowledge history <slug> | Lista as versões. |
jiraya knowledge restore <slug> --revision <n> | Restaura uma versão. |
jiraya knowledge delete <slug> | Exclui. |
jiraya knowledge activity | Mostra a atividade recente, inclusive exclusões. |
O documento é endereçado pelo slug, gerado a partir do título e mostrado por list, search e create. A referência completa está em jiraya knowledge.
Atenção
A base de conhecimento só aceita acesso pelo navegador ou de dentro de uma execução. Um token de acesso pessoal usado fora de uma execução recebe erro de permissão: para ler ou escrever documentos você mesmo, use o app.
Atualizado em