> For the complete documentation index, see [llms.txt](https://docs.wrks.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wrks.ai/admin-help/features/agents.md).

# 에이전트 관리 화면의 모든 것

`기업관리자 > 에이전트 관리` 에서 회사 전용 에이전트를 만들고 누구에게 보여줄지 정합니다.

## 에이전트 종류

| 종류             | 누가 쓰나    | 어디서 만드나          |
| -------------- | -------- | ---------------- |
| **전사 에이전트**    | 회사 전체    | 에이전트 관리          |
| **팀 에이전트**     | 지정한 부서만  | 팀 에이전트 관리        |
| **웍스 공식 에이전트** | 웍스AI가 제공 | 만들 수 없음 (노출만 조정) |

부서마다 다른 자료를 쓰게 하려면 **팀 에이전트**로 만드세요. 전사 에이전트에 특정 팀 자료를 올리면 모두가 보게 됩니다.

## 화면에 있는 것

| 항목             | 무엇을 하나                |
| -------------- | --------------------- |
| 에이전트 이름 / 설명   | 직원이 보고 무엇에 쓰는지 알 수 있게 |
| 공개 범위          | 전체 공개 / 일부 공개 / 비공개   |
| 카테고리           | 에이전트를 묶어 정리           |
| 노출 순서          | 목록에서 보이는 차례           |
| 에이전트 메인 노출     | 첫 화면에 띄우기             |
| 노출하기 / 노출 중단하기 | 직원에게 보일지              |
| 복제하기           | 기존 것을 복사해 새로 만들기      |
| 매니저 변경         | 담당자 바꾸기               |
| 제작자            | 누가 만들었는지              |

***

## 공개 범위 세 가지

| 범위        | 누가 보나         |
| --------- | ------------- |
| **전체 공개** | 회사 전체         |
| **일부 공개** | 지정한 사람·조직만    |
| **비공개**   | 만든 사람만 (테스트용) |

**만드는 중에는 비공개로 두세요.** 완성되면 공개로 바꾸시면 됩니다. 화면에도 "충분히 검토/수정하신 후 메인에 노출해 보세요" 라고 안내가 나와요.

일부 공개는 이름·이메일이나 조직으로 대상을 추가합니다.

## 노출 대기중이란

만들었지만 아직 직원에게 안 보이는 상태예요. **노출하기**를 눌러야 직원 화면에 나타납니다.

## 메인 노출

첫 화면에 크게 띄웁니다. 자주 쓰는 에이전트를 올려두면 직원들이 쉽게 찾아요. **노출 순서**로 차례를 정할 수 있습니다.

## 카테고리

에이전트가 많아지면 카테고리로 묶어 정리합니다.

카테고리 이름 위에 마우스를 올리면 아래 조작을 할 수 있어요.

| 항목            | 무엇을 하나                                       |
| ------------- | -------------------------------------------- |
| `카테고리 추가`     | 새 카테고리를 만듭니다                                 |
| `카테고리 수정`     | 카테고리 이름을 바꿉니다                                |
| `카테고리 공개 범위`  | 이 카테고리를 누구에게 보여줄지 정합니다 (전체 공개 / 일부 공개 / 비공개) |
| `카테고리 매니저 변경` | 이 카테고리를 맡을 담당자를 지정합니다                        |

**카테고리 노출 순서**는 이름을 잡고 좌우로 끌어 바꾸실 수 있어요.

카테고리별로 담당자를 두려면 `카테고리 매니저 변경` 으로 지정하시면 됩니다. 그 사람은 맡은 카테고리만 관리할 수 있어요. → [사용자 관리 화면에서 할 수 있는 모든 것](/admin-help/account/user-management.md)

> 카테고리는 최소 1개가 남아 있어야 합니다.

## 복제하기

비슷한 에이전트를 여러 개 만들 때 씁니다. 복제한 것은 먼저 **비활성 탭**으로 들어가니, 수정한 뒤 노출하시면 됩니다.

***

## 자주 묻는 질문

### Q. 에이전트가 자꾸 틀린 답을 해요.

대부분 자료가 부족하거나 지시문이 모호해서예요.

* 답에 필요한 자료가 실제로 올라가 있는지 확인
* 지시문에 "모르면 모른다고 답해라" 를 넣기
* 오래된 자료 지우기 (옛 자료를 보고 답할 수 있어요)

### Q. 만들었는데 직원 화면에 안 보여요.

`노출 대기중` 상태일 수 있어요. **노출하기**를 눌러주세요. 공개 범위가 `비공개` 로 돼 있어도 안 보입니다.

### Q. 특정 부서만 쓰게 하려면?

**팀 에이전트 관리**에서 만들고 부서를 지정하세요. 전사 에이전트라면 공개 범위를 **일부 공개**로 두고 대상을 지정하시면 됩니다.

### Q. "부서 관리 메뉴에서 부서를 먼저 생성해 주세요" 라고 나와요.

팀 에이전트는 부서를 지정해야 해서 조직도가 먼저 필요해요. `기업관리자 > 부서 관리` 에서 부서를 만들어 주세요.

### Q. 자료를 바꾸면 바로 반영되나요?

올린 자료를 처리하는 데 잠시 걸립니다. 조금 기다린 뒤 확인해 주세요.

### Q. 어떤 파일을 올릴 수 있나요?

문서, 표, 발표자료 등 일반적인 업무 파일을 올릴 수 있어요. 스캔 이미지는 글자 인식이 필요하니 `파일 통제` 에서 문서 전처리를 켜두시면 좋습니다.

### Q. 만들면 요금이 나오나요?

만드는 것 자체는 요금이 없어요. 직원들이 쓴 만큼만 나갑니다.

### Q. 노출을 중단하면 어떻게 되나요?

직원 화면에서 사라집니다. 이미 나눈 대화는 각자 대화 목록에 남아요. 나중에 다시 켤 수 있습니다.

### Q. 삭제와 노출 중단이 뭐가 다른가요?

* **노출 중단** — 잠시 감추기. 되돌릴 수 있어요
* **삭제** — 완전히 지우기. 되돌릴 수 없어요

### Q. 매니저 변경은 뭔가요?

그 에이전트를 관리할 담당자를 바꿉니다. 담당자가 바뀌거나 퇴사할 때 쓰세요.

### Q. 사내 시스템과 연결하고 싶어요.

`기업관리자 > 에이전트 도구 관리` 에서 연결한 도구를 붙일 수 있어요. → [에이전트 도구 관리 화면의 모든 것](/admin-help/integrations/internal-systems.md)

### Q. 직원들이 에이전트가 있는 줄 몰라요.

메인 노출을 켜고, `공지사항 관리` 에서 안내를 띄워보세요. → [공지사항 관리 화면의 모든 것](/admin-help/features/notices.md)

### Q. 비서로 만들어둔 게 있는데 어떻게 하나요?

→ [비서 기능이 없어졌어요](/admin-help/features/assistant-sunset.md)

## 이럴 땐 문의해 주세요

* 자료를 올렸는데 계속 처리가 안 될 때
* 특정 파일만 인식이 안 될 때


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.wrks.ai/admin-help/features/agents.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.