AI 글 작성 도우미

2.17.0 버전부터 지원합니다.

참고: 2.18.0, 3.0.0 이상 버전에서는 새로운 설정 방식을 사용합니다. 설정 방법은 다음 문서를 참고합니다: 2.18.0 / 3.0.0+ 설정.

생성형 AI로 글 작성을 돕는 플러그인입니다. 에디터에서 업무 문서 초안을 만들거나 텍스트를 효율적으로 편집할 수 있습니다.

하위 페이지

• 미리 정의된 프롬프트 메뉴
• 2.18.0 / 3.0.0+ 설정
• 이미지 생성 AI
• Node Express 서버 예제
• Java Spring 서버 예제
• 플러그인 API

지원되는 브라우저

• Microsoft Edge (최신)
• Google Chrome (최신)
• Apple Safari (최신)
• 다른 브라우저에서도 동작할 수 있으나 모든 기능이 보장되지는 않습니다.
• Internet Explorer는 지원되지 않습니다.

설정

플러그인을 적용하기 전에 SynapEditor 객체가 존재해야 하므로, 플러그인 파일을 에디터 스크립트 파일 아래에 포함해야 합니다.

<script src="url of aiWriteSupporter.min.js"></script>
<link rel="stylesheet" href="url of aiWriteSupporter.min.css">

UI

AI에게 내용을 작성하도록 요청하는 버튼을 툴바, 풍선팝업, 바로 삽입, 메뉴 영역에 추가할 수 있습니다. 버튼 이름은 openAIInteraction입니다.

툴바

// synapeditor.config.js
'editor.toolbar': [ /* ... */ 'openAIInteraction' ]

바로 삽입

// synapeditor.config.js
'editor.quickInsert': [ /* ... */ 'openAIInteraction' ]

구성 키

URL & API Key

요청을 보낼 API의 URL과 API 키를 설정합니다.

