# 에이전트란

> **이 장에서 배우는 것**
> Connect에서 에이전트가 무엇을 뜻하는지, 다섯 종류를 언제 쓰는지, 목록 화면을
> 읽는 법.

## 일을 처리하는 주체

[개념 트랙에서 본 에이전트](/guide/ai-agent-basics)는 "목표를 받고 스스로 도는
루프"였습니다. Connect에서 **에이전트**는 조금 더 넓은 뜻으로 쓰입니다.

> **워크스페이스에서 일을 처리하는 것들의 총칭**입니다.

## 에이전트 화면

왼쪽 메뉴의 **에이전트**로 들어갑니다.

![에이전트 목록 화면](/guide-assets/cn-agents.png)

카드 하나가 에이전트 하나입니다.

| 위치 | 뜻 |
|---|---|
| 왼쪽 위 배지 | 종류 — `Sub-Agent` · `APP` · `HTTP` · `CLI` · `시스템` |
| 이름 아래 `@핸들` | 호출용 핸들. 대화에서 `@이름`으로 부름 |
| 하단 숫자 둘 | 사용한 사람 수 · 호출 횟수 |
| 오른쪽 아래 배지 | **공개** 또는 **비공개** |
| 왼쪽 아래 토글 | **활성화** 여부 |
| 하트 | 즐겨찾기 |

상단 필터로 `워크스페이스 / 공개 / 내 에이전트 / 즐겨찾기`를 오가고, 그 아래
줄에서 **종류**(Sub-Agent · 도구 · HTTP · CLI · 시스템)와 **공개 범위**로 다시
좁힙니다.

## 다섯 종류

| 종류 | 무엇인가 | 언제 쓰나 |
|---|---|---|
| **서브 에이전트** | 역할·말투·지시문을 정해둔 담당자 | 같은 유형의 요청을 반복할 때 |
| **MCP 서버** | 외부 도구 묶음 | GitHub, Slack, 사내 DB 연결 |
| **HTTP 액션** | API 하나를 부르는 동작 | 사내 API 하나만 필요할 때 |
| **CLI 액션** | 명령 하나를 실행 | 정해진 스크립트 실행 |
| **시스템** | 등록된 내 컴퓨터 | 실제 파일 작업이 필요할 때 |

## 어디서부터 시작하나

**서브 에이전트부터 시작하세요.**

```mermaid
graph TD
  A["서브 에이전트<br/>외부 연결 없음"] --> B["MCP 서버<br/>도구 묶음 연결"]
  B --> C["HTTP · CLI 액션<br/>특정 동작"]
  C --> D["시스템<br/>내 컴퓨터"]
```

이유가 셋입니다.

1. **외부 연결이 필요 없습니다.** 지시문만 쓰면 됩니다
2. **효과가 바로 보입니다.** 반복 요청이 사라집니다
3. **연습이 됩니다.** [좋은 지시 쓰기](/guide/ai-intent-context)가 그대로 적용됩니다

## 공개 범위와 활성화는 다릅니다

자주 헷갈리는 지점입니다.

```mermaid
graph TD
  A["에이전트"] --> B["공개 범위<br/>누가 볼 수 있는가"]
  A --> C["활성화<br/>지금 쓸 수 있는가"]
  B --> B1["공개 — 워크스페이스 전원"]
  B --> B2["비공개 — 만든 사람만"]
  C --> C1["켜짐 — 대화에서 선택 가능"]
  C --> C2["꺼짐 — 목록에는 있지만 안 쓰임"]
```

조합으로 보면 이렇습니다.

| 공개 | 활성화 | 상태 |
|---|---|---|
| 비공개 | 켜짐 | 만든 사람만 사용. **다듬는 중** |
| 공개 | 켜짐 | 팀 전체가 사용. **정상 운영** |
| 공개 | 꺼짐 | 보이지만 못 씀. **잠시 내림** |
| 비공개 | 꺼짐 | 사실상 보관 |

> **지우는 대신 비활성화하면** 설정과 이력이 남습니다. 나중에 다시 켤 수 있습니다.

## 에이전트가 쌓이면

| 문제 | 대처 |
|---|---|
| 비슷한 게 여럿 | 하나로 합치기 |
| 안 쓰는 게 많음 | 비활성화 |
| 뭐가 뭔지 모르겠음 | 설명을 채우기 |

[도구가 많아질 때의 문제](/guide/mcp-too-many-tools)와 같은 이야기입니다. 후보가
많으면 고르기 어려워집니다.

---

## 확인

**1. 서브 에이전트부터 시작하라는 이유 세 가지는?**

<details>
<summary>답</summary>

**외부 연결이 필요 없고, 효과가 바로 보이고, 좋은 지시 쓰기 연습이 되기**
때문입니다. 지시문만 쓰면 되므로 시작하기 가장 쉽습니다.
</details>

**2. "공개인데 비활성화" 상태는 언제 씁니까?**

<details>
<summary>답</summary>

**잠시 내릴 때**입니다. 팀에게 보이지만 아무도 쓸 수 없습니다. 지우는 대신
비활성화하면 설정과 이력이 남습니다.
</details>

**3. 에이전트가 너무 많아지면 왜 문제입니까?**

<details>
<summary>답</summary>

**고르기 어려워지기 때문**입니다. 도구가 많아질 때와 같은 문제로, 안 쓰는 것은
비활성화하는 게 좋습니다.
</details>

---

직접 하나 만들어봅니다 → [서브 에이전트 만들기](/guide/cn-create-agent)