> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 워크플로우 수정하기

> 플레이북 액션·Step 엔진·참고 사항·출력 스키마를 고치는 방법과 저장 규칙.

**위치:** 워크플로우 상세 → **워크플로우 수정** (또는 목록의 작업 → 워크플로우 수정)

**정책과 AI 모델을 뺀 나머지는 모두 수정할 수 있습니다.** 기본 정보·플레이북 액션·Step 엔진·출력 스키마·참고 사항이 대상이고, 어느 것을 고쳐도 플레이북이 다시 생성되지 않습니다.

<Frame caption="워크플로우 수정 화면 — 섹션마다 편집 버튼이 있습니다.">
  <img src="https://mintcdn.com/argosidentity/uzgj8WfVduVpDN5-/images/omni/ko/workflow-edit.png?fit=max&auto=format&n=uzgj8WfVduVpDN5-&q=85&s=007a769dc872b06d47ee30e95615c9db" alt="워크플로우 수정 화면" width="3756" height="1972" data-path="images/omni/ko/workflow-edit.png" />
</Frame>

## 화면 구성

| 섹션          | 편집    | 내용                |
| ----------- | ----- | ----------------- |
| 기본 정보       | 가능    | 이름·설명             |
| 플레이북 ID     | 읽기 전용 | 복사 버튼만 제공         |
| 플레이북 액션     | 가능    | 액션 순서·이름·설명·배정 엔진 |
| AI 모델       | 읽기 전용 | 생성 시 고른 모델        |
| JSON 출력 스키마 | 가능    | 복사 버튼도 제공         |
| 참고 사항       | 가능    | 액션별 참고 사항을 합친 목록  |

<Frame caption="수정 화면 하단 — AI 모델, JSON 출력 스키마, 참고 사항.">
  <img src="https://mintcdn.com/argosidentity/uzgj8WfVduVpDN5-/images/omni/ko/workflow-edit-bottom.png?fit=max&auto=format&n=uzgj8WfVduVpDN5-&q=85&s=2877acc1659867da21a0420757bbd369" alt="워크플로우 수정 화면 하단" width="3202" height="1771" data-path="images/omni/ko/workflow-edit-bottom.png" />
</Frame>

## 정책과 AI 모델은 바꿀 수 없습니다

수정 화면에 **정책 정의 섹션이 없습니다.** 정책을 바꾸는 것은 플레이북·액션·엔진 배정을 전부 다시 만드는 일이라, 사실상 다른 워크플로우가 됩니다. 그래서 생성 이후에는 정책을 고정하고, 그 아래 실행 계획만 손보도록 되어 있습니다. AI 모델도 같은 이유로 읽기 전용입니다.

정책 원문은 [`GET /workflows/:workflowId`](/ko/omni/api-reference/get-workflow)의 `policyText`에서 확인할 수 있습니다.

