# 문제 해결

> 에이전트가 엉뚱한 일을 했다, 실행이 끝나지 않는다, 아무 일도 안 일어난다 — 흔한 증상과 각각을 실제로 고치는 방법.

자주 나오는 순서대로 정리한 증상 목록입니다. 커넥터에 한정된 문제는 [별도 페이지](/ko/docs/connect/troubleshooting/)에 있습니다.

## 에이전트가 엉뚱한 일을 했다

무엇을 바꾸기 전에 [실행](/ko/docs/work/runs/)을 읽으세요. 도구 호출이 어디서 어긋났는지 보여주고, 해법은 거기서 따라 나옵니다.

| 실행에서 보이는 것 | 원인 | 해법 |
| --- | --- | --- |
| 도구를 하나도 안 부르고 일반 지식으로 답함 | 찾아봐야 한다는 것을 모름 | [시스템 프롬프트](/ko/docs/build/system-prompt/)에 그렇게 적고, 커넥터가 바인딩됐는지 확인 |
| 맞는 도구를 잘못된 인자로 부름 | 맥락 부족 | 그 사실을 프롬프트나 [메모리](/ko/docs/capabilities/memory/)에 두기 |
| 수렴하지 못하고 맴돎 | 작업 정의 부족, 또는 길이에 비해 [추론 강도](/ko/docs/build/models/#추론-강도)가 낮음 | 작업을 좁히고, 강도를 올리기 |
| 답은 맞는데 쓸 수가 없음 | "다 됐다" 의 기준이 없음 | 원하는 산출물을 프롬프트에 서술 |
| 뻔한 것을 물어봄 | 그 사실이 에이전트가 볼 수 있는 어디에도 없음 | 프롬프트 · 메모리 · [프로젝트](/ko/docs/capabilities/projects/) |

한 문장의 스티어링으로 실행이 매번 살아난다면, 그 문장은 프롬프트에 있어야 합니다. [시험하고 다듬기](/ko/docs/build/iterating/)를 보세요.

## 실행이 끝나지 않는다

**멈춰서 사용자를 기다리는 중입니다.** [질문](/ko/docs/work/questions/), [승인](/ko/docs/work/approvals/), [스킬 요청](/ko/docs/capabilities/skills/#에이전트가-스킬을-요청할-때)은 실행을 무기한 붙잡습니다. 대화 맨 아래로 내려가 보세요. 거기 있습니다.

**단계 한도에 닿았습니다.** 긴 작업은 최종 답 없이 끝납니다. 계속하라고 하거나 작업을 나누세요.

**실패했습니다.** 오류가 대화에 있습니다. 모델 오류는 대개 모델 제공자가 호출을 거부한 것입니다. [BYOK](/ko/docs/account/bring-your-own-key/)를 쓴다면 키와 크레딧을 확인하세요.

**앱을 닫았습니다.** 그것 때문에 멈추지는 않습니다. 실행은 Endue 서버에서 끝나고, 돌아오면 결과가 실 안에 있습니다.

## 메시지를 보내도 아무 일이 없다

- **이미 실행이 돌고 있습니다.** 실행 중에 보낸 메시지는 새 차례를 시작하는 대신 그 실행에 [방향을 잡아줍니다](/ko/docs/work/steering/).
- **허용량을 다 썼습니다.** 그 주의 허용량이 소진되면 실행이 거절됩니다. [요금제와 사용량](/ko/docs/account/plans-and-usage/)을 보세요.
- **로그아웃됐습니다.** 세션은 일정 시간 활동이 없으면 끝납니다. 다시 로그인하면 대화는 두고 간 그대로 있습니다.

## 에이전트가 갖고 있던 능력을 잃었다

| 증상 | 확인할 것 |
| --- | --- |
| 커넥터의 도구가 사라짐 | 연결의 재승인이 필요하거나 바인딩이 풀렸을 수 있음 — [연결 문제 해결](/ko/docs/connect/troubleshooting/) |
| 기억을 못 하기 시작함 | 메모리 [도구 그룹](/ko/docs/capabilities/built-in-tools/)이 꺼져 있을 수 있음 |
| 아티팩트를 저장하지 않음 | 아티팩트 도구 그룹이 꺼져 있을 수 있음 |
| 예전 버전처럼 행동함 | 프롬프트 [리비전](/ko/docs/build/system-prompt/#리비전과-되돌리기)이 복원됐을 수 있음 |

변경은 *다음* 실행부터 적용됩니다. 방금 고친 것을 무시하는 에이전트는 아마 실행 도중일 것입니다.

## 루틴이 돌지 않는다

- **반복 실패로 중지됐습니다.** Endue 는 실패하는 루틴을 영원히 재시도하는 대신 중지하고 알려줍니다.
- **돌았는데 행동을 거절했습니다.** 지켜보는 사람이 없는 실행은 보내거나 지우지 못합니다 — [루틴](/ko/docs/automate/routines/#승인할-사람이-아무도-없다)을 보세요.
- **돌았는데 알아채지 못했습니다.** [인박스](/ko/docs/work/inbox/)를 확인하세요. 산출물은 대개 [아티팩트](/ko/docs/capabilities/artifacts/)로 쌓입니다.

<Aside type="tip" title="새 대화에서 재현해 보세요">
  긴 실은 설정과 무관하게 답을 바꾸는 기록을 안고 있습니다. 원인을 짚기 어려운 문제라면, 에이전트가
  망가졌다고 결론 내리기 전에 새 대화에서 같은 요청을 해보세요.
</Aside>

## 도움 받기

- **문서 검색** — 아무 페이지에서나 <kbd>Ctrl</kbd>/<kbd>⌘</kbd> + <kbd>K</kbd> 를 누르세요.
- **메일 보내기** — [support@endue.ai](mailto:support@endue.ai). 무엇을 요청했는지, 에이전트가 무엇을 했는지, 어느 도구 호출이 어긋났는지를 함께 보내주세요. 대개 그것이면 주고받지 않고 답할 수 있습니다.

## 관련 문서

<CardGrid>
  <LinkCard
    title="연결 문제 해결"
    href="/ko/docs/connect/troubleshooting/"
    description="만료된 토큰, 취소된 접근, 잘못된 계정."
  />
  <LinkCard
    title="시험하고 다듬기"
    href="/ko/docs/build/iterating/"
    description="되풀이되는 문제를 더 나은 에이전트로 바꾸기."
  />
  <LinkCard
    title="실행"
    href="/ko/docs/work/runs/"
    description="실행 읽기, 그리고 실행이 멈추는 모든 이유."
  />
</CardGrid>