어시웍스 구조 및 개념 가이드

어시웍스를 사용하기 전에 알아 두어야 할 조직 구조를 설명합니다. 누가 유닛과 앱을 만들고 누가 사용하는지, 각 설정이 어느 범위에 적용되는지 다룹니다.

어시웍스의 조직 구조

운영사가 고객사를 생성하고, 고객사 안에 팀을 구성합니다. 각 팀에는 구성원이 소속됩니다. 기관에 속하지 않은 개인 사용자는 별도의 개인 공간을 사용합니다.

Root운영사AIF · 고객사 생성과 전체 관리

Enterprise고객사예: 엔터프라이즈A · 기관 또는 회사 단위

팀업무1팀

Admin 관리자 Client 팀원

팀업무2팀

Client 팀원

고객사 단위로 관리하는 항목: 유닛, 앱, 문서, 지도 자료, 연결 정보. 다른 고객사에서는 조회할 수 없습니다.

Enterprise엔터프라이즈B

고객사별로 분리해 관리합니다.

Personal개인 공간개인 사용자

운영사와 관리자 계층이 없습니다. 가입한 사용자가 직접 유닛을 만들어 사용합니다. 팀에 앱을 지정하지 않으므로 APPS 메뉴와 Audit Log는 제공되지 않으며, 기관 자료 없이 빈 상태로 시작합니다.

구분	설명	관리 주체
운영사 (Root)	어시웍스를 납품하고 운영하는 주체입니다. 고객사를 생성하고 공용 유닛을 고객사에 배포합니다.	운영사(AIF)
고객사 (Enterprise)	어시웍스를 도입한 기관 또는 회사입니다. 유닛, 앱, 자료는 고객사 단위로 분리해 관리합니다.	고객사 관리자(Admin)
팀	고객사 안의 부서 단위입니다. 팀별로 사용할 앱, 유닛 제작 허용 여부, 알림 대상을 설정합니다.	고객사 관리자(Admin)
구성원	팀에 소속된 사용자입니다. 권한에 따라 관리자(Admin)와 팀원(Client)으로 구분합니다.	고객사 관리자(Admin)
개인 공간 (Personal)	기관에 속하지 않은 사용자의 공간입니다. 팀 관리 기능 없이 유닛을 만들고 사용합니다.	가입한 사용자 본인

개인 공간과 고객사 공간 전환

한 계정이 개인 공간과 고객사 공간을 함께 가질 수 있습니다. 팀 전환 메뉴에서 사용할 공간을 선택해 전환합니다.

공간을 전환하면 메뉴, 유닛, 자료가 선택한 공간을 기준으로 바뀝니다. 각 공간에서 만든 유닛은 해당 공간에만 표시됩니다.

Root 권한의 관리 주체

Root 권한의 관리 주체는 납품 형태에 따라 다릅니다.

납품 형태	Root 권한 관리 주체
클라우드	운영사만 Root 화면에 접근합니다. 고객사는 Admin 화면부터 사용합니다.
온프레미스	설치를 마친 뒤 Root 계정을 고객사에 전달합니다. 전달한 뒤에는 운영사가 원격으로 접근할 수 없습니다.
Root를 제공하지 않는 경우	고객사가 Admin 설정에서 소속 Enterprise를 직접 운영합니다.

로그인한 계정의 권한에 따라 표시되는 화면과 사용할 수 있는 기능이 달라집니다.

권한 구분

Root

운영사

AIF

고객사를 생성하고 관리자 계정을 발급합니다. 공용 유닛을 고객사에 배포하고, 납품 형태와 제작 권한 등급 등 고객사의 기본 조건을 설정합니다.

Admin

고객사 관리자

팀장, 운영 담당자

유닛을 만들어 앱에 연결하고, 팀별로 사용할 앱을 지정합니다. 구성원, 문서와 지도 자료, 연결 정보, 예약, 실행 기록을 관리합니다.

Client

팀원

실무 담당자

소속 팀에 지정된 앱에서 대화로 업무를 요청합니다. 반복할 요청은 예약하고, 실행 결과를 알림으로 받습니다.

