← 전체 가이드로 돌아가기
02. 에이전트에게 말하기
문제가 생겼을 때
먼저 확인할 내용문제가 생겼을 때 에이전트에게 말하는 법 사이트가 안 열리거나 수정한 내용이 보이지 않으면, 원인을 직접 추측하기보다 지금 보이는 상황부터 알려주세요. 에이전트가 상태를 확인하고, 안전하게 처리할 수 있는 범위와 승인이 필요한 조치를 나눠 안내합니다. 이렇게 말하세요 에러가 보
# 문제가 생겼을 때 에이전트에게 말하는 법
사이트가 안 열리거나 수정한 내용이 보이지 않으면, 원인을 직접 추측하기보다 지금 보이는 상황부터 알려주세요. **에이전트가 상태를 확인하고, 안전하게 처리할 수 있는 범위와 승인이 필요한 조치를 나눠 안내합니다.**
---
## 이렇게 말하세요
### 에러가 보일 때
```
예약 버튼을 누르면 빈 페이지가 나와. 고쳐줘.
```
```
관리자 페이지에 로그인이 안 돼.
```
```
배포했는데 사이트가 안 열려.
```
### 수정이 반영 안 될 때
```
관리자에서 전화번호 바꿨는데 홈페이지에 안 바뀌어.
```
```
블로그 글 올렸는데 목록에 안 보여.
```
### 뭔가 이상할 때
```
홈페이지가 갑자기 느려졌어. 확인해줘.
```
```
어제까지 잘 되던 게 오늘 안 돼.
```
---
## 에이전트가 하는 일
에이전트에게 문제를 전달하면 다음 순서로 확인합니다.
1. **현재 상태 진단**: 시스템, DB, 빌드 상태 점검
2. **원인 파악**: 에러 로그, 설정 파일, 코드 변경 이력 확인
3. **해결 방법 제안**: 영향 범위와 복구 방법을 함께 설명
4. **수정 또는 확인 요청**: 안전한 조치는 진행하고, 위험하거나 선택이 필요한 조치는 먼저 승인 요청
5. **결과 보고**: 뭘 고쳤는지, 재발 방지를 위해 뭘 알아야 하는지
---
## 더 좋은 결과를 위한 팁
### 스크린샷이 있으면 공유하세요
에러 메시지나 이상한 화면을 캡처해서 전달하면 진단이 빨라집니다.
### 언제부터 이랬는지 말해주세요
```
"어제 업데이트 받은 후부터 이래"
"오늘 아침에 처음 발견했어"
"수정하려다가 이렇게 됐어"
```
시점 정보가 있으면 원인을 훨씬 빠르게 찾을 수 있습니다.
### 뭘 했는지 말해주세요
```
"관리자에서 프로그램 가격을 수정한 직후"
"배포 버튼 누른 다음에"
"아무것도 안 했는데 갑자기"
```
---
## 기억하세요
- **처음부터 원인을 알 필요는 없습니다.** 보이는 증상과 발견한 시점만 알려주셔도 됩니다.
- **명령어를 외울 필요도 없습니다.** 하고 싶은 일과 불편한 점을 평소 말하듯 적어주세요.
- **수정 결과는 꼭 확인하세요.** 에이전트의 결과 보고에서 바뀐 내용과 남은 확인 사항을 함께 볼 수 있습니다.
---
## 관련 콘텐츠
- 📹 **관련 영상**: 커리큘럼 5-3. 문제가 생겼을 때
- 📋 **워크숍**: W4 M5에서 다룸
요약과 검수 정보이 페이지에서 확인할 내용
문제가 생겼을 때 에이전트에게 말하는 법 사이트가 안 열리거나 수정한 내용이 보이지 않으면, 원인을 직접 추측하기보다 지금 보이는 상황부터 알려주세요. 에이전트가 상태를 확인하고, 안전하게 처리할 수 있는 범위와 승인이 필요한 조치를 나눠 안내합니다. 이렇게 말하세요 에러가 보
- 질문
- 문제가 생겼을 때을 실제 운영에서 어떻게 적용하나요?
- 대상
- ClinicOS를 설치하거나 직접 운영하는 한의원 담당자
- 결론
- 문제가 생겼을 때 에이전트에게 말하는 법 사이트가 안 열리거나 수정한 내용이 보이지 않으면, 원인을 직접 추측하기보다 지금 보이는 상황부터 알려주세요. 에이전트가 상태를 확인하고, 안전하게 처리할 수 있는 범위와 승인이 필요한 조치를 나눠 안내합니다. 이렇게 말하세요 에러가 보
작성·검수: ClinicOS 제품·운영팀 · 문서 검증 [email protected] · 리비전 4 · 마지막 확인 2026-09-01 · 본문과 문서 메타데이터에서 자동 구성한 요약