# 워크플로우 오류 강조 표시 및 해결하기

**목차**

* [개요](#개요)
* [이 기능이 중요한 이유](#이-기능이-중요한-이유)
* [주요 기능](#주요-기능)
* [오류 해결 AI 사용하기 (단계별 가이드)](#오류-해결-ai-사용하기-단계별-가이드)
* [오류 해결 유형](#오류-해결-유형)
* [자주 묻는 질문](#자주-묻는-질문)

***

## 개요

* 오류 강조 표시 및 AI 오류 해결 기능을 통해 워크플로우 내 오류를 빠르게 식별하고 이해하며 해결할 수 있습니다.
* 이 기능은 사이드 패널의 오류 탭에서 직접 시각적 단서, 실행 가능한 인사이트, 명확한 문제 해결 가이드를 제공합니다.
* 오류 강조 표시 범위가 확장되어 실행에 영향을 미치기 전에 더 많은 설정 오류를 감지할 수 있습니다. 또한 저장 버튼을 클릭할 때 유효성 검사가 실행되므로 If/Else(조건 분기) 및 Wait(대기)와 같은 액션의 문제가 라이브 실행 중이 아닌 변경 사항을 커밋하는 순간 플래그됩니다.

## 이 기능이 중요한 이유

* **워크플로우 안정성 향상**: 오류를 빠르게 강조 표시하고 해결을 도와 워크플로우가 원활하게 실행되도록 보장합니다.
* **시간 절약**: 오류에 대한 직접적인 설명과 권장 수정 사항을 제공하여 추측을 없앱니다.
* **사용자 신뢰도 증대**: 외부 지원 없이도 복잡한 워크플로우를 쉽게 문제 해결할 수 있게 해줍니다.

## 주요 기능

오류 강조 표시는 이제 액션과 트리거 전반에 걸친 더 많은 워크플로우 구성을 다루어 불완전한 설정으로 워크플로우를 발행할 가능성을 줄입니다.

**1. 사이드 패널의 오류 버튼:**

* 워크플로우 빌더 내 왼쪽 사이드 패널에 위치
* 오류 버튼을 클릭하면 감지된 모든 오류 목록을 명확하게 표시하는 오류 패널이 열림
* 두 가지 카테고리로 구분:
  * **연동 문제(Integration Issues)**: 연동과 관련된 오류
  * **필수 필드 누락(Missing Mandatory Fields)**: 액션이나 트리거에서 중요한 데이터가 누락되어 발생하는 오류

![오류 패널 예시](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155043843603/original/mutkR7LITuWYwV8PaSfMBD5JiOGlze-4Tg.png?1742819719)

**2. 시각적 오류 강조 표시:**

* 액션과 트리거 옆(우측 하단 모서리)에 오류 아이콘이 나타남
* 워크플로우 빌더 내에서 쉽게 식별할 수 있도록 오류가 강조 표시됨

### If/Else 및 Wait 액션에 대한 저장 시점 검증

Hyperclass는 저장 버튼을 클릭할 때 추가 검증 확인을 실행합니다. If/Else(조건 분기)나 Wait(대기) 액션이 잘못 구성된 경우, 빌더가 해당 단계를 강조 표시하고 오류 패널에 문제를 나열하여 발행 전에 수정할 수 있도록 합니다.

**팁**: 오류의 의미를 확실하지 않다면 오류 패널의 'AI로 해결하기'를 사용하여 안내 단계를 받고 올바른 구성 영역으로 직접 이동하세요.

![저장 시점 검증 예시](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155043843758/original/CIBlNwX4eJDjal6n3Dug-DrwRmcjJDg8Ng.png?1742819829)

**3. 오류 패널**

* 새로운 사이드 패널 도입
* 하나의 패널에서 워크플로우와 관련된 모든 오류를 확인할 수 있음

![오류 패널 인터페이스](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155043843850/original/uKn_iA1gY8cL6R3T5_tazD7qsVxGQ1kopQ.png?1742819881)

**4. AI 기반 오류 해결:**

* AI 어시스턴트가 오류에 대한 자세한 설명을 제공하고 해결을 위한 실행 가능한 단계를 제안
* 사용자는 AI 어시스턴트에서 직접 권장 사항을 보고 수정 사항을 적용할 수 있음
* 즉각적인 문제 해결을 위한 전용 "AI로 해결하기" 버튼 제공
* 버튼을 클릭하면 AI 어시스턴트가 해결 단계를 공유하고 구성을 위한 액션/트리거 사이드바가 열림

![AI 해결 기능 1](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155043843991/original/0L7EI_fqK6WTaTTKzCCN5BLZCMN_TsW-8A.jpeg?1742819949)

![AI 해결 기능 2](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155043844063/original/9VISRPn3TvHSO25lToLra0lp15-tRFN0zg.jpeg?1742819970)

**5. 오류 탭 표시 비활성화:**

* 사용자가 오류 탭을 항상 표시하고 싶지 않다면 숨길 수 있음
* 사이드 패널 설정에서 토글 버튼을 통해 사용자 선호에 따라 탭을 비활성화하거나 다시 활성화할 수 있음

![오류 탭 설정](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155043844132/original/ptfgK4QqE7o4CPQBdqoX9N5lpED10HH7QA.png?1742820020)

***

## 오류 해결 AI 사용하기 (단계별 가이드)

**1단계: 오류 식별**

* 워크플로우 빌더에서 ⚠️ 오류 아이콘으로 오류가 강조 표시됨
* 사이드 패널의 오류 탭을 클릭하여 전체 오류 목록을 확인

**2단계: AI 어시스턴트를 사용하여 오류 해결**

* 해당 오류 옆의 "AI로 해결하기" 버튼을 클릭
* AI 어시스턴트가 왼쪽 패널에 열리며 다음을 제공:
  * 오류 설명: 오류의 원인
  * 제안된 수정 사항: 문제 해결을 위한 실행 가능한 단계

**3단계: 수정 사항 적용**

* 사용자는 액션/트리거 사이드바에서 제안된 수정 사항을 적용할 수 있음
* 수정이 외부 연동과 관련된 경우, AI가 적절한 구성 설정으로 안내

**4단계: 확인 및 계속**

* 오류가 해결되면 오류 아이콘(⚠️)이 사라져 문제가 해결되었음을 확인
* 문제가 해결되면 사이드 패널 목록에서 오류가 자동으로 제거됨

***

## 오류 해결 유형

**1. 연동 문제**

* 오류: 잘못된 인증으로 인해 Facebook 연동이 실패했습니다.
* 해결 방법: AI 어시스턴트가 연동을 다시 연결하거나 재인증하도록 안내합니다.

**2. 필수 필드 누락**

* 오류: 스냅샷 가져오기에서 필수 필드(예: 예약 날짜, 커스텀 필드 등)가 누락되었습니다.
* 해결 방법: AI 어시스턴트가 누락된 필드를 나열하고 매핑하거나 새로 생성할 수 있는 옵션을 제공합니다.

***

## 자주 묻는 질문

**Q. 오류 아이콘을 영구적으로 숨길 수 있나요?** A. 네, 사이드 패널 설정에서 토글을 끄시면 됩니다.

**Q. 오류가 발견되면 발행된 워크플로우가 초안 단계로 이동하나요?** A. 아니요, 워크플로우는 초안 단계로 이동하지 않습니다.

***

*원문 최종 수정: Thu, 26 Feb, 2026 at 7:47 AM* *Hyperclass 사용 가이드 — hyperclass.ai*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hyperclass.gitbook.io/hyperclass-docs/workflows/workflows-pro-plan-new-pricing-tiers/highlighting-resolving-errors-in-a-workflow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.