태블로 에이전트 '오류가 발생했습니다' 에러 해결하기
태블로 서버(2025.3 버전 이상) 설정 메뉴에서 OpenAI 연결 테스트는 '성공'으로 나오지만, 웹 편집 화면에서 태블로 에이전트(Tableau Agent) 기능을 사용하려고 할 때 다음과 같은 오류 메시지가 발생하며 기능이 작동하지 않는 경우가 있습니다.
오류가 발생했습니다. 다시 시도하십시오.
(브라우저 개발자 도구 확인 시 500 Internal Server Error 발생)
이 오류는 태블로 서버의 장애나 설정 문제가 아니라, 연결된 OpenAI API 계정의 크레딧(잔액)이 소진되어 있을 때 주로 발생합니다.
태블로 서버 설정에서의 연결 테스트는 단순히 API 키의 유효성만 확인하는 무료 호출이므로 문제없이 통과합니다. 하지만 웹 편집 화면에서 에이전트가 텍스트를 생성하는 작업은 유료 호출입니다. 따라서 계정에 잔액이 없으면 OpenAI 측에서 잔액 부족을 이유로 요청을 거부하게 되고, 태블로 내부 시스템이 이를 화면에 500 에러로 반환하는 것입니다.
실제로 태블로 서버의 content-exploration 마이크로서비스 상세 로그를 추적해 보면, 다음과 같이 OpenAI 서버가 반환한 429 Too Many Requests (insufficient_quota) 에러를 명확하게 확인할 수 있습니다.
Caused by: org.springframework.web.client.HttpClientErrorException$TooManyRequests: 429 Too Many Requests on POST request for "https://api.openai.com/v1/chat/completions":
"error": {
"message": "You exceeded your current quota, please check your plan and billing details.",
"type": "insufficient_quota",
"code": "insufficient_quota"
}
Solution
오류를 해결하려면 OpenAI 플랫폼(platform.openai.com)의 Billing 메뉴에 접속하여 결제 상태를 확인하고 크레딧을 충전해야 합니다. 결제를 진행하여 크레딧을 충전한 뒤, 해당 권한이 서버에 동기화되기까지 약 5~10분 정도 대기합니다. 이후 태블로 웹 편집 화면을 새로고침하고 태블로 에이전트 기능을 다시 실행하면 정상적으로 작동합니다.
Reference
