Recipes

AgentRQ 멀티 에이전트 작업 보드: MCP 기반 스케줄링 및 이벤트 워크플로

README 링크에서 발견 · 2 days ago

Software & DevOps

인간과 AI 에이전트가 MCP를 통해 칸반 보드를 공유하며, 이벤트와 YOLO 모드를 지원합니다.

What they did

AgentRQ를 인간 운영자와 AI 에이전트가 동일한 작업 보드에서 협업하는 공유 워크스페이스로 설정했습니다. Model Context Protocol을 사용해 Claude와 Codex 같은 에이전트가 워크스페이스에 연결되어 상태를 확인할 수 있습니다. 에이전트는 할당된 작업을 가져오고, 카드를 Not Started, Ongoing, Blocked, Done 사이에서 이동시키며, 민감한 작업에 대한 권한을 요청하고, 인간에게 질문을 다시 게시합니다. 인간은 목표를 작업으로 분해하고, 각 작업을 에이전트에 할당하며, 카드가 이동할 때 보드가 실시간으로 업데이트되는 것을 지켜봅니다. 작업 스케줄링을 사용해 반복 작업에 주기(15분마다, 매시간, 매일, 매주 또는 사용자 지정 요일)를 부여했고, 백그라운드 폴러가 예정된 시점에 실행을 생성하도록 하여 에이전트를 계속 깨어 있게 두지 않았습니다. qa_passed, deploy_finished, blog_published 같은 이름의 신호인 Events를 연결하여 완료된 작업이 신호를 발생시키고, 그 신호가 다른 워크스페이스에 새 작업을 자동으로 생성하도록 했으며, 이러한 이벤트와 워크스페이스를 YAML을 작성하는 대신 연결을 드래그하여 Workflow 그래프에 배치했습니다. 장시간 자율 작업을 위해 작업에 YOLO 모드를 켜서 모든 권한 요청이 자동 허용되면서도 기록에는 남도록 했고, 이후 끄면 승인 절차가 복원됩니다. History 탭의 Input, Agent, Tools 호출을 레인별로 그룹화한 타임라인을 통해 실행을 감사했고, 특정 호출을 검색하고 무엇이 실행되었고 무엇을 반환했는지 확인했으며, 인간을 기다리는 데 소요된 시간과 차단된 시간을 보여주는 작업별 타임라인을 검토했습니다.

How it went

보드는 처음부터 끝까지 돌아갔습니다. 다섯 개의 작업이 다섯 개의 에이전트에 의해 처리되었고, 카드는 Not Started에서 Ongoing으로 넘어갔으며, 한 에이전트가 질문을 던지자 해당 카드는 Blocked로 바뀌어 사람이 Allow를 클릭할 때까지 그 상태로 있다가, 이후 모든 카드가 Done에 도달했습니다. 예약된 작업은 정해진 주기에 맞춰 실행되었고, 이벤트 체인은 qa_passed에서 deploy_finished를 거쳐 릴리스 노트까지 전파되었으며, YOLO 모드에서는 단 한 번의 승인 대기 없이 테스트 스위트가 48개의 통과 테스트까지 실행되었습니다. 도구 호출 이력과 타임라인은 각 에이전트가 무엇을 했고 시간이 어디에 쓰였는지에 대한 깔끔한 감사 추적을 제공했습니다.

Worth knowing

AgentRQ Chrome 확장 프로그램 또는 플랫폼을 설치하고 MCP를 통해 각 에이전트를 연결해야 하므로, 설정이 단일 구성 파일 이상으로 복잡합니다. YOLO 모드는 인간 승인 게이트를 완전히 제거하기 때문에 프로덕션 또는 자격 증명을 다루는 작업에서는 위험합니다. 이벤트 및 워크플로 연결은 워크스페이스 전반에 걸친 일관된 이벤트 명명에 의존하며, README에는 셀프 호스팅, 인증, 데이터 보존에 대한 세부 내용이 없습니다. 에이전트 지원은 클라이언트마다 다르며, 스케줄링은 플랫폼의 폴러가 계속 실행되는 것에 의존합니다.

Wiring

Web Store에서 AgentRQ Chrome 확장 프로그램을 설치하고 워크스페이스를 엽니다. 각 에이전트 클라이언트(Claude, Codex)에서 AgentRQ MCP 서버를 추가하여 에이전트가 워크스페이스 상태를 읽고 쓸 수 있게 합니다: 작업 목록 조회, 할당된 작업 클레임, 상태 업데이트, 권한 요청, 메시지 게시. 워크스페이스와 그 작업 보드를 생성한 다음, 작업을 만들고 각 작업을 이름으로 에이전트에 할당합니다. 스케줄링의 경우 작업에 시작 날짜 또는 반복 주기를 설정합니다. 플랫폼의 폴러는 매분 틱하며 실행 시점이 되면 실행을 생성합니다. 자동화의 경우 이름이 지정된 이벤트(qa_passed, deploy_finished, blog_published)를 정의하고 이를 완료 이미터로 작업에 연결합니다. 대상 워크스페이스를 이벤트에 구독시키면 이벤트가 발생할 때 새 작업을 받습니다. Workflow 그래프에서 워크스페이스를 이벤트 위로 드래그하여 구독시키거나, 이벤트를 워크스페이스 위로 드래그하여 완료 시 이벤트를 발생시키도록 하여 이벤트와 워크스페이스를 배치합니다. 작업별 또는 워크스페이스별로 YOLO를 토글하여 권한 요청을 자동 허용하면서도 계속 로그에 기록되도록 하고, 작업의 History 탭과 타임라인에서 실행을 검토합니다.

Try it yourself

이 저장소에 AgentRQ를 설정하려면 다음 단계를 따르세요.

1. **AgentRQ Chrome 확장 프로그램 설치**
   - Chrome 웹 스토어에서 AgentRQ 확장 프로그램을 설치하고, 이 저장소에 대한 접근 권한을 부여하세요.

2. **MCP로 에이전트 연결**
   - 새 워크스페이스를 생성합니다.
   - MCP를 통해 Claude 에이전트와 Codex 에이전트를 각각 연결합니다.

3. **태스크 보드 생성**
   - 다음 컬럼으로 태스크 보드를 만듭니다: Not Started, Ongoing, Blocked, Done.

4. **태스크 추가**
   - **테스트 스위트 실행** — Codex에 배정, 매일 반복되는 스케줄 설정.
   - **린트 및 스타일 수정** — Codex에 배정.
   - **최근 커밋에서 릴리스 노트 초안 작성** — Claude에 배정.

5. **이벤트 연결**
   - `tests_passed` 이벤트를 생성하여 테스트 태스크가 완료될 때 발생하도록 설정합니다.
   - 이 이벤트가 릴리스 노트 태스크를 자동으로 생성하도록 연결합니다.

6. **YOLO 모드 비활성화**
   - YOLO 모드를 꺼 두어 셸 명령을 직접 승인할 수 있게 합니다.

7. **첫 실행의 도구 호출 기록 확인**
   - 첫 실행 후 도구 호출 기록(tool-call history)을 열어 확인합니다.

참고: 위 단계는 AgentRQ의 실제 UI/명령 체계에 따라 세부 조작이 달라질 수 있습니다. 특정 화면이나 명령어 수준의 안내가 필요하면 알려 주세요.

Source

English

Tools in this stack