문제 해결
실행 실패
History에서 실패한 실행을 찾고, 오류를 읽고, 일반적인 원인을 해결하는 방법.
단계를 끝낼 수 없으면 실행이 실패합니다. 도구에서 오류가 발생하거나, 앱이 연결되지 않았거나, 워크스페이스에 크레딧이 없거나, 요금제에서 해당 단계를 허용하지 않는 경우입니다. 모든 실행은 저장되므로, 나중에 무슨 일이 있었는지 확인할 수 있습니다.
증상#
- 에이전트가 중간에 멈추거나 비어 있거나 일반적인 답변을 내놓습니다.
- 워크플로가 일찍 종료되거나, 배치 행에 Failed가 표시됩니다.
- 예약 실행이 아무것도 하지 않았습니다.
- 게시를 클릭한 뒤 “Validation failed. Please fix the errors highlighted on the components.“와 같은 오류 배너가 표시됩니다.
History에서 실행 찾기#
- 사이드바에서 History를 클릭합니다.
- Error messages 필터를 켜면 오류가 포함된 세션만 표시됩니다. Agent or workflow와 챗봇으로도 필터링할 수 있습니다.
- 세션을 엽니다. Plain 또는 Verbose를 사용해 표시되는 세부 정보의 양을 변경합니다.
- 이벤트를 아래로 읽어갑니다. 이벤트에는 User message, Chatbot output, System message, Chat hook, Tool Call, Agent Query 라벨이 붙습니다. 오류를 보고하는 이벤트를 찾으려면 Tool Call 이벤트를 확인하세요.
표 위의 지표 패널(Show metrics)은 시간 경과에 따른 Total errors를 차트로 보여줍니다. 기록을 얼마나 거슬러 볼 수 있는지는 요금제에 따라 제한됩니다. 요금제와 한도를 참고하세요. 배치 실행의 경우 표에 Status와 Error 열이 있고, Re-run Failed 또는 Retry row로 실패한 행을 다시 실행합니다.
일반적인 오류와 해결 방법#
| 표시되는 내용 | 원인 | 해결 방법 |
|---|---|---|
| “Insufficient credits to perform this action. Please recharge your credits.” | 잔액이 비어 있음 | 크레딧 소진 |
| “Workspace credit limit reached” | 워크스페이스 지출 한도 | Settings → Credits에서 한도를 높이세요 |
| “NAME is not configured. Please set up the integration first.” | 해당 단계에 연결되지 않은 앱이 필요함 | Integrations에서 연결하세요 |
| “…is connected but is missing the permissions it requires. Please reconnect the integration and grant the additional permissions.” | 연결에 권한이 없음 | 다시 연결하고 모든 권한을 승인하세요 |
| “…requires re-authorization. The refresh token is expired or revoked. Please reconnect the integration.” | 로그인이 만료되거나 취소됨 | 계정을 다시 연결하세요 |
| “Component NAME can only be used with … plan” | 해당 단계가 요금제에 포함되지 않음 | 단계를 교체하거나 업그레이드하세요 |
| “Allowed limit of … reached. Please upgrade your plan.” | 무언가를 만드는 중에 요금제 한도에 도달함 | 하나를 제거하거나 업그레이드하세요 |
| “Validation failed. Please fix the errors highlighted on the components.” | 단계에 필수 설정이 빠져 있음 | 강조 표시된 단계를 수정한 뒤 다시 게시하세요 |
예약 실행#
워크스페이스의 크레딧이 소진되면, 시스템은 영원히 재시도하는 대신 일정을 꺼버립니다. 크레딧이 생기면 일정을 열어 다시 활성화하세요. 일정을 참고하세요.
해결하기#
- 실패한 세션을 찾아 오류 메시지를 그대로 복사합니다.
- 표에서 해당 항목을 찾아 해결 방법을 적용하고 같은 입력으로 다시 실행합니다.
- 외부 서비스에서 발생한 오류이고 이유를 알 수 없다면, 캔버스에서 해당 단계만 따로 테스트하세요. 테스트와 실행 로그를 참고하세요.
실행 비용 확인하기
실행에 무엇이 소요됐는지 확실하지 않다면 Transactions를 확인하세요. 각 청구 내역은 유형과 컨텍스트와 함께 표시됩니다. 크레딧을 참고하세요.