WeKnora는 기업 문서를 어떻게 AI 에이전트의 지식 기반으로 바꾸나

기업 문서를 AI에 연결할 때 중요한 것은 질문에 답하는 기능만이 아니다. 같은 자료를 바탕으로 에이전트가 여러 단계를 거쳐 작업하고, 흩어진 내용을 찾아보기 쉬운 형태로 정리할 수 있는지도 관건이다. 텐센트 위신(Weixin·위챗) 팀의 오픈소스 지식 플랫폼 WeKnora는 이 세 가지 용도를 하나의 지식 기반에 묶는다. DeepSeek Harness용 플러그인은 이를 대체하는 제품이 아니라, 별도로 실행되는 에이전트가 배포된 WeKnora의 지식에 접근하는 통로다. 11621

같은 문서, 세 가지 활용 방식

• RAG 빠른 질의응답: 지식 기반에서 관련 내용을 검색한 뒤 답변에 활용한다. RAG는 문서 검색 결과를 생성형 AI의 답변에 결합하는 방식이다.
• ReAct 에이전트: 여러 단계가 필요한 작업에서 문서 검색, 웹 검색, MCP 도구, 조직별 스킬을 활용한다. MCP는 AI 도구와 외부 서비스의 연결에 쓰이는 규격이다.
• 위키 모드: 원본 문서를 서로 연결된 마크다운 페이지로 정리하고, 시각적 지식 그래프로 관계를 보여준다. 수동 편집, 수정 이력, 이전 버전으로 되돌리기도 지원한다고 프로젝트는 설명한다. 다만 ‘스스로 유지·관리하는 위키’라는 표현이 생성된 내용을 원본과 대조할 필요가 없다는 뜻은 아니다. 18

에이전트 기능에는 파일 처리와 작업 실행을 위한 세션 유지형 스킬 샌드박스도 포함된다. WeKnora는 Docker, E2B, Cube 기반 실행 환경을 설명하며, 대화가 바뀌어도 유용한 맥락을 기억하는 기능도 제공한다. 위신 팀에 따르면 제안된 기억은 사용자가 승인한 뒤 활용된다. 외부 클라이언트가 지식 기반을 검색하고 질문하도록 작업 공간을 MCP 엔드포인트로 제공하는 기능도 있다. 161216

WeKnora는 위챗 대화 오픈 플랫폼과 관련된 프로젝트로 소개되며, 기업용 위챗 등 메신저 채널 연동도 언급된다. 이는 아래의 DeepSeek Harness 플러그인과는 별개의 연결 방식이다. 451621

Harness 플러그인이 맡는 일

@wxg-prc-cpg/dsh-weknora는 DeepSeek Harness 에이전트에 배포된 WeKnora를 이용하는 네 가지 읽기 전용 도구를 제공한다. 접근 가능한 지식 기반 목록 조회, 키워드와 의미 검색을 결합한 혼합 검색, 문서의 페이지별 읽기, 출처가 표시된 WeKnora의 RAG 또는 에이전트 답변 요청이다. 마지막 도구는 후속 질문에 사용할 세션 ID를 반환할 수 있다. 여기서 ‘읽기 전용’은 Harness에 노출된 도구에 관한 설명이지, WeKnora 내부의 모든 에이전트 작업에 부작용이 없다는 보증은 아니다. 2124

역할도 구분해야 한다. WeKnora는 문서와 검색 결과, 자체적으로 생성한 답변을 제공한다. Harness는 자신의 에이전트를 조율하며 반환된 내용의 활용 방식을 결정한다. WeKnora HTTP API 문서는 작업 공간 단위와 플랫폼 단위의 API 키를 비롯한 인증 방식을 설명한다. 실제 배포 환경과 플러그인 설정에 맞는 자격 증명 및 접근 범위를 확인해야 하며, Harness가 모델을 호출하는 데 쓰는 자격 증명은 별개다. 172136

Harness의 web 프로필에 대해 공개된 플러그인 설치 명령은 다음과 같다. 21

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

이 명령은 플러그인을 설치할 뿐 WeKnora 서버를 설치하지는 않는다. 이미 배포돼 접속 가능한 WeKnora 인스턴스를 연결하고, 패키지 안내에 따라 설정과 자격 증명을 구성해야 한다. 패키지 목록에는 배포 주소 설정값으로 WEKNORA_BASE_URL이 제시돼 있다. 다른 환경변수 이름은 추측하지 말고 전체 패키지 안내를 확인하는 편이 안전하다. 21

인기와 ‘검증’ 표시를 읽는 법

9월 17일 게시된 리뷰는 WeKnora 저장소의 깃허브 스타를 2만 5,863개로, 앞선 9월 16일 보도는 2만 3,400개로 집계했다. 둘 다 당시의 수치다. 개발자의 관심을 보여주지만, 특정 환경에서의 검색 정확도나 문서 접근 통제, 보안, 안정성을 입증하지는 않는다. 46

9월 보도에 따르면 플러그인 연동은 DeepSeek Harness 0.1.0-rc.8과 WeKnora 0.7.2 조합에서 확인됐다. 별도 플러그인 디렉터리는 dsh-weknora 0.1.0을 ‘Verified’로 표시하고, WeKnora 문서는 v0.8.0의 기능을 설명한다. 이는 각각 다른 구성 요소에 관한 정보다. 더 새로운 버전의 모든 조합이 함께 테스트됐다거나, 디렉터리 표시가 보안 심사를 뜻한다고 해석해서는 안 된다. 120424348

민감한 문서에 적용하려면 실제 사용할 서버·플러그인·Harness 버전을 고정해 함께 시험해야 한다. 설정한 자격 증명으로 어떤 지식 기반과 문서를 읽을 수 있는지, 인용이 원문을 제대로 가리키는지, 페이지별 읽기로 문서 전체를 확인할 수 있는지 점검하자. 시간 초과 처리와 호출하는 에이전트에 전달되는 기밀 텍스트의 범위도 확인 대상이다. 깃허브 인기와 디렉터리 등록 여부는 발견의 단서이지, 운영 환경 검증의 대체재는 아니다. 243648