정책 자체를 바꿔야 한다면 **워크플로우를 새로 만드세요.** 기존 워크플로우를 [복사](/ko/omni/dashboard/workflow-setup/workflow-detail#복사)한 뒤 새로 만드는 편이 출력 스키마를 다시 쓰지 않아도 되어 빠릅니다.

<Tip>
  정책을 다시 쓰기 전에 **참고 사항**부터 확인하세요. 판정이 어긋나는 원인은 대개 정책 문장 자체가 아니라, 그 문장이 액션의 참고 사항으로 잘못 옮겨진 경우입니다. 참고 사항은 이 화면에서 바로 고칠 수 있습니다.
</Tip>

## 기본 정보 편집

<Frame caption="기본 정보 — 편집을 누르면 이름과 설명을 바꿀 수 있습니다.">
  <img src="https://mintcdn.com/argosidentity/uzgj8WfVduVpDN5-/images/omni/ko/workflow-edit-information.png?fit=max&auto=format&n=uzgj8WfVduVpDN5-&q=85&s=b0467672cf4b80c9317a9ec97330acd2" alt="기본 정보 섹션" width="3202" height="300" data-path="images/omni/ko/workflow-edit-information.png" />
</Frame>

이름과 설명만 바뀌고 플레이북에는 영향이 없습니다.

## 플레이북 액션 편집

가장 많이 쓰는 편집입니다. **편집**을 누르면 별도 창이 아니라 그 자리에서 편집 모드로 바뀝니다. 순서·이름·설명·엔진을 고친 뒤 **저장**하면 한 번에 반영됩니다.

<Frame caption="플레이북 액션 편집 모드 — 드래그 핸들, 이름 옆 연필, 우측 엔진 버튼, 삭제, 하단 액션 추가.">
  <img src="https://mintcdn.com/argosidentity/uzgj8WfVduVpDN5-/images/omni/ko/workflow-edit-playbook-actions.png?fit=max&auto=format&n=uzgj8WfVduVpDN5-&q=85&s=033aa236d31aefc6069a4e6d301da3a5" alt="플레이북 액션 편집 모드" width="3736" height="1977" data-path="images/omni/ko/workflow-edit-playbook-actions.png" />
</Frame>

| 조작    | 방법                                                         |
| ----- | ---------------------------------------------------------- |
| 순서 변경 | 행 왼쪽 **드래그 핸들**로 끌어 옮깁니다. Step 번호는 위에서부터 다시 매겨집니다          |
| 이름 수정 | 액션 이름 옆 **연필 아이콘**. 규칙: **영소문자로 시작 · 영소문자·숫자·언더스코어(`_`)만** |
| 설명 수정 | 설명 줄을 눌러 바로 입력                                             |
| 엔진 수정 | 행 오른쪽 **엔진 n개** 버튼(배정된 엔진이 없으면 **엔진 선택**)                  |
| 액션 삭제 | 행 오른쪽 **휴지통**                                              |
| 액션 추가 | 목록 맨 아래 **+ 액션 추가**                                        |

바꾼 것이 없으면 **저장** 버튼이 비활성입니다. **취소**를 누르면 편집 전으로 돌아갑니다.

| 오류                                         | 원인                      |
| ------------------------------------------ | ----------------------- |
| 영소문자로 시작하고, 영소문자·숫자·언더스코어(`_`)만 사용할 수 있습니다 | 이름 규칙 위반                |
| 액션 이름이 중복되었습니다                             | 같은 이름의 액션이 둘 이상         |
| 저장할 수 없는 액션이 있습니다                          | 위 두 오류가 남아 있는 상태로 저장 시도 |

<Warning>
  `step`은 실행 순서일 뿐이라 순서를 바꾸면 번호가 다시 매겨집니다. 연동 코드에서 단계를 가리킬 때는 순서와 무관하게 고정되는 `workId`를 쓰세요.
</Warning>

## Step 엔진 편집

액션 행 오른쪽의 **엔진 n개**(또는 **엔진 선택**)를 누르면 그 Step에 배정할 엔진을 고르는 창이 열립니다.

<Frame caption="Step 엔진 편집 — 전체 엔진 카탈로그에서 체크로 고릅니다.">
  <img src="https://mintcdn.com/argosidentity/uzgj8WfVduVpDN5-/images/omni/ko/workflow-edit-step-engines.png?fit=max&auto=format&n=uzgj8WfVduVpDN5-&q=85&s=1c1e31610443a874d765f811a7d1e216" alt="Step 엔진 편집" width="3736" height="1977" data-path="images/omni/ko/workflow-edit-step-engines.png" />
</Frame>

* 제목은 **Step n 엔진 편집**입니다.
* **전체 선택** 체크박스와 "7개 중 2개 선택됨" 표시가 있습니다.
* 엔진마다 이름과 설명이 함께 보이므로 무엇을 하는 엔진인지 여기서 확인할 수 있습니다.
* **적용**을 누르면 그 Step에 반영되고, 최종 저장은 플레이북 액션의 **저장**으로 합니다.

엔진별 기능·단가·지원 국가는 [AI 모델과 엔진](/ko/omni/dashboard/workflow-setup/engine-selection)에 있습니다.

## 출력 스키마 편집

**출력 스키마 편집** 창이 열리고, 생성 때와 같은 **필드 빌더**와 **JSON Schema 직접 입력** 두 탭을 씁니다.

<Frame caption="출력 스키마 편집 — 필드 빌더에 기존 스키마가 펼쳐집니다.">
  <img src="https://mintcdn.com/argosidentity/uzgj8WfVduVpDN5-/images/omni/ko/workflow-edit-schema.png?fit=max&auto=format&n=uzgj8WfVduVpDN5-&q=85&s=465b8ac868ceb56af51f92e3fbc116bc" alt="출력 스키마 편집" width="3705" height="1971" data-path="images/omni/ko/workflow-edit-schema.png" />
</Frame>

| 요소         | 설명                                                        |
| ---------- | --------------------------------------------------------- |
| 드래그 핸들     | 필드 순서 변경                                                  |
| 펼침 화살표     | `object`·`array` 필드의 하위 속성 열기·닫기                          |
| 이름 옆 숫자 배지 | 그 필드가 가진 하위 속성 개수                                         |
| **+** 버튼   | `object`·`array` 필드에 하위 속성 추가                             |
| 휴지통        | 필드 삭제                                                     |
| 형식/제약조건    | `string`은 형식(None·Date·Email…), `array`는 `최대: 10`처럼 최대 크기 |

제약은 생성 때와 같습니다 — 루트는 `"type": "object"`, 중첩 최대 2단계, 이름 중복 불가. 전체 규칙은 [출력 스키마](/ko/omni/dashboard/workflow-setup/output-schema)에 있습니다.

<Warning>
  스키마를 바꿔도 **이미 끝난 분석의 결과는 바뀌지 않습니다.** 분석은 실행 시점의 스키마를 동결해 보관하기 때문입니다. 새 스키마는 다음 분석부터 적용됩니다.
</Warning>

## 참고 사항 편집

액션이 정책 의도를 잘못 옮겼을 때 가장 먼저 손볼 곳입니다. **참고사항 편집** 창의 텍스트 영역에 항목이 `- ` 로 시작하는 줄로 나열됩니다.

<Frame caption="참고사항 편집 — 한 줄이 항목 하나입니다.">
  <img src="https://mintcdn.com/argosidentity/uzgj8WfVduVpDN5-/images/omni/ko/workflow-edit-reference-notes.png?fit=max&auto=format&n=uzgj8WfVduVpDN5-&q=85&s=be3a82ad41f4aa5f40c4d7168b726cb1" alt="참고사항 편집" width="3705" height="1971" data-path="images/omni/ko/workflow-edit-reference-notes.png" />
</Frame>

| 조작          | 동작                  |
| ----------- | ------------------- |
| Enter       | 새 `-` 항목을 만듭니다      |
| Shift+Enter | 현재 항목을 다음 줄에 이어 씁니다 |

| 제한     | 값       |
| ------ | ------- |
| 항목 수   | 액션당 20개 |
| 항목당 길이 | 500자    |

저장하면 기존 목록을 **전체 교체**합니다. 바꾼 것이 없으면 **저장**이 비활성입니다.

## 저장하면 일어나는 일

| 무엇을 바꿨나      | 플레이북 재생성 | `playbookId` | `playbookVersion` |
| ------------ | -------- | ------------ | ----------------- |
| 기본 정보(이름·설명) | 없음       | 유지           | 변동 없음             |
| 플레이북 액션      | 없음       | 유지           | 증가                |
| Step 엔진      | 없음       | 유지           | 증가                |
| 참고 사항        | 없음       | 유지           | 증가                |
| 출력 스키마       | 없음       | 유지           | 증가                |

`playbookId`는 워크플로우가 사는 동안 유지되고, 수정할 때마다 `playbookVersion`만 올라갑니다. 과거 분석은 실행 시점의 플레이북을 동결해 두므로 수정의 영향을 받지 않습니다 — [분석 결과 읽기](/ko/omni/guides/reading-analysis-results#어떤-플레이북으로-판정했는가).

바꿀 것이 없으면 "저장할 변경사항이 없습니다"가 표시됩니다.

## 자주 나오는 오류

| 메시지                            | 뜻                                           |
| ------------------------------ | ------------------------------------------- |
| 플레이북이 없는 워크플로우입니다              | 플레이북 생성이 아직 끝나지 않았거나 실패함                    |
| 해당 step을 찾을 수 없습니다             | 다른 곳에서 액션이 지워진 뒤 저장을 시도함. 새로고침 후 재시도        |
| 이미 할당된 엔진입니다                   | 같은 Step에 같은 엔진을 중복 배정                       |
| 이 엔진은 step에서 사용 중이라 제거할 수 없습니다 | 어떤 Step이 아직 그 엔진을 쓰고 있음. Step 엔진 편집에서 먼저 해제 |
| 접근 권한이 없습니다                    | 이 워크플로우를 수정할 권한이 없는 계정                      |

## 관련 문서

* [생성 완료와 워크플로우 상세](/ko/omni/dashboard/workflow-setup/workflow-detail) — 복사·삭제와 프로파일 표
* [정책 작성 가이드](/ko/omni/guides/policy-writing-guide) — 정책 자체를 다시 써야 할 때