6.3. 기본 스킬과 새 버전 알림
개요
AAS 는 문서 변환, 명함 정리, 화면 사용법 안내 같은 기본 스킬을 스킬 허브(스킬 패키지를 모아 두고 프로파일에 설치하게 하는 곳)에 올려 모든 프로파일(AI 에이전트의 설정 묶음)에 넣어 줍니다. 두 낱말은 용어 사전에 있습니다. 스킬 허브에 새 버전이 나오면 그 스킬을 쓰는 프로파일에 알림이 가고, 관리자가 자동 업그레이드를 켜 두면 고치지 않은 스킬은 저절로 새 버전이 됩니다. 이 장은 기본 스킬이 배달되는 방식, 새 버전 알림의 위치, 「새 버전 있음」 탭 사용법, 자동 업그레이드 설정을 설명합니다.
권한: 알림과 「새 버전 있음」 탭은 스킬을 올릴 권한이 있는 관리자, AI 에이전트 작업공간의 주인, 팀 관리자에게 보입니다. 자동 업그레이드 스위치는 관리자에게만 보입니다.
AAS 기본 스킬
AAS 기본 스킬은 여섯 개입니다. 모두 스킬 허브의 「공용」 네임스페이스에 패키지로 올라갑니다.
| 패키지 이름 | 하는 일 |
|---|---|
| hwp-to-markdown | 한글(HWP·HWPX) 문서를 Markdown 으로 바꿔 읽습니다. |
| doc-to-markdown | docx·pptx·xlsx·pdf(글자 있음)·html 등을 Markdown 으로 바꿔 읽습니다. |
| ocr-to-markdown | 그림과 스캔 PDF 의 글자를 OCR 로 읽어 Markdown 으로 바꿉니다. |
| markdown-to-doc | Markdown 글을 hwpx·docx·pptx·xlsx·pdf 등의 파일로 만듭니다. |
| business-card-ocr | 명함 사진을 OCR 로 읽어 명함 목록에 쌓고 찾고 엑셀로 내보냅니다. |
| aas-help | AAS 화면 사용법을 AI 에이전트가 안내하게 합니다. |
관리자가 알아야 할 것
- 기본 스킬은 AAS 서버가 스스로 스킬 허브의 「공용」에 올리고 사용자의 프로파일에 넣습 니다. 관리자가 화면에서 올릴 필요가 없습니다.
- 새로 만든 프로파일에는 다음 확인 때 들어갑니다. 공용(루트) 프로파일에는 넣지 않습니다.
- 사용자가 지운 기본 스킬은 다시 넣지 않습니다. 다시 쓰려면 스킬 허브에서 직접 설치합니다.
- 설치가 실패하면 그 버전은 한 번만 시도하고, 프로파일의 「확인할 것」에 알립니다.
참고: AAS 기본 스킬은 화면에서 게시하거나 숨길 수 없습니다. 새 버전은 AAS 서버를 새 버전으로 반영할 때 함께 나갑니다. 기본 스킬 목록을 바꾸는 것은 운영자(AAS 를 설치하고 서버를 관리하는 사람, 용어 사전)의 일입니다.
새 버전 알림이 보이는 곳
알림은 스킬을 올릴 권한이 있는 사람에게만 보입니다. 관리자, 그 AI 에이전트 작업공간의 주인, 팀 관리자입니다.

