MARP는 세계관을 분석한 뒤 플롯·등장인물 분석을 병렬로 실행하고, 분석 메모를 RisuAI 메인 모델에 전달합니다. 최종 RP 답변은 메인 모델이 작성합니다.
v0.9.7에서는 설정 화면을 심해 네이비 + 골드 테마로 바꾸고, 분석 진행과 결과를 채팅 화면 오른쪽 위에 작게 띄우는 진행 표시를 추가했습니다.
| 사용 방식 | 받을 파일 | 실행 위치 |
|---|---|---|
| Lite | multiagent-lite-v0.9.7.js | RisuAI 브라우저 플러그인 |
| Full | multiagent-full-v0.9.7.zip | RisuAI 브라우저 플러그인 + 별도 서버 |
Full ZIP에는 플러그인, Docker 구성, Linux amd64·arm64 실행 파일과 사용 문서가 들어 있습니다. 실행 파일만 필요하면 릴리즈 첨부 파일에서 해당 아키텍처와 SHA256SUMS를 받습니다.
- 위 JS를 받아 RisuAI 플러그인에서 가져오거나 기존 MARP Lite를 교체합니다.
- MARP 공통 탭에서 공급자·API URL·credential·모델을 설정하고 저장합니다. 기존 사용자는 저장된 설정을 그대로 사용합니다.
- 연결 테스트와 진단 탭에서 동작을 확인합니다.
새 설치는 ZIP을 풀고 .env.example을 .env로 복사합니다. 기존 설치는 서버·플러그인을 함께 업데이트하되 .env, data/와 Docker 데이터 볼륨을 유지합니다.
설치 폴더에서 실행합니다.
MULTIAGENT_VERSION=v0.9.7 docker compose pull
MULTIAGENT_VERSION=v0.9.7 docker compose up -dZIP의 plugin/multiagent-full-v0.9.7.js를 RisuAI에 가져오고 MARP 공통 탭에서 서버 URL을 지정합니다. 기본 포트는 6009입니다. 휴대전화에서는 휴대전화의 localhost가 아닌 서버에 접근할 수 있는 주소를 입력합니다.
직접 소스에서 빌드하려면 docker compose up -d --build를 사용합니다. 사용자 지정 MULTIAGENT_IMAGE를 쓰고 있다면 해당 이미지의 버전도 함께 확인합니다.
Linux에서는 ZIP을 푼 뒤 sh ./run.sh를 실행하면 아키텍처에 맞는 포함 실행 파일을 사용합니다. 새 설치에서만 .env.example을 .env로 복사합니다. 다른 환경의 소스 빌드는 Go 1.27.1이 필요합니다.
플러그인 ID와 자동 업데이트 주소, Docker 이미지 이름·서비스 이름·데이터 경로는 유지됩니다. v0.8.x 프리셋도 가져올 수 있습니다. Full 구버전 서버는 기존 응답으로 동작하며, 단계 시작 시각의 실측은 Full 서버 v0.9.1 이상에서 지원합니다.
채팅 입력창 왼쪽의 햄버거 메뉴에서 MARP Lite 또는 MARP Full을 선택합니다. 캐릭터 목록 쪽 햄버거 메뉴에는 MARP 항목을 표시하지 않습니다. 플러그인 설정 화면에서도 같은 UI를 열 수 있습니다.
v0.9.1 Full 서버를 사용 중이라면 이번 메뉴 이동은 브라우저 플러그인만 v0.9.2로 업데이트해도 적용됩니다. 서버 분석 동작은 동일합니다.
공통 탭의 채팅 화면 진행 표시를 켜면 분석 진행과 결과가 채팅 화면 오른쪽 위에 작게 뜹니다. 기본값은 꺼짐입니다.
- 처음 켤 때 RisuAI가 "메인 Document 접근" 권한을 묻습니다. MARP는 이 권한으로 표시 하나를 그리고, 겹치지 않도록 NMOS 표시의 위치만 읽습니다.
- 점 세 개는 세계관 · 플롯 · 등장인물입니다. 골드 = 진행 중, 초록 = 성공, 빨강 = 실패, 회색 = OFF.
- Lite는 단계별로 갱신되고, Full은 진행 중 경과 시간만 보이다가 끝나면 결과를 표시합니다. 결과는 4초 뒤 사라집니다.
- NMOS 진행 표시가 오른쪽 위에 있으면 그 아래에 붙습니다. RisuAI 요청 상태 알림이 떠 있는 동안에는 가려질 수 있습니다.
- 표시를 누르면 MARP 설정이 열립니다.
- 권한을 거부했다면 설정 → 플러그인 → MARP 줄 메뉴 → 권한 응답 초기화 후 다시 켜세요.
| 탭 | 확인할 수 있는 내용 |
|---|---|
| 워터폴 | 최근 분석의 단계별 소요 시간, 병렬 실행, 성공·실패·OFF |
| 연결 테스트 | 전체·개별 에이전트의 인증·모델 조회 API 연결, Full 서버 상태 |
| 호출 기록 | 최근 50건, 종류·실패 필터, 상세 결과, JSON 내보내기·비우기 |
| 진단 | 합성 자료로 실행하는 텍스트·PDF 분석 테스트 |
연결 검사는 LLM 응답을 생성하지 않습니다. 진단의 분석 테스트는 실제 LLM을 호출하며 결과를 대화에 주입하지 않습니다. Lite는 현재 편집값, Full은 입력한 서버 URL에 저장된 공급자 설정으로 테스트합니다.
기록은 현재 플러그인 세션의 메모리에 보관하고 재로드하면 초기화됩니다. 결과 미리보기는 에이전트당 앞 2,000자이며 JSON 내보내기에 포함됩니다. 자동 폴링과 자동 저장은 없습니다. 상세 사용법과 상태 표시를 참고하세요.
공통 설정은 에이전트별로 덮어쓸 수 있고 빈 값은 공통값을 상속합니다. 기본 Lenient는 성공한 결과를 사용하고 Strict는 일부 실패에도 분석 주입을 중단합니다. 내장 PDF는 기본 off입니다.
PDF Pod 병용 설정은 **API 형식 감지 자동 · API 형식 변환 끄기**입니다. Lite 내장 PDF를 켜면 PDF Pod에서 MARP의 PDF 압축 수준을 끄기로 둡니다. Full의 서버 요청은 PDF Pod를 통과하지 않습니다. PDF Pod 안에서 Lite를 열면 공통 탭의 PDF Pod 연동 카드가 에이전트별 동작 여부와 필요한 설정을 보여 줍니다.
- 공급자·설정·실패 처리
- PDF Pod 안에서 MARP Lite 쓰기 (화면 안내)
- 내장 PDF 수준·텍스트 복귀·PDF Pod 병용
- 워터폴·테스트·호출 기록
- 개발·API·패키지 빌드
- 자동 검증 범위·실제 기기 점검
UI 업데이트 후 문제가 생기면 v0.9.1의 플러그인으로 교체하고 Full Docker는 MULTIAGENT_VERSION=v0.9.1으로 위 명령을 실행합니다. 설정 파일과 데이터 볼륨은 유지합니다. v0.9.0 이전 구성으로 복귀하는 방법은 전체 변경 내역에 있습니다.
MARP는 MIT License로 배포됩니다.