호스트 액션
이 챕터는 스페이스 액션 의 호스트 측 짝입니다. 참여자 챕터가 액션이 참여자에게 어떻게 보이는지 를 다뤘다면, 이 챕터는 호스트인 당신이 각 액션 유형을 어떻게 만들고 편집 하는지를 안내합니다.
액션 만들기
스페이스의 액션 페이지 /spaces/:space_id/actions 에서 액션 카루셀의 + 만들기 영역을 누르세요 — 그때 열리는 모달이 모든 액션 작성의 진입점입니다.
모달은 먼저 어떤 종류의 액 션인가? 를 묻고, 네 개의 타일 중 하나를 고르게 합니다.
| 타일 | 무엇을 만드는가 |
|---|---|
| Poll (투표) | 빠른 투표 — 단일 선택, 다중 선택, 주관식, 선형 척도. |
| Quiz (퀴즈) | 채점되는 문항과 통과 기준선. |
| Discussion (토론) | 호스트의 질문과 리치텍스트로 작성하는 답변. |
 Follow (팔로우) | 큐레이션된 사용자 목록을 팔로우하도록 요청하는 캠페인. |
타일을 선택하면 오른쪽에 빈 카드의 라이브 미리보기 가 나타나고, 만들기(Create) 를 누르면 새 액션의 편집기 URL 로 바로 이동합니다 — 이후는 거기서 채워 넣으면 됩니다.
Meet 에 대해. 다섯 번째 액션 유형인 Meet (RSVP 가 가능한 일정 이벤트) 는 플랫폼에 존재하고 자체 뷰어
/spaces/:space_id/actions/meets/:meet_id도 있지만, 호스트 편집기 진입점은 (예정) 입니다. 오늘은 MCP API 의create_meet도구로 Meet 를 만들고, 다른 액션처럼 참여자 카루셀에 노출시키는 방식으로 사용합니다.
편집기 URL 의 구조
모든 액션 편집기는 다음의 안정적인 URL 패턴을 갖습니다.
| 유형 | URL |
|---|---|
| Discussion | /spaces/:space_id/actions/discussions/:discussion_id/edit |
| Poll | /spaces/:space_id/actions/polls/:poll_id (관리자 뷰) |
| Quiz | /spaces/:space_id/actions/quizzes/:quiz_id (관리자 뷰) |
| Follow | /spaces/:space_id/actions/follows/:follow_id (관리자 뷰) |
| Meet | /spaces/:space_id/actions/meets/:meet_id (관리자 뷰) |
Discussion 은 전용 /edit URL 을 갖고, Poll · Quiz · Follow · Meet 은 관리자 뷰와 참여자 뷰가 같은 URL 을 공유 합니다 — 뒤의 네 가지에 대해 Ratel 이 방문자가 관리자인지 감지하여 페이지를 편집기 모드로 전환합니다. 참여자에게는 참여 카드가, 호스트에게는 편집기가 보여요.
편집은 디바운스를 거쳐 자동 저장 됩니다. 푸터의 Save 버튼은 저장 대기 중인 변경 사항을 즉시 반영하고 저장됨(Saved) 토스트를 띄웁니다. 별도의 "발행" 버튼은 없습니다 — 저장과 발행이 같은 동작입니다.
공통 설정
모든 편집기는 상단의 Content (내용) 카드와 하단의 Configuration (설정) 카드로 나뉩니다. 설정 카드의 섹션은 네 가지 액션 유형 모두 공통으로 다음과 같습니다.
| 섹션 | 무엇을 설정하는가 |
|---|---|
| 일정 (Schedule) | 시작 / 종료 일시. 이 구간을 벗어나면 액션이 활성화되지 않습니다. |
| 참여 및 보상 (Participation & Rewards) | 스페이스의 인센티브 풀 에서 가져오는 Credits (CR) 보상. 완료 시 참여자 포인트로 환산됩니다. |
| 선행 액션 (Dependency Actions) | 참여자가 이 액션을 풀기 전에 먼저 완료해야 하는 다른 액션. |
| 상태 (Status) | 초안 / 활성 / 종료 토글. |
| 위험 영역 (Danger zone) | 액션 삭제. 제출/응답이 함께 사라지며, 이미 지급된 보상은 환불되지 않습니다. |
Discussion 은 조정 (Moderation) 섹션을 더 가집니다 (오프토픽 답변을 가릴 수 있는 권한 지정); Poll 은 투표 규칙 (Voting rules) 섹션을 더 가집니다 (아래 참고).
Discussion 편집기
URL: /spaces/:space_id/actions/discussions/:discussion_id/edit
Content 카드는 다음을 담습니다.
- 제목 (Title) — 토론 카드 상단에 노출되는 헤드라인.
- 설명 / 본문 (Description / body) — 마크다운 지원 리치 텍스트. 이것이 참여자가 답할 프롬프트 입니다.
- 첨부 (Attachments) — PDF / PNG / JPG 를 드래그앤드롭, 각 25MB 까지.
Configuration 카드는 공통 섹션에 더해 조정 (Moderation) 섹션을 가집니다. 토론이 활성화된 후 오프토픽 답변을 가릴 수 있는 권한을 여기서 지정합니다.
Poll 편집기
URL: /spaces/:space_id/actions/polls/:poll_id
Content 카드는 다음을 담습니다.
- 제목 (Title) — 폴의 헤드라인.
- 질문 (Questions) — 1 ~ 20 개. 각 질문은 네 가지 유형 중 하나로 동작합니다.
- Single (단일) — 질문당 한 옵션 (라디오).
- Multi (다중) — 여러 옵션 선택 (체크박스).
- Subjective (주관식) — 자유 텍스트 응답, 선택적으로 입력창 위에 힌트 표시.
- Linear (선형) — 최소 / 최대를 가진 숫자 스케일 (1–5, 0–10 등).
- "Other" 옵션 허용 (질문별) — 고정된 선지 옆에 자유 텍스트 "Other" 선택지를 추가합니다.
Configuration 카드는 공통 섹션에 더해 투표 규칙 (Voting rules) 섹션을 가집니다.
- 응답 수정 허용 (Allow response editing) — 켜면 폴 진행 중에 참여자가 응답을 수정할 수 있습니다. 끄면 제출 즉시 응답이 확정됩니다.
- 암호화 업로드 (Encrypted upload) — 켜면 투표 결과가 암호화되어 온체인에 저장되며, 제출 후 응답 수정이 불가능합니다. 감사 가능성이 중요한 고비중 투표에 사용하세요.
Quiz 편집기
URL: /spaces/:space_id/actions/quizzes/:quiz_id
Content 카드는 다음을 담습니다.
- 제목 (Title) 과 설명 (Description) — 참여자가 시작하기 전에 보는 프레이밍.
- 질문 (Questions) — 3 ~ 20 개, 각각 Single 또는 Multi 선택. 정답을 표시합니다.
- 합격 점수 (Pass Score) — 통과에 필요한 최소 점수 (전체 문항 대비).
- 재시도 횟수 (Retry Count) — 참여자별 재응시 가능 횟수.
- 응시 시간 (Survey Time) — 한 번의 응시에 허용되는 총 시간.
- 첨부 (Attachments) — 참여자가 참고할 자료: PDF / PNG / JPG, 각 25MB 까지.
합격하면 보상이 잠금 해제되고, 불합격하면 (Retry Count 가 허용하는 한) 다시 응시할 수 있습니다.
Follow 편집기
URL: /spaces/:space_id/actions/follows/:follow_id
Targets 카드는 다음을 담습니다.
- 제목 (Title) — 캠페인의 이름.
- 타겟 (Targets) — 참여자가 팔로우해야 할 1 ~ 20 명 의 사용자 계정. 각 타겟은 참여자 뷰에서 인라인 행으로 렌더링되고, 그 자리에 팔로우 버튼이 함께 보입니다.
Configuration 카드는 공통 섹션 — 일정, 참여 및 보상, 선행 액션, 상태, 위험 영역 — 만 갖습니다.
Meet 편집기 (예정)
URL: /spaces/:space_id/actions/meets/:meet_id (관리자 뷰)
라이브스트림 · 화상 통화 · 워크숍 · 오프라인 모임 같은 일정 이벤트입니다. 이 URL 의 참여자 뷰는 라이브이지만, 만들기 모달의 호스트 편집기 진입점은 (예정) 입니다. 오늘 시점에 Meet 가 필요한 호스트는 MCP API 의 create_meet 도구를 사용하세요 (AI 연결 참고).
팁
- 보상 예산은 적절한 액션에 배정하세요. Credit 은 스페이스의 인센티브 풀에서 빠집니다. 온보딩용 퀴즈는 무보상으로 두고, 최종 리포트의 핵심이 되는 토론에 Credit 을 집중하는 식으로요.
- Dependencies 로 시퀀스를 짜세요. 흔한 패턴: 빠른 사전(Sample) 폴 → 깊은 최종(Final) 폴. 최종 폴이 사전 폴에 의존하도록 설정하면 참여자가 워밍업을 마치고 본 질문에 답하게 됩니다.
- 참여자 뷰로 테스트하세요. 같은 URL 을 시크릿 창이나 다른 세션에서 열어보세요 — 참여자가 보는 화면이 그대로 드러납니다. 관리자 / 참여자 전환은 자동입니다.
다음 단계
- 스페이스 액션 — 같은 다섯 액션 유형의 참여자 측 레퍼런스.
- 스페이스 앱 → 인센티브 풀 — 액션 보상이 빠져나오는 Credit 풀을 펀딩하세요.
- 리포트 — 액션 결과를 발행 가능한 내러티브로 바꾸세요.