스니펫 및 추가 소스 설정

Updated on 3월 21, 2024

스니펫 및 추가 소스 설정 기능은 현재 베타 단계로, 일부 고객들만 사용하실 수 있습니다. 또한, 연동 과정이 매끄럽지 않거나 불안정할 수 있으며, 연동된 콘텐츠 또한 정제되지 않은 형태일 수 있음을 알려드립니다.

스니펫

스니펫은 문서보다 짧은 단문 형태의 데이터로, ‘추가 소스 설정’에서 연동한 써드 파티 서비스들의 데이터들을 보관합니다. 위와 같이 지식베이스 > 스니펫 메뉴에서 데이터를 확인하실 수 있으며, 여기에 쌓인 스니펫들을 인풋 노드를 사용하여 이 LLM 앱의 인풋으로 활용할 수 있습니다. 연동 가능한 써드 파티 서비스들은 아래에서 확인하실 수 있습니다.

추가 소스 설정

지식베이스의 추가 소스 설정 탭에 대해 알아보겠습니다. 이 탭에서, Notion, Github, Slack, Google Calendar, Jira, Gmail의 콘텐츠들을 지식 베이스에 연동할 수 있으며, 이외에도 다양한 소스들이 연동 대기 중이니, 필요하신 서드파티 서비스가 있다면 연동을 요청해주세요.

1. Notion

Notion 계정을 연동해서 지식베이스의 문서 탭에 문서를 가져올 수 있습니다. 연동 버튼 클릭 후, 연동하시려는 계정에 로그인합니다. 이후, 연동하시려는 페이지를 선택해주세요. 잠시 기다려주시면, ‘최근 연동 상태’가 성공으로 표시되며, 연동이 완료됩니다. 선택하신 문서 양에 따라 지식 베이스로 불러오는 데에 많은 시간이 소요될 수 있음을 유의해주세요. 최초 연동 시점에 연동 범위로 선택된 모든 페이지를 불러온 이후, 1시간 마다 갱신된 콘텐츠를 새로 가져옵니다. 

2. Github

Github 계정 및 리포지토리를 연동하여 지식베이스의 문서 탭에 문서를 가져올 수 있습니다. 우선 연동 버튼을 누르고, 계정으로 로그인 및 권한을 허용합니다.

이후 리포지토리 목록에 원하는 리포지토리 이름을 추가하면, 그 이하의 문서들을 모두 가져오게 됩니다. 최초 연동 이후, 1시간 마다 추가/갱신된 콘텐츠를 새로 가져옵니다. 문서 양에 따라, 지식 베이스로 동기화하는 데에 많은 시간이 소요될 수 있음을 유의해주세요.

3. Google Calendar 

Google 계정을 연동하여 캘린더 이벤트를 지식베이스의 스니펫 탭에 가져올 수 있습니다. 연동 버튼을 누르고, 계정으로 로그인 및 권한을 허용합니다. 연동이 완료되면, 연동한 시점의 하루 전을 시작점으로 삼아 그 1년 후까지의 모든 캘린더 이벤트(구독 중인 모든 캘린더)를 불러오게 됩니다. 최초 연동 이후에는, 1시간 마다 추가/갱신된 이벤트를 새로 동기화합니다. 상세 항목들은 아래와 같습니다.  

  • summary: 이벤트 제목
  • description: 상세 설명
  • location: 장소
  • attendees: 참석자
  • start: 시작 시간
  • end: 끝나는 시간

4. Jira

JIRA 계정을 연동하여 티켓들을 지식베이스의 스니펫 탭에 가져올 수 있습니다.연동 버튼을 누르고, 계정으로 로그인 및 권한을 허용합니다. 연동이 완료되면 전체 티켓을 불러오게 되며, 최초 연동 이후 1시간 마다 추가된 티켓을 새로 가져옵니다. 상세 항목들은 아래와 같습니다. 

  • key: 티켓 번호 (ABC-123 등)
  • summary: 티켓 제목
  • description: 티켓 내용 본문

5. Gmail

Google 계정을 연동하여 Gmail 내용을 지식베이스의 스니펫 탭에 가져올 수 있습니다. 연동 버튼을 누르고, 계정으로 로그인 및 권한을 허용합니다. 연동이 완료되면, 최초 연동시점 하루 전의 메일부터 연동시점까지의 메일(보낸 메일, 받은 메일)을 불러옵니다. 최초 연동 이후에는 1시간 마다 추가된 메일을 새로 동기화합니다. 상세 항목들은 아래와 같습니다. 

  • sender: 송신인
  • recipients: 수신인
  • date: 이메일을 보낸/받은 날짜
  • subject: 제목
  • body: 내용

6. Slack

Slack 채널에 Alli를 연동해서 지식베이스의 스니펫 탭에 메시지를 가져올 수 있습니다. 연동 버튼을 누르고, 원하는 워크스페이스에 Alli Data Loader 앱의 권한을 허용합니다. 허용하시면, 자동으로 Alli (Alli Data Loader) 앱이 워크스페이스에 추가됩니다. 이 앱은 기존의 Slack용 Alli Answerbot 앱과는 별개로 기능하며, 오로지 데이터 스니펫 연동을 위해서만 사용됩니다.

이제, 연동할 채널을 입력해주세요. 이 때, 채널 명이 아닌 채널 ID를 추가, 저장해주세요. 채널 ID는 슬랙 채널 화면에서 “채널 세부 정보 받기”를 클릭하시면, 가장 아래에 위치하고 있습니다.

마지막으로, 해당 채널에 Alli 앱을 추가(초대)해주세요.

이제 모든 준비가 완료되었습니다. 연동된 채널의 메시지는 지식베이스의 스니펫 메뉴에 쌓이게 됩니다. 스니펫에 추출되는 상세 항목들은 아래와 같습니다. 

  • timestamp: 메시지가 작성된 시각 (UTC+0 기준)
  • username: 메시지를 발화한 사용자
  • message: 메시지 내용

최초 연동 시점에 해당 채널의 전체 메시지를 불러온 이후, 1시간 마다 추가된 메시지를 새로 가져오며, 삭제, 수정된 메시지는 동기화되지 않습니다. 메시지의 시간 순 정렬은 현재 제공하고 있지 않으며 향후 구현 예정이오니 참고 부탁드립니다.  

공통: 기타 알아두면 좋을 것들

  • 연동 실패 시에는 연동 해제 후 다시 연동해야합니다.
  • 연동 상태가 성공으로 표시되더라도, 콘텐츠가 모두 지식베이스로 불러와지는 데에는 제법 많은 시간이 소요될 수 있습니다.
  • 최초 연동 이후 추가 연동 주기는 1시간이며, 갱신될 내용이 없는 경우 최근 연동 시각이 갱신되지 않습니다.