프로젝트 소개
QM은 업무용 멀티플레이어 에이전트 하네스로, Slack과 웹에서 사용할 수 있습니다. 단일 개인 비서가 아니라 스타트업을 위해 설계되었습니다. 각 직원은 격리된 워크스페이스를 받고, 사람들은 채널, 그룹 메시지, 프로젝트에서 에이전트와 협업할 수도 있습니다. 모든 사람과 모든 방은 자체적으로 범위가 지정된 메모리, 파일, 키체인 뷰, 권한, 크론, 웹 앱, 지속적 샌드박스를 가집니다.
README에 설명된 주요 기능:
- 개인 및 공유 범위: 사람들은 Slack 채널과 프로젝트에서 협업하면서도 자신을 위해 에이전트를 맞춤 설정합니다.
- Slack과 웹: 동일한 아이덴티티와 구성이 Slack과 웹 앱 사이에서 유지됩니다.
- 관리자 제어: 조직 수준 구성, 보안 및 공유 태세, 사용 가능한 하네스와 모델.
- 웹 앱: 맞춤형 내부 앱을 만들어 적절한 사람들에게 게시합니다.
- 공유 스킬: 스킬은 범위 소유이며 부여를 통해 공유 가능하고, 관리자 게이트를 거쳐 전체 조직으로 승격되며, git 저장소에서 스킬 팩을 가져올 수 있습니다.
- 백그라운드 작업: 크론, 감시, 인바운드 웹훅이 아무도 지켜보지 않는 동안 작업을 실행합니다.
사용 예시로는 내부 노트, 이메일, 문서, 데이터베이스, 웹을 함께 검색하기; 내부 앱을 만들고 게시하기; 과거 발송물에서 글쓰기 목소리를 학습하고 일정에 따라 받은편지함을 분류하며 라벨과 답장 초안 작성하기; 기존 저장소에서 작업하여 테스트 실행, PR 열기, CI 모니터링, 로그 확인하기; 공유 채널에서 프로젝트를 추적하며 업데이트와 후속 조치하기 등이 있습니다.
아키텍처: 모든 턴은 다양한 모델과 하네스(Pi, OpenCode, Codex, Claude Code)를 사용해 응답을 생성할 수 있는 중앙 헤드리스 코어를 통해 실행됩니다. Postgres 지속성 계층은 사용자 데이터, 세션 기록 및 기타 지속적 상태를 보관합니다. 에이전트는 작고 고정된 도구 표면을 가집니다. 한 도구는 `execute`이며, 이는 범위 자체의 격리된 샌드박스에서 명령을 실행합니다. 웹 UI와 관리자 패널은 하나의 서비스를 공유하고, 포털과 선택적 내장 인증 브로커는 다른 서비스를 공유합니다. 코어는 Node에서 TypeScript로 실행되며 HTTP에는 Fastify를 사용합니다. Slack 플러그인은 Bolt를 사용하고, 웹 UI는 Vite로 빌드하며 Lit으로 렌더링합니다. 회사별 구성은 `qm` CLI로 검증 및 배포되는 배포 디렉터리에 있습니다. 기반 요소(하네스, 세션 저장소, 샌드박스, 메모리)는 인터페이스 뒤에 위치하며, 메모리는 내장 노트북을 유지하면서 범위별로 외부 제공자로 라우팅될 수 있습니다.
보안 및 비밀: 에이전트는 자신이 일하는 사람의 자격 증명과 권한으로 그 사람으로서 행동하며, 행동은 감사됩니다. 조직은 하나의 보안 태세를 선택하며 더 좁은 범위는 이를 강화만 할 수 있습니다. Strict(두 가지 무효과 턴 종료자를 제외하고 모든 하네스 도구 호출이 인간 승인을 위해 일시 중지됨), Auto(기본값; 사설 네트워크 접근을 차단하고 구성된 경우 콘텐츠 스크리너를 사용), Dangerous(태세 기반 콘텐츠 스크리닝 또는 도구 승인 게이트 없음). 승인 규칙과 강력한 거부가 있는 사전 선언된 명령 정책이 모든 태세에 적용됩니다. 공유 태세는 독립적입니다. Isolated(기본값)는 명시적으로 공유하지 않는 한 리소스를 해당 범위에 유지하고, Open은 명시된 제한 아래에서 옵트인된 개인 파일, 아티팩트, 스킬, 메모리를 옵트인된 공유 방에서 읽을 수 있게 합니다. SECURITY.md는 위협 모델과 알려진 한계를 문서화합니다.
배포: `@yc-software/qm`에 의존하는 조직 소유 배포 저장소를 만들고, 조직 슬러그와 대상(fly 또는 aws)으로 `qm init`을 실행한 다음, 생성된 배포 스킬을 설치하고 따릅니다. 각 배포는 운영자 자신의 클라우드 계정에서 실행됩니다. 맞춤 설정은 배포 저장소(구성, 도구, 스킬, 서비스)를 통해 또는 QM 자체 변경을 위해 소스 포크를 유지하여 수행할 수 있습니다. README는 환경 변수와 콜백 계약을 포함하여 호스팅 서비스를 통한 관리형 Slack 설치도 다룹니다.
기여는 코드가 아닌 사람이 작성한 텍스트로 받습니다. adrs/ 아래의 .txt 또는 .md 파일에 원하는 변경을 설명하십시오. 취약점은 SECURITY.md에 따라 비공개로 보고해야 합니다. QM은 별도로 명시된 경우를 제외하고 MIT 라이선스로 제공됩니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.