AI
AI
Holarch의 모든 AI 기능, 미리 보기와 승인이 작동하는 방식, AI 키와 사용되는 키, Individual 및 Team 요금제에 포함된 AI, 사용량과 제한, AI 권한, 공급자에게 전송되는 내용입니다.
이 페이지의 내용
AI를 사용하면 일상적인 시스템 엔지니어링 작업을 빠르게 할 수 있습니다. AI는 다음을 할 수 있습니다.
- 열린 프로젝트에 관한 질문에 답하기,
- 요구사항을 다시 쓰고 생성하기,
- 기능과 흐름 제안하기,
- 추적 연결 제안하기,
- 위험, 테스트 케이스, 트레이드 스터디 기준, 결정 근거의 초안 작성하기,
- 클립아트 그리기.
AI는 선택 사항입니다. Holarch의 다른 모든 기능은 AI 없이 작동합니다.
모든 AI 변경은 먼저 미리 보기로 나타납니다. 확인할 때까지 모델은 아무것도 변경되지 않습니다. 실행 취소 한 번(⌘Z / Ctrl+Z)으로 변경 전체를 되돌립니다.
개념
| 용어 | 의미 |
|---|---|
| ✦ AI 컨트롤 | 상단 표시줄에 있는 하나의 AI 컨트롤입니다. ✦ AI는 AI에게 묻기를 열고, ▾는 현재 페이지의 AI 도구와 AI 설정…을 나열합니다. |
| AI에게 묻기 | 열린 프로젝트와 Holarch에 관한 질문에 답하는 채팅 패널. |
| AI 도구 | 측정 가능한 기준 추가…나 연결 검토 같은 페이지별 동작. |
| 미리 보기 | 무언가 적용되기 전에 AI의 제안을 보여 주는 대화 상자: 현재 텍스트, 제안된 텍스트, 단어 단위 변경, 또는 선택할 항목 목록. |
| AI 키 | Claude용 Anthropic API 키입니다. Holarch는 키를 서버에 암호화하여 저장하며 다시 표시하지 않습니다. 다른 제공업체는 현재 지원하지 않습니다. Holarch가 AI 모델을 선택하는 방식을 참조합니다. |
| 사용 중인 키 | 서버가 내 요청에 사용하는 키: 내 키, 조직의 키 또는 포함된 AI(Holarch의 키). |
| 토큰 | AI 제공업체가 세는 단위입니다. 토큰 하나는 영어 단어의 약 4분의 3입니다. 각 요청은 보낸 토큰과 돌려받은 토큰을 셉니다. |
| 월 한도 | 키 소유자가 설정한, 키의 월별 토큰 상한. |
| 구성원 한도 | 조직(또는 자체 호스팅 서버)이 비용을 내는 AI에 대해 관리자가 설정하는 1인당 월별 상한입니다. 모든 사람에게 적용되는 기본값과 개인별 사용자 지정 한도가 있습니다. |
| AI 참조 파일 | 텍스트가 일부 AI 프롬프트에 추가되도록 프로젝트에 첨부하는 파일. |
사용 방법
사용 시기와 이유
AI는 수명 주기의 각 단계에서 도움을 주지만, 검토를 대신하지는 않습니다.
- 요구사항: 모호한 문장을 단일하고 측정 가능한 "shall" 문장으로 바꾸고, 복합 요구사항을 분할하고, 근거 초안을 작성하고, 하위 요구사항을 생성하고, Correct, Feasible, Necessary를 판단하며, 규칙이 놓치는 모호하거나 검증할 수 없는 표현을 찾습니다(Unambiguous, Verifiable).
- 동작: 요구사항 집합에서 기능을 추출하고 기능 흐름을 제안합니다(요구사항 이후, 할당 이전).
- 추적성: 추적성 매트릭스에서 빠진 연결을 제안하고 의심스러운 연결을 표시합니다.
- 검증: 요구사항에 대한 테스트 케이스 초안을 작성합니다.
- 위험과 결정: 항목에 대한 위험 초안을 작성하고, 요구사항과 MOE에서 트레이드 스터디 기준을 제안하고, 결정 근거 초안을 작성합니다.
- 문서와 화이트보드: 문서를 요약하거나 번역하고, 서식 있는 텍스트를 다시 쓰고, 스티커 메모를 요구사항으로 바꿉니다.
- 질문: 프로젝트(“검증하는 테스트 케이스가 없는 요구사항은 무엇입니까?”)나 Holarch(“CSV 파일에서 요구사항을 가져오려면 어떻게 합니까?”)에 대해 묻습니다.
AI 설정하기
AI 기능은 Individual 및 Team 요금제에서 키 없이 작동하며, 이 요금제에는 매월 AI 요청이 포함됩니다(포함된 AI 참조). 더 많이 사용하려면 내 Anthropic 키를 추가하거나 조직의 키를 사용합니다. Free 요금제에는 포함된 AI와 내 키가 없습니다. 단, 학술 이메일 주소가 있는 계정과 활성 수업 조직의 구성원은 예외입니다.
- Anthropic Console(console.anthropic.com)에서 API 키를 만듭니다.
- Holarch에서 ✦ AI ▾ → AI 설정…을 엽니다. (또는 이니셜 → 계정 설정을 클릭하고 AI 키로 스크롤합니다.)
- + 키 추가를 클릭합니다.
- 제공업체에는 현재 제공되는 유일한 제공업체인 Anthropic API가 표시됩니다.
- API 키에 키를 붙여넣습니다.
- 선택 사항: 1,000 이상의 월 한도(토큰)를 입력합니다. 비워 두면 한도가 없습니다.
- 테스트 후 저장을 클릭합니다.
- 비밀번호 확인이 열리면 비밀번호를 입력합니다. 확인은 10분 동안 유지됩니다.
“AI 키가 추가되었습니다(Anthropic API, …abcd).” 알림이 표시됩니다. Holarch는 먼저 짧은 테스트 요청을 보냈습니다. 테스트가 실패하면 키는 저장되지 않으며 메시지가 이유를 알려 줍니다.
- 사용 중인 키를 확인합니다.
내 키: Anthropic API(…abcd)가 표시됩니다.
AI 도구 사용
선택한 항목에서 페이지별 AI 도구를 실행하고, 제안을 검토한 다음 적용합니다.
- 페이지를 열고 항목(예: 문서의 요구사항)을 선택합니다.
- 상단 표시줄에서 ✦ AI 옆의 ▾를 클릭합니다. (또는 ⌘K / Ctrl+K를 누르고 도구 이름을 입력합니다.)
- 도구를 선택합니다(예: 측정 가능한 기준 추가…).
실행 중인 타이머와 함께 “<제공업체>에 요청하는 중…” 대화 상자가 표시됩니다. 취소는 요청을 중지합니다.
- 미리 보기를 검토합니다.
미리 보기의 영향 목록은 AI가 변경할 항목에 추적되는 것, 즉 요구사항, 테스트, 인터페이스, 문서, 다이어그램, 다른 프로젝트의 항목을 각각 영향 받음 또는 확인으로 표시하여 보여 줍니다(영향). 제목을 클릭하면 열리고, 행을 클릭하면 미리 보기를 닫지 않고 항목을 볼 수 있습니다.
- 대화 상자가 허용하는 곳에서 제안을 편집합니다.
- 원하지 않는 것은 선택 해제합니다.
- 적용 버튼(예: 적용, 선택 항목 추가, 테스트 케이스 만들기 또는 선택 항목 적용)을 클릭합니다.
“측정 가능한 기준 추가 적용됨” 같은 짧은 알림이 표시됩니다. 실행 취소 한 번으로 변경 전체를 되돌립니다.
질문하기
AI에게 묻기는 열린 프로젝트와 Holarch에 관한 질문에 답합니다. 아무것도 변경하지 않습니다.
- 상단 표시줄에서 ✦ AI를 클릭합니다. (또는 ⌘K / Ctrl+K를 누르고 AI에게 묻기…를 선택합니다.)
- 질문을 입력하거나 예시 중 하나를 클릭합니다.
- Enter를 누르면 보냅니다. Shift+Enter는 대신 줄을 추가합니다.
패널에 답이 표시됩니다. 항목과 도움말 주제의 이름은 링크입니다. 일부 답에는 답이 가리키는 페이지를 여는 버튼이 있습니다. 답의 코드는 옆으로 스크롤되는 상자에 표시됩니다.
- 필요하면 후속 질문을 합니다. 최근 대화가 각 질문과 함께 전송됩니다.
app.holarch.app에서는 사용 방법 질문에 holarch.app의 가이드, 문서, 교육, 동영상 대본, 변경 기록으로도 답합니다. 그 페이지로의 링크는 새 탭에서 열립니다.
AI에게 묻기는 사용자가 쓰는 언어로 답합니다. 도움말과 Docs는 영어이므로 답의 메뉴, 버튼, 필드 이름은 영어 인터페이스에 표시되는 대로 나타납니다. AI에게 묻기는 어떤 언어의 질문에 대해서도 도움말 주제와 Docs 섹션을 찾으며, 답이 영어가 아니면 각 도움말 및 Docs 링크를 답의 언어로 영어 페이지라고 표시합니다(예: (auf Englisch) 또는 (英語)).
AI에게 묻기가 프로젝트에서 읽는 내용:
- 사용 방법과 기능에 관한 질문("CSV 파일을 가져오려면 어떻게 합니까?", "Holarch는 Word로 내보낼 수 있습니까?"): 프로젝트 데이터 없음. AI에게 묻기는 도움말, Docs, Holarch 기능 목록으로 답합니다.
- 작은 프로젝트: 모든 항목과 관계를 각 질문과 함께 전부 보냅니다.
- 큰 프로젝트: 프로젝트 전체의 요약(클래스별 항목, 그 Status, Priority 및 기타 목록 값, 레이블, 유형별 관계, 문서 및 다이어그램 이름)을 보냅니다. 그런 다음 AI에게 묻기는 질문에 필요한 것만 단계적으로 읽습니다: 단어로 항목을 검색하고(검색과 같은 일반 텍스트 일치), 관계와 함께 개별 항목을 읽고, 클래스, 속성 값, 레이블, 텍스트, 또는 가지고 있거나 없는 관계(예: verified by가 없는 요구사항)로 항목을 세거나 나열합니다. Claude에서는 Claude Haiku를 사용한 빠른 분류 단계가 먼저 올 수 있으며, 이는 같은 질문의 일부입니다. 목록이 잘리면 답 아래의 줄이 무엇을 근거로 했는지 알려 줍니다(예: "클래스 Requirement이고 verified by가 없는 항목 9,812개 중 200개(항목 100,000개 중)와 프로젝트 요약을 근거로 함."). 텍스트가 너무 많이 필요한 질문은 멈추고 그렇게 알려 줍니다. 더 좁은 질문을 합니다.
- 큰 프로젝트에서 질문을 좁히려면 항목에 나오는 단어나 번호를 사용하거나, 먼저 항목을 열거나, 항목을 선택하고 마우스 오른쪽 버튼 → ✦ 이 항목들에 대해 AI에게 묻기를 사용합니다.
패널 버튼:
- 확장 버튼은 패널이 창 대부분을 채우게 합니다. 다시 누르면 크기가 복원됩니다.
- ⚙는 AI 설정을 엽니다.
- ⟲는 대화를 지웁니다.
- ×는 패널을 닫습니다.
패널 크기를 바꾸려면:
- 패널의 왼쪽 가장자리를 끌어 넓히거나 좁힙니다.
- 키보드로: Tab으로 가장자리로 이동한 다음 ←(넓게) 또는 →(좁게)를 누릅니다. 더 큰 단계로 바꾸려면 Shift를 누르고 있습니다. Home은 가장 작은 크기, End는 가장 큰 크기로 설정합니다.
- 가장자리를 두 번 클릭하면 기본 크기로 돌아갑니다.
이 브라우저는 선택한 크기를 유지합니다. 좁은 창에서는 패널이 너비를 채웁니다.
참조 파일 첨부
참조 파일은 표준이나 작업 기술서 같은 배경 자료를 AI 프롬프트에 추가합니다. 각 프로젝트에는 파일 목록이 하나 있으며, 각 파일에는 자체 AI에서 사용 스위치가 있습니다.
- ✦ AI ▾ → AI 설정…을 엽니다.
- AI용 프로젝트 참조 파일 아래에서 + 파일을 클릭하고 파일을 선택합니다.
파일이 크기와 함께 AI에서 사용이 선택된 상태로 표시됩니다. 목록 아래 줄에는 사용 중인 파일 수와 추가되는 텍스트 양이 표시됩니다(예: "사용 중: 파일 3개 중 2개, 48k자").
- 파일을 더 추가하려면 반복합니다.
- 파일을 보내지 않고 목록에 두려면 AI에서 사용을 선택 해제하고, 제거하려면 ×를 클릭합니다.
- 저장을 클릭합니다.
참조 파일은 이 브라우저에 남으며 다른 구성원과 공유되지 않습니다. 이전 버전에서 패키지에 저장한 파일은 하나의 목록에 나타나며, 활성화되어 있던 패키지의 파일이 사용됩니다. 파일 형식과 한도는 AI 참조 파일을 참조합니다.
실전 예: EO-1 요구사항 다듬기
CubeSat EO-1 데모에는 검토자가 거부할 Draft 요구사항이 세 개 있습니다.
- 2.5 Safe Mode Recovery: “The spacecraft should recover from safe mode quickly and resume imaging as appropriate”
- 3.5 Battery Thermal Control: “The thermal design shall keep the battery warm enough (TBD).”
- 6.4 Operator Interface: “The operator interface shall be user friendly and/or easy to use.”
AI로 고칩니다.
- 데모를 만듭니다: 프로젝트 관리 → 프로젝트 파일 ▾ → 새 데모 프로젝트.
- EO-1 System Requirements Specification을 엽니다.
- 2.5 Safe Mode Recovery를 선택합니다.
- ✦ AI ▾ → 측정 가능한 기준 추가…를 선택합니다.
현재, 변경 사항, 제안(적용하기 전에 편집)이 표시됩니다. 제안은 예를 들어 “The spacecraft shall exit safe mode and resume imaging within 24 hours of the fault being cleared.”입니다. 설명에는 24시간이 제안된 값이라고 나와 있습니다.
- 임무 분석 결과가 다르면 값을 바꿉니다.
- 적용을 클릭합니다.
- 6.4 Operator Interface를 선택하고 복합 요구사항 분할…을 선택합니다.
단일 요구사항 각각이 표시됩니다. 항목 1은 6.4를 대체하고, 나머지는 그 뒤에 추가됩니다.
- 요구사항 분할을 클릭합니다.
- 3.5를 선택하고 근거 초안 작성…을 선택합니다.
- 근거를 검토하고 적용을 클릭합니다.
- 니즈 및 요구사항 → 품질을 엽니다.
- ✦ AI ▾ → AI로 검사(요구사항 n개)…를 선택합니다.
각 요구사항에 대해 Correct, Feasible, Necessary, Unambiguous, Verifiable 판단이 이유와 함께 표시됩니다. 판정 아래의 확인란은 적용하면 무엇이 바뀌는지 알려 주며("No → Yes", "발견 사항 추가"), "변경 없음"은 저장된 값이 이미 일치한다는 뜻입니다. 다시 쓰기와 승인된 요구사항은 선택 해제된 상태로 시작합니다. 버튼 위의 줄은 적용될 내용을 셉니다(예: "요구사항 5개에 값 7개와 다시 쓰기 2개를 적용합니다.").
- 선택 항목 적용을 클릭합니다.
- 문서로 돌아가 2.5를 선택하고 테스트 케이스 생성…을 선택합니다.
- 단계(순서대로), 준비, 예상 결과, 검증 방법을 검토합니다.
- 테스트 케이스 만들기를 클릭합니다.
2.5에 연결된 새 테스트 케이스가 표시됩니다.
적용한 각 변경은 실행 취소 한 번으로 되돌릴 수 있습니다. 어느 것이든 되돌리려면 ⌘Z / Ctrl+Z를 누릅니다.
팁과 모범 사례
- AI 출력은 초안으로 취급합니다. 적용하기 전에 숫자, 단위, 가정을 분석 결과와 대조합니다. AI가 제안하는 값은 설명에 표시됩니다.
- 먼저 선택합니다. 요구사항 도구는 요구사항(또는 다른 Statement)이 선택되어 있을 때만 ▾에 나타납니다.
- 선택은 적용을 뜻합니다. 미리 보기의 각 행을 읽습니다. 승인되었거나, 베이스라인에 포함되었거나, 잠긴 항목에 대한 변경, 연결 제거, 웹 주소가 있는 제안은 선택 해제되고 강조된 상태로 시작합니다. 확인한 후에만 선택합니다.
- 입력 배너를 확인합니다. 입력에 가져온 파일의 텍스트, 다른 사람의 변경, AI 참조 파일 또는 숨겨진 텍스트가 포함되어 있으면 미리 보기에 배너가 표시됩니다. 그런 제안은 꼼꼼히 확인합니다.
- 사용 중인 파일은 작게 유지합니다. 참조 파일은 많은 프롬프트에 추가되어 토큰을 더 많이 씁니다. 현재 작업에 필요 없는 파일은 AI에서 사용을 선택 해제합니다.
- 조직과 공유하는 키에는 월 한도를 설정합니다.
흔한 실수:
- ✦ AI가 AI 키 없음을 엶. 사용할 수 있는 키가 없습니다. AI 키 열기를 클릭하여 키를 추가하거나 조직 관리자에게 조직 키를 요청합니다.
- ✦ AI가 회색으로 표시됨. 가리키면 이유가 표시됩니다.
- “보기 전용: AI 도구에는 편집 권한이 필요합니다”: 보기 전용 권한이 있습니다.
- “관리자가 이 조직의 AI를 껐습니다.”: 조직이 AI를 껐습니다.
- 페이지의 도구가 ▾에 없음. 도구가 작동하는 항목을 선택하거나, 그 도구를 제공하는 페이지를 엽니다. 모든 AI 기능을 참조합니다.
- “이 항목에 변경을 적용하려면 확인란을 선택합니다.” 대상이 승인되었거나, 베이스라인에 포함되었거나, 잠겨 있습니다. 변경할 의도라면 동의 확인란을 선택합니다.
- 키 테스트가 실패함. 키가 완전하고, 활성 상태이며, 크레딧이 있는지 확인합니다.
다른 기능과의 연결
- AI 변경은 일반 모델을 거칩니다: 실행 취소할 수 있고, 저장되고, 공동 작업자와 실시간으로 공유되며, 버전 기록에 남습니다.
- 요구사항 도구는 다른 기능으로 이어집니다.
- 품질 페이지: “AI: …” 이유가 붙은 수동 Yes/No 값,
- 추적성: 대상에 추적된 생성 요구사항,
- 검증: 검증 방법 레이블이 붙은 생성 테스트 케이스,
- 위험 등록부: 원인과 관계된 생성 위험.
- AI에게 묻기는 도움말 주제와 실행 중인 앱의 기능 목록을 사용하므로, 무언가를 사용할 수 없으면 그렇게 알려 줍니다.
- 조직 관리자는 자신의 프로젝트에 대한 AI를 제어합니다(관리 참조).
✦ AI 컨트롤
컨트롤은 모든 프로젝트 페이지의 상단 표시줄에 있습니다.
- ✦ AI는 AI에게 묻기를 엽니다.
- ▾는 현재 페이지의 AI 도구와 AI 설정…을 나열합니다.
AI 도구가 없는 페이지에는 ✦ AI만 표시됩니다. 좁은 창에서는 컨트롤이 반짝임 기호와 ▾로 표시됩니다. 같은 도구가 ⌘K / Ctrl+K의 이 페이지의 AI 도구 아래에도 있습니다.
다음 중 하나에 해당하면 컨트롤이 꺼집니다. 도구 설명에 이유가 표시됩니다.
- 보기 전용 권한이 있는 경우: “보기 전용: AI 도구에는 편집 권한이 필요합니다”,
- 프로젝트의 조직이 AI를 끈 경우: “관리자가 이 조직의 AI를 껐습니다.”
- 설치의 관리자가 AI를 끈 경우: “이 설치에서는 AI가 꺼져 있습니다.”(설치에서 AI가 꺼진 경우 참조).
키가 없어도 컨트롤은 켜져 있습니다: ✦ AI는 AI 키 열기와 함께 AI 키 없음(“계정 → AI 키에서 Anthropic 키를 추가합니다.”)을 열며, ▾의 AI 도구도 같은 대화 상자를 엽니다.
마우스 오른쪽 버튼 메뉴에서
데이터베이스 행, 문서 항목 또는 개요 항목, 품질, TBD/TBR 또는 검토할 연결 행의 마우스 오른쪽 버튼 메뉴는 최대 세 개의 제안 동작으로 시작하며(연결 검토…나 TBD 해결… 같은 비AI 동작이 먼저), 각각 오른쪽에 이유가 표시됩니다. 제안은 AI 호출 없이 엔터티의 상태에서 나오므로 메뉴가 즉시 열립니다: 실패한 품질 기준을 고치는 다시 쓰기(예: ✦ 측정 가능한 기준 추가…, "실패: Unambiguous"), verified by 관계가 없는 요구사항에 대한 ✦ 테스트 케이스 생성…, 하위 항목이 없는 요구사항에 대한 ✦ 하위 요구사항 생성…, 하위 Action에 흐름이 없는 Action에 대한 ✦ 흐름 제안…. 해당하는 것이 없으면 메뉴는 ✦ AI로 검사…(요구사항)와 ✦ 이 항목에 대해 AI에게 묻기…를 제안하며, 후자는 엔터티를 맥락으로 하고 질문이 시작된 상태로 AI에게 묻기를 엽니다. ✦ AI 더 보기 ▸는 엔터티에 대한 모든 AI 동작을 나열합니다. ✦ AI 컨트롤이 꺼져 있으면 AI 부분은 같은 이유가 붙은 흐린 행 하나, ✦ AI 동작:입니다. 규칙과 전체 목록은 모델과 데이터베이스에 있습니다.
여러 항목을 선택했을 때
여러 행이나 문서 항목을 선택하고(⌘ / Ctrl-클릭 또는 ⇧ / Shift-클릭, Windows와 Linux에서는 Ctrl-클릭) 그중 하나를 마우스 오른쪽 버튼으로 클릭하거나, 데이터베이스 일괄 작업 표시줄 시작 부분의 ✦ AI ▾를 사용합니다. 메뉴의 ✦ 그룹은 선택 전체에 작동합니다. 각 레이블에는 적용되는 항목 수가 표시되며, 어느 항목에도 맞지 않는 동작은 이유와 함께 흐리게 표시됩니다(예: "선택한 요구사항 없음").
| Action | 기능 | 미리 보기 |
|---|---|---|
| ✦ AI로 검사(요구사항 n개)… | 선택한 요구사항을 요청당 20개씩 검토합니다. | 모든 AI 기능에 설명된 검토 표. |
| ✦ 다시 쓰기(n) ▸ | 선택한 요구사항과 Statement에 대해 다시 쓰기 도구 하나를 요청당 10개씩(분할은 5개씩) 실행합니다. 각 도구에는 개수가 표시됩니다(명확하게 다시 쓰기, 측정 가능한 기준 추가(요구사항만), 단순화, 복합 요구사항 분할, 근거 초안 작성, 이름 제안). | 항목마다 확인란과 각 변경의 단어 단위 차이가 있는 목록 하나. 분할은 항목 아래에 부분을 표시하며, 부분 1은 항목을 대체하고 나머지는 그 뒤에 추가됩니다. 제안된 변경이 없는 항목에는 "제안된 변경 없음"이 표시됩니다. |
| ✦ 테스트 케이스 생성(n)… | 선택한 요구사항마다 테스트 케이스 하나를 요청당 10개씩 작성합니다. | 요구사항마다 확인란이 있는 목록 하나: 테스트 케이스 이름(편집 가능), 방법, 단계, 준비, 예상 결과. 이미 verified by 테스트 케이스가 있는 요구사항은 이미 검증됨 포함(n)을 선택하지 않으면 제외됩니다. 만들어진 각 테스트 케이스는 상태가 Not Run이고 요구사항을 verifies하며, 그 방법이 요구사항에 레이블로 추가됩니다(잠겼거나, 승인되었거나, 베이스라인에 포함된 요구사항에는 추가되지 않음). |
| ✦ 이 항목들에 대해 AI에게 묻기(n)… | 선택한 항목을 맥락으로 하고 질문이 "이 항목 n개에 대해: "로 시작된 상태로 AI에게 묻기를 엽니다. | 답만 합니다. 최대 50개 항목을 보내며, 패널에 개수가 표시됩니다. |
| ✦ 추적 제안(n)… | 선택한 항목 사이에 빠진 관계를 제안하며, 스키마가 그 클래스 사이에 허용하는 관계(satisfied by, verified by, traced to, decomposed by, specified by, performed by)만 사용합니다. 최대 150개 항목. | 각각 이유가 붙은 제안된 관계 목록 하나. 잠겼거나, 승인되었거나, 베이스라인에 포함된 항목으로의 연결은 선택 해제된 상태로 시작합니다. |
선택 항목 적용은 선택된 행을 실행 취소 한 단계로 적용합니다. 잠겼거나, 승인되었거나, 베이스라인에 포함된 항목과 웹 주소가 들어 있는 제안은 선택 해제된 상태로 시작합니다.
최대 3개의 요청이 동시에 실행되므로 요구사항 50개에 약 3분의 1의 시간이 걸립니다. 50개가 넘는 항목은 여러 요청이 필요하므로 먼저 확인을 요청합니다. 진행 대화 상자에는 완료된 항목과 배치 수가 표시되며, 취소는 모든 요청을 중지하고 미리 보기는 그때까지의 결과를 보여 줍니다. 요청 하나가 실패하면 미리 보기는 나머지 결과를 보여 주고 처리되지 않은 항목을 알려 줍니다(예: "항목 21–40 검토 안 됨").
모든 AI 기능
| 위치 | 기능 | 적용하기 전에 검토하는 내용 |
|---|---|---|
| 상단 표시줄, 모든 프로젝트 페이지 | AI에게 묻기 | 답만 하며, 아무것도 변경되지 않습니다. |
| 요구사항을 선택한 상태의 문서, 데이터베이스, 항목 보기(▾) | 명확하게 다시 쓰기…, 측정 가능한 기준 추가…, 단순화…, 근거 초안 작성…, 이름 제안… | 현재, 변경 사항(단어 단위 차이), 제안(적용하기 전에 편집), AI의 설명. 적용. |
| 같은 곳, 요구사항 또는 Statement | 복합 요구사항 분할… | 이름과 텍스트가 있는 각 부분. 항목 1은 원본을 대체하고 나머지는 그 뒤에 추가됩니다. 요구사항 분할. 분할이 필요 없는 Statement에는 분할할 내용 없음이 표시됩니다. |
| 같은 곳, 요구사항 | AI로 검사(이 요구사항)… | 이유와 선택적 다시 쓰기가 붙은 Correct, Feasible, Necessary, Unambiguous, Verifiable. Unambiguous와 Verifiable은 규칙 검사가 놓치는 것만 보고하며, 받아들인 No는 품질 페이지에 AI 발견 사항으로 나열됩니다. 확인란은 값이 바뀔 곳에만 있고 각각 효과가 표시되며, 다시 쓰기는 선택 해제된 상태로 시작합니다. 선택 항목 적용. |
| 같은 곳, Statement 또는 요구사항 | 하위 요구사항 생성… | 모드(하위 항목(한 수준 아래) 또는 형제 항목(같은 수준)), 개수(1–20), 컨텍스트. 그다음 편집 가능한 카드. 선택 항목 추가. |
| 같은 곳, 요구사항 | 테스트 케이스 생성… | 번호, 이름, 단계(순서대로), 준비, 예상 결과, 검증 방법(요구사항에 레이블 추가). 테스트 케이스 만들기. |
| 같은 곳, 선택한 모든 항목 | 위험 생성… | 후보 위험을 최대 3개 고른 다음(다음: 세부 정보) 번호, 이름, 범주(프로젝트의 위험 범주), 설명, 결과 설명, 결과 %, 확률 %를 편집합니다. 선택한 위험 추가. 각 위험은 항목과 관계됩니다(caused by). |
| 문서와 항목 보기(▾) | 요구사항 생성… | 대상 항목 사용, 컨텍스트, 상위 요구사항(1–20), 상위 항목당 하위 항목 수(0–10), 요구사항 유형(환경, 기능, 인터페이스, 성능, 신뢰성, 안전, 검증), 지침, 새 요구사항을 대상에 관계 설정(traced to). 그다음 편집 가능한 카드. 선택 항목 추가(Draft로 생성). |
| 문서(▾) | 문서 요약… | 섹션, 세부 수준(낮음, 중간 또는 높음, 약 1–3개 단락), 언어. 그다음 핵심 메모 검토, 그다음 요약 미리 보기. 문서 시작 부분에 Statement Document Summary(S.0)로 저장됩니다. |
| 문서(▾) | 문서 번역… | 언어(18개 언어 또는 사용자 지정…), 새 번호, 이름, 설명. 그다음 나란히 보는 미리 보기. 새 문서로 저장은 사본을 만들며, 원본은 변경되지 않습니다. |
| 문서(▾) | AI로 검사(요구사항 n개)… | 위와 같이, 문서의 모든 요구사항에 대해. |
| 문서 작성 ▾ | ✦ 하위 요구사항 생성…, ✦ 요구사항 생성…, ✦ 위험 생성…, ✦ 테스트 케이스 생성…, ✦ 요약…, ✦ 번역… | 위와 같습니다. |
| 문서 분할 대화 상자 | ✦ 분할 제안 | 분할 행을 채웁니다. 편집한 다음 적용합니다. |
| 품질(▾) | AI로 검사(요구사항 n개)… | 위와 같이, 목록의 요구사항에 대해. |
| 홈(▾) | ✦ 프로젝트 요약 작성 | 프로젝트 요약의 요약(최신 베이스라인 이후 변경, 위험에 처한 것, 다음 세 가지 실행 항목, 링크 포함). 홈에 보관은 이를 프로젝트 요약 패널에 유지하며, 거기서 다시 작성이 이를 대체합니다. |
| 가져오기, 매핑 단계(▾) | 매핑 제안 | 제안된 매핑: 변경된 열마다 이유가 붙은 선택된 행 하나. 선택 항목 적용. |
| 기여(▾) | ✦ 이 그룹의 작업 요약…, ✦ 이 구성원의 작업 요약… | 기록된 활동의 요약이며, 모델은 아무것도 변경되지 않습니다. 기여를 참조합니다. |
| 기능 분석(▾, 집합에 기능이 있을 때) | AI로 기능 검토 및 확장… | ✦ 기능 검토 및 확장: 발견 사항, 그다음 기존 기능(Keep, Changed)과 가장 높은 번호 다음으로 번호가 매겨진 새 기능(New). 제안된 이름 바꾸기, 분할, 병합, 이동(Suggested)은 선택했을 때만 적용됩니다. 실행 취소 한 번으로 모두 되돌립니다. |
| 기능 분석(▾) | AI로 기능 추출… | ✦ AI가 제안한 기능: 요구사항별 기능이며, 적용하기 전에 편집할 수 있습니다. |
| 기능 분석(▾) | AI로 흐름 제안… | ✦ AI가 제안한 흐름: 제안된 흐름과 근거. 보호된 흐름을 대체하려면 동의가 필요합니다. |
| 추적성 매트릭스(▾) | 연결 검토 | 연결 검토 목록: 빠진 연결(셀에 +)과 의심스러운 기존 연결(셀에 ?)이 각각 신뢰도와 이유와 함께 표시됩니다. 목록에서 선택하거나 표시된 셀을 클릭합니다. 변경 N개 적용은 연결하고 연결을 해제하며, 실행 취소 한 번으로 모두 되돌립니다. 50% 미만의 제안과 보호된 항목에 닿는 제안은 선택 해제된 상태로 시작합니다. |
| 트레이드 스터디(▾) | 요구사항과 MOE에서 기준 제안…, 결정 근거 초안 작성… | 제안된 기준. 기록 대화 상자의 근거 초안(그곳의 초안 버튼도 해당). |
| Risk 다이어그램 도구 모음(▾도 해당), 그리고 매트릭스 셀 패널의 ✦ 위험 생성 | ✦ 위험 생성 | 루트 또는 선택한 셀에 대해 대상 엔터티, 컨텍스트, 프로젝트의 위험 범주에 속한 위험 수(1–10, 기본값 5). 그다음 제안된 위험 검토, 그다음 선택 항목 만들기. |
| 화이트보드(▾, 또는 스티커 메모를 선택했을 때 선택 도구 모음) | 요구사항 수집… | AI로 “shall” 문장 초안 작성을 선택하고, 선택적 지침을 추가하고, 문장 초안 작성을 누른 다음 각 이름과 문장을 편집합니다. 요구사항 만들기. |
| 화이트보드 클립아트 패널 | ✦ AI로 생성… | 설명, 스타일, 색 구성표, 시점, 변형(1–8). 변형을 고른 다음 라이브러리에 추가 또는 추가 및 삽입. 다시 생성, 다듬기…, 중지를 사용할 수 있습니다. |
| 서식 있는 텍스트 편집기 ✦ 버튼 | 표현 개선, 단순화, 맞춤법 및 문법 수정, 줄이기, 세부 정보 추가, 문장 완성, 어조 바꿔 다시 쓰기…, 번역…, 전체 텍스트 번역…, AI로 작성… | 현재, 제안됨, 변경 사항. 다시 시도, 버리기 또는 바꾸기. AI로 작성…은 프롬프트와 어조를 물은 다음 미리 보기 만들기와 삽입을 제공합니다. |
어조 바꿔 다시 쓰기…와 AI로 작성…의 어조: 학술적, 단호함, 편안함, 자신감, 건설적, 공감, 흥미진진, 유창함, 격식, 친근함, 고무적, 전문적.
페이지별 세부 사항은 도움말을 참조합니다: 기능 분석, 추적성 매트릭스, 트레이드 스터디, 위험 등록부, 화이트보드, 화이트보드 클립아트.
미리 보기와 승인
- 확인할 때까지 아무것도 적용되지 않습니다. 미리 보기를 닫거나 취소하면 아무것도 변경되지 않습니다.
- 실행 취소 한 번으로 모두 되돌립니다. 적용한 각 AI 변경은 영향을 주는 항목 수와 관계없이 실행 취소 한 번으로 되돌립니다.
- 보호된 항목은 동의 필요. 일부 변경은 강조되고 선택 해제된 상태로 시작합니다.
- 승인되었거나, 베이스라인에 포함되었거나(문서 베이스라인), 잠긴 항목에 대한 변경,
- 연결 제거(기능 분석 재할당),
- 웹 주소가 들어 있는 제안.
이런 종류의 변경이 하나뿐이면 “그래도 이 변경 적용(…)” 같은 상자가 표시됩니다.
- 입력 배너. 입력에 가져온 파일의 텍스트, 다른 사람의 변경, AI 참조 파일 또는 숨겨진 텍스트가 포함되어 있으면 미리 보기에 배너가 표시됩니다.
- 검사된 응답. 모든 응답은 사용자가 보기 전에 검사됩니다. 형태가 잘못되었거나, 텍스트가 너무 많거나, 요청에 없던 id가 있는 응답은 거부됩니다(“AI 응답이 거부되었습니다…”). 아무것도 변경되지 않습니다. 텍스트는 들어갈 위치에 맞게 정리됩니다: 스크립트, 이미지, 프레임, 다른 사이트로의 링크가 없습니다.
- 요구사항 텍스트는 품질 검사를 따릅니다. 요구사항 텍스트를 쓰는 요청(명확하게 다시 쓰기, 측정 가능한 기준 추가, 단순화, 분할, 요구사항 생성과 하위 요구사항 생성, AI 요구사항 검사의 다시 쓰기, 문서의 AI 분할, 화이트보드의 요구사항 수집)은 품질 검사의 표현 규칙을 단어 목록과 함께 나열합니다. 여전히 규칙을 어기는 제안은 검사기의 발견 사항과 함께 한 번 다시 보내지며, 더 나은 응답이 표시됩니다. 제안된 각 문장 아래에 미리 보기는 검사기의 결과를 표시합니다: "✔ 품질 검사기의 표현 규칙을 통과합니다." 또는 발견 사항과 함께 "품질 검사기: …". 편집하는 대로 업데이트됩니다. 연결이나 검토자가 필요한 규칙(검증하는 테스트 케이스, 중복, Correct, Feasible)은 이 검사에 포함되지 않습니다.
- AI에게 묻기는 텍스트를 표시합니다. Holarch 페이지와 도움말 주제로의 링크만 클릭할 수 있으며, 웹 주소는 일반 텍스트로 남습니다.
프로젝트 텍스트를 지시와 분리하는 방법은 AI가 신뢰할 수 없는 콘텐츠를 다루는 방식을 참조합니다.
AI 키
제공업체
| 제공업체 | 필드 |
|---|---|
| Anthropic API | API 키 |
| Kimi API | API 키, 영역(내 키로 사용하는 Kimi K3 참조) |
| GLM API | API 키(내 키로 사용하는 GLM 5.3 참조) |
Holarch의 AI는 Claude이지만, 호스팅 서비스에서 중국 본토, 홍콩, 마카오, 대만에서 오는 요청에는 GLM 5.3을 사용합니다(중국 본토의 AI). Kimi K3와 GLM 5.3은 켤 수 있는 옵션입니다. 조직에서는 조직 관리자가 각각을 켜기 전까지 꺼져 있습니다(조직에서의 Kimi K3와 GLM 5.3 참조).
자체 호스팅 설치에서는 Amazon Bedrock도 제공할 수 있습니다(Amazon Bedrock을 통한 Claude 참조). app.holarch.app의 호스팅 서비스는 제공하지 않습니다.
여러 키: 기본 선택으로 표시된 키가 모든 요청에 응답합니다. 다른 키 옆의 이 키 사용을 클릭하면 그 키로 전환됩니다. 목록에 이미 키가 있으면 키 추가는 새 키를 AI 요청에 사용할지 묻습니다(AI 요청에 이 키 사용, 기본적으로 켜짐).
OpenAI, Gemini, Azure OpenAI 키는 현재 지원하지 않습니다(이유). 이전에 이 중 하나에 대해 추가한 키는 목록에 남으며 “이름 키는 현재 지원하지 않습니다. 키는 보관됩니다. 더 이상 필요 없으면 삭제합니다.”로 표시됩니다. 사용되지 않으며, 제거로 삭제합니다.
모든 키 양식에는 월 한도(토큰)도 있습니다(비워 두면 한도 없음, 최소 1,000, 최대 10,000,000,000).
내 키
내 키는 계정 설정 → AI 키와 AI 설정에서 내 키를 나열합니다. 각 키에는 다음이 표시됩니다.
- 제공업체. 여러 제공업체의 키가 있으면 기본 설정으로 표시됩니다.
- 키: 마지막 4자. 제공업체가 거부하면 마지막 사용 시 거부됨이 나타납니다.
- 추가한 사람과 마지막 사용.
- 이번 달: 사용한 토큰, 한도 “중”, 한도 도달.
버튼:
- 테스트는 짧은 요청을 보냅니다: “✓ 작동함(1.2초)” 또는 이유와 함께 “✕”.
- 제거는 “…(으)로 끝나는 … 키를 제거하시겠습니까? 그러면 요청에 조직의 키(있는 경우) 또는 요금제에 포함된 AI가 사용됩니다.”라고 묻고 최근 비밀번호 확인이 필요합니다. 알림: “AI 키가 제거되었습니다.”
제공업체마다 키를 하나씩 가질 수 있습니다. 이미 키가 있는 제공업체의 키를 추가하면 기존 키를 대체합니다. 첫 번째 키가 기본 설정 키입니다.
키가 없으면: “내 키가 없습니다.”
조직 키
조직 키를 사용하면 구성원이 자신의 키 없이 AI를 사용할 수 있습니다. 조직 관리자는 계정 페이지의 조직 → 조직 키에서 이 키를 추가, 테스트, 제거합니다. 양식은 내 키와 같습니다. 페이지에는 “자신의 키가 없는 … 구성원은 이 키를 사용합니다.”라고 표시됩니다.
구성원은 어떤 조직 키가 있는지만 봅니다: “조직 키: Anthropic API(…abcd). 내 키가 없을 때 사용됩니다.” 조직 키가 없으면 “조직 키가 없습니다. 자신의 키가 없는 구성원은 요금제에 포함된 AI를 사용합니다.”가 표시됩니다.
이번 달 구성원별 사용량에는 구성원, 요청, 토큰, 비용(추정), 한도와 합계 행이 각 구성원의 월 한도를 설정하는 컨트롤 아래에 나열됩니다(구성원 한도 참조).
사용되는 키
서버는 요청마다 다음 순서로 키 하나를 고릅니다.
- 내 키: 추가한 경우.
- 조직의 키. 내가 구성원인 조직에 속한 프로젝트에서는 그 조직의 키가 사용됩니다. 그런 프로젝트 밖에서는 정확히 한 조직에 속해 있으면 그 조직의 키가 사용됩니다. AI를 끈 조직은 누구에게도 키를 빌려주지 않습니다.
- 포함된 AI: 이번 달 포함된 요청이 있는 Holarch 자체 키(아래 참조).
- 없음: AI 기능이 꺼집니다.
Free 요금제에서는 1단계와 3단계가 학술 이메일 주소가 있는 계정과 활성 수업 조직의 구성원에게만 적용됩니다. 다른 Free 계정은 자신의 키를 추가할 수 없으며, AI 기능은 요금제를 선택하라고 요청합니다(포함된 AI 참조). 사용 중인 키에는 “없음. 키를 추가할 때까지 AI 기능이 꺼져 있습니다.”가 표시됩니다.
AI 설정과 계정 페이지의 사용 중인 키에 결과가 표시됩니다(예: 내 키: Anthropic API(…abcd), SYSE 682의 조직 키: Anthropic API(…wxyz) 또는 포함된 AI: Claude Haiku).
포함된 AI
Individual 및 Team 요금제에는 매월 일정 수의 AI 요청이 포함되며, Holarch 자체 Anthropic 키를 통해 Claude가 응답합니다. 키가 필요 없습니다. 중국 본토, 홍콩, 마카오, 대만에서 오는 요청에는 대신 Holarch 자체 Z.ai 키를 통해 GLM 5.3이 같은 요청 수로 응답합니다(중국 본토의 AI).
| 요금제 | 포함된 AI |
|---|---|
| Free | 없음. 내 키도 사용할 수 없음 |
| 학술 이메일 주소가 있는 Free 또는 활성 수업 조직의 구성원 | 월 최대 75개 AI 요청, Claude Haiku. 내 키를 추가할 수 있음 |
| Individual | 월 최대 150개 AI 요청, Claude Sonnet |
| Team | 좌석당 월 최대 300개 AI 요청, Claude Sonnet. 무거운 작업에는 Claude Opus(요청 하나가 2개로 계산됨) |
- Free 요금제의 AI: AI 기능에는 “AI는 Individual 및 Team 요금제에 포함됩니다. 30일 무료 Individual 체험판을 시작하거나 요금제를 선택합니다.”가 체험판 시작 및 요금제 선택…과 함께 표시됩니다. 이미 체험판을 사용했으면: “AI는 Individual 및 Team 요금제에 포함됩니다. 계정 설정 → 요금제 및 결제에서 요금제를 선택합니다.” Individual 체험판 중에는 Individual 요금제에 포함된 AI가 적용됩니다.
- 학술 이메일 주소: .edu, .edu.country 또는 .ac.country로 끝나거나 등록된 대학의 확인된 주소를 가진 Free 계정은 포함된 AI와 자체 키를 유지합니다. 조직의 Single Sign-On으로 로그인하는 계정은 대신 조직을 따릅니다. 계정 설정 → 요금제 및 결제에 “학술 이메일: Free에서 포함된 AI와 프로젝트당 소유자 및 최대 6명의 초대된 편집자”가 표시됩니다.
- MCP 클라이언트와 REST API는 Individual 및 Team 요금제에 포함되며, Free에서는 학술 이메일 주소가 있거나 활성 수업 조직에 속한 경우(AI를 유지하는 것과 같은 계정)에 포함됩니다. 이들은 Holarch의 AI가 아니라 사용자 클라이언트의 AI를 사용합니다. API 및 MCP를 참조하십시오.
- 요청은 AI 기능을 한 번 사용하는 것입니다. AI에게 묻기 질문, 요구사항 초안 작성, 제안된 흐름, 선택한 항목에 대한 일괄 작업이 이에 해당합니다. AI에게 묻기가 프로젝트를 여러 단계로 읽더라도 질문 하나는 요청 하나입니다. 여러 부분으로 나누어 보낸 일괄 작업과 응답 형식이 잘못되어 Holarch가 다시 묻는 경우도 한 번으로 계산됩니다. 실패한 요청은 계산되지 않습니다.
- PDF 사양 가져오기: 파일 길이로 계산되며, 요구사항을 놓치는 비용이 차이보다 크기 때문에 포함된 AI가 있는 Free 계정을 포함한 모든 요금제에서 Claude Sonnet으로 답합니다. Holarch는 파일을 5페이지씩 읽고 각 부분에서 파일 전체를 다시 읽으므로 긴 파일일수록 더 많이 계산됩니다. 약 30페이지까지는 5페이지당 요청 1건(10페이지: 요청 2건, 25페이지: 5건), 그 이후에는 5페이지당 더 많이 계산됩니다(100페이지: 요청 30건, 200페이지: 90건). 실행하기 전에 Holarch는 사용량을 표시합니다. 예: “이 가져오기는 이번 달에 남은 포함된 AI 요청 140건 중 30건을 사용합니다(긴 파일은 5페이지당 더 많이 계산됨).” 남은 요청보다 많은 요청이 필요한 PDF는 시작되지 않습니다. 더 짧은 파일로 나누십시오. PDF 사양 가져오기를 참조하십시오.
- AI 요구사항 검사: 요구사항 100개당 요청 1건(올림)입니다. 요구사항이 100개를 넘는 검사를 실행하기 전에 Holarch는 사용량을 표시합니다. 예: “이 검토는 이번 달에 남은 포함된 AI 요청 52건 중 3건을 사용합니다(요구사항 100개당 요청 1건).” 남은 요청보다 많은 요청이 필요한 검사는 시작되지 않습니다.
- AI로 클립아트 생성: 변형마다 요청 하나(변형 4개: 요청 4개)이며, 모든 요금제에서 Claude Haiku로 그려집니다.
- SysML v2 모델 질문(Individual 및 Team): 질문당 요청 1건이며, 선택한 모델로 답합니다(Claude Sonnet, 또는 Team 요금제의 Claude Opus는 2건으로 계산).
- 표시되는 곳: 계정 설정 → AI 키와 AI 설정에 포함된 AI: Claude Haiku · 이번 달 요청 75건 중 52건 남음 · 11월 1일 재설정이 표시됩니다.
- 모두 사용한 경우: “이번 달 포함된 AI 요청 75건을 모두 사용했습니다. 11월 1일에 재설정됩니다. 더 사용하려면 계정 설정 → AI 키에서 자체 Anthropic 키를 추가하십시오.” 유료 요금제가 판매되면 Free 요금제의 메시지는 “… 11월 1일에 재설정됩니다. Individual에는 Claude Sonnet으로 월 최대 150건의 AI 요청이 포함됩니다. 계정 설정 → AI 키에서 자체 Anthropic 키를 추가하거나 계정 설정 → 요금제 및 결제에서 유료 요금제를 선택하십시오.”이며 요금제 선택…을 제공합니다. 요청은 매월 1일(UTC)에 재설정되며 이월되지 않습니다.
- Holarch의 추가 요청: Holarch가 계정(또는 조직)에 추가 AI 요청을 주면 월간 요청 다음에 사용되며, 만료가 가장 빠른 것부터 사용됩니다. Free 요금제에서도 마찬가지입니다. 그러면 AI 설정에 추가 요청이 표시되고(예: … 11월 1일 재설정 · 추가 요청 40건), 계정 설정 → 요금제 및 결제에 만료 날짜와 함께 나열됩니다. 사용하지 않은 요청이 만료되기 7일 전에 이메일로 알려 드립니다.
- Team: Claude Opus. 모델에서 이 브라우저에 대해 Claude Opus, 무거운 작업용(요청 2건)을 선택합니다. 기본값은 Claude Sonnet입니다.
- Holarch의 기능 전용. 포함된 AI는 Holarch AI 기능의 요청에만 답합니다. AI에게 묻기는 Holarch와 사용자 모델에 대한 질문에 답하고, 그 밖의 질문은 Holarch와 사용자 모델에 대한 질문에 답한다는 짧은 한 문장으로 질문의 언어로 거절합니다. 다른 AI 기능은 각자의 작업만 수행합니다. 다른 용도로 사용하려면 자체 키를 추가하십시오. 기능이 허용하는 것보다 많은 데이터가 담긴 요청은 “이 AI 요청은 포함된 AI로 처리하기에 너무 큽니다. 한 번에 더 적은 항목으로 작업하거나 내 Anthropic 키를 사용하십시오.”라는 메시지와 함께 거부됩니다.
- 제한. 각 기능에는 최대 응답 길이가 있으며, AI에게 묻기 질문은 2,000자로 제한됩니다.
- 유료 요금제는 일시 중지되지 않습니다. Individual과 Team은 월간 요청 수까지 포함된 AI를 유지합니다. Free 요금제와 Individual 체험 기간에는 포함된 AI가 일시 중지될 수 있습니다. 이번 달 Free 사용 예산이 소진된 경우(1일까지) 또는 Holarch가 일시 중지한 경우입니다. 그러면 요청에 “Free 계정의 포함된 AI가 11월 1일까지 일시 중지되었습니다. 이번 달 Free 사용 예산이 소진되었습니다. 계정 설정 → 요금제 및 결제에서 유료 요금제를 선택하거나 계정 설정 → AI 키에서 자체 Anthropic 키를 추가하십시오.” 또는 “Free 계정의 포함된 AI가 일시 중지되었습니다. 유료 요금제를 선택하십시오 …”가 표시됩니다. 유료 요금제가 판매되기 전에는 메시지에 자체 키만 언급됩니다. 수업 조직의 구성원은 본인의 요금제에 따라 계산됩니다.
- 조직: AI를 끈 조직은 해당 조직 프로젝트의 포함된 AI도 끕니다.
자체 키나 조직의 키로 한 요청은 포함된 요청에서 차감되지 않으며, 해당 키의 공급자가 키의 계정에 요금을 청구합니다. Holarch가 이 모델들을 사용하는 이유: Holarch가 AI 모델을 선택하는 방법.
AI 설정
✦ AI ▾ → AI 설정…, AI에게 묻기의 ⚙, ⌘K / Ctrl+K → AI 설정… 또는 이니셜 → AI 설정…으로 엽니다.
| 구성 요소 | 목차 |
|---|---|
| AI 키 | 사용 중인 키, 포함된 AI: 모델과 이번 달 남은 요청(Team: 모델, Claude Sonnet(요청 1건) 또는 Claude Opus, 무거운 작업용(요청 2건)), 이번 달: 자체 키의 경우 토큰(월 한도 대비), 요청 및 정가 기준 예상 비용, 조직 키의 경우 요청과 키에 월 한도가 있으면 사용한 비율이 미터와 함께 표시됩니다(80 %부터 황색). 프로젝트의 조직이 AI를 끈 경우 이 프로젝트에 그렇게 표시됩니다. |
| 내 키 | 공급자 목록과 내 키(위 참조). |
| 세션 간에 AI에게 묻기 기록 유지 | AI에게 묻기 대화를 이 브라우저에 보관합니다. 끄면 저장된 대화가 삭제됩니다. |
| AI용 프로젝트 참조 파일 | 하나의 목록: 각 파일과 크기, AI에서 사용 및 ×, + 파일, 사용 중인 파일과 문자 수. |
| 링크 | 사용되는 AI 키, AI 사용량 및 제한, 계정 → AI 키의 조직 키 |
저장은 설정을 보관합니다(“AI 설정이 저장되었습니다”).
AI 참조 파일
참조 파일은 표준이나 작업 기술서 같은 배경 자료를 AI 프롬프트에 추가합니다. 설정 방법은 참조 파일 첨부를 참조하십시오.
- 파일 형식: .txt .md .csv .json .xml .html .docx .reqif. 파일당 최대 200,000자가 보관됩니다.
- AI에서 사용이 켜진 파일은 AI에게 묻기와 생성, 확장, 테스트 케이스, 위험, 요약, 내용 삽입 및 서식 있는 텍스트 도구에 추가됩니다. 모두 합쳐 최대 100,000자를 보내며, 사용 중인 파일이 더 길면 목록 아래 줄에 그렇게 표시됩니다.
- 참조 파일은 프로젝트별로 이 브라우저에 보관됩니다. 다른 구성원과 공유되지 않습니다.
- “참조 파일이 브라우저 저장소에 맞지 않습니다. 파일을 제거하거나 더 작은 파일을 첨부하십시오.”는 브라우저가 파일 저장을 거부했다는 뜻입니다. 파일을 제거하십시오.
사용량과 한도
| 한도 | 값 | 메시지 |
|---|---|---|
| 1인당 분당 요청 수 | 30 | “AI 요청이 너무 많습니다. 1분 후에 다시 시도하십시오.” |
| 1인당 동시에 실행되는 요청 | 3 | “AI 요청 3건이 이미 실행 중입니다. 5초 후에 다시 시도하십시오.” |
| 서버에서 실행 중인 요청 | 공유 용량 | “AI 서비스가 사용 중입니다. 10초 후에 다시 시도하십시오.” |
| 월 포함 AI | 요금제의 요청 수(요금제 및 한도 참조) | “이번 달에 포함된 AI 요청 75개를 모두 사용했습니다. 11월 1일에 초기화됩니다. 더 사용하려면 계정 설정 → AI 키에서 자체 Anthropic 키를 추가하십시오.”(숫자는 요금제에 따라 다름) |
| 키당 월간 토큰 | 키 소유자가 설정 | “이 키의 월간 AI 한도에 도달했습니다. 계정 → AI 키에서 키의 한도를 높이거나 다음 달까지 기다리십시오.” |
| 구성원별 월 한도 | 조직의 관리자가 설정(구성원 한도 참조) | “Acme의 월 AI 한도에 도달했습니다(요청 40건 / 요청 40건). Acme의 관리자가 조직 설정 → AI에서 한도를 늘릴 수 있습니다. 12월 1일에 초기화됩니다.” |
| 프롬프트 크기 | 600,000자 | — |
| 응답 크기 | 400,000자 | “AI 응답이 너무 깁니다(400,000자 초과).” |
월은 UTC 기준의 달력상 월입니다. 조직 관리자는 계정 페이지에서 구성원별 사용량을 봅니다. 여러 한도가 적용되면 먼저 도달한 한도가 요청을 중지합니다: 키의 월 한도, 구성원 한도, 그리고 포함된 AI의 경우 요금제의 허용량.
구성원 한도
관리자는 자신이 AI 비용을 내는 사람들에게 월 AI 한도를 설정합니다. 모든 사람에게 적용되는 기본값과, 더 많거나 적게 또는 전혀 필요하지 않은 사람을 위한 사용자 지정 한도가 있습니다.
위치: 조직 관리자: 조직 설정 → AI → 이번 달 구성원별 사용량, 또는 계정 페이지의 조직에 있는 조직 카드. 자체 호스팅 서버에서는 사이트 관리자가 관리자 → AI 비용 및 사용량 → 사용자별 월 AI 한도에서 조직 밖 사람들의 한도도 설정합니다.
한도가 적용되는 범위:
- 조직의 한도: 조직 키로 비용을 내는 AI(모든 공급자: Anthropic, Kimi, GLM, Bedrock), 그리고 호스팅 서비스에서는 조직의 Team 좌석을 보유한 구성원의 포함된 AI. 자체 호스팅 서버에서는 조직 작업에 사용되는 서버 자체의 AI 키도 포함됩니다(조직의 프로젝트, 또는 그 조직에만 속한 사람의 경우 어디서든).
- 자체 호스팅 서버 자체의 한도: 조직 밖에서 사용하는 서버의 AI.
- 개인 자신의 키에는 적용되지 않습니다. 그 비용은 본인이 냅니다.
포함된 AI에는 요금제의 월 허용량이 계속 적용됩니다. 한도로 허용량을 낮출 수는 있지만 높일 수는 없습니다.
기본값 설정:
- 단위를 선택합니다: 요청(포함된 AI가 세는 방식대로 사용자 작업당 하나), 토큰(입력과 출력) 또는 US$(비용 추정)(공급자의 정가 기준).
- 구성원별 기본 한도를 입력합니다. 한도를 두지 않으려면 비워 둡니다.
- 저장을 클릭합니다. 알림에 “한도를 저장했습니다.”가 표시됩니다.
단위를 변경하면 기본 한도와 모든 사용자 지정 한도가 지워집니다(“단위를 …(으)로 변경하면 기본 한도와 모든 사용자 지정 한도가 지워집니다. 제한 없음으로 설정된 구성원은 그대로 유지됩니다.”).
한 사람의 한도 설정: 그 사람의 행에서 편집…을 클릭하고 기본값 사용, 제한 없음 또는 숫자와 함께 사용자 지정 한도를 선택한 다음 저장을 클릭합니다. 사용자 지정 한도는 한도 열에 사용자 지정으로 표시되며, 기본값 사용으로 제거합니다. 한도가 0이면 조직이 비용을 내는 그 사람의 AI가 중지됩니다.
사람 찾기: 이름이나 이메일로 필터링하고, 모든 사람, 80% 이상인 사람, 한도 도달한 사람, 또는 사용자 지정 한도 있음인 사람을 표시합니다. 한도 열에는 “사용량 / 한도”가 막대와 함께 표시됩니다(80 %부터 주황색, 한도에서 빨간색).
구성원은 계정 설정 → AI 및 API(그리고 AI 설정)에서 자신의 사용량을 봅니다. 월 한도(Acme): “요청 12건 / 40건 · 12월 1일에 초기화”가 막대와 함께 표시되고, 다 쓰면 “한도에 도달했습니다. Acme의 관리자가 한도를 늘릴 수 있습니다.”가 표시됩니다.
알림: 한도의 80 %와 100 %에서 본인이 종 아이콘(내 계정 아래)으로 알림을 받으며, 이메일 알림을 끄기로 하지 않았으면 즉시 이메일로도 받습니다. 누군가 한도에 도달하면 조직의 관리자(자체 호스팅 서버 자체의 한도라면 사이트 관리자)가 그 사람을 명시한 알림을 하나 받습니다. 각 알림은 사람별로 한 달에 한 번입니다.
사이트 관리자에게는 한도가 적용되지 않습니다. 모든 변경은 변경 전후의 값과 함께 감사 로그에 기록됩니다(org.ai-limit, 자체 호스팅 서버 자체의 한도는 admin.ai-limit).
AI 사용 기록(시간, 기능, 모델, 토큰 및 예상 비용, 프롬프트나 응답은 절대 포함하지 않음)은 13개월 후에 삭제됩니다.
AI 권한
AI 권한은 요청 종류마다 스위치 하나로 AI가 할 수 있는 일을 정합니다.
| 스위치 | 허용하는 내용 | 프로젝트 데이터 전송 |
|---|---|---|
| 도움말 및 사용 방법 | AI에게 묻기가 도움말, Docs 및 기능 목록을 바탕으로 Holarch 사용에 대한 질문에 답합니다. | 아니요 |
| 프로젝트에 대한 질문 | 요약, 설명, 품질 및 누락 검사, 프로젝트에 대한 AI에게 묻기. 아무것도 변경하지 않습니다. | 예 |
| 제안 및 변경 | 편집을 제안하는 모든 도구: 다시 쓰기, 생성, 번역, 연결·기능·흐름 제안, 위험, 테스트 케이스. 각 변경은 여전히 미리 보기로 표시됩니다. 프로젝트에 대한 질문이 필요합니다. | 예 |
| AI의 참조 파일 | 프로젝트의 AI 참조 파일이 이를 사용하는 프롬프트에 추가됩니다. | 파일 |
사전 설정: 끔(AI 없음), 도움말만, 읽기 전용(도움말 및 프로젝트에 대한 질문), 전체(네 가지 모두), 그 밖의 조합은 사용자 지정.
읽기 전용도 프로젝트 내용을 AI 공급자에게 보냅니다. AI가 변경을 제안하지 못하게 할 뿐입니다. 도움말만은 프로젝트 데이터를 보내지 않습니다.
설정하는 사람:
- 조직 설정 → AI(조직 관리자): 조직의 모든 프로젝트. 관리를 참조하십시오.
- 관리자 → AI 설정 → AI 권한(자체 호스팅 설치의 관리자): 설치의 모든 사용자.
- 계정 → AI 및 API → AI 권한(계정 소유자): 자신의 AI 요청과 어느 조직에도 속하지 않은 자신의 프로젝트.
- 공유 → AI 권한(프로젝트 소유자): 하나의 프로젝트. 소유자는 더 끄는 것만 할 수 있습니다.
요청은 해당하는 모든 수준에서 스위치가 켜져 있어야 하므로, 어떤 수준도 다른 수준이 끈 것을 다시 켤 수 없습니다. 편집기는 그런 스위치를 꺼지고 비활성화된 상태로, 끈 사람과 함께 표시합니다.
스위치가 꺼져 있으면:
- ✦ AI ▾, 마우스 오른쪽 버튼 메뉴 및 일괄 작업 표시줄의 해당 도구가 이유와 함께 회색으로 표시됩니다. 예: “이 조직의 관리자가 AI에 의한 변경을 껐습니다.”
- 무언가를 변경하라는 요청을 받으면 AI에게 묻기가 “여기서는 AI에 의한 변경이 꺼져 있습니다.”라고 답합니다.
- 도움말 및 사용 방법만 켜져 있으면 AI에게 묻기는 Holarch 사용에 대한 질문에 답하고 프로젝트는 전혀 보내지 않습니다.
- 어떤 키를 사용하든 서버도 그런 요청을 거부합니다.
스위치 설정과 관계없이 제한된 표시가 있는 프로젝트에서는 여전히 AI가 꺼집니다. Claude처럼 MCP로 연결된 AI 도구도 같은 스위치를 따릅니다. 읽기 도구에는 프로젝트에 대한 질문이, 쓰기 및 제안 도구에는 제안 및 변경이 필요합니다. 거부된 도구 호출은 같은 메시지를 반환합니다. 예: “이 조직의 관리자가 AI에 의한 변경을 껐습니다.” 일반 API 호출(스크립트 및 통합)은 AI 요청이 아니므로 AI 권한의 제한을 받지 않으며, 조직의 API 접근 스위치가 이를 관리합니다. AI 권한의 모든 변경은 감사 로그에 기록됩니다.
조직에 끔을 설정하면 아무도 조직의 키를 사용하지 않으며, 조직 프로젝트의 ✦ AI 컨트롤이 “이 조직의 관리자가 AI를 껐습니다.”와 함께 꺼집니다. 소유자 중 한 명이 공유 → 조직에서 조직을 선택하면 프로젝트가 그 조직에 속합니다.
Amazon Bedrock을 통한 Claude
Amazon Bedrock은 AWS GovCloud(US)를 포함하여 사용자 자신의 AWS 계정에서 Claude를 실행합니다. 자체 호스팅 설치는 관리자가 켜면 이를 제공합니다. 호스팅 서비스는 이를 제공하지 않습니다.
Bedrock 키 추가: 계정 → AI 키 → 키 추가, 공급자 Amazon Bedrock: AWS 리전, 액세스 키 ID, 비밀 액세스 키 및 선택 사항인 모델 ID. Holarch는 키를 저장하기 전에 테스트합니다. 키 목록에는 리전과 액세스 키 ID의 마지막 4자가 표시됩니다. 관리자는 설치 전체에 자체 Bedrock 접근 권한을 줄 수도 있으며, 그러면 사용 중인 키에 이 설치: Amazon Bedrock (us-gov-west-1)이 표시됩니다. 자체 키와 조직 키가 여전히 먼저 사용됩니다.
AWS GovCloud에서는 모델 ID가 상용 리전과 다릅니다. AWS 계정에 Claude용으로 나열된 모델 또는 추론 프로필 ID를 입력하십시오.
PDF 사양 가져오기를 포함한 모든 AI 기능이 Bedrock을 통해 작동합니다. 한 가지는 사용할 수 없습니다. Claude가 요청을 거절하면 Holarch가 다른 Claude 모델로 다시 보낼 수 없으며, 도구에 “Claude declined”가 표시됩니다.
| 메시지 | 의미 및 해결 방법 |
|---|---|
| “Amazon Bedrock: 액세스가 거부되었습니다(…)” | AWS 자격 증명으로 모델을 호출할 수 없습니다. IAM 권한과 해당 리전의 계정에서 모델이 활성화되어 있는지 확인하십시오. |
| “Amazon Bedrock: …은(는) 이 AWS 계정의 이 리전에서 사용할 수 없습니다.” | 해당 리전에서 계정에 나열된 모델 또는 추론 프로필 ID를 입력하십시오. |
| “Amazon Bedrock: AWS 자격 증명을 찾을 수 없습니다. …” | 액세스 키나 AWS 프로필을 설정하십시오. |
| “AWS 리전을 입력하십시오(예: us-east-1 또는 us-gov-west-1).” | 리전을 수정하십시오. |
내 키로 사용하는 Kimi K3
Holarch의 AI와 포함된 AI는 Claude이지만, 호스팅 서비스에서 중국 본토, 홍콩, 마카오, 대만에서 오는 요청에는 GLM 5.3을 사용합니다(중국 본토의 AI). Kimi K3(Moonshot AI)는 내 Moonshot 키나 조직의 Moonshot 키로 사용하는 검증된 옵션으로, 예를 들어 Claude를 사용할 수 없는 곳에서 쓸 수 있습니다. 다른 모든 내 키와 같은 요금제 규칙이 적용됩니다. Kimi 키를 사용하는 동안 요청은 그 키로 Moonshot에 전송되며 Claude로는 절대 전송되지 않습니다. AI에게 묻기 패널에는 Kimi K3 (내 키) 또는 Kimi K3 (조직 키)가 표시됩니다. Kimi 키로 보낸 요청은 Moonshot AI로 전송됩니다. 프롬프트와 그에 포함된 프로젝트 내용이 Moonshot AI로 전송되며, 사용자 또는 조직과 Moonshot AI 간의 자체 계약이 적용됩니다. 키 양식에 이 안내가 표시되며, Kimi 키에서 이 키 사용을 누르면 한 번 확인을 요청합니다. 자체 호스팅 설치에서는 관리자가 켠 경우에만 Kimi를 사용할 수 있습니다.
Kimi 키 추가: 계정 → AI 키 → 키 추가(또는 AI 설정…), 공급자 Kimi API: API 키와 영역:
- platform.moonshot.ai에서 만든 키에는 국제 (api.moonshot.ai),
- platform.moonshot.cn에서 만든 키에는 중국 본토 (api.moonshot.cn).
키는 만들어진 영역에서만 작동합니다. Holarch는 저장하기 전에 키를 테스트하며, 키 목록에는 영역과 마지막 4자가 표시됩니다. 조직의 키는 조직 설정 → AI에서 같은 방식으로 작동합니다. 자체 호스팅 설치에서는 관리자가 설치 전체에 자체 Kimi 키를 지정할 수도 있으며, 그러면 사용 중인 키에 이 설치 · Kimi API (api.moonshot.cn)가 표시됩니다. 내 키와 조직의 키가 여전히 우선합니다. Claude로 돌아가려면 Anthropic 키 옆의 이 키 사용을 클릭하거나 Kimi 키를 제거합니다.
AI 권한, 제한 표시, 미리 보기, 한 번의 실행 취소는 Kimi에서도 똑같이 작동하며, 사용량은 이번 달 사용량에 포함됩니다.
모델은 Kimi K3입니다. Kimi는 답하기 전에 추론합니다. Holarch는 Kimi가 새 내용(새 요구사항, 테스트 케이스, 위험, 기능, 흐름)을 작성할 때는 더 많은 추론을, AI에게 묻기, AI 요구사항 검사, 추적성 검토, 다시 쓰기, 번역, 요약에는 더 적은 추론을 요청합니다. 답변은 Claude보다 오래 걸리며, 보통 10~60초입니다.
새 요구사항, 다시 쓰기, 테스트 케이스, 위험은 프로젝트 요구사항의 언어로, 그 언어에서 의무를 나타내는 조동사(예: 중국어의 应)를 사용해 작성됩니다.
PDF 사양서 가져오기에는 Claude(Anthropic API 또는 Amazon Bedrock)가 필요합니다.
| 메시지 | 의미 및 해결 방법 |
|---|---|
| “Kimi API: API 키가 거부되었습니다(HTTP 401).” | 키가 다른 영역의 키이거나 취소되었습니다. 영역을 확인하거나 그 영역의 플랫폼에서 키를 만듭니다. |
| “Kimi 영역을 선택하십시오: 국제 또는 중국 본토.” | 영역을 선택합니다. |
| “AI가 응답하는 데 너무 오래 걸렸습니다.” | 요구사항을 더 적게 선택하고 검사를 다시 실행합니다. |
내 키로 사용하는 GLM 5.3
GLM 5.3(Z.ai)은 Kimi K3에 이어 내 키나 조직의 키로 사용하는 두 번째 검증된 옵션입니다. 포함된 AI는 계속 Claude이며(중국 본토, 홍콩, 마카오, 대만에서 오는 요청에는 포함된 AI도 GLM 5.3입니다: 중국 본토의 AI), 다른 모든 내 키와 같은 요금제 규칙이 적용됩니다. GLM 키를 사용하는 동안 요청은 그 키로 Z.ai에 전송되며 Claude로는 절대 전송되지 않습니다. AI에게 묻기 패널에는 GLM 5.3 (내 키) 또는 GLM 5.3 (조직 키)가 표시됩니다. 요청은 사용자와 Z.ai 간의 계약에 따라 Z.ai(싱가포르)로 전송됩니다: 프롬프트와 그에 포함된 프로젝트 내용이 Z.ai로 전송되어 싱가포르에서 처리됩니다. 키 양식에 이 안내가 표시되며, GLM 키에서 이 키 사용을 누르면 한 번 확인을 요청합니다. 자체 호스팅 설치에서는 관리자가 켠 경우에만 GLM을 사용할 수 있습니다.
GLM 키 추가: 계정 → AI 키 → 키 추가(또는 AI 설정…)에서 공급자 GLM API를 선택하고 Z.ai 국제 플랫폼(z.ai)의 API 키를 붙여 넣습니다. 요청은 api.z.ai로 전송됩니다. 중국 본토 서비스(open.bigmodel.cn)의 키는 별개의 서비스이므로 작동하지 않습니다. Holarch는 저장하기 전에 키를 테스트하며, 키 목록에는 마지막 4자가 표시됩니다. 조직의 키는 조직 설정 → AI에서 같은 방식으로 작동합니다. 자체 호스팅 설치에서는 관리자가 설치 전체에 자체 GLM 키를 지정할 수도 있으며, 그러면 사용 중인 키에 이 설치 · GLM API (api.z.ai)가 표시됩니다. Claude로 돌아가려면 Anthropic 키 옆의 이 키 사용을 클릭하거나 GLM 키를 제거합니다.
AI 권한, 제한 표시, 미리 보기, 한 번의 실행 취소는 GLM에서도 똑같이 작동하며, 사용량은 이번 달 사용량에 포함됩니다.
모델은 GLM 5.3입니다. 항상 답하기 전에 추론합니다. Holarch는 새 내용(새 요구사항, 테스트 케이스, 위험, 기능, 흐름)을 작성할 때는 더 많은 추론을, AI에게 묻기, AI 요구사항 검사, 추적성 검토, 다시 쓰기, 번역, 요약에는 더 적은 추론을 요청합니다. 답변 시간은 Claude와 비슷합니다. Claude는 요구사항을 하위 요구사항으로 더 깊이 분해합니다. 새 내용은 프로젝트 요구사항의 언어로 작성되며, TBD와 TBR은 모든 언어에서 쓰인 그대로 유지됩니다.
PDF 사양서 가져오기에는 Claude(Anthropic API 또는 Amazon Bedrock)가 필요합니다.
| 메시지 | 의미 및 해결 방법 |
|---|---|
| “GLM API: API 키가 거부되었습니다(HTTP 401).” | 키가 취소되었거나 open.bigmodel.cn의 키입니다. z.ai에서 키를 만듭니다. |
조직에서의 Kimi K3와 GLM 5.3
Holarch의 AI는 Claude이지만, 호스팅 서비스에서 중국 본토, 홍콩, 마카오, 대만에서 오는 요청에는 GLM 5.3을 사용합니다. Kimi K3와 GLM 5.3은 켤 수 있는 옵션입니다. 조직에서는 조직 관리자가 조직 설정 → AI → 선택적 AI 공급자에서 각각을 켜기 전까지 둘 다 꺼져 있습니다(조직에서 Kimi K3 또는 GLM 5.3 허용 참조). 조직이 없으면 데이터 안내를 확인한 후 직접 결정합니다.
- 조직을 위한 작업(조직의 프로젝트와 키): 누구의 키를 사용하든 그 조직의 설정이 결정합니다.
- 내 작업(개인 프로젝트, 내 키): 소속된 모든 조직이 그 공급자를 켜 두었어야 합니다.
- 키 추가에는 꺼진 공급자도 (조직에서 끔) 표시와 함께 계속 나열됩니다. 그 공급자를 선택하면 “조직에서 공급자을(를) 꺼 두었으므로 이 공급자의 키를 추가할 수 없습니다. 조직의 관리자가 조직 설정 → AI에서 켤 수 있습니다.”가 표시되며, 테스트 후 저장은 비활성 상태로 유지됩니다.
- 이전에 추가한 키는 그 공급자가 꺼져 있는 동안에도 “사용 안 함: 조직에서 이 공급자를 꺼 두었습니다. …”로 표시되어 보관되며, 테스트나 이 키 사용은 없습니다. 공급자가 켜지면 즉시 다시 작동합니다.
Holarch가 조직의 AI를 설정하는 경우(다음 섹션 참조)에는 그 설정이 대신 결정합니다.
조직의 AI를 Kimi K3가 제공하는 경우
일부 조직에서는 Holarch가 직접 AI를 설정합니다. 예를 들어 회사에서 Claude를 사용할 수 없는 경우입니다. 그러면 AI 설정과 계정 페이지의 사용 중인 키, 그리고 AI에게 묻기 패널에 조직의 AI는 Kimi K3가 제공합니다.가 표시됩니다. 조직 관리자는 조직 설정 → AI에서 그 설정과 이유를 볼 수 있습니다.
그런 조직에 속해 있는 동안에는 개인 프로젝트와 다른 조직의 프로젝트에서도 모든 AI 요청이 Kimi K3를 사용합니다:
- Holarch를 통한 Kimi K3: Holarch 자체의 Kimi 키가 응답합니다. 요청은 포함된 AI와 마찬가지로 요금제의 포함된 AI 요청과 AI 요청 팩에서 차감되며, Holarch의 AI 기능만 실행합니다.
- 조직 자체의 Kimi 또는 GLM 키: 조직 관리자가 조직 설정 → AI에서 Kimi(Moonshot AI) 또는 GLM(Z.ai) 키를 추가합니다(내 키로 사용하는 Kimi K3 및 내 키로 사용하는 GLM 5.3 참조). 이 옵션만 있으면 사용 중인 키에 조직의 AI는 조직 자체의 Kimi(Moonshot AI) 또는 GLM(Z.ai) 키를 사용합니다.가 표시됩니다. 키가 추가될 때까지 AI 기능은 조직 관리자에게 문의하라고 안내합니다.
- 끄기: AI 기능에 “Holarch가 조직의 AI를 껐습니다.”가 표시됩니다. 그 밖의 모든 기능은 작동합니다.
Claude는 사용되지 않습니다. 개인 및 조직의 Anthropic 및 Bedrock 키는 사용되지 않고 추가할 수도 없으며, 키 추가는 설정이 허용하는 경우에만 Kimi(Moonshot AI)와 GLM(Z.ai) 키를 제공하고, PDF 사양서 가져오기(Claude 필요)는 사용할 수 없으며, MCP로 연결된 AI 앱은 거부됩니다. AI 권한, 제한 표시, 미리 보기, 한 번의 실행 취소는 평소와 같이 작동합니다.
이 설정은 Holarch만 변경할 수 있으며, 조직 관리자는 AI 권한에서 더 많은 기능을 끌 수 있습니다. 이 설정이 있는 조직은 관리자가 삭제할 수 없습니다. 문의하려면 [email protected]로 연락하십시오.
설치에서 AI가 꺼진 경우
자체 호스팅 설치의 관리자는 예를 들어 폐쇄망에서 관리자 → AI 설정의 AI 권한을 끄기로 설정하거나 서버 설정에 HOLARCH_AI=off를 지정하여 모든 사용자의 AI를 끌 수 있습니다. HOLARCH_AI는 help, read 또는 help,read,refs 같은 목록도 받습니다. 꺼져 있는 동안:
- ✦ AI가 “이 설치에서는 AI가 꺼져 있습니다.”와 함께 꺼집니다.
- AI 도구, AI 설정… 및 AI에게 묻기는 같은 내용을 알리는 AI가 꺼져 있음을 엽니다.
- 계정 → AI 키에 같은 안내가 표시되고 키 추가가 없습니다.
- AI 공급자에게 아무것도 보내지 않으며 서버가 AI 요청을 거부합니다.
Holarch의 나머지 기능은 평소처럼 작동합니다.
개인정보: 전송되는 내용
- 요청할 때만. AI 기능을 시작하지 않으면 AI 공급자에게 아무것도 보내지 않습니다.
- 기능에 필요한 것만.
- 요구사항 도구는 요구사항, 그 상위 항목, 검증 항목 및 프로젝트 이름을 보냅니다.
- AI에게 묻기는 질문, Holarch 기능에 대한 설명, 최대 3개의 도움말 항목, 프로젝트의 엔터티와 관계(큰 프로젝트에서는 요약과 질문에 필요한 항목, 사용 방법 질문은 프로젝트 데이터를 보내지 않음), 현재 페이지와 최근 대화를 보냅니다.
- 사용 중인 AI 참조 파일은 AI 참조 파일에 나열된 곳에 추가됩니다.
- 숨겨진 텍스트는 제외됩니다. 크기가 0이거나 보이지 않거나 흰 바탕에 흰 글자인 텍스트는 보내지 않습니다.
- 전송되는 곳. 요청은 Holarch 서버에서 Anthropic으로 갑니다. Kimi 키를 쓰면 Moonshot AI로, GLM 키를 쓰거나 중국 본토, 홍콩, 마카오, 대만에서 포함된 AI를 쓰면 Z.ai(싱가포르)로 갑니다. 해당 공급자의 약관이 적용됩니다. 공급자가 API 데이터를 보관하거나 학습에 사용하는지 여부를 포함하여 약관을 확인하십시오. Holarch는 사용자의 콘텐츠를 AI 모델 학습에 사용하지 않습니다.
- Holarch가 보관하는 것. 프롬프트 텍스트와 응답은 보관하지 않습니다. 사용량과 한도를 위해 요청마다 시간, 키, 작업, 토큰 수, 예상 비용 및 결과를 기록합니다. AI에게 묻기 대화는 세션 간에 AI에게 묻기 기록 유지가 켜져 있을 때만 브라우저에 남습니다.
- 키. 키는 서버에서 암호화되며, 브라우저로 다시 보내지 않고 저장 후에는 다시 표시되지 않습니다.
단축키
| 키 | Action |
|---|---|
| ⌘K / Ctrl+K → AI에게 묻기… | AI에게 묻기 열기 |
| ⌘K / Ctrl+K → 도구 이름 | 현재 페이지의 AI 도구 실행 |
| Enter | AI에게 묻기에서 질문 보내기 |
| Shift+Enter | AI에게 묻기에서 줄 바꾸기 |
| ⌘Z / Ctrl+Z | 마지막으로 적용한 AI 변경 실행 취소 |
메시지
| 메시지 | 의미 및 해결 방법 |
|---|---|
| “AI 키가 설정되지 않았습니다. 계정 → AI 키에서 Anthropic 키를 추가하십시오.” 및 AI 키 없음 대화 상자 | 사용할 수 있는 키가 없습니다. AI 키 열기를 클릭하고 키를 추가하거나 조직 관리자에게 조직 키를 요청하십시오. |
| “API 키를 붙여 넣으십시오.” / “API 키 전체를 붙여 넣으십시오.” | 키 필드가 비어 있거나 잘렸습니다. |
| “1,000토큰 이상의 월 한도를 입력하거나, 한도를 두지 않으려면 비워 두십시오.” | 한도를 수정하십시오. |
| “…의 월 AI 한도에 도달했습니다(… / …). …의 관리자가 조직 설정 → AI에서 한도를 늘릴 수 있습니다. …에 초기화됩니다.” | 조직이 정한 본인의 월 한도를 모두 사용했습니다. 조직 관리자에게 한도를 늘려 달라고 요청하거나, 자신의 키를 사용하거나, 월이 끝날 때까지 기다리십시오. 구성원 한도를 참조하십시오. |
| “이 서버의 월 AI 한도에 도달했습니다(… / …). 사이트 관리자가 관리 → AI 비용 및 사용량에서 한도를 늘릴 수 있습니다. …에 초기화됩니다.” | 자체 호스팅 서버가 정한 본인의 한도를 모두 사용했습니다. 사이트 관리자에게 문의하십시오. |
| “한도를 0 이상의 숫자로 입력하십시오.” / “요청 또는 토큰 수를 정수로 입력하십시오.” / “달러 한도는 소수점 이하 두 자리까지 입력하십시오.” | 구성원 한도를 수정하십시오. |
| “… 키가 저장되지 않았습니다. 키를 확인한 다음 다시 시도하십시오.” | 테스트 요청이 실패했습니다. 이유가 먼저 표시됩니다. |
| “AI 키를 변경하려면 비밀번호를 입력하십시오.” | 키를 변경하려면 최근 10분 이내에 비밀번호 확인이 필요합니다. |
| “비밀번호가 틀렸습니다. 다시 시도하십시오.” | 비밀번호 확인의 비밀번호가 일치하지 않았습니다. |
| “이 조직의 관리자만 조직의 AI 키를 변경할 수 있습니다.” | 조직 관리자에게 요청하십시오. |
| “저장된 키를 이 서버에서 읽을 수 없습니다. 키를 제거하고 다시 추가하십시오.” | 키를 제거하고 다시 추가하십시오. |
| “공급자가 API 키를 거부했습니다. 계정 → AI 키에서 새 키를 추가하십시오.” | 키가 잘못되었거나, 취소되었거나, 크레딧이 없습니다. |
| “AI 공급자에서 오류가 발생했습니다. 다시 시도하거나 계정 → AI 키에서 키를 테스트하십시오.” / “AI 공급자에 연결할 수 없습니다.” | 공급자 오류 또는 장애입니다. 나중에 다시 시도하십시오. |
| “AI가 응답하는 데 너무 오래 걸렸습니다.” | 요청 시간이 초과되었습니다. 다시 시도하거나 입력을 줄이십시오. |
| “AI 응답이 예상 형식과 일치하지 않습니다: …” / “AI 응답이 거부되었습니다…” | 응답이 검사를 통과하지 못했으며 아무것도 변경되지 않았습니다. 다시 시도하십시오. |
| “이 조직의 관리자가 AI를 껐습니다.” | 조직 관리자에게 요청하거나 조직 밖에서 프로젝트를 사용하십시오. |
| “이 설치에서는 AI가 꺼져 있습니다.” | 이 설치의 관리자가 AI를 껐습니다. 나머지 기능은 모두 작동합니다. |
| “Holarch가 조직의 AI를 껐습니다.” | Holarch가 조직의 AI를 끄기로 설정했습니다. 조직의 AI를 Kimi K3가 제공하는 경우를 참조하십시오. |
| “조직에서 Claude를 사용할 수 없으므로 Anthropic 및 Claude 키를 사용할 수 없습니다. 대신 Kimi(Moonshot AI) 또는 GLM(Z.ai) 키를 추가하십시오.” | 조직에서는 Claude를 사용하지 않습니다. 설정이 허용하는 경우 Kimi 또는 GLM 키를 추가합니다. |
| “조직의 AI는 조직 자체의 Kimi(Moonshot AI) 또는 GLM(Z.ai) 키를 사용합니다. 조직 관리자에게 키를 추가해 달라고 요청하십시오.” | 아직 조직의 Kimi 또는 GLM 키가 없습니다. 조직 관리자에게 문의합니다. |
| “조직에서 Kimi (Moonshot AI)를 꺼 두었습니다 …. …의 관리자가 조직 설정 → AI에서 켤 수 있습니다.”(또는 GLM (Z.ai)) | 조직에서 이 공급자를 허용하지 않았습니다. 조직 관리자에게 문의하거나 Claude 키를 사용합니다. 조직에서의 Kimi K3와 GLM 5.3을 참조하십시오. |
| “조직에서는 MCP로 연결된 AI 앱을 사용할 수 없습니다. 대신 Holarch의 AI를 사용하십시오.” | Holarch가 조직의 AI를 설정한 동안에는 MCP 도구가 거부됩니다. |
| “이 조직의 관리자가 AI에 의한 변경을 껐습니다.”(또는 “프로젝트에 대한 질문이 …”, “AI 도움말이 …”, “AI의 참조 파일이 …”, “… 이 프로젝트의 소유자가 …”, “… 계정 설정에서 …”) | 그 종류의 AI 요청이 AI 권한에서 꺼져 있습니다. 메시지에 언급된 사람에게 요청하거나 켜져 있는 종류의 도구를 사용하십시오. |
| “여기서는 AI에 의한 변경이 꺼져 있습니다.” | 제안 및 변경이 꺼져 있는 동안 AI에게 묻기에 무언가를 변경하라는 요청이 있었습니다. 질문이 허용되면 여전히 질문에 답합니다. |
| 이 프로젝트에서는 AI가 꺼져 있음 | 프로젝트에 서비스가 제한 대상으로 취급하는 표시가 있습니다. 분류 필드나 표제란의 분류 또는 CUI 표시, 문서 이름이나 텍스트의 SECRET//NOFORN 같은 배너, 문서·프로젝트·조직 표시의 수출 통제 고지(ITAR/EAR)가 이에 해당합니다. Company Proprietary, Company Confidential 및 배포 문구는 AI를 끄지 않습니다. 표시를 제거하거나 지원팀에 문의하십시오. 아무것도 보내지 않았습니다. AI 공급자가 그런 데이터에 대해 승인된 자체 호스팅 설치에서는 사이트 관리자가 이런 프로젝트에 AI를 허용할 수 있습니다(관리 → AI → 제한된 표시). 호스팅 서비스는 항상 AI를 끈 상태로 유지합니다. |
| “보기 전용: AI 도구에는 편집 권한이 필요합니다” | 소유자에게 편집자 역할을 요청하십시오. |
| “세션이 종료되었습니다. 다시 로그인하십시오.” | 다시 로그인한 다음 요청을 반복하십시오. |
| “서버에 연결할 수 없습니다. 연결을 확인한 다음 다시 시도하십시오.” | 네트워크 문제입니다. |
| “검토할 요구사항이 없습니다. 먼저 요구사항을 선택하거나 여십시오.” / “Requirement를 선택하십시오.” | 도구가 작업할 항목을 선택하십시오. |
| “<provider>이(가) 요구사항을 반환하지 않았습니다.” / “… 위험을 제안하지 않았습니다.” | 맥락을 추가하고 다시 시도하십시오. |
| “번역이 취소되었습니다. 아무것도 변경되지 않았습니다.” | 번역을 취소했습니다. |
제한 사항
- 계정 및 조직마다 공급자당 키 하나.
- 월간 키 한도: 1,000~10,000,000,000토큰.
- 구성원 한도: 조직 단위로 0~100,000,000,000(달러 한도는 센트 단위). 조직당 단위는 하나입니다.
- 1인당 분당 요청 30건, 동시에 3건.
- 프롬프트 최대 600,000자, 응답 최대 400,000자.
- 참조 파일: 각각 최대 200,000자, 이 브라우저에 저장.
- 요구사항 생성: 상위 항목 1~20개, 상위 항목당 하위 항목 0~10개. 하위 요구사항 생성: 1~20개. 위험 생성: 실행당 최대 3개(Risk 다이어그램: 1~10개). 클립아트: 변형 1~8개.
- 뷰어는 AI를 사용할 수 없습니다.