URL에는 OpenAI API 주소(https://api.openai.com/v1/chat/completions) 또는 OpenAI API로 요청을 전달하는 URL을 설정합니다. URL은 필수입니다. 설정하지 않으면 플러그인의 "AI 요청" 버튼이 툴바, 메뉴 등에 표시되지 않습니다.

API 키에는 OpenAI에서 발급받은 키를 설정합니다. 클라이언트에서 API 키를 설정하는 것은 안전하지 않습니다. 키가 브라우저의 개발자 도구 > Network 탭에 노출되기 때문입니다. 키를 숨기려면 이 설정을 사용하지 말고, 대신 서버에서 요청을 보내세요.

// URL + API key (key visible in browser — unsafe)
'aiWriteSupporter.config': {
  url: 'https://api.openai.com/v1/chat/completions',
  apiKey: 'sk-abc123...456xyz'
}

// URL only (recommended — proxy through your server)
'aiWriteSupporter.config': {
  url: '/request'
}

2.17.2311 버전부터 지원합니다.

사용하는 생성형 AI에 따라 다음을 구성합니다.

OpenAI GPT

// URL + API key (key visible in browser, unsafe)
'aiWriteSupporter.config': {
  ai: 'gpt',
  url: 'https://api.openai.com/v1/chat/completions',
  apiKey: 'sk-abc123...456xyz'
}

// URL only
'aiWriteSupporter.config': {
  ai: 'gpt',
  url: '/request'
}

NAVER HyperCLOVA X

참고: NAVER HyperCLOVA X ('hcx') 연동이 중단되었습니다(서비스 종료). 'gpt' 또는 'gemini'로 전환해야 합니다.

이전 설정, 참고용:

// url: a URL you implemented to forward requests to HyperCLOVA X
'aiWriteSupporter.config': {
  ai: 'hcx',
  url: '/request'
}

HyperCLOVA X 옵션(2.17.2311 버전부터 지원):

요청 본문

GPT 옵션에 대해서는 https://platform.openai.com/docs/api-reference/completions/create를 참고합니다.

'aiWriteSupporter.config': {
  url: 'url',
  apiKey: 'apiKey',
  requestBody: {
    temperature: 2,
    presence_penalty: 2
    // ...
  }
}

이미지 첨부

기반 AI가 Gemini 또는 GPT-4 이상(3.0.2407 버전부터 지원)일 때 사용할 수 있습니다. Gemini는 최대 1개, GPT-4 이상은 최대 10개의 이미지를 지원합니다.

OCR URL — "이미지 첨부"

ocrUrl이 설정되면, 초안 작성 메뉴에 이미지 첨부 옵션이 표시됩니다. 플러그인은 이미지를 OCR 처리하여 추출된 텍스트를 프롬프트와 함께 전송합니다.

'aiWriteSupporter.config': {
  ocrUrl: 'https://ailab.synap.co.kr/sdk',   // promotional usage
  ocrApiKey: 'issued-api-key'
}

ocrUrl 미설정	ocrUrl 설정됨

사용자 정의 프롬프트

프롬프트 메뉴 항목 추가:

'aiWriteSupporter.config': {
  customPrompts: [
    {
      key: 'my-custom-menu1',
      type: 'prompt',         // 'prompt' | 'immediately' | 'group'
      label: { ko: '나의 커스텀 메뉴 1', en: 'My custom menu 1' },
      prompt: { ko: '바나나를 영어로', en: 'banana in english' }
    },
    {
      key: 'my-custom-menu2',
      type: 'immediately',
      label: { ko: '나의 커스텀 메뉴 2', en: 'My custom menu 2' },
      prompt: { ko: '포도를 영어로', en: 'grape in english' }
    },
    {
      key: 'my-custom-menu3',
      type: 'group',
      label: { ko: '내가 제일 자주쓰는 메뉴 모음', en: 'My most used menu' },
      items: ['englishTranslation', 'tabularFormat']
    }
  ]
}

항목 키

각 항목은 key, type, label, prompt 키를 가진 객체입니다:

{
    key: 'customPromptKey',
    type: 'prompt', // or 'immediately'
    label: {
        ko: '메뉴에 보여지는 텍스트',
        en: 'Label shown in menu'
    },
    prompt: {
        ko: 'AI에게 전달될 프롬프트. 요약해줘, 내용을 늘려줘, ...',
        en: 'Prompts to be passed to the AI',
    }
}

하위 메뉴가 있는 메뉴는 type: 'group'와 items를 사용합니다:

{
    key: 'customPromptKey',
    type: 'group',
    label: {
        ko: '하위 메뉴가 있는 메뉴',
        en: 'Menu with submenus'
    },
    items: ['summarize', 'explanation', ...]
}

카테고리 설정

카테고리: favorites, draft, edit, createByReference, write.

초안 카테고리 재정의

카테고리에 표시되는 메뉴를 재정의할 수 있습니다. 플러그인에 미리 정의된 프롬프트 메뉴의 키는 미리 정의된 프롬프트 메뉴에 나와 있습니다.

'aiWriteSupporter.config': {
  categoryConfig: {
    draft: ['meetingRequestEmail', 'salesEmail', 'jobAnnouncement']
  }
}

카테고리 숨기기

카테고리를 빈 배열로 설정하면 해당 카테고리가 숨겨집니다.

// Hide edit and createByReference categories
'aiWriteSupporter.config': {
  categoryConfig: {
    edit: [],
    createByReference: []
  }
}

사용자 정의 메뉴를 즐겨찾기에 추가하기

즐겨찾기 카테고리는 모든 상황에서 항상 표시됩니다. 가장 자주 사용하는 프롬프트 메뉴를 추가할 수 있습니다.

'aiWriteSupporter.config': {
  categoryConfig: {
    favorites: ['my-custom-menu1', 'my-custom-menu2', 'my-custom-menu3']
  },
  customPrompts: [ /* ... see Custom Prompts above ... */ ]
}