본문으로 건너뛰기
← 블로그
AI Agents하이프마크 AI팀

마블로 시작하기 — 첫 멀티 에이전트 만드는 30분 튜토리얼

마블로 시작하기 — 첫 멀티 에이전트 만드는 30분 튜토리얼

30분 후에 무엇이 만들어지나

주제를 입력하면 다음 순서로 움직이는 워크플로우를 만들어 봅니다:

  1. 주제를 입력하면
  2. 리서처 에이전트 (Claude) 가 웹에서 자료 수집
  3. 작성 에이전트 (Codex) 가 600자 한국어 글 작성
  4. 검증 에이전트 (Grok) 가 사실 확인
  5. 인용 포함 최종 글을 반환

세 에이전트가 서로 다른 모델에서 동작합니다. 이게 핵심입니다. 단일 모델로는 비용도 품질도 떨어집니다. 이종 에이전트가 강한 이유 참조.

사전 준비

  • 마블로 계정 (Free 가능. 멀티 에이전트는 Pro 19,000원/월 이상)
  • 모델 연결: 사용할 에이전트(Claude·Codex·Grok)마다 CLI 로그인 또는 직접 설정한 API 키
  • 30분

1단계: 보드 만들기 (90초)

마블로에서 "보드" 는 하나의 워크플로우입니다.

  1. 마블로 로그인 → 새 보드
  2. 이름: 한국어-글쓰기-파이프라인
  3. 설명: 리서치·작성·검증 3-에이전트 한국어 워크플로우

끝. 90초.

2단계: 리서처 에이전트 추가 (5분)

리서처는 사실을 수집합니다. Claude를 씁니다. 긴 컨텍스트 추론이 가장 강합니다.

  1. 에이전트 추가 클릭
  2. 역할(Role): researcher
  3. 모델: Claude Opus
  4. 시스템 프롬프트:
당신은 리서치 에이전트입니다. 주제가 주어지면 웹에서 가장 권위 있는
출처를 찾아 구조화된 발견사항을 산출하세요.

출력 형식:
- 주제 요약 (2-3문장)
- 5-8개 핵심 주장, 각각 인용 URL 포함
- 출처들 사이에서 의견이 갈리는 2-3개 지점

산문이 아닌 구조화된 발견사항만 출력하세요.
  1. MCP 도구 추가: web_search (마블로 기본 제공)
  2. 저장

3단계: 작성 에이전트 추가 (5분)

작성자는 구조화된 발견사항을 글로 만듭니다. 작성 에이전트는 Codex로 둡니다.

  1. 에이전트 추가
  2. 역할: writer
  3. 모델: Codex
  4. 시스템 프롬프트:
당신은 한국어 작성 에이전트입니다. 구조화된 리서치 결과를 받아 600자
한국어 글을 작성합니다.

규칙:
- 제공된 발견사항의 사실만 사용
- 인라인 인용: [출처: URL]
- 결론부터 시작, 배경은 뒤에
- 한 문단에 하나의 아이디어
- "할 수도", "어쩌면" 같은 헷지 표현 금지 (출처가 불확실한 경우만 예외)
- 존댓말 ('-습니다')
  1. 입력: researcher 의 출력을 받음
  2. 저장

4단계: 검증 에이전트 추가 (5분)

검증자는 작성자가 만든 글을 원본 자료와 대조합니다. 검증자는 작성자(Codex)와 벤더가 다른 Grok으로 둡니다. 같은 모델이 작성과 검증을 함께 맡으면 같은 사각지대를 공유하기 때문입니다.

  1. 에이전트 추가
  2. 역할: fact_checker
  3. 모델: Grok
  4. 시스템 프롬프트:
당신은 사실 검증 에이전트입니다. 두 가지를 받습니다:
1. 원본 리서치 발견사항 (구조화)
2. 작성된 한국어 글

글에 있는 모든 사실 주장에 대해, 발견사항에 그 근거가 있는지 확인하세요.

출력:
- "검증됨" 주장 (발견사항으로 뒷받침됨)
- "근거없음" 주장 (발견사항에 없음 — 삭제 권장)
- "인용누락" 주장 (발견사항에 있지만 인라인 인용 빠짐)

엄격하게 검증하세요. 숫자·날짜·출처 인용이 발견사항과 정확히 일치하지
않으면 플래그하세요.
  1. 입력: researcher 와 writer 양쪽에서 받음
  2. 저장

