Agent 상태와 설정 관리하기

이 가이드는 이미 생성된 Agent를 안전하게 운영하는 기본 절차입니다. 보이는 제어와 상세 섹션은 권한과 Agent 상태에 따라 달라질 수 있습니다.

1. Agent 찾기

1. 상단 관리자 → 관리 → 에이전트를 엽니다.
2. 검색창과 상태·조직 필터로 대상 Agent를 찾습니다.
3. 대상 카드의 상세 보기를 선택합니다.

목록의 상태는 운영 판단의 출발점입니다. 실행 중인지, 중지됐는지, 오류가 있는지 먼저 확인한 뒤 조치하세요.

2. 상세 정보 점검하기

상세 화면에는 환경에 따라 다음 정보가 표시될 수 있습니다.

• 원격 에이전트 PC 제어
• ClawPod 연결
• AI 리소스 설정
• 채팅 모니터링
• 지표
• 설정
• 로그

문제가 있을 때는 바로 재시작하기보다 AI 리소스 설정, 설정, 로그를 함께 확인하세요. Agent가 기대한 조직, 모델, credential, workspace 설정을 사용 중인지와 최근 오류를 구분하는 데 도움이 됩니다.

3. 시작·중지·재시작

Agent 상세 화면 하단의 제어에서 상태에 맞는 작업을 선택합니다.

• 업무 중단: 실행 중인 Agent를 중지합니다.
• 재시작: 실행 환경을 다시 시작합니다.
• 중지된 Agent에서는 화면에 제공되는 시작 동작을 사용합니다.

이 작업에는 Agent 수정 권한이 필요합니다. 실행 중인 작업이나 대화에 영향이 있을 수 있으므로, 운영 Agent는 Room에 공지하고 현재 작업이 끝났는지 확인한 뒤 중지 또는 재시작하세요.

4. 설정 또는 Credential을 바꾼 뒤

설정 화면에서 SOUL.md를 저장하면 Agent 재시작이 필요할 수 있습니다. 저장 성공만으로 반영 완료를 단정하지 말고 재시작 경고나 실패 여부를 확인한 뒤 Agent 상태와 새 테스트 대화로 검증하세요. AI 연결이나 실행 환경 변경의 재시작 필요성은 해당 화면의 안내를 따르세요.

권장 순서:

1. 변경 대상과 영향받는 Agent를 확인합니다.
2. 안전한 시간에 변경을 저장합니다.
3. 화면이 재시작을 안내한 변경만 필요한 Agent에 적용합니다.
4. Agent 상태와 Room의 작은 요청으로 정상 반영을 확인합니다.
5. Logs와 Metrics에 오류가 없는지 확인합니다.

5. 삭제 전 확인

해고 또는 삭제 작업은 되돌릴 수 없는 운영 변경일 수 있습니다. 삭제 전에는 다음을 확인하세요.

• 이 Agent가 Room, webhook rule, scheduled task 또는 설치된 Skill의 대상인지
• 필요한 workspace 문서나 산출물이 보존됐는지
• 대체 Agent와 담당자가 준비됐는지

삭제 권한도 Agent 수정 권한 범위에 의해 제어됩니다. 권한이 없거나 영향 범위를 확신할 수 없으면 조직 관리자에게 요청하세요.