# 나만의 에이전트 만들기

> Source: https://docs.wrks.ai/user-guide/personal-assistants · Last updated: 2026-11-06

웍스AI v2.0부터는 기존 '나만의 비서'가 더 강력해진 '**나만의 에이전트**'로 새롭게 바뀌었어요. 에이전트는 한 마디로 **역할이 정해진 나만의 AI**입니다. 역할을 한 번만 정해두면 다음부터는 일만 시키면 돼요. 거래처 메일, 주간보고, 회의록 정리 같은 반복 업무가 한 문장으로 끝납니다.

일반 AI 대화와의 차이는 간단해요. 일반 대화는 매번 역할 설명과 요청을 함께 입력해야 하지만, 에이전트는 만들 때 역할을 한 번 등록해두면 (예: "너는 거래처 메일 전문 작성자야. 항상 격식체로, 수신자 이름을 넣어줘.") 그 다음부터는 "김부장님께 납품 일정 안내 메일 써줘" 한 마디면 끝이에요.

웍스AI의 에이전트는 세 가지입니다.

| 구분                                  | 누가 사용                   | 어떻게 만들어지나          |
| ------------------------------------- | --------------------------- | -------------------------- |
| <strong>나만의 에이전트</strong>             | 나 혼자                     | 내가 직접 만들기           |
| <strong>팀 에이전트</strong>                 | 같은 부서 구성원            | 부서원 누구나 만들기·수정 |
| <strong>워크스페이스·전사 에이전트</strong> | 워크스페이스 또는 회사 전체 | 회사(관리자)가 만들어 제공 |

일부 사람에게만 공유된 카테고리의 에이전트는 **'내게 공유된 에이전트'** / **'내게 공유된 전사 에이전트'** 탭에서 볼 수 있어요. 내가 만든 에이전트를 회사 공식 에이전트로 올리고 싶다면 이 페이지 아래 **'회사 공식 에이전트로 등록 신청하기'** 절차를 따르세요.

<figure><img src="/files/VCp1CsluxRYlE82G6qBW" alt="[에이전트 만들기] 카드를 누르면 만들기 창이 열려요. 아래로 내리면 프롬프트, 도구, 스킬을 차례로 고를 수 있어요"><figcaption><p>[에이전트 만들기] 카드를 누르면 만들기 창이 열려요. 아래로 내리면 프롬프트, 도구, 스킬을 차례로 고를 수 있어요</p></figcaption></figure>

