AI 에이전트가 답을 못 할 때

## 먼저 확인할 것 | 증상 | 확인 | |---|---| | AI 에이전트 메뉴가 안 보인다 | 역할 권한 — 읽기 전용·인사(HR) 역할은 사용할 수 없습니다 | | "API 키가 없습니다" | 설정 → AI Agent 탭에서 제공자 API 키 등록 필요 | | 답변이 안 오거나 매우 느리다 | 외부 데이터 조회 지연 | | "데이터가 없다"고만 답한다 | 해당 채널 미연동 또는 권한 범위 밖 | | 음성 답변이 안 나온다 | 브라우저 오디오가 아직 활성화되지 않음 | ## 메뉴가 안 보인다 AI 에이전트는 **오너 · 관리자 · 팀원 · 마케팅** 역할만 사용할 수 있습니다. 읽기 전용과 인사(HR) 역할은 대상이 아닙니다. 셀프 가입 계정은 읽기 전용으로 시작하므로 가입 직후에는 보이지 않습니다. 오너에게 역할 변경을 요청하세요 → [계정 구조와 역할](/news/guide/account-structure) ## "API 키가 설정되지 않았습니다" AI 에이전트는 외부 AI 모델을 사용하므로 **제공자 API 키가 필요**합니다. 1. **설정 → AI Agent** 탭으로 이동 2. 사용할 제공자(Claude · GPT · Gemini) 중 하나 이상의 API 키 등록 3. 사용할 기본 모델 선택 사내 폐쇄망 환경이라면 COMKEY Private LLM 을 사용할 수 있습니다. ## 답변이 느리다 AI 에이전트는 질문에 답하기 위해 **실제 데이터를 조회**합니다. 연동한 채널의 외부 API 를 부르는 경우 그만큼 시간이 걸립니다. | 원인 | 대응 | |---|---| | 여러 채널을 한 번에 물어봤다 | 질문을 쪼개세요. "광고비" 와 "매출" 을 따로 물으면 각각 빠릅니다 | | 긴 기간을 조회했다 | 기간을 좁히세요. "지난 3개월 일별" 보다 "지난주" 가 훨씬 빠릅니다 | | 특정 채널이 응답이 없다 | 그 채널 연동 상태 확인 → [연동 상태 · 재인증](/news/guide/integration-refresh) | | 이미지를 여러 장 첨부했다 | 이미지 분석은 시간과 비용이 더 듭니다. 필요한 것만 첨부 | ## "데이터가 없다"고 답한다 AI 에이전트는 **화면과 같은 데이터**를 봅니다. 화면에 없는 것은 답할 수 없습니다. 확인 순서: 1. **그 채널을 연동했는가** — 미연동이면 에이전트도 조회할 수 없습니다 2. **화면에는 값이 있는가** — 화면에도 없으면 데이터 문제입니다 → [데이터가 보이지 않을 때](/news/guide/trouble-data) 3. **내 역할이 그 영역을 볼 수 있는가** — 질문한 사람의 권한이 적용됩니다. 예를 들어 마케팅 역할은 재무·은행 데이터를 조회할 수 없어, 물어봐도 답하지 못합니다 ## 답변 내용이 부정확하다 에이전트에게 **회사 맥락**을 주면 답변 품질이 크게 올라갑니다. - **설정 → AI Agent → 업무 지침** 에 회사 상황·용어·판단 기준을 적어 두세요 (예: "주력 채널은 스마트스토어", "광고 ROAS 목표는 300%", "매출은 부가세 제외 기준") - 질문에 **기간과 기준을 명시**하세요. "요즘 어때?" 보다 "지난 7일 매출을 전주와 비교해줘" - 숫자가 중요한 보고라면 **해당 화면에서 교차 확인**하세요 ## 음성이 동작하지 않는다 ### 음성 답변이 안 나옴 브라우저는 사용자 조작 없이 소리를 재생하지 못합니다. **마이크 버튼을 한 번 누르면** 오디오가 활성화되고, 이후 음성 답변이 재생됩니다. ### 음성 입력이 안 됨 - 브라우저의 **마이크 권한**을 허용했는지 확인하세요 (주소창 좌측 아이콘) - 다른 앱이 마이크를 점유하고 있으면 실패할 수 있습니다 - HTTPS 가 아닌 환경에서는 브라우저가 마이크 접근을 막을 수 있습니다 ## 응답에 코드 블록이나 이상한 기호가 보인다 답변 형식이 깨져 보이면 그대로 캡처해 [문의](/news/guide/contact)해 주세요. 출력 형식은 서비스 쪽에서 조정할 수 있는 부분입니다. ## 비용이 예상보다 많이 나온다 AI 에이전트는 사용량만큼 과금되는 외부 모델을 씁니다. **설정 → AI Agent → 비용 추적** 에서 사용량과 비용 추이를 확인할 수 있습니다. | 비용이 늘어나는 요인 | 줄이는 방법 | |---|---| | 이미지(Vision) 분석 | 필요한 이미지만 첨부 | | 긴 대화 이어가기 | 주제가 바뀌면 새 대화로 시작 | | 대용량 기간 조회 반복 | 화면에서 볼 수 있는 것은 화면으로 | | 비싼 모델 사용 | 일상 질문은 더 가벼운 모델로 설정 | 같은 화면에서 **비용 한도**를 설정할 수 있습니다. ## 능동 알림이 너무 많이 온다 / 안 온다 **설정 → AI Agent → 능동 알림** 에서 임계값을 조정합니다. - 너무 자주 오면 임계값을 올리세요 (변화 폭이 더 커야 알림) - 안 오면 임계값을 낮추고, 알림 채널이 연결됐는지 확인하세요 - 점검은 매시 정각에 이루어집니다. 설정 직후 바로 오지는 않습니다 ## 그래도 안 되면 [문의](/news/guide/contact) 시 아래를 알려주세요. - 질문한 문장 그대로 - 받은 답변 (스크린샷) - 기대한 답 - 사용한 제공자·모델 - 시각 ## 관련 문서 - [AI 에이전트 시작하기](/news/guide/agent-start) - [AI 제공자와 API 키](/news/guide/agent-providers) — 키 · 잔액 · 모델 확인 - [업무 지침 설정](/news/guide/agent-instructions) — 답변 품질을 올리는 가장 빠른 방법 - [문의하기](/news/guide/contact)