기능	Root	Admin	Client
고객사 생성, 관리자 계정 발급	가능	불가	불가
공용 유닛 배포 (유닛 카탈로그)	가능	불가	불가
유닛 제작 (Tools, Agents, Flows)	가능	제작 가능 등급인 경우	팀에 제작 허용이 켜진 경우
앱 생성, 팀별 앱 지정	가능	가능	불가
문서, 지도 자료, 연결 정보 관리	가능	가능	불가
앱에서 대화로 요청, 내 예약	불가	실무 화면 열기로 미리 보기	가능
Monitoring, Audit Log 조회 범위	전체 고객사	소속 고객사	본인

유닛 제작 권한 설정

유닛 제작 권한은 고객사와 팀, 두 단계에서 설정합니다.

고객사의 제작 권한 등급: 운영사가 설정합니다. 사용만으로 설정하면 고객사는 운영사가 배포한 유닛만 사용합니다. 제작 가능으로 설정하면 고객사가 유닛을 직접 만들 수 있습니다.
팀의 유닛 제작 허용: 고객사가 제작 가능 등급일 때만 설정할 수 있습니다. 제작 허용을 켠 팀에는 Tools, Agents, Flows 메뉴가 표시됩니다.

관리자가 자료를 등록하고 유닛을 만들어 앱에 연결하면, 팀원은 그 앱에서 대화로 유닛을 실행합니다. 단계별로 사용하는 메뉴는 다음과 같습니다.

자료 등록부터 팀원 사용까지

1자료 등록Storage · VDB · Maps · Connections

문서를 올려 VDB에 저장하고, 지도 자료와 연결 정보를 등록합니다.

2유닛 만들기Tools · Operators · Loops · Flows

기능 단위의 Tool을 만들고, 필요한 Tool을 선택해 실행할 Operator를 연결합니다. 여러 단계로 이루어진 작업은 Flow로 구성합니다.

3앱에 연결Apps

팀원이 사용할 앱을 만들고 유닛을 연결합니다. 대화형 + 지도 앱에는 맵셋을 지정합니다.

4팀에 앱 지정Settings › 팀

팀별로 사용할 앱, 팀원, 알림 대상을 설정합니다.

5대화로 요청대화형 · 대화형 + 지도

팀원이 앱에서 업무를 요청하면 내용에 맞는 유닛이 실행됩니다.

6기록 확인Monitoring · Audit Log

실행 내역과 설정 변경 이력을 확인합니다.

유닛은 앱에 연결해야 팀원 화면에 표시됩니다. 유닛을 만든 뒤 앱에 연결하지 않으면 팀원은 해당 유닛을 사용할 수 없습니다.

직접 만든 유닛과 배포받은 유닛

2단계의 유닛은 고객사가 직접 만들거나, 운영사가 유닛 카탈로그에서 배포한 것을 사용합니다. 배포받은 유닛도 3단계부터 같은 순서로 앱에 연결합니다.

유닛 간 연결 관계

유닛	역할	연결 대상
Tool	한 가지 기능을 수행하는 가장 작은 단위입니다.	Operator에 장착하거나 Flow의 단계로 추가합니다.
Operator	요청을 해석하고, 장착된 Tool 중 필요한 것을 선택해 실행합니다.	앱에 연결하거나 Flow의 단계로 추가합니다. 맵셋을 연결하면 결과를 지도 화면에 표시합니다.
Loop	컨테이너 작업 환경에서 파일을 만들고 코드를 실행하며 결과를 수정합니다.	Operator가 호출하거나 단독으로 실행합니다. Flow에서는 Operator에 연결해서만 사용합니다.
Flow	여러 유닛을 정해진 순서와 조건에 따라 실행합니다.	앱에 연결하거나, 예약해 정해진 시간에 실행합니다.

화면과 문서에서 사용하는 용어를 정리했습니다. 메뉴 이름은 화면 표기를 그대로 사용합니다.

조직과 권한

