워크플로우 사용 가이드
여러 에이전트 단계를 연결한 순서대로 실행하는 파이프라인입니다. 매번 같은 단계를 거쳐야 하는 정형 작업에 맞습니다 — 예: 기사를 넣으면 분석 → 키워드 추출 → 제목 생성을 항상 이 순서로 수행.
에이전트 워크플로우와의 차이
- 워크플로우(이 문서): 연결(엣지) = 데이터 흐름. 그린 순서대로 모든 노드가 반드시 실행. 결과가 예측 가능해야 하는 파이프라인용. 순환 불가, 합류(여러 입력 모으기) 가능.
- 에이전트 워크플로우: 연결 = 핸드오프 허용 경로. 에이전트가 다음 단계를 스스로 선택 (되돌리기 순환 허용). 리뷰 루프·분류 후 분기 같은 동적 흐름용.
- 상단 모드 뱃지(⇄)로 언제든 전환할 수 있습니다(그래프 유지).
핵심 개념 3가지
| 개념 | 의미 |
|---|---|
| 노드 = 에이전트 단계 | 이름·설명·모델·프롬프트·도구·첨부문서를 가진 하나의 처리 단계 |
| 연결(엣지) = 데이터 전달 | A→B 연결이면 A 의 출력이 B 의 입력이 된다. 실행 순서도 이 방향을 따른다 |
| 다중 입력 = 라벨 블록 합류 | 여러 노드를 한 노드로 연결하면 각 출력이 [노드 이름] 블록으로 합쳐져 입력된다 — 프롬프트에서 "「기사 분석」 결과를 참고해…"처럼 이름으로 지칭 가능 |
- 시작 노드는 자동: 들어오는 연결이 없는 노드가 실행 입력을 받습니다(여러 개면 각각 받음).
- 순환 금지: A→B→A 같은 왕복은 파이프라인에선 불가 — 필요하면 에이전트 워크플로우로 전환.
예제 따라하기 — 기사 제목 생성 플로우
목표: 기사 본문을 넣으면 분석 → 키워드 추출 → 제목/부제목 초안을 만든다.
1. 만들기 시작
나의 에이전트 → [워크플로우] → [새 워크플로우]. 제목을 "기사 제목 생성"으로.
2. 노드 3개 추가
하단 바 [에이전트 추가] 3번 → 각 노드 클릭 후 오른쪽 패널에서:
| 노드 이름 | 프롬프트 (요지) | 모델/온도 | |
|---|---|---|---|
| ① | 기사 분석 | 기사 본문의 핵심 팩트·주제·톤·길이를 분석하세요. | 낮은 온도(0.1) |
| ② | 키워드 추출 | 「기사 분석」 결과를 기반으로 SEO 핵심 키워드와 해설 관점 키워드를 추출하세요. | 낮은 온도 |
| ③ | 제목 생성 | 분석과 키워드를 바탕으로 제목+부제목 초안 3개를 만드세요. 생성 유형: 특집형/기획형. | 높은 온도(0.8) |
"생성 유형·출력 옵션" 같은 고정 지침은 노드 프롬프트에 적습니다 (실행할 때마다 바뀌는 값이 아니라면 실행 입력이 아니라 프롬프트가 자리입니다).
3. 연결
기사 분석 → 키워드 추출 → 제목 생성 순서로 오른쪽 점 → 왼쪽 점 드래그.
분석 결과를 제목 생성이 직접 참고하게 하려면 기사 분석 → 제목 생성도 추가로 연결
— 제목 생성 노드에는 두 출력이 [기사 분석], [키워드 추출] 블록으로 함께 들어옵니다.
4. 저장 후 실행
하단 실행 입력에 기사 본문을 붙여넣고 [실행]. 실행 입력은 시작 노드(기사 분석)에 전달됩니다.
5. 진행 확인 → 결과
- 실행 바 위 진행 패널: 현재 노드·도구 실행·답변 타이핑이 실시간 표시
- 캔버스: 실행 중(파란 링) → 완료(초록) 순서대로 진행
- 완료 시 마지막 노드 결과가 아티팩트(문서 뷰, PDF 저장)로 열림 — 노드 클릭 → "실행 결과"에서 중간 단계 출력도 크게 볼 수 있습니다
실행 기록
- 실행마다 채팅 기록에 세션 하나(🔀, 제목 자동 생성)로 저장 — 사이드바에서 재열람
- 빌더 상단 [기록]: 이 워크플로우의 실행만 모아 보고, 클릭하면 결과를 아티팩트로
- 저장하지 않은 워크플로우의 실행은 기록되지 않습니다
AI 리뷰
상단 [리뷰] 버튼 — 구조(고아 노드·순환)·프롬프트·도구 구성을 AI 가 검수하고, 확신 있는 개선(설명/프롬프트)은 [제안 적용] 한 번으로 반영(되돌리기 가능).
자주 걸리는 것들
| 증상 | 원인 / 해결 |
|---|---|
| "그래프에 순환(cycle)이 있습니다" | 파이프라인은 한 방향만 — 되돌리기가 필요하면 모드 뱃지(⇄)로 에이전트 워크플로우 전환 |
| 실행 버튼이 안 눌림 | 실행 입력(필수)이 비어 있음 |
| 상류 결과를 참고 못 함 | 연결이 있는지 확인 — 입력은 [노드 이름] 블록으로 들어오니 프롬프트에서 그 이름으로 지칭 |
| 특정 단계만 다르게 돌길 원함 | 파이프라인은 전 노드 실행 — 조건 분기가 필요하면 에이전트 워크플로우 사용 |
팁
- 노드 프롬프트에 출력 형식(bullet/표/글자수)을 명시하면 다음 노드가 다루기 쉬워집니다.
- 정확성 단계(분석·추출)는 온도 낮게, 창작 단계(제목·카피)는 높게 — 노드별 온도가 분리돼 있습니다.
- 참고 규정·양식은 노드의 첨부문서로(파싱돼 프롬프트에 포함).