에이전트가 응답하지 않습니다

에이전트는 빌더의 테스트 채팅, 사이트의 챗봇, 또는 API를 통해 응답하지 못할 수 있습니다. 원인은 거의 항상 아래 점검 항목 중 하나입니다. 가장 흔하고 가장 빨리 배제할 수 있는 항목부터 순서대로 확인하세요.

증상#

• 메시지를 보냈는데 아무 응답도 돌아오지 않습니다.
• 채팅에 답변 대신 오류가 표시됩니다.
• 챗봇 방문자에게 “Oops! Something went wrong. Please contact website owner!“가 표시됩니다.

예상 원인, 순서대로#

1. 워크스페이스의 크레딧이 소진됨#

에이전트는 크레딧 없이는 실행될 수 없습니다. Read-only mode 알림이 있는지 확인하고 사이드바 하단의 크레딧 수치를 확인하세요. API 호출자는 “Insufficient credits to perform this action. Please recharge your credits.“를 받습니다. 챗봇 방문자에게는 “Sorry, you’ve reached your payment limit.“가 표시됩니다. 크레딧 소진을 참고하세요.

2. 구독이 종료되었거나 워크스페이스가 읽기 전용임#

요금제가 취소된 경우 워크스페이스가 비활성 상태가 되고 “This workspace is inactive because its subscription ended.“와 함께 실행이 거부됩니다. 소유자만 요금제를 다시 선택할 수 있습니다.

3. 에이전트에 필요한 앱이 연결되지 않음#

도구에 연결하지 않은 계정이 필요한 경우 “Slack integration is required, but was not found” 또는 “Component is not integrated"와 같은 경고가 표시되고, 해당 도구에 도달한 실행은 “is not configured. Please set up the integration first.“와 함께 실패합니다. Integrations를 열고 연결하세요. 연동 연결 끊김을 참고하세요.

4. 카테고리 없이 메모리가 켜져 있음#

에이전트 빌더에서 Memory에는 카테고리가 필요합니다. 빌더는 “Pick a category, or turn Memory off. The agent refuses to run while Memory is on with none picked.“라고 경고합니다. Advanced에서 카테고리를 선택하거나 메모리를 끄세요. 메모리와 채팅 기록을 참고하세요.

5. 변경 사항이 저장되었지만 게시되지 않음#

편집 내용은 초안으로 저장됩니다. 사이트의 챗봇을 포함해 실제 에이전트를 사용하는 사람들은 Publish changes를 클릭할 때까지 마지막으로 게시된 버전을 봅니다. 그때까지 트리거에는 “Publish to activate"가 표시됩니다. 공유 및 게시를 참고하세요.

6. 챗봇이 꺼져 있거나 속도 제한이 걸림#

Chatbots에서 챗봇을 열고 Chatbot enabled가 켜져 있는지 확인하세요. 메시지를 너무 많이 보낸 방문자에게는 “Too many requests. Please try again later or sign in to continue.“가 표시됩니다. 제한은 챗봇 설정의 Rate Limiting 아래에 있습니다.

7. 단계나 도구가 실패함#

모델 자체가 작동하더라도 에이전트의 도구나 단계가 실패할 수 있습니다. History를 열고 세션을 찾은 다음 Error messages 필터를 켜고 실패한 이벤트를 확인하세요. 실행 실패를 참고하세요.

해결 방법#

1. 빌더의 채팅에서 짧은 테스트 메시지 하나를 보내고 오류가 있다면 정확한 문구를 기록하세요.
2. 그 문구를 위 목록과 대조하고 해당하는 해결책을 적용하세요.
3. 무언가를 변경했다면 게시한 다음, 실패가 발생한 위치(예: 사이트)에서 다시 테스트하세요.