용어	설명
운영사 (Root)	어시웍스를 납품하고 운영하는 주체입니다. 전체 고객사를 관리합니다.
고객사 (Enterprise)	어시웍스를 도입한 기관 또는 회사입니다. 화면에는 Enterprise로 표시됩니다.
팀	고객사 안의 부서 단위입니다. 사용할 앱, 제작 허용, 알림 대상을 팀별로 설정합니다.
구성원 (멤버)	고객사에 소속된 사용자입니다. Settings › 멤버에서 소속 팀을 변경합니다.
관리자 (Admin)	고객사를 운영하는 권한입니다. 유닛, 앱, 팀, 자료를 관리합니다.
팀원 (Client)	팀에 지정된 앱을 사용하는 권한입니다. 관리 메뉴는 표시되지 않으며, 제작 메뉴는 팀의 제작 허용이 켜진 경우에만 표시됩니다.
개인 공간 (Personal)	기관에 속하지 않은 사용자의 공간입니다. 운영사와 관리자 계층이 없습니다.
팀 전환	개인 공간과 고객사 공간 사이를 전환하는 메뉴입니다.
납품 형태	클라우드 또는 온프레미스입니다. 운영사가 고객사를 생성할 때 설정하며, 고객사 화면에서는 읽기 전용으로 표시됩니다.
폐쇄망	외부 연결이 차단된 환경입니다. 기관 내부 연결과 내부에 설치된 모델만 사용합니다.
제작 권한 등급	고객사가 유닛을 직접 만들 수 있는지 정하는 설정입니다. 운영사가 사용만 또는 제작 가능 중에서 선택합니다.
유닛 제작 허용	팀 단위의 제작 권한입니다. 고객사가 제작 가능 등급일 때만 설정할 수 있습니다.
유닛 카탈로그	운영사가 납품에 사용하는 공용 유닛과 구성 프리셋 목록입니다. 유닛마다 배포할 고객사를 지정합니다.
배포	운영사가 유닛을 고객사에 제공하는 작업입니다. 유닛을 배포하면 연결된 Tool도 함께 배포됩니다.
설치본	온프레미스 설치 준비 상태를 확인하고 Root 계정을 고객사에 전달하는 운영사 전용 화면입니다.

유닛

용어	설명
유닛	어시웍스에서 실행되는 기능 단위입니다. Tool, Agent, Flow로 구분합니다.
Tool	한 가지 기능을 수행하는 가장 작은 단위입니다. 언어 모델(LLM), 이미지 판독(VLM), 외부 API, MCP, DB, 자료 수집(Collector), 문서 적재(VDB Loader), 문서 검색(VDB) 중에서 종류를 선택합니다.
Agent	Operator와 Loop를 함께 이르는 이름입니다. Agents 메뉴에서 관리합니다.
Operator	요청에 맞는 Tool을 선택해 실행하고, 결과를 답변으로 작성하는 유닛입니다.
Loop	컨테이너 작업 환경에서 파일을 만들고 코드를 실행하며 결과를 수정하는 유닛입니다. 사용할 자원과 작업 시간의 한도를 설정합니다.
Flow	여러 유닛을 순서와 조건에 따라 연결한 작업 흐름입니다.

앱과 진입점

용어	설명
앱 (Apps)	팀원이 접속해 업무를 시작하는 화면입니다. 유닛을 연결해야 팀원에게 표시됩니다.
대화형	대화로 업무를 요청하는 앱 유형입니다.
대화형 + 지도 (어시지오)	대화 화면과 지도를 함께 표시하는 앱 유형입니다. 맵셋을 지정해 사용합니다.
실무 화면	팀원이 사용하는 앱 화면입니다. 관리자는 앱 상세의 실무 화면 열기에서 미리 확인합니다.
Air	고객사 사이트에 연결하는 위젯입니다. 유닛이 아닌 진입점(서비스 접속 방식)입니다.

자료와 연결