이 페이지에서는 **나만의 에이전트 만들기 7 STEP**과 **회사 공식 에이전트 등록 신청**을 안내드려요. (팀 에이전트는 [팀 에이전트 이용 방법](https://docs.wrks.ai/user-guide/team-agents) 페이지에서 안내합니다.)

## STEP 1. 에이전트 만들기 화면 진입

웍스AI에 로그인한 뒤 왼쪽 사이드바 '**업무**' > '**에이전트**'를 누르세요. 홈 아래의 **"에이전트를 골라 일을 맡겨주세요."** 영역에서 **'나만의 에이전트'** 탭을 누르고 **\[에이전트 만들기]** 카드를 클릭하면 생성 팝업이 열려요.

<figure><img src="/files/yX9v4moHn5sa3KDVZMEe" alt="'나만의 에이전트' 탭의 [에이전트 만들기] 카드"><figcaption><p>'나만의 에이전트' 탭의 [에이전트 만들기] 카드</p></figcaption></figure>

## STEP 2. 모델 선택

팝업 상단의 **'모델 선택'** 드롭다운을 클릭해 이 에이전트가 사용할 AI 모델을 정합니다. (모델 검색창도 있어요.) 연결할 도구·프롬프트와의 궁합을 보고 선택하세요. 모델에 따라 옆에서 **생각의 깊이**(답하기 전에 얼마나 오래 생각할지)도 고를 수 있어요.

## STEP 3. 에이전트 이름과 프롬프트 입력

* **에이전트명**: 에이전트 카드와 목록에 보이는 이름이에요. 알아보기 쉽게 지으면 됩니다. (예: "오늘의 법령 메일 공유 에이전트")
* **프롬프트**: 이 에이전트의 캐릭터나 역할을 적는 칸입니다. **뭐하는 에이전트인지 한두 줄만** 쓰시면 충분해요 — 다음 STEP의 요술봉이 전문 프롬프트로 다듬어 줍니다.
* 이 밖에 **아이콘, 에이전트 설명, 대화 시작 가이드(최대 6개), 스킬**도 넣을 수 있어요.
* **에이전트 유형**: 보통은 **대화형**(기본)을 그대로 둬요. **링크형**은 누르면 정해 둔 웹 주소로 이동하는 바로가기예요(아래 '링크형 에이전트' 참고).
* 별표(*)가 붙은 칸(모델 선택, 에이전트 이름, 프롬프트)은 꼭 채워야 해요. 에이전트 설명은 200자까지 쓸 수 있어요.

<figure><img src="/files/kHHDknnRYotzqE4j6FKp" alt="기본 정보 — 에이전트 유형, 모델 선택, 에이전트 이름(별표 칸은 꼭 채워요)"><figcaption><p>기본 정보 — 에이전트 유형, 모델 선택, 에이전트 이름(별표 칸은 꼭 채워요)</p></figcaption></figure>

## STEP 4. 프롬프트 요술봉 활용

한두 줄만 적고 입력란 우측의 **요술봉 버튼**을 눌러보세요. AI가 역할·제약조건·출력 형식이 포함된 전문 프롬프트로 자동 변환해 줍니다. 생성된 프롬프트는 자유롭게 수정할 수 있으니, 내 의도와 맞는지 한번 읽어보고 업무 특성에 맞게 다듬어 주세요.

> **좋은 프롬프트 예시** "너는 우리 팀의 주간보고 정리 담당이야. 내가 메모를 주면 ① 이번 주 한 일 ② 다음 주 할 일 ③ 도움이 필요한 일, 세 칸으로 정리해 줘. 한 칸에 3줄 이하로, 존댓말로 써 줘."

**대화 시작 가이드**: 프롬프트 아래 **가이드 추가**를 누르면 대화를 시작할 때 누르기만 하면 되는 예시 질문 버튼을 만들 수 있어요(최대 6개). 예: "이번 주 메모로 주간보고 써 줘"

<figure><img src="/files/op7J9hAEpGMO6HkHIQyI" alt="프롬프트 칸 오른쪽 요술봉 버튼, 아래 [+ 가이드 추가]로 대화 시작 가이드를 넣어요"><figcaption><p>프롬프트 칸 오른쪽 요술봉 버튼, 아래 [+ 가이드 추가]로 대화 시작 가이드를 넣어요</p></figcaption></figure>

## STEP 5. 참고 파일 업로드 (선택)

에이전트가 **내 파일을 참고해 답변**하길 원하면 파일을 올려주세요.

* **파일당 최대 100MB**, 다중 업로드와 드래그 업로드를 지원해요.
* **내 컴퓨터에서 올리기** 말고도 **웍스 드라이브에서 가져오기**로 웍스 드라이브에 올려 둔 파일을 바로 붙일 수 있어요.
* .pdf, .docx, .doc, .pptx, .hwp, .hwpx 등 사내 문서 형식을 지원하며, 'AI 문서 인식 성능 자동 향상 기능' 대상 파일은 최대 50MB까지 가능합니다.
* 파일을 올리면 대화 시 파일을 먼저 검색해 참고합니다.

**안 올리는 게 나을 수도 있어요.** 파일을 올리면 대화때마다 파일 검색을 거치므로, 반드시 파일 검색이 필요한 경우가 아니라면 올리지 않는 것이 에이전트 성능에 좋습니다.

## STEP 6. 도구 연결하기 (선택)

에이전트가 업무 수행 중 이용할 외부 도구를 연결할 수 있어요. **Notion, Microsoft 365, Google Calendar, 국가법령정보, 국가통계포털(KOSIS)** 등의 도구 중에서 **필요한 것만 골라 최대 5개**까지 선택합니다.

* 처음 쓰는 도구는 카드를 클릭해 해당 서비스에 로그인하면 카드에 '**연결됨**'이 표시돼요.
* 시간이 지나 연결이 '**만료됨**'으로 바뀌면 카드를 다시 클릭해 재로그인하세요. 대화 중에 연결이 끊기면 입력창 하단 도구 아이콘에 빨간 느낌표가 뜨고, 그 아이콘을 클릭하면 대화 화면에서 바로 재연결할 수 있어요.
* 꾸준히 쓸 도구만 선택하세요. 도구가 적을수록 토큰도 아끼고 응답 성능도 올라갑니다.

자세한 도구별 사용법은 [에이전트 도구 연결 가이드](https://docs.wrks.ai/user-guide/agent-tools) 페이지를 참고하세요.

* 도구 고르는 화면 위쪽의 분야 버튼(전체, 협업, 조직, 금융, 법률 등)을 눌러 도구를 찾을 수 있어요. 계정 연결이 필요한 도구는 카드에 '**로그인 필요**'가 보이고, 로그인을 마치면 '연결이 완료되었습니다'가 나오며 창이 저절로 닫혀요.
* 도구는 **계정 연결해서 쓰는 도구**(Gmail, Google Drive, Google Calendar, Notion, M365 등), **바로 쓸 수 있는 도구**(국가법령정보, 국가통계포털 같은 공공·금융 데이터), **우리 회사 도구**(회사가 따로 연결해 둔 사내 도구)로 나뉘어요.

<figure><img src="/files/F82R5LllCD1dmijJqVe5" alt="도구 고르기 — 분야 버튼, 로그인 필요·연결됨 표시, 최대 5개까지"><figcaption><p>도구 고르기 — 분야 버튼, 로그인 필요·연결됨 표시, 최대 5개까지</p></figcaption></figure>

### 스킬과 내부 도구 (선택)

* **스킬 선택**: 스킬은 자주 하는 일을 AI가 똑같이 따라 하도록 정리해 둔 설명서예요. 켜 두면 에이전트가 대화 중 필요할 때 꺼내 써요. → [스킬](https://docs.wrks.ai/user-guide/skills)
* **내부 도구 선택**: 웍스AI에 원래 들어 있는 기본 기능이에요. 코드 실행, 이미지 생성, 웹 검색, 시각화(차트) 자동 작성, 문서 요약, 드라이브, 워크플로우가 있고 처음에는 모두 켜져 있어요. 필요 없는 기능은 꺼 두세요. 여기서 끈 기능은 대화를 시작할 때 꺼진 상태가 되고, 쓰는 사람이 대화 중에 **+** 버튼 → **내부 도구**에서 다시 켤 수 있어요.

## STEP 7. 만들기 완료

**\[만들기]** 버튼을 클릭하면 '나만의 에이전트' 목록에 새 카드가 생기고, 카드를 클릭하면 바로 대화를 시작할 수 있습니다. 이제 역할 설명 없이 **한 문장만 보내면** 정해둔 역할대로 결과를 만들어줘요. 대화는 좌측 사이드바에 자동 저장되어 이어서 대화할 수 있습니다.

## 에이전트 수정·삭제

카드에 마우스를 올리면 우측 상단에 **연필(수정)·휴지통(삭제)** 아이콘이 나타나요. 모델·이름·프롬프트·파일·도구 모두 수정할 수 있습니다.

**삭제한 에이전트는 복구할 수 없어요.** 삭제 전에 공들인 프롬프트 내용은 별도로 저장해 두시길 권합니다.

<figure><img src="/files/YrJ87tepNr3dzprYABwq" alt="카드에 마우스를 올리면 연필(수정)·휴지통(삭제) 버튼이 나타나요. 별은 즐겨찾기예요"><figcaption><p>카드에 마우스를 올리면 연필(수정)·휴지통(삭제) 버튼이 나타나요. 별은 즐겨찾기예요</p></figcaption></figure>

## 링크형 에이전트

자주 가는 사내 사이트(포털, 위키, 결재 시스템 등)를 에이전트 목록에 바로가기처럼 두고 싶을 때 써요.

1. 에이전트 유형에서 **링크형**을 골라요.
2. **링크 주소 입력** 칸에 http:// 또는 https:// 로 시작하는 주소를 넣어요.
3. 이름과 설명을 채우고 **만들기**를 눌러요. 카드를 누르면 그 주소로 이동해요.

링크형은 대화를 하지 않아서 모델, 프롬프트, 참고 파일, 도구, 대화 시작 가이드 칸이 없어요.

## 활용 팁: 이런 에이전트부터 만들어 보세요

거래처 메일 작성 / 주간보고서 / 회의록 정리 / 영업 제안서 / 마케팅 콘텐츠 / HR·채용 — 각각 한두 줄 설명 + 요술봉이면 충분해요. 도구 없이 AI 기본 기능만으로도 보고서·기획서·이메일 초안, 회의록 요약, 번역, 데이터 분석, 브레인스토밍을 충분히 맡길 수 있습니다.

| 에이전트        | 프롬프트 한 줄 예시                                     | 함께 쓰면 좋은 도구        |
| --------------- | ------------------------------------------------------- | -------------------------- |
| 주간보고 도우미 | 메모를 주면 이번 주 한 일과 다음 주 할 일로 정리해 줘   | 없어도 돼요                |
| 회의록 정리     | 회의 메모를 결정사항, 할 일, 담당자로 정리해 줘         | 없어도 돼요                |
| 거래처 메일     | 거래처에 보낼 메일을 정중한 말투로 써 줘                | Gmail 또는 M365 메일·일정 |
| 법령 확인       | 질문과 관련된 법 조항을 찾아 원문과 쉬운 설명을 함께 줘 | 국가법령정보               |
| 통계 브리핑     | 질문한 통계를 찾아 표와 차트로 정리해 줘                | 국가통계포털               |

주민등록번호·비밀번호·신용카드 번호 등 **민감 정보는 절대 입력하지 마세요.** 회사 기밀 문서를 업로드할 때는 사내 보안 정책을 먼저 확인하세요.

## 회사 공식 에이전트로 등록 신청하기

내가 만든 에이전트가 다른 직원들에게도 유용하다면 회사 공식 에이전트로 등록을 신청해 보세요.

**전체 흐름**: ① 에이전트 대화 화면 오른쪽 위 **\[우리 회사 공식 에이전트 등록 신청]** 버튼 클릭 → ② '공식 에이전트 등록 신청하기' 창에서 내용을 확인하고 **\[신청하기]** 클릭 → ③ 관리자 검토 대기 → ④ 관리자가 이름·설명·지시문을 검토(필요 시 수정) → ⑤ 승인되면 **내가 속한 워크스페이스**의 공식 에이전트로 보여요(노출 카테고리는 관리자가 정해요). 내 스킬은 신청에 함께 가지 않아요.

등록 신청 시점의 설정(이름·지시문·도구)이 **스냅샷으로 전달**돼요. 신청 후 내 에이전트를 수정해도 반영되지 않으니, 변경하려면 다시 신청해야 합니다. 신청 전에 이름·프롬프트를 한번 더 가다듬어 주세요.

**공유되는 것**: 에이전트 이름·아이콘, 설명, 지시문(시스템 프롬프트), 연결된 도구 설정, 업로드 파일(답변 참조용), 카테고리 설정

**공유되지 않는 것**: 나의 대화 내역, 개인 지식·메모, OAuth 토큰·계정 자격증명. 업로드 파일은 에이전트가 답변할 때만 참조되고, 다른 사용자가 원본 파일을 직접 다운로드하는 것은 보안상 차단돼요. 도구는 '연결 설정'만 공유되며 실제 데이터 접근은 각 사용자 본인의 인증을 통해 이뤄지므로 내 메일·캘린더를 다른 사용자가 볼 수 없습니다.

* 신청한 에이전트는 워크스페이스 에이전트가 돼요. 회사 전체에 보이는 에이전트로는 신청할 수 없어요.
* 공식 에이전트는 워크스페이스마다 따로 보여요. 다른 워크스페이스에서도 쓰려면 그곳에서 따로 신청해야 해요.
* 대화 시작 가이드는 6개까지, 한 항목에 150자까지 넣을 수 있어요.
* 고른 모델을 지금 쓸 수 없다는 안내가 보이면, 다른 모델을 골라야 신청할 수 있어요.

관리자가 노출을 중단하면 메인 화면에서 카드는 사라지지만 **이미 나눈 대화 내역은 그대로 유지**됩니다. 등록 신청 후 소식이 없다면 회사 관리자에게 문의해 보세요.
