사용할 수 있는 위치
AI assistant는 템플릿 XML 문서 편집 화면에서 사용하는 것을 기준으로 합니다.
일반 Markdown 문서의 자유 편집을 자동으로 바꾸는 기능이 아니라, 템플릿 XML 수정안을 검토하는 보조 도구입니다.
사용 전 설정
- 설정 페이지를 엽니다.
- AI 제공자를 선택합니다.
- 선택한 제공자의 API key를 입력합니다.
- 기본 저장 방식인 이번 탭에서만 사용을 유지하거나, 개인 기기에서만 이 브라우저에 저장을 선택합니다.
- 유효성 확인 후 템플릿 편집기로 돌아갑니다.
제공자와 모델 선택
AI 제공자는 사용자가 직접 선택합니다. 제공자별 모델, 비용, 응답 품질, 사용 가능 지역, 조직 정책이 다를 수 있습니다.
권장 모델은 기본 작업에 적합한 시작점일 뿐이며, 긴 XML 문서나 복잡한 변경 요청에서는 더 큰 모델이 필요할 수 있습니다.
| 확인 항목 | 설명 | 실무 기준 |
|---|---|---|
| 모델 권한 | 계정에서 선택 모델을 사용할 수 있는지 | 유효성 확인 실패 시 먼저 점검 |
| 비용 | 요청 길이와 응답 길이에 따라 비용 발생 가능 | 긴 XML 요청 전 불필요한 내용 정리 |
| 응답 품질 | 모델별로 XML 보존 능력이 다름 | 적용 전 XML 검증 필수 |
| 조직 정책 | 회사 문서를 외부 AI에 보내도 되는지 | 민감 문서는 조직 정책 우선 |
AI 실행 시 전송되는 데이터
AI assistant를 실행하면 선택한 AI 제공자 API로 API key, 사용자의 요청 문장, 현재 템플릿 XML 원문이 전송됩니다.
이 요청은 현재 구조에서 Notive Office 서버를 거치지 않고 브라우저에서 선택한 AI 제공자 API로 직접 전송됩니다.
Notive Office는 API key나 문서 원문을 자체 서버에 저장하거나 수집하지 않습니다. 다만 선택한 AI 제공자의 처리 정책은 해당 제공자의 정책을 따릅니다.
AI 요청에 포함하지 말아야 할 정보
- 고객 개인정보, 주민등록번호, 전화번호, 이메일 대량 목록
- API key, access token, database password, private key
- 비공개 계약 조건, 인사 정보, 내부 재무 정보
- 조직 정책상 외부 AI 전송이 금지된 원문
- 공개 전 제품 전략이나 보안 취약점 세부 정보
수정 요청 작성법
| 좋은 요청 | 피해야 할 요청 |
|---|---|
| 3번 섹션의 성공 지표를 정량 지표 중심으로 바꿔줘 | 문서 좋게 바꿔줘 |
| 위험 요소를 3개로 줄이고 대응 방안을 한 문장씩 추가해줘 | 알아서 정리해줘 |
| 기존 XML 구조는 유지하고 문장만 더 간결하게 바꿔줘 | 전체를 마음대로 고쳐줘 |
AI 응답 검토 기준
- 수정 요청의 범위를 벗어난 섹션이 바뀌지 않았는지 확인합니다.
- 문서의 수치, 날짜, 담당자, 범위가 사실과 맞는지 확인합니다.
- AI가 임의로 추가한 기능, 정책, 약속이 없는지 확인합니다.
- replacementXml이 현재 템플릿 구조를 유지하는지 확인합니다.
- warnings 항목에 적용 전 검토해야 할 내용이 있는지 확인합니다.
수정안 검토 후 적용
- AI 응답의 요약과 변경 내용을 먼저 읽습니다.
- 주의사항과 누락 가능성을 확인합니다.
- XML 검증이 성공했는지 확인합니다.
- 미리보기에서 레이아웃과 문서 의미가 맞는지 확인합니다.
- 문제가 없을 때만 적용 버튼을 누릅니다.
AI 오류 유형별 대응
| 오류 | 가능한 원인 | 대응 |
|---|---|---|
| API key 오류 | key 값, 제공자, 권한 불일치 | 설정에서 key와 제공자를 다시 확인 |
| 모델 사용 불가 | 계정 권한 또는 모델명 문제 | 제공자 콘솔에서 모델 사용 가능 여부 확인 |
| 네트워크/CORS 오류 | 브라우저 직접 호출 제한 또는 네트워크 문제 | 다시 시도하거나 제공자 상태 확인 |
| XML 검증 실패 | AI가 구조를 깨뜨림 | 적용하지 않고 요청을 더 구체화 |
| 응답이 너무 짧음 | 요청이 모호하거나 모델 제한 | 수정 범위와 원하는 출력 형식을 명시 |
AI 응답에서 확인할 항목
{
"summary": "수정안 요약",
"changes": ["구체적인 변경 내용"],
"rationale": ["수정 이유"],
"replacementXml": "<document>...</document>",
"warnings": ["적용 전 확인 사항"]
}