WeKnora: como documentos viram respostas, tarefas de agentes e uma Wiki

O desafio de usar documentos internos com IA não é apenas encontrar um trecho relevante. É permitir que um assistente responda com base nele, que um agente o consulte durante uma tarefa mais longa e que o conteúdo continue organizado para consultas futuras. Essa é a proposta do WeKnora, plataforma de código aberto desenvolvida pela equipe Weixin, da Tencent. O plugin para DeepSeek Harness acrescenta uma forma de acessar esse conhecimento a partir de outro agente — não substitui o WeKnora. 11621

Uma base, três formas de trabalhar

• Perguntas e respostas com RAG: a plataforma recupera informações da base para fundamentar respostas a consultas do dia a dia. RAG é a sigla em inglês para geração aumentada por recuperação. 18
• Agente ReAct: para tarefas com várias etapas, pode combinar busca nos documentos, pesquisa na web, ferramentas MCP e habilidades disponíveis no ambiente. MCP é um protocolo de conexão com ferramentas e fontes externas. 18
• Modo Wiki: transforma material de origem em páginas Markdown interligadas, acompanhadas de um grafo visual de conhecimento. O projeto também descreve edição manual, histórico de revisões e reversão de alterações. Chamar essa Wiki de “automanutenível” expressa o fluxo pretendido, não elimina a necessidade de conferir as páginas geradas com os documentos originais. 18

As capacidades mais recentes incluem ambientes isolados de execução de habilidades que persistem durante a sessão, com opções baseadas em Docker, E2B ou Cube para lidar com arquivos e executar tarefas. Há também memória entre conversas: segundo a equipe Weixin, sugestões de informações a guardar precisam da aprovação do usuário antes de serem usadas. Um espaço de trabalho pode ainda ser exposto por um endpoint MCP para que clientes externos pesquisem a base e façam perguntas. 161216

O projeto é da equipe Weixin, e uma análise o associa à plataforma de diálogos do WeChat. Descrições de seus canais citam ainda o WeChat corporativo e outros aplicativos de mensagens. Essas integrações não devem ser confundidas com o plugin do DeepSeek Harness, que é um caminho distinto para acessar uma instalação do WeKnora. 451621

O que dizem as mais de 25 mil estrelas

Uma análise publicada em setembro registrou 25.863 estrelas para o repositório no GitHub; uma reportagem anterior no mesmo mês citava 23.400. São retratos de momentos diferentes, não uma contagem atual fixa. Os números sinalizam interesse de desenvolvedores, mas não comprovam precisão das respostas, eficácia dos controles de acesso ou confiabilidade e segurança de uma implantação específica. 46

O que o plugin entrega ao DeepSeek Harness

O @wxg-prc-cpg/dsh-weknora oferece a um agente no Harness quatro ferramentas de leitura para uma instância do WeKnora já implantada: listar bases de conhecimento acessíveis, fazer busca híbrida, ler um documento por páginas e solicitar uma resposta gerada pelo próprio WeKnora — via RAG ou agente — com citações das fontes. A ferramenta de respostas pode retornar um identificador de sessão para perguntas posteriores. “Somente leitura” descreve as ferramentas oferecidas ao Harness; não garante que toda ação interna de um fluxo com agente no WeKnora seja livre de efeitos. 2124

A divisão de responsabilidades é importante: o WeKnora fornece os documentos, a recuperação de informações e as respostas que ele próprio gerar; o Harness coordena seu agente e decide como usar os trechos ou respostas recebidos. A API HTTP do WeKnora documenta chaves de API vinculadas a um espaço de trabalho e chaves de abrangência da plataforma, além de outras formas de autenticação. A credencial e seu escopo precisam corresponder à configuração do serviço e do plugin. A credencial usada pelo modelo no Harness tem outra finalidade. 172136

Para o perfil web do Harness, o comando publicado é: 21

dsh plugin --profile web add @wxg-prc-cpg/dsh-weknora

Esse comando instala o plugin, não o servidor WeKnora. É preciso apontá-lo para uma instância já implantada e acessível e seguir as instruções do pacote para configuração e credenciais. A página do pacote mostra WEKNORA_BASE_URL como parâmetro para indicar o serviço; consulte a documentação completa antes de definir outras variáveis de ambiente. 21

Antes de usar com documentos sensíveis

Reportagens de setembro afirmam que a integração foi verificada com DeepSeek Harness 0.1.0-rc.8 e WeKnora 0.7.2. Separadamente, um catálogo apresenta o plugin dsh-weknora 0.1.0 como “Verified”, enquanto a documentação do WeKnora descreve recursos da v0.8.0. São versões de componentes diferentes: isso não demonstra que todas as combinações posteriores foram testadas, nem transforma o selo de um catálogo em auditoria de segurança. 120424348

Na prática, vale fixar e testar as versões exatas do servidor, do plugin e do Harness em conjunto. Confira quais bases e documentos a credencial configurada consegue acessar, se as citações sustentam as respostas, se a leitura paginada cobre o documento inteiro e como a integração lida com tempo limite. Verifique também que texto confidencial chega ao agente que fez a chamada. Popularidade no GitHub e presença em um catálogo ajudam a descobrir o projeto; não substituem essas verificações. 243648