용어	설명
Storage	올린 문서의 원본을 폴더 단위로 보관하는 메뉴입니다.
VDB	원본 문서를 검색할 수 있도록 저장한 결과입니다. 원본이 바뀌면 다시 적재해야 검색에 반영됩니다.
적재	문서를 검색할 수 있도록 VDB에 저장하는 작업입니다.
Maps	지도 자료와 맵셋을 관리하는 메뉴입니다.
맵셋	베이스맵과 오버레이맵을 묶은 설정입니다. Operator와 대화형 + 지도 앱에 연결합니다.
베이스맵	지도 화면의 배경 지도입니다. 운영사가 제공하는 목록에서 선택하며, 배율별로 다르게 지정할 수 있습니다.
오버레이맵	베이스맵 위에 겹쳐 표시하는 구역, 경계 등의 자료입니다. 기관 자료와 운영사 공통 자료로 구분합니다.
Connections	유닛이 내부 시스템이나 외부 서비스에 접속하는 데 필요한 정보입니다. 내부 시스템은 주소를, 외부 서비스는 키를 등록합니다.

운영과 기록

용어	설명
Schedules (예약)	유닛을 정해진 시간에 실행하도록 예약하는 기능입니다.
알림 대상	팀이 받을 알림 종류입니다. 탐지 결과 발생, 실행 실패, 승인 요청, 예약 완료 중에서 선택합니다.
Monitoring	실행 내역, 사용량과 비용, 정확도를 확인하는 화면입니다.
Audit Log	계정, 권한, 구성, 배포 설정의 변경 이력을 기록하는 화면입니다. 누가 언제 변경했는지 확인할 수 있습니다.

설정 시 확인할 내용

권한과 배포 구조를 설정할 때 확인할 사항을 정리했습니다.

자료는 기관별로 분리해 관리합니다

문서 폴더와 오버레이맵은 소속 기관의 자료만 표시됩니다. 베이스맵은 운영사가 등록한 공통 목록에서 선택합니다. 운영사 계정으로 로그인하면 전체 고객사의 자료가 해당 고객사 이름과 함께 표시됩니다. 개인 공간에는 기관 자료가 제공되지 않으므로 빈 상태로 시작합니다.

기관 오버레이맵은 기관이 직접 등록합니다

기관은 Maps › 맵셋 선택 › 오버레이맵 파일 등록에서 기관 오버레이맵을 올립니다. 베이스맵과 공통 오버레이맵은 운영사가 Maps › 자료에서 등록합니다. 문서는 기관이 Storage에서 직접 올립니다.

유닛은 Tool · Agent · Flow로 구분됩니다

Agent에는 Operator와 Loop가 포함됩니다. Loop는 Operator가 호출하거나 단독으로 실행할 수 있습니다. Flow에서는 Operator에 연결해서만 사용합니다. Air는 유닛이 아닌 진입점이므로 APPS 메뉴에 있습니다.

주기적으로 추가되는 지도 자료는 카탈로그에서 검색합니다

위성영상처럼 주기적으로 추가되는 자료는 기간·영역(지도에서 그리기)·구름량으로 검색 범위를 좁혀 사용할 장면을 선택합니다. 해당 맵셋이 연결된 Operator를 실행하면 선택한 장면이 해당 시점의 지도로 표시됩니다.

배율별로 표시할 지도를 설정할 수 있습니다

맵셋의 배율 탭에서 확대·축소 범위를 제한하고, 배율별 베이스맵과 오버레이맵 표시 범위를 설정합니다. 예를 들어 축소 상태에서는 일반지도를, 확대 상태에서는 위성사진을 표시할 수 있습니다. 정보가 밀집된 자료는 확대 상태에서만 표시하도록 설정해 겹침을 줄입니다.

맵셋은 Operator와 지도 앱에 연결합니다

맵셋은 베이스맵과 오버레이맵을 묶은 설정입니다. 베이스맵은 운영사가 제공하는 고정 목록에서 여러 개를 선택할 수 있으며, 실행 화면에서 전환할 수 있습니다. 오버레이맵은 소속 기관의 자료와 운영사가 등록한 공통 자료에서 선택합니다. 기관별 자료는 Enterprise 간에 분리됩니다. 맵셋을 Operator에 연결하면 실행 화면의 배경지도와 참조 자료가 함께 설정됩니다. 대화형 + 지도 앱은 앱 상세에서 맵셋을 지정합니다. 맵셋을 연결하지 않으면 지도 없이 실행됩니다.