> 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/user-guide/undefined.md).

# 팀 에이전트 이용 방법

**팀 에이전트**는 같은 부서에 속한 구성원만 사용하는 부서 전용 에이전트입니다. 보고·기안 절차 안내, 부서 규정 Q\&A, 팀 업무 양식 작성처럼 우리 부서만의 업무를 맡기기에 제격이에요.

### 팀 에이전트의 특징

* **만들기·수정·삭제**: 우리 부서원 누구나 할 수 있어요. 별도 승인 절차 없이 만들면 **즉시 부서 전체에 공유**됩니다.
* **사용**: 해당 부서 구성원만 사용할 수 있어요. 다른 부서에서는 보이지 않고 접근할 수 없습니다.
* **시작 조건**: 내 계정에 **부서가 할당되어 있어야** 해요. 팀 에이전트 화면에 부서가 안 보이면 관리자에게 부서 할당을 요청하세요.

### 만드는 방법

1. **\[AI 대화]** 메인 화면 하단의 **'팀 에이전트'** 탭을 누르고 **\[에이전트 만들기]** 카드를 클릭합니다.
2. **모델**을 선택하고, **에이전트 이름**(짧고 명확하게, 예: 보고/기안 에이전트)과 **에이전트 설명**(한 줄, 예: 우리 팀 보고절차 규정 에이전트)을 입력합니다.
3. **프롬프트**를 한두 줄 적고 **요술봉**을 누르면 전문 프롬프트로 자동 변환돼요. 자유롭게 수정 가능합니다.
4. 필요하면 **참고 파일**을 올리세요. 파일당 최대 100MB, .pdf · .docx · .pptx · .hwp 등 사내 문서 형식을 지원해요. ('AI 문서 인식 성능 자동 향상 기능' 대상 파일은 최대 50MB)
5. 필요하면 **도구**를 연결하세요 (최대 5개). 예를 들어 인사·경영지원팀이라면 **국가법령정보 + 국가통계포털(KOSIS)** 조합을 추천해요.
6. \*\*\[만들기]\*\*를 누르면 승인 절차 없이 같은 부서 구성원 모두에게 바로 노출됩니다.

{% hint style="info" %}
꿄 필요한 파일이 없다면 올리지 않는 편이 좋아요. 파일이 많을수록 응답 성능이 떨어질 수 있습니다.
{% endhint %}

### 수정·삭제와 주의사항

카드의 연필 아이콘을 누르면 생성 화면과 동일한 수정 모달이 열리고, 모델·이름·설명·프롬프트·파일·도구를 모두 변경할 수 있어요.

* 부서원 누구나 수정할 수 있으므로, 중요한 에이전트는 **부서 내 합의 후 수정**하길 권해요.
* **삭제는 복구할 수 없으니** 중요한 프롬프트는 별도로 저장해 두세요.


---

# 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/user-guide/undefined.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.