이용안내
처음이라면 여기부터 — 무엇이 다른지, 어떻게 올리는지, 무엇을 올리면 안 되는지.
1시작하기 D.AIA 가 무엇이고 무엇부터 보면 되는지.
D.AIA 는 회사가 만든 AI 자산을 한곳에서 찾아 쓰고, 내가 만든 것을 올리는 곳입니다.
로그인하지 않아도 스토어 · 이용안내 · 공지는 읽을 수 있습니다. 자산을 쓰거나 올리려면 로그인이 필요합니다.
처음 로그인
로그인 창의 처음이신가요? 에서 사번을 넣으면 사내 메일로 인증번호가 오고, 그다음 비밀번호를 정합니다. 비밀번호를 잊었을 때도 같은 길(비밀번호를 잊으셨나요?)로 새로 정합니다.
조직도에 없는 사번이면 없다고 알려 줍니다 — 퇴사했거나 아직 인사정보에 오르지 않은 사람은 들어올 수 없습니다. 인사정보는 매일 새벽 다우오피스에서 받아 옵니다.
자산은 세 가지입니다
- 앱 — 브라우저에서 바로 여는 것. D.AIA 아래 경로로 열립니다
- 에이전트 커넥터 — Claude 같은 도구에 붙여 쓰는 것. 도구를 붙이는 방식(MCP)으로 연결하고, 설치 방법이 자산마다 적혀 있습니다
- 스킬 — 반복하는 업무의 절차를 적어 둔 것. SKILL.md 한 장일 수도 있고 스크립트·자료를 함께 담은 파일 묶음일 수도 있습니다
상단 메뉴는 홈 · 스토어 · 이용안내 셋이 늘 보이고, 자산 담당자에게는 처리함이, 시스템 관리자에게는 관리자가 하나 더 보입니다.
스토어 둘러보기 →마이 스튜디오 — 로그인하면 열립니다
2찾아 쓰기 쓸 것을 고르고, 비공개 자산을 여는 법.
스토어에서 종류(앱 · 에이전트 커넥터 · 스킬)와 분류로 좁혀 고릅니다.
전사 공개 자산은 바로 씁니다. 비공개 자산은 사용 신청을 내고 담당자가 승인해야 열립니다.
사용 신청
- 자산 카드나 상세에서 사용 신청 을 누릅니다
- 어떤 일에 쓰려는지 적습니다 — 담당자가 이것을 보고 판단합니다
- 그 자산의 담당자가 승인하거나 반려합니다
- 결과가 알림으로 옵니다. 승인되면 그때부터 바로 열립니다
담당자가 비공개 자산에 미리 넣어 둔 사람은 사용 신청 없이 바로 씁니다.
같은 자산에 처리되지 않은 신청이 있으면 다시 낼 수 없습니다.
앱을 열면 다시 로그인하지 않는 경우
D.AIA 와 로그인을 이어 둔 앱은 서비스 열기 로 들어가면 그 앱에서 비밀번호를 묻지 않습니다 — D.AIA 가 누구인지 알려 주기 때문입니다. 모든 앱이 그런 것은 아니고, 이어 두지 않은 앱은 그 앱의 로그인 화면이 나옵니다.
이어 둔 앱인데 그 앱에 계정이 없으면 앱이 안내를 띄웁니다. 계정 요청하기 를 누르면 D.AIA 질문하기가 그 앱이 골라진 채로 열려 담당자에게 알림이 갑니다.
스킬은 받아 가는 길이 셋입니다
- 등록자가 조직에 게시해 두면 Claude 사용자 지정 › Skills › 내 항목 의 조직에서 칸에 들어와, 켜기만 하면 씁니다
- 등록자가 Claude 에서 공유해 줍니다 — D.AIA 에서 공유 요청을 냅니다
- .skill 파일을 내려받아 Claude 에 업로드합니다
3올리기 내가 만든 것을 등록하는 차례.
만드는 길은 종류마다 다릅니다
셋 다 같다고 적어 두었더니, 스킬을 올리려는 사람이 검증·배포를 기다리고 커넥터를 쓰려는 사람이 등록 신청서를 찾았습니다.
- 앱 — 등록 신청 → 심사 → Claude 로 제작 → 검증 → 배포. 저장소와 배포 설정은 허브가 합니다
- 스킬 — Claude 에서 만들어 팀에 공유한 뒤, 허브에는 목록에 올리는 신청만 냅니다. 검증도 배포도 없습니다
- 에이전트 커넥터 — 만드는 것이 아니라 연결하는 것입니다. 사내 데이터에 붙는 것이라 DT팀이 만들고 운영합니다
앱을 올리는 차례
상단 오른쪽 + 올리기 로 시작합니다. 세 단계이고, 각 단계에서 할 수 있는 것만 보입니다.
- 유형 고르기 — 앱 · 에이전트 커넥터 · 스킬 가운데 하나. 앱은 웹으로 여는 것과 내려받아 쓰는 것으로 한 번 더 갈립니다
- 등록 칸 채우기 — 이름 · 개요 · 분류 · 공개범위, 그리고 유형마다 다른 칸
- 확인 후 제출 — 낸 뒤에는 시스템 관리자가 처리함에서 등록 검수를 합니다
웹으로 여는 앱은 작업물을 함께 올립니다
Claude Cowork 작업 경로를 폴더째 압축해서 올려 주세요 — 시스템 관리자가 그것으로 저장소를 만듭니다. Cowork 에서 연결해 둔 폴더를 통째로 압축합니다: 숨은 파일과 설정까지 다 들어가야 하고, 고른 파일 몇 개만 올리면 관리자가 그대로 올릴 수 없습니다.
zip 하나로 300MB 까지 올립니다. 키가 적힌 파일은 빼고 압축해 주세요 — 저장소에 올라간 키는 코드에서 지워도 기록에 남아 새로 발급받아야 합니다.
이미 저장소에 올려 두었거나 저장소가 필요 없으면 비워 두어도 됩니다. 올린 것은 쓰는 사람에게 보이지 않습니다 — 검수하는 사람과 담당자만 내려받습니다.
올린 뒤에도 자산 관리의 정보 탭에서 작업물을 새로 올리거나 뺄 수 있습니다.
사용자 가이드는 D.AIA 안에서 씁니다
자산 관리의 사용자 가이드 카드에서 가이드 쓰기 를 누르면 넓은 편집 화면이 열립니다. 화면 캡처는 붙여넣거나 끌어다 놓으면 들어갑니다 — 한 장 10MB 까지입니다.
쓰는 동안은 임시저장만 됩니다. 게시 를 눌러야 자산 상세의 사용자 가이드 탭에 나가고, 그 전까지 이용자는 앞서 게시한 판을 봅니다. 제목 1 · 제목 2 로 쓴 줄은 오른쪽 목차가 됩니다.
HTML 편집 단추로 HTML 을 그대로 넣을 수 있습니다. HTML 안에 그림을 품고 온 경우(data: 형식)는 저장할 때 D.AIA 그림으로 옮겨 담습니다. 다만 스크립트와 바깥 주소의 그림은 빠집니다 — 그런 그림은 D.AIA 에 직접 넣어 주세요. 파일과 주소로 내던 가이드도 그대로 둘 수 있습니다.
LLM 을 쓰는 자산이라면 키가 앱보다 먼저입니다
부서가 앱을 만들기 전에 키부터 받습니다. 앱이 없어도 개발하는 동안 모델을 불러야 하기 때문입니다 — 다음 꼭지에 따로 적었습니다.
주소는 이름만 적습니다
주소를 통째로 받지 않습니다. 앞자리는 화면에 박혀 있고 뒤에 쓰고 싶은 이름만 적습니다 — 통째로 받으면 https 를 빼먹거나 끝에 / 를 붙여 제각각이 됩니다.
영문 소문자 · 숫자 · 하이픈만 쓰고 3~30자입니다. 하이픈으로 시작하거나 끝날 수 없고, 이미 쓰는 이름과 겹치면 막힙니다. 규칙에 맞지 않는 글자는 아예 들어가지 않습니다.
실제 주소는 시스템 관리자가 등록 검수를 하며 넣습니다. 등록하는 사람은 주소를 가지고 있지 않습니다.
자산명은 나중에 바꾸지 않습니다 — 바꾸면 그 시점을 기준으로 사용량이 두 이름으로 나뉘어 어느 쪽도 온전하지 않게 됩니다.
올리기 — 로그인하면 열립니다마이 스튜디오 — 로그인하면 열립니다
4LLM 키와 이용 주소 모델을 부르는 길 — 접수부터 사용량까지.
자산은 제공 서비스(Gemini · OpenAI 같은 곳)를 직접 부르지 않습니다. 사내 LLM 게이트웨이를 거쳐 부르고, D.AIA 는 그 길을 내주는 자리입니다.
왜 직접 부르지 않나
- 키가 코드에 남지 않습니다 — 주소에는 비밀이 없고 키는 게이트웨이가 갈아 끼웁니다
- 사용량이 부서와 자산별로 잡힙니다 — 주소가 그 둘을 가릅니다
- 키를 바꿔도 코드를 고치지 않습니다 — 관리자가 게이트웨이에서 갈아 끼웁니다
차례는 넷입니다
- 부서가 제공 서비스에서 키를 받아 옵니다 — D.AIA 가 키를 발급하지 않습니다
- 마이 스튜디오 키 접수 탭에서 접수합니다 — 제공 서비스 · 키 값 · 자산명 셋이 필수입니다
- 시스템 관리자가 게이트웨이에 등록하고 이용 주소를 냅니다
- 그 주소를 코드의 base_url 로 지정합니다. 앱은 나중에 연결해도 됩니다
자산명은 이용 주소에 그대로 들어갑니다. 영문 소문자 · 숫자 · 붙임표만 쓰고, 우리 부서에 이미 등록한 이름과 겹칠 수 없습니다.
접수한 것은 우리 부서 키 에 상태와 함께 섭니다 — 기다림 · 발급 완료 · 반려. 발급되기 전에는 스스로 취소할 수 있습니다.
이용 주소의 모양
주소는 부서코드 · 자산명 · 제공 서비스 셋으로 만들어집니다. 이 셋이 사용량을 가르는 축이기도 합니다.
- 부서코드 — 두 자리 부서 글자에 순번이 붙습니다(AD01 처럼). 관리자가 정합니다
- 자산명 — 접수할 때 적은 이름입니다
- 제공 서비스 — gemini · openai · anthropic 처럼 소문자로 붙습니다
- OpenAI 와 Azure OpenAI 만 주소 끝에 슬래시 v1 이 더 붙습니다 — SDK 가 뒤에 붙이는 경로가 달라서입니다. 여기서 404 가 가장 많이 납니다
코드에 붙이는 법
바꾸는 것은 SDK 의 base_url 한 줄뿐입니다. 키 자리에는 아무 값이나 두어도 됩니다 — 이 경로는 인증 헤더를 보지 않습니다.
자산마다 코드가 다르므로 적용 방법 단추를 누르면 그 자산의 제공 서비스에 맞는 코드가 그대로 나옵니다. 베껴 적지 말고 그 화면에서 복사하세요.
이미 만들어 둔 프로젝트를 옮길 때는 세 번째 칸의 프롬프트를 복사해 쓰시는 AI 도구에 그대로 붙여넣으면 됩니다. 주소와 지켜야 할 것이 다 들어 있습니다.
알아 둘 것
- 스트리밍은 받지 않습니다 — stream 을 켜고 부르지 마세요
- 모델 이름은 그대로 전달됩니다. 게이트웨이가 막지 않으니 쓰는 시점의 제공 서비스 문서를 확인하세요
- 응답은 제공 서비스가 준 그대로입니다 — 게이트웨이가 감싸거나 바꾸지 않습니다
- 주소를 자산 담당자 밖으로 알리지 마세요 — 그 주소만 있으면 우리 부서 예산으로 부를 수 있습니다
얼마나 썼는지 보기
마이 스튜디오 모델 키·사용량 탭에서 기간을 골라 봅니다. 게이트웨이에 그때그때 물어 보여 주는 것이라 D.AIA 가 따로 담아 두지 않습니다.
비용은 추정치입니다 — 게이트웨이가 셈해 준 값이라 제공 서비스가 청구하는 금액과 다를 수 있습니다. 단가를 모르는 모델은 0원이 아니라 빈 칸으로 둡니다.
실패한 호출이 있으면 그 줄 아래에 사유가 펼쳐집니다. 실패한 호출에는 토큰과 비용이 없습니다 — 제공 서비스가 거절한 것을 그대로 센 것입니다.
자산명은 나중에 바꾸지 않습니다 — 바꾸면 그 시점을 기준으로 사용량이 두 이름으로 나뉘어 어느 쪽도 온전하지 않게 됩니다.
모델 키·사용량 — 로그인하면 열립니다키 접수 — 로그인하면 열립니다
5배포 올린 뒤에 운영까지 가는 길.
웹으로 여는 앱만 배포합니다. 내려받아 쓰는 앱 · 스킬 · 에이전트 커넥터는 배포할 것이 없어 이 자리가 서지 않습니다.
자산 관리의 배포 탭에서 합니다 — 마이 스튜디오 등록 자산에서 자산 관리 를 누르면 들어갑니다.
버전을 여기서 만들지 않습니다
저장소에 푸시된 것을 내보내는 자리입니다. 푸시하면 D.AIA 가 받아 등록까지 자동으로 하고, 그 뒤 검증 · 운영은 담당자가 눌러 진행합니다 — 누르지 않으면 운영까지 올라가지 않습니다.
- 푸시 — 저장소의 main 에 올립니다. 이것은 D.AIA 밖에서 하는 일입니다
- 등록 — D.AIA 가 자동으로 받아 둡니다. 가지를 가리지 않고 받습니다
- 검증 — 담당자가 누릅니다. 코드와 커밋 본문을 함께 검사합니다
- 운영 — 담당자가 누릅니다. 빌드하고 운영에 반영합니다
검증이 보는 것은 다섯입니다
- 단가 · 마진율 — 고객사 이름과 단가 · 마진율 · 수수료율이 함께 적힌 곳
- 개인정보 — 이름 · 연락처 · 메일 주소 · 주민번호 꼴의 문자열
- 금지 파일 — .env · 키 파일 · 자격 증명 파일 · 표 파일
- 배포 가능성 — Dockerfile 이 저장소 맨 위에 있는지. 없으면 적어만 둡니다
- 게이트웨이 우회 — 제공 서비스 주소를 직접 부르는 코드. 적어만 둡니다
걸린 것은 막은 것이 위에, 막지 않은 것이 접혀 아래에 섭니다. 막지 않음 은 적어만 둔 것입니다 — 주석의 메일 주소, 견본 표 파일, Dockerfile 자리, 주소가 없을 때만 쓰는 제공 서비스 기본 주소처럼 코드에 있을 수 있는 것이라 배포를 막지 않습니다.
오탐이면 그 줄에서 예외를 신청합니다. 승인되면 그 커밋 그 줄 하나에만 붙습니다 — 검증을 끄는 것이 아닙니다.
저장소와 Coolify 앱은 관리자가 넣습니다
두 칸이 비어 있으면 푸시해도 D.AIA 가 받지 못하고, 받아도 운영에 올리지 못합니다. 등록 검수 때 시스템 관리자가 넣어 주는 것이라 담당자가 채울 수 없습니다.
같은 자리에 SSO 받을 주소 가 있습니다. 앱이 D.AIA 로그인을 이어 받게 할 때 시스템 관리자가 넣습니다 — 쓰지 않는 앱이 많아 비어 있는 것이 보통입니다.
점검 중에는 올라가지 않습니다
화면 맨 위에 지금 점검 중입니다 배너가 떠 있으면 운영 반영을 눌러도 거절되고, 언제 끝나는지 알려 줍니다. 점검이 끝나면 배너가 저절로 내려가고 다시 올릴 수 있습니다.
고친 것은 감사 로그에 남습니다. 두 칸이 비어 있으면 시스템 관리자에게 알려 주세요.
가장 최근 푸시로만 배포합니다
앞선 커밋을 골라 올릴 수는 없습니다. 되돌리기는 두지 않습니다 — 앞 커밋으로 돌리려면 저장소에서 되돌려 푸시하고 다시 검증 · 운영을 누릅니다.
그 앞에 받아 둔 푸시는 목록으로만 남습니다. 무엇이 밀렸는지 보라고 두는 것이지 거기서 배포하는 자리가 아닙니다.
배포 이력에는 배포한 커밋이 남습니다 — 실패한 것도 지우지 않습니다.
푸시 전에 걸러 내는 법
검증은 저장소에 올라간 뒤에 돕니다. 키는 검증이 따로 보지 않으니 특히 조심하세요 — 코드에서 지워도 저장소 기록에는 그대로 남아 있어, 그 키는 더 쓸 수 없고 새로 발급받아야 합니다.
저장소에 검사 설정을 미리 넣어 두면 커밋할 때 내 컴퓨터에서 먼저 걸러집니다. 검증까지 오지 않고, 저장소에 남지도 않습니다.
검사는 코드뿐 아니라 커밋 본문도 봅니다 — 코드는 깨끗해도 커밋 메시지에 적은 것이 걸릴 수 있습니다.
설정을 넣는 방법은 저장소마다 달라 시스템 관리자가 알려 줍니다. 문의는 Q&A 에 남겨 주세요.
마이 스튜디오 — 로그인하면 열립니다
6올리면 안 되는 것 넣는 순간 되돌릴 수 없는 것들.
아래는 사내 AI 업무 가이드라인을 그대로 따릅니다. D.AIA 가 따로 정한 것이 아닙니다.
절대 넣지 않습니다
- 고객사 계약 조건 — 단가 · 마진율 · 수수료율
- 전사 매출 · 지출 총괄 같은 합산 경영 데이터
- 개인정보 — 이름 · 연락처 · 주민번호
- 인사 · 급여 정보
조건을 지키면 쓸 수 있습니다
- 업무 데이터 — 비식별화한 뒤에 씁니다
- 캠페인 광고비 — 개별 캠페인 단위만 넣습니다. 전사 집계는 안 됩니다
- 고객사 이름 — 코드명으로 바꿔 적습니다
키를 코드에 적지 않습니다
LLM 키는 D.AIA 에 접수하고, 발급받은 이용 주소로 부릅니다. 코드에 키를 그대로 적으면 저장소 기록에 남아, 코드에서 지워도 그 키는 새로 발급받아야 합니다.
제공 서비스 주소를 직접 부르면 검증에 게이트웨이 우회로 적힙니다(배포는 막지 않습니다). 그렇게 부르면 사용량이 부서 몫으로 잡히지 않습니다.
이용 주소에는 비밀이 없지만 아무 데나 알려도 되는 것은 아닙니다 — 그 주소를 가진 사람은 부서 예산을 쓸 수 있습니다. 메일이나 문서로 옮겨 적지 마세요.
이용 주소 보기 — 로그인하면 열립니다
7접근 권한 누가 무엇을 쓸 수 있는지 정하는 자리.
자산마다 공개범위가 있습니다 — 전사 공개 와 비공개 둘입니다.
- 전사 공개 — 로그인한 사람이면 누구나 바로 씁니다
- 비공개 — 담당자가 넣어 둔 사람만 바로 쓰고, 나머지는 사용 신청을 냅니다
접근 목록에는 사람만 담깁니다. 부서 단위로 여는 길은 없습니다 — 부서에 사람이 드나들면 누가 쓰는지 아무도 모르게 됩니다.
담당자는 둘입니다
PO 와 기술 담당입니다. 둘 다 사용 신청을 승인할 수 있고, 먼저 처리한 사람의 결정으로 끝납니다. 자산과 같은 부서가 아니어도 담당자가 될 수 있습니다.
좁힐 때는 먼저 보여 줍니다
공개범위를 좁히면 쓰던 사람이 막힙니다. 그래서 몇 명이 걸리는지 먼저 보여 준 뒤에 바꿉니다.
마이 스튜디오 — 로그인하면 열립니다
자주 묻는 것 12
로그인하지 않아도 되나요?
비공개 자산은 어떻게 쓰나요?
LLM 키는 어디서 받나요?
코드에 키를 어떻게 넣나요?
이용 주소로 불렀는데 404 가 납니다.
배포 단추를 눌렀는데 아무 일도 없습니다.
처음 접속에서 없는 사번이라고 나옵니다.
앱을 열었더니 계정이 없다고 나옵니다.
자산 이름을 나중에 바꿀 수 있나요?
배포가 검증에서 막혔습니다.
고객사 이름을 넣어도 되나요?
담당자가 되려면 같은 부서여야 하나요?
여기에 없는 것은 Q&A 에 남기면 자산 담당자나 시스템 관리자가 답합니다. 읽으려면 로그인이 필요합니다 — 문의 글에는 그 자산이 무엇을 하는지가 적혀 있습니다.