워크플로 문제 해결: 어떻게 진단하나요?
워크플로 문제 해결은 컴포넌트, 연결, 인증 정보, 수신 요청의 네 영역 중 처음 실패하는 단계부터 시작하세요. 워크플로의 나머지 부분을 변경하기 전에 해당 단계의 오류와 데이터를 확인하세요. 이 가이드는 오류 색인에 문서화된 실패 유형을 따릅니다.
작성: Ai Flowi · 기술 검토: Janice Lee, 기술 지원, Ai Flowi.
게시일 · 수정일 2026년 10월 9일
관련 점검 항목 선택
컴포넌트 누락, 호환되지 않는 포트, 모델 설정, 가져오기, 컴포넌트 업데이트 문제는 일반적인 오류 문서부터 확인하세요. 인증과 권한은 Google 연결 문서를, 수신 요청이나 응답은 웹훅 문서를 이용하세요. Telegram에만 해당하는 실패라면 Telegram 문제 해결 문서를 열기 전에 웹훅 기본 사항을 확인하세요. 먼저 오류를 읽고, 변경할 때마다 실패하는 최소 단위를 다시 테스트하세요.
- 일반적인 오류에서는 컴포넌트 누락, 호환되지 않는 포트 유형, 모델 설정, 가져오기, 컴포넌트 업데이트를 다룹니다. 편집기에서 연결에 실패하거나 변경 후 워크플로 동작이 달라졌을 때 참고하세요.
- Google 연결에서는 저장된 Connections, 계정 권한, 권한 범위, 재인증을 다룹니다. Google 컴포넌트가 인증하거나 작업을 수행할 수 없을 때 참고하세요.
- 웹훅에서는 거부된 HTTP 메서드, 응답 컴포넌트, 예상한 워크플로 경로에 도달하지 않는 요청을 다룹니다. 수신 요청이나 응답이 실패할 때 참고하세요.
- Telegram 문제 해결에서는 웹훅 기본 사항을 확인한 뒤 Telegram에만 해당하는 실패를 다룹니다.
Telegram에만 해당하는 실패라면 웹훅 기본 사항을 확인한 뒤 Telegram 문제 해결을 참고하세요. Telegram 웹훅 설정과 업데이트 파싱은 문서화된 확장 기능이며 각각의 점검 항목이 있습니다.
유용한 진단 순서
먼저 화면에 표시된 오류나 실패한 컴포넌트를 확인하세요. 두 컴포넌트가 연결되지 않으면 원본 출력의 types와 대상 입력의 accepts를 비교하세요. 서비스 작업이 실패하면 비밀 정보를 공유하지 않고 저장된 인증 정보와 서비스 권한을 확인하세요. 수신 요청은 메서드와 민감한 정보를 제거한 페이로드를 점검한 다음, 응답에 도달할 때까지 워크플로를 따라가세요. 쓰기 실패의 경우 다시 시도하기 전에 재시도 검토용 런북 예제를 사용하여 근거 자료를 정리하세요.
구조적 호환성이 런타임에 인증 정보나 외부 서비스가 작동한다는 것을 보장하지는 않습니다. 변경할 때마다 실패하는 최소 단위를 다시 테스트한 다음, 전체 워크플로를 다시 실행하세요. 워크플로 기본 사항 페이지에서는 데이터 유형에 맞춰 컴포넌트를 연결하는 방법을 설명합니다.
기록된 워크플로 실행 추적 확인
AI Flowi Workflow의 실행 추적(Traces)에서는 기록된 워크플로 실행을 확인할 수 있습니다. 워크플로의 실행 추적(Traces)을 열고 실행을 검색한 다음 성공(Success), 오류(Error) 또는 날짜 범위로 필터링하세요. 실행을 선택하면 추적 상세 정보(Trace Details)가 열립니다. 이 화면은 기록된 추적 데이터를 사용합니다. 목록이 비어 있거나 추적 기록이 없으면 기록되지 않은 실행을 설명할 수 없습니다. 모델 실행의 근거를 해석하려면 추적 상세 정보와 함께 LLM 관측 가능성 가이드를 읽어보세요.
세션별 그룹화(Group by Session)로 표시된 실행을 묶거나, 새로고침(Reload)으로 목록을 다시 불러오세요. 다운로드(Download)는 현재 불러온 실행 행을 JSON으로 내보냅니다.
실행 내 스팬 확인
추적 상세 정보(Trace Details)에는 스팬 트리와 선택한 스팬의 상세 정보 패널이 있습니다. 스팬을 선택하여 상태와 지연 시간을 확인하고, 해당 정보가 기록되어 있으면 모델 이름, 입력, 출력, 오류도 확인하세요.
토큰 사용량이 제공되면 총 토큰 수와 입력(프롬프트) 토큰 수와 출력(응답) 토큰 수가 표시됩니다. 사용량이 없는 LLM 스팬에는 대시가 표시됩니다. 예상 비용(Estimated Cost)은 기록된 토큰 사용량에 포함된 비용이 0보다 큰 경우에만 표시됩니다. 스팬에 입력, 출력, 오류가 없으면 패널은 추가 상세 정보가 없다고 안내합니다.