템플릿
우리 팀만 쓰는 문서 AI 챗봇
팀이 직원 안내서, 규정, 업무 매뉴얼 같은 우리 문서를 검색하고 대화할 수 있는 문서 AI 챗봇이에요. 평소 말로 물으면 답이 되는 구절을 해당 페이지 링크와 함께 보여 줘요. 동료만 열 수 있어요.
이런 분께: 같은 질문에 계속 답하고 있는 모든 사람
01하는 일
팀이 얻는 것
이미 있는 문서를 올리기
편집자가 직원 안내서, 규정, 업무 매뉴얼을 PDF, Markdown, 텍스트 파일로 올려요. 파일당 최대 20 MB예요.
평소 말로 검색
결과는 일치하는 구절을 단어에 강조 표시해서 보여 주고, PDF의 해당 페이지나 파일의 해당 부분에서 열려요.
원하면 글로 쓴 답도
내 Anthropic API 키를 추가하면 앱이 사용한 구절을 인용해서 몇 문장으로 답해요.
문서는 앱 안에 그대로
키가 없으면 검색 툴이고, 앱 밖으로 나가는 건 없어요. 키가 있으면 가장 잘 맞는 구절만, 최대 8개까지 Claude에 보내 답을 써요.
02역할
누가 무엇을 할 수 있나요
앱을 열 수 있는 사람만 여기까지 들어와요. 앱 안에서는 담당자가 People 페이지에서 회사 이메일로 동료에게 역할을 줘요.
| 누가 | 할 수 있는 일 |
|---|---|
| 앱을 열 수 있는 모든 사람 | 검색, 질문, 문서 읽기 |
| 편집자 | 문서 올리기와 삭제 |
| 관리자 | 편집자와 관리자 지정 변경 |
| 담당자(처음 배포한 사람) | 모든 것 |
앱을 열 수 있는 사람 자체는 TeamOnly가 정해요. 회사 사람 모두, 또는 npx teamonly access only로 지정한 사람만이에요.
03시작
명령어 몇 개면 온라인에
컴퓨터에 Node.js가 있어야 해요. Claude Code나 Cursor를 쓰고 있다면 이미 있어요. 터미널에서 다음을 실행하세요.
앱 만들기
handbook라는 새 폴더에 앱 전체를 만들고 필요한 것을 설치해요.내 컴퓨터에서 써 보기
http://localhost:5173에서 열리고, 앱 담당자인 테스트 사용자로 로그인된 상태예요.온라인에 올리기
컴퓨터마다 한 번 로그인한 뒤 배포하세요.
handbook.acme.teamonly.app같은 링크가 생기고, 회사 사람만 열 수 있어요.
npx teamonly init --template ask-the-docs handbookCreated "handbook" from the ask-the-docs templatecd handbook && npm installnpm run devLocal: http://localhost:5173/npx teamonly loginSigned in as dana@acme.comnpx teamonly deployLive at https://handbook.acme.teamonly.appOnly @acme.com accounts can sign in.04내 것으로 만들기
AI에게 요청해서 고치기
템플릿은 폴더 안의 평범한 코드예요. Claude Code나 Cursor에 평소 말로 수정을 요청하고, npm run dev로 확인한 뒤 다시 배포하세요. 이런 요청을 해 볼 수 있어요.
“도움이 됐나요?” 버튼을 추가하고, 결과가 없었던 검색어를 보여 줘.
문서를 인사, IT, 재무 같은 폴더로 나누고, 폴더 하나만 검색할 수 있게 해 줘.
Documents 페이지에 문서마다 마지막으로 업데이트된 날짜를 보여 줘.
사람들이 가장 많이 묻는 질문 목록을 편집자만 볼 수 있게 남겨 줘.
05비용
비용은 얼마인가요
- 템플릿은 무료예요. 비용은 템플릿을 호스팅하는 TeamOnly에 내는데, 카드 없는 14일 무료 체험이 끝난 뒤부터예요.
- Builder, 월 $19: 제작자 1명, 앱 최대 3개.
- Team, 월 $249: 제작자와 앱 수 제한 없음, 회사 이메일이 있는 누구나 배포 가능.
- 앱을 쓰기만 하는 동료는 무료예요. 사용자 요금이 없어요.
쓰려면 AI 구독이 필요한가요?
아니요. 키가 없어도 문서를 위한 완전한 검색 툴이에요. 글로 쓴 답을 받으려면 내 Anthropic API 키가 필요하고, Anthropic이 사용량만큼 청구해요.
어떤 파일을 읽을 수 있나요?
PDF, Markdown, 텍스트 파일이고 파일당 최대 20 MB예요. Word 파일, Google Docs, 웹 페이지는 먼저 PDF로 저장하세요. 종이를 사진으로 찍기만 한 스캔 PDF에는 텍스트가 없어서, 앱이 안내 메시지와 함께 거부해요.
우리 문서가 AI로 보내지나요?
Anthropic API 키를 추가했을 때만 보내져요. 그러면 질문마다 가장 잘 맞는 구절을 최대 8개까지 Claude에 보내 답을 써요. 파일 자체는 TeamOnly에 있는 그 앱 전용 저장소에 남아요.
답이 틀릴 수도 있나요?
그럴 수 있어요. 그래서 모든 답은 구절을 인용하고 출처로 링크해요. Claude는 그 구절로만 답하라는 지시를 받고, 앱은 답을 믿기 전에 출처를 확인하라는 안내를 보여 줘요.
공유 드라이브나 인트라넷을 읽을 수 있나요?
바로는 안 돼요. 편집자가 앱에 파일을 올려요. 회사 내부 네트워크에만 있는 서버에는 접근할 수 없어요.
얼리 액세스
이번 주에 첫 툴을 올려 보세요.
TeamOnly는 얼리 액세스 중이고, 지금 모든 요금제에 가입할 수 있어요. 카드 없이 14일 동안 무료로 써 보거나, 구독하세요. 어느 쪽이든 회사 설정이 바로 끝나고, 명령어 세 개면 첫 앱이 온라인에 올라가요.
아직 준비가 안 됐나요? 소식 받기
질문은 hello@teamonly.dev로 보내 주세요. 사람이 직접 답해요.