5단계: 그래프 연결 (3분)

마블로의 그래프 뷰에서 드래그로 연결:

[입력] → researcher → writer → fact_checker → [출력]
                  ↘____________↗
            (리서처 결과가 검증자에게도 흐름)

두 번째 연결 (researcher → fact_checker) 이 독립적 검증을 만듭니다. 검증자가 원본 자료와 작성된 글 양쪽을 보고 차이를 잡아냅니다.

6단계: 테스트 실행 (5분)

  1. 테스트 실행 클릭
  2. 입력: "한국 AI 에이전트 시장 2026 현황"
  3. 트레이스 뷰에서 각 에이전트 실행 관찰

예상 출력:

researcher: 발견사항 7개 수집, 인용 URL 4개
writer: 612자 한국어 초안 작성
fact_checker:
  - 검증됨 7개
  - 근거없음 0개
  - 인용누락 1개 (주장 #4의 인용 누락)

검증자가 인용 누락을 잡았습니다. 이종 셋업의 가치는 여기서 드러납니다. 단일 모델이면 이걸 놓쳤을 가능성이 높습니다.

7단계: 배포 (2분)

  1. 배포 클릭
  2. 웹훅 URL이 발급됩니다
  3. POST 로 { "topic": "주제" } 전송
  4. 응답: { "article": "...", "trace_id": "..." }

끝. 프로덕션 엔드포인트입니다. 버전 관리·트레이스·에이전트별 비용 추적 자동.

무슨 일이 일어났나

  • 세 벤더 (Anthropic·OpenAI·xAI) 를 한 워크플로우에서 사용: 이종 (heterogeneous)
  • 각 에이전트가 역할에 맞는 모델에서 실행
  • 검증자가 작성자와 독립적 (다른 벤더)
  • 비용이 에이전트별로 자동 기록
  • 모든 프로덕션 요청을 엔드투엔드로 추적 가능

실행 비용은 쓰는 모델과 요금제에 따라 달라집니다. 요금제는 마블로 가격에서 확인하세요.

초보자 흔한 실수

실수 1: 세 에이전트 모두 같은 모델 비용·품질 트레이드오프가 사라집니다. 첫날부터 이종으로.

실수 2: 두 번째 연결 (researcher → fact_checker) 누락 없으면 검증자가 근거 자료가 없는 상태에서 일관성만 확인합니다. 사실 검증이 안 됩니다.

실수 3: 모호한 시스템 프롬프트 리서처의 구조화된 출력 형식이 있어야 작성자가 깔끔하게 파싱합니다. 프롬프트의 구체성이 전체 체인에서 효과를 냅니다.

실수 4: 테스트 실행 건너뛰기 마블로 테스트 뷰가 트레이스를 보여줍니다. 저희 내부 프로젝트에서는 배포 전 테스트 실행 단계에서 대부분의 버그를 잡았습니다.

다음에 확장할 패턴

세 에이전트 패턴이 기초입니다. 자주 추가하는 확장:

  • 편집자 에이전트: 톤·스타일 최종 다듬기
  • 번역 에이전트: 다국어 출력 (한국어 ↔ 영어)
  • MCP 도구: 최종 글을 우리 CMS·노션·티스토리에 게시
  • 검증 결과 기반 분기: "근거없음" 주장이 있으면 작성자에게 루프백

각 확장이 그래프에 노드 하나 추가입니다. 패턴이 확장됩니다.

막히면

직접 워크스루를 원하시면 30분 무료 세션 을 신청하실 수 있습니다. 마블로 팀이 귀사의 실제 워크플로우를 함께 설계합니다.

관련 글


마지막 업데이트: 2026-05-19. 마블로 UI는 자주 개선되지만 워크플로우 패턴은 안정적입니다.

마치며

하이프마크 빌더 커뮤니티는 AI 에이전트를 만들고 운영하며 얻은 경험과 참고할 자료를 꾸준히 공유하려고 합니다. 빌더 여러분께 도움이 될 좋은 자료들을 계속 모아 나누겠습니다.

계속 읽어 보세요

빌드 노트와 실측 기록의 새 글은 RSS로 받아볼 수 있습니다.

모든 채널 보기 →

회사에서 검토한다면 팀에 가져가기

마블로 시작하기 — 첫 멀티 에이전트 만드는 30분 튜토리얼 | Hypemarc