# 에이전트 관리하기
## 심플리에 등록된 기기와 에이전트가 설치된 기기 연결하기
등록된 기기와 설치된 기기는 기본적으로 기기의 일련 번호를 기준으로 자동 연결됩니다. 몇 가지 경우에 의해 자동 연결이 되지 않는 경우가 있습니다.
설정 > 에이전트 관리
#### 에이전트 상태
에이전트는 다음 상태 중 하나를 가집니다.
| 상태 | 설명 | 표시 |
| --------- | ----------------------- | --- |
| **연결됨** | 기기와 정상적으로 연결되어 데이터 수집 중 | 녹색 |
| **연결 대기** | 에이전트가 설치되었으나 기기와 미연결 | 주황색 |
| **오프라인** | 일정 기간 데이터 전송 없음 | 회색 |
| **삭제됨** | 에이전트가 삭제되어 비활성화 | - |
{% hint style="info" %}
**오프라인 상태** 기기가 꺼져 있거나 네트워크에 연결되지 않으면 오프라인으로 표시됩니다. 기기가 다시 연결되면 자동으로 상태가 업데이트됩니다.
{% endhint %}
***
#### 기기 연결
에이전트가 설치된 기기는 일련번호(Serial Number)를 기준으로 자동 연결됩니다.
**시나리오 1: 기존 등록 기기에 연결**
이미 SMPLY에 등록된 기기에 에이전트를 설치한 경우:
**단계 1: 자동 연결 확인**
1. 에이전트 설치 후, **기기 > 목록**에서 해당 기기를 확인합니다.
2. 일련번호가 일치하면 자동으로 연결됩니다.
**단계 2: 수동 연결 (일련번호 없는 경우)**
1. 기존 기기 정보에 일련번호가 없는 기기는 자동 연결되지 않습니다.
2. **에이전트 > 관리**에서 연결 대기 중인 에이전트를 찾습니다.
3. **기기 연결** 버튼을 클릭합니다.
4. 연결할 기기를 선택합니다.
**시나리오 2: 신규 기기 등록과 함께 연결**
SMPLY에 등록되지 않은 기기에 에이전트를 설치한 경우:
**단계 1: 에이전트 확인**
1. **에이전트 > 관리**에서 연결 대기 중인 에이전트를 확인합니다.
**단계 2: 기기 등록 및 연결**
1. 해당 에이전트의 **기기 등록** 버튼을 클릭합니다.
2. 기기 정보를 입력합니다.
3. 저장하면 자동으로 에이전트와 연결됩니다.
{% hint style="warning" %}
**일련번호 없는 기기** 조립 PC 등 일련번호가 없는 기기는 SMPLY에서 임의로 시리얼키가 생성되고 해당 키를 이용하여 연결됩니다.
{% endhint %}
***
#### 에이전트 삭제
퇴사자 기기나 더 이상 사용하지 않는 기기의 에이전트를 삭제할 수 있습니다.
**단계 1: 에이전트 선택**
1. **에이전트 > 관리**로 이동합니다.
2. 삭제할 에이전트를 찾습니다.
**단계 2: 삭제 실행**
1. 에이전트 우측의 **삭제** 버튼을 클릭합니다.
2. 확인 대화상자에서 **삭제**를 클릭합니다.
{% hint style="danger" %}
**삭제 시 영향**
* 에이전트가 삭제되면 해당 기기에서 구성원이 즉시 로그아웃됩니다.
* 더 이상 데이터가 수집되지 않습니다.
* 삭제된 에이전트는 복구할 수 없습니다.
{% endhint %}
***
#### 문제 해결
**에이전트가 연결 대기 상태로 유지됩니다**
**원인 1: 일련번호 불일치**
* 기기에 등록된 일련번호와 에이전트가 감지한 일련번호가 다를 수 있습니다.
* 기기 정보에서 일련번호를 확인하고 수정하세요.
**원인 2: 중복 기기**
* 동일한 일련번호의 기기가 여러 개 등록되어 있을 수 있습니다.
* 중복 기기를 정리한 후 다시 시도하세요.
**에이전트가 오프라인으로 표시됩니다**
**원인 1: 기기 전원 꺼짐**
* 기기가 꺼져 있거나 절전 모드일 수 있습니다.
**원인 2: 네트워크 문제**
* 기기가 인터넷에 연결되어 있는지 확인하세요.
* 방화벽에서 에이전트 통신이 차단되지 않았는지 확인하세요.
**원인 3: 에이전트 프로세스 중단**
* 에이전트 프로세스가 비정상 종료되었을 수 있습니다.
* 기기를 재시작하거나 에이전트를 재설치하세요.
**에이전트 삭제 후에도 데이터가 수집됩니다**
**원인: 기기에 에이전트가 남아있음**
* SMPLY에서 삭제해도 기기의 에이전트는 자동 삭제되지 않습니다.
* 기기에서 에이전트를 직접 제거하세요.
***
#### 자주 묻는 질문
**Q: 하나의 기기에 여러 에이전트를 설치할 수 있나요?**
아니요, 하나의 기기에는 하나의 에이전트만 설치할 수 있습니다. 중복 설치 시 충돌이 발생할 수 있습니다.
**Q: 에이전트를 삭제하면 수집된 데이터도 삭제되나요?**
아니요, 이미 수집된 소프트웨어 사용 데이터는 유지됩니다. 에이전트 삭제 후에는 새로운 데이터만 수집되지 않습니다.
**Q: 에이전트 버전을 업데이트하려면 어떻게 하나요?**
에이전트는 자동 업데이트를 지원합니다. 네트워크에 연결되어 있으면 새 버전이 자동으로 설치됩니다.
**Q: Windows에서 에이전트가 자동으로 실행되나요?**
예. Windows에서 에이전트를 설치하면 \*\*Windows 작업 스케줄러(Scheduled Task)\*\*에 자동으로 등록됩니다. 이를 통해 시스템 시작 시 또는 일정 주기로 에이전트가 자동 실행되어 데이터를 수집합니다.
**Q: 에이전트가 수집하는 데이터는 무엇인가요?**
설치된 소프트웨어 목록, 소프트웨어 사용 시간, 기기 기본 정보(운영체제, 하드웨어 스펙 등)를 수집합니다. 파일 내용이나 개인 데이터는 수집하지 않습니다.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.smply.one/agent/management.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.