딥시크, 팀 채팅을 코딩 작업으로 잇는 슈퍼에이전트 공개

딥시크 하네스 팀이 개발팀의 요청을 받아 여러 코딩 작업을 진행하는 ‘dsh-superagent’ 연구용 코드를 깃허브에 공개했다. 한 저장소의 이슈와 코드 수정 요청을 살피고, 선택적으로 페이슈의 팀 대화도 연결한다. 허용된 사람이 일을 맡기면 별도 작업 공간에서 처리한 뒤 원래 대화에 코드 변경 제안인 풀 리퀘스트 등을 돌려준다.

공개 저장소는 깃허브 메타데이터 기준 10월 31일 생성됐다. 팀은 이 코드를 공식 딥시크 제품이 아닌 연구 시제품으로 명시했다. 내부에서 쓰던 구현을 공개용으로 바꿨으며, 함께 설명한 설계 가운데 일부는 향후 개발 방향이다. 따라서 설계 글에 나오는 기능 전체를 이번 공개 코드의 완성된 기능으로 볼 수는 없다.

이 도구가 다루는 단위는 팀의 작업이다. 새 요청을 판단하는 세션과 실제 일을 수행하는 세션을 나누고, 각 작업에는 맡겨진 범위와 결과를 보낼 대화를 기록한다. 서로 다른 작업이 같은 대화에서 생길 수 있고, 한 작업이 여러 관련 대화를 참고하는 방식도 문서화했다.

지켜보는 대화와 일을 맡길 권한은 별개

메시지를 읽는다고 곧바로 수정 작업을 시작하는 것은 아니다. 허용 목록에 있는 사람이 에이전트를 직접 부르면 명시적 요청으로 처리한다. 그 밖의 메시지에서 일을 찾아 시작하려면 팀이 정한 규칙과 자동 수락 설정이 필요하다. 기본 관찰 모드에서는 어떤 일을 수락했을지만 기록하며, 판단 결과를 실제 작업으로 넘기지 않는다.

작업 중 다른 대화의 자료를 참고할 때도 그 메시지가 새 권한을 만들지는 않는다. 담당 에이전트는 범위 안의 후속 요청을 처리하고, 범위를 벗어나면 다시 분류하도록 돌려보낸다.

딥시크 팀은 사람이 여러 에이전트를 감독할 때 드는 주의력도 설계 대상으로 삼았다. 에이전트는 요청을 한 번 확인한 뒤 진행 중에는 조용히 일하고, 결과가 생기거나 결정이 필요하거나 일을 끝낼 수 없을 때 다시 알리도록 했다. 메시지는 요청이 들어온 대화로 돌아간다. 관련 없는 대화에 작업 보고를 퍼뜨리는 대신 결과를 받아야 할 곳을 유지하는 방식이다.

실제 처리는 작업마다 따로 만든 세션과 디렉터리에서 진행한다. 동시 실행 수에는 상한이 있고, 이미 진행 중인 일에 사람이 답하거나 상태를 물을 때는 추가 자리를 둔다. 새 작업이 대기열을 채우더라도 기존 작업을 이어갈 통로를 남긴다.

팀은 에이전트가 어떤 결과를 내야 검토에 넘길 수 있는지도 바꿀 수 있다. 대화 방식, 작업 범위, 풀 리퀘스트에 포함할 검증 근거를 각각 지시문으로 편집한다. 기본 지시는 초안을 미완성으로 표시하고, 풀 리퀘스트를 열었다는 사실만으로 준비됐다고 보고하지 않도록 했다. 화면을 바꾸는 작업에는 실제 변경 전 화면을 요구한다. 허용 목록과 도구 인수 검사는 프롬프트와 별개로 코드가 집행한다.

감독 화면은 사람이 답해야 하는 질문, 검토할 결과, 막히거나 실패한 일을 앞에 보여 준다. 개별 기록에서는 어떤 요청으로 일을 시작했는지, 허용 범위가 무엇인지, 누가 실행을 맡았는지 확인할 수 있다. 실패한 작업을 다시 시작하는 기능과 처리 일시 정지도 제공한다. 정상 상태의 항목은 화면에서 공간을 차지하지 않도록 한다는 원칙을 뒀다.

수락·무시 같은 판단에는 이유와 해당 규칙이 남고, 메시지가 걸러지거나 전달되지 않은 경우에도 관련 대화나 작업으로 이어진다. 검색창에서는 댓글 주소나 이슈 번호로 과거 대화를 찾을 수 있어, 사람이 요청이 어느 작업으로 이어졌는지 추적하게 했다.

실행 세션은 운영체제 사용자 권한으로 명령을 승인 없이 실행한다. 실행 문서는 작업 디렉터리와 명령어 래퍼를 보안 경계로 보지 말라고 명시했다. 따라서 팀이 맡길 작업을 정하는 권한 정책과 별도로, 실행 컴퓨터가 어떤 파일과 자격 증명에 접근할 수 있는지 살펴야 한다.

코드는 MIT 라이선스로 배포되며, 운영에는 모델 제공자 설정과 저장소에 쓰기 권한을 가진 에이전트 전용 깃허브 계정이 필요하다. 에이전트는 그 계정으로 댓글을 쓰고 브랜치를 올리며 풀 리퀘스트를 연다. 배포 문서는 깃허브닷컴의 저장소를 대상으로 하며 기업이 자체 서버에 설치하는 GitHub Enterprise Server는 지원하지 않는다고 명시했다. 페이슈를 연결하려면 별도의 봇도 구성해야 한다. 감독 화면에서 저장소와 계정, 허용할 사람, 실행 위치를 설정하며, 초기 설정을 마쳐야 메시지 확인과 작업 처리가 시작된다.