그림 6.3-1. 「새 버전 있음」 탭
| 자리 | 모양 |
|---|---|
| 「스킬 허브」 화면의 「새 버전 있음」 탭 | 탭 이름 옆에 올릴 수 있는 스킬 수가 나옵니다. |
| 왼쪽 메뉴 「스킬 › 스킬 허브」 | 회색 숫자가 붙습니다. 고장이 아니라서 빨간색이나 주황색을 쓰지 않습니다. 지금 보는 AI 에이전트 작업공간만 셉니다. |
| 프로파일의 「확인할 것」 | 「스킬 N개에 새 버전이 있습니다」가 안내 단계로 나옵니다. 누르면 「새 버전 있음」 탭으로 이동합니다. |
| 대시보드 | 「스킬 새 버전 N개」 줄이 나옵니다. |
| 프로파일의 스킬 목록 | 스킬 줄에 「새 버전 v…」가 붙습니다. |
자동 업그레이드가 스킬을 올린 경우에는 「확인할 것」에 안내가 남습니다. 안내는 7일 뒤에 사라지고, 확인 버튼으로 먼저 지울 수도 있습니다.
「새 버전 있음」 탭 사용하기
- 왼쪽 메뉴의 「스킬 › 스킬 허브」를 엽니다.
- 「새 버전 있음」 탭을 누릅니다.
- 필요하면 「범위」를 「내가 관리하는 모든 작업공간」으로 바꿉니다. 관리자는 전체 AI 에이전트 작업공간을 한 목록에서 볼 수 있습니다. 이때 「AI 에이전트 작업공간」 열이 함께 나옵니다.
- 올릴 줄의 체크 상자를 켭니다.
- 「선택하여 업그레이드 (N)」 버튼을 누릅니다.
- 확인 창에서 확인합니다.
올리기를 시작하면 이 화면을 닫아도 계속 진행됩니다. 위쪽 띠에 「N개 중 N개 완료 · N개 실패 · N개 기다리는 중」이 나옵니다. 새 버전은 다음 대화부터 적용됩니다.
표의 열은 「프로파일」「스킬」「지금 → 새 버전」「상태」입니다. 「찾은 방법」 열은 기본으로 숨어 있고 열 선택에서 켤 수 있습니다.
상태의 뜻
| 상태 | 뜻 | 고를 수 있는가 |
|---|---|---|
| 새 버전 있음 | 바로 올릴 수 있습니다. | 가능 |
| 업그레이드 대기 중, 업그레이드 중 | 처리 중입니다. | 불가 |
| 업그레이드 실패, 자동 업그레이드 실패 | 다시 올릴 수 있습니다. 「확인할 것」에도 나옵니다. | 가능 |
| 직접 고친 내용 있음 | 사용자가 고친 스킬입니다. 줄을 열어 하나씩 처리합니다. | 불가 |
| 고친 내용 확인 불가, 고친 내용 확인 중 | 고친 내용을 아직 알 수 없습니다. | 불가 |
| 업그레이드할 수 없음: 공용 프로파일 | 공용 프로파일에는 올리지 않습니다. | 불가 |
| 업그레이드할 수 없음: 관리자 허용 필요 | 「제한」 패키지를 이 AI 에이전트 작업공간이 허용받지 않았습니다. | 불가 |
| 현재 버전 확인 불가 | 프로파일의 스킬 버전을 읽지 못했습니다. | 불가 |
| 프로파일 주인이 고친 버전을 쓰는 중, 건너뛴 버전 | 기본 화면에서는 숨깁니다. 「건너뛴 버전도 보기」를 켜면 나옵니다. | 불가 |
| 업그레이드 완료 | 올리기를 마쳤습니다. | 불가 |
「찾은 방법」이 「폴더 이름」인 줄에는 「추정」 표시가 붙습니다. 설치 기록이 없어 폴더 이름으로 패키지를 찾았다는 뜻입니다.
고친 스킬 처리하기
사용자가 고친 스킬은 한꺼번에 올리지 않습니다. 줄을 눌러 서랍(화면 오른쪽에서 열리는 상세 창, 용어 사전)을 열고 하나를 고릅니다.
| 선택 | 결과 |
|---|---|
| 고친 것은 따로 보관하고 업그레이드 | 지금 스킬을 프로파일의 「스킬」 목록에 「<이름>-local」이라는 이름으로 남겨 두고 새 버전을 설치합니다. 남긴 스킬은 스킬 허브 업데이트와 상관없이 계속 쓸 수 있습니다. |
| 새 버전으로 덮어쓰기 | 지금 내용을 30일 동안 백업한 뒤 새 버전으로 바꿉니다. |
이 버전 건너뛰기
- 줄 메뉴에서 「이 버전 건너뛰기」를 누릅니다.
- 화면 아래 알림의 「되돌리기」로 취소할 수 있습니다.
- 나중에 다시 받으려면 「건너뛴 버전도 보기」를 켜고 「다시 알림 받기」를 누릅니다.
건너뛴 뒤 더 새로운 버전이 나오면 다시 알립니다.
화면에 오류 띠가 나올 때
| 띠 | 뜻 |
|---|---|
| 스킬 허브에 연결하지 못해 새 버전을 확인하지 못했습니다 | 스킬 허브가 응답하지 않습니다. 「다시 확인」을 누르고, 계속되면 A.2. 문제 해결을 봅니다. |
| AI 에이전트 작업공간 N곳의 스킬을 읽지 못했습니다 | 일부 AI 에이전트 작업공간이 멈췄거나 준비 중입니다. |
자동 업그레이드
관리자는 기본 스킬의 새 버전을 자동으로 올리게 할 수 있습니다. 이 스위치는 관리자에게만 보입니다.
처음에는 이 스위치가 켜져 있습니다. 한 번도 바꾸지 않은 설치에서는 이미 자동으로 올라가고 있습니다.
- 「새 버전 있음」 탭의 위쪽 도구 띠에서 「자동 업그레이드」 스위치를 찾습니다.
- 스위치가 켜져 있는지 봅니다. 켜져 있으면 더 할 일이 없습니다.
- 꺼져 있고 켜려면 스위치를 누릅니다.
- 켤 때는 확인 창에 지금 바로 업그레이드되는 프로파일 수가 나옵니다. 숫자를 읽고 확인을 누릅니다.
끄려면 같은 스위치를 누르고 확인 창에서 확인합니다. 끄면 새 버전이 나와도 알림만 가고 자동으로 올라가지 않습니다. 이미 올라간 스킬은 그대로입니다.
자동 업그레이드는 다음 규칙을 따릅니다.
- 기본 스킬만 대상입니다. 사용자가 직접 올린 스킬이나 허브에서 따로 설치한 스킬은 대상이 아닙니다.
- 사용자가 고친 스킬은 건너뜁니다. 알림만 갑니다.
- 같은 프로파일의 같은 버전은 한 번만 시도합니다. 실패하면 「자동 업그레이드 실패」로 남고 「확인할 것」에 나옵니다.
- 끄면 새 버전이 나와도 알림만 보냅니다.
참고: 새 버전이 스킬 허브에 올라간 직후에는 화면에 바로 보이지 않을 수 있습니다. 잠시 뒤 「다시 확인」을 누릅니다. 계속 보이지 않으면 운영자에게 알립니다.