BBoilerplate
강의 문의

큐레이션

DeepSeek Harness

모델·도구·스킬·세션·샌드박스를 플러그인으로 조합하는 DeepSeek의 오픈소스 에이전트 하네스

TypeScript210,033

요약

DeepSeek Harness(dsh)는 DeepSeek AI가 공개한 오픈소스 에이전트 하네스다. 공식 README는 모델, 도구, 스킬, 세션, 샌드박스 등을 플러그인으로 다루는 “everything-is-a-plugin” 구조와 Cordis 기반을 핵심으로 설명한다.

도구 소개

에이전트를 하나의 고정된 실행기로 묶기보다, 하네스의 구성 요소를 플러그인 경계로 나눠 확장하려는 프로젝트다. 공식 문서와 저장소에서 아키텍처, 플러그인, 웹 인터페이스의 현재 범위를 확인할 수 있다. 저장소는 MIT 라이선스이며, 별도의 THIRD_PARTY_NOTICES 파일로 의존성 고지도 제공한다.

다만 현재는 개발자 프리뷰다. 공식 README가 호환성을 깨는 변경이 있을 수 있다고 명시하므로, 기존 에이전트 환경을 바로 교체하기보다 격리된 프로젝트에서 구조와 확장 지점을 살펴보는 편이 맞다.

설치와 시작

가장 짧은 시작 방법은 공식 패키지로 웹 인터페이스를 실행하는 것이다.

npx @deepseek-ai/dsh web

기본 웹 주소는 로컬 127.0.0.1:3080이다. 소스에서 확인하려면 저장소를 복제한 뒤 의존성을 설치하고 빌드한다.

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

사용 포인트

  • 여러 모델·도구·스킬을 플러그인 단위로 조합하는 하네스 구조를 직접 살펴볼 수 있다.
  • 에이전트 실행기와 웹 인터페이스를 함께 운영하며, 특정 모델 서비스에 종속되지 않는 확장 방식을 실험할 수 있다.
  • 새 프로젝트나 내부 실험에서 플러그인 경계, 세션 구성, 샌드박스 연결 방식을 비교하는 참고 구현으로 사용할 수 있다.

적용 판단

이 프로젝트의 핵심 가치는 특정 모델의 사용법보다 에이전트 하네스 자체를 플러그인 구조로 공개했다는 데 있다. 반면 개발자 프리뷰이고 설치·플러그인 호환성이 빠르게 바뀔 수 있으므로, 운영 중인 환경에 바로 넣기보다 별도 디렉터리와 제한된 인증 정보로 검토하는 것을 권한다. 공식 README의 안전성 안내와 변경 공지를 먼저 확인해야 한다.

참고