# 워크플로우 사용 가이드

여러 에이전트 단계를 **연결한 순서대로 실행**하는 파이프라인입니다.
매번 같은 단계를 거쳐야 하는 정형 작업에 맞습니다 — 예: 기사를 넣으면
분석 → 키워드 추출 → 제목 생성을 항상 이 순서로 수행.

> **에이전트 워크플로우와의 차이**
> - **워크플로우(이 문서)**: 연결(엣지) = 데이터 흐름. 그린 순서대로 **모든 노드가 반드시 실행**.
>   결과가 예측 가능해야 하는 파이프라인용. 순환 불가, 합류(여러 입력 모으기) 가능.
> - **에이전트 워크플로우**: 연결 = 핸드오프 허용 경로. 에이전트가 **다음 단계를 스스로 선택**
>   (되돌리기 순환 허용). 리뷰 루프·분류 후 분기 같은 동적 흐름용.
> - 상단 모드 뱃지(⇄)로 언제든 전환할 수 있습니다(그래프 유지).

---

## 핵심 개념 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/표/글자수)을 명시하면 다음 노드가 다루기 쉬워집니다.
- 정확성 단계(분석·추출)는 온도 낮게, 창작 단계(제목·카피)는 높게 — 노드별 온도가 분리돼 있습니다.
- 참고 규정·양식은 노드의 **첨부문서**로(파싱돼 프롬프트에 포함).