1. 회원가입 또는 로그인
위의 링크를 클릭하여 스톰에 접근한 뒤에 로그인을 합니다.
만약 계정이 존재하지 않는다면 우측 하단의 회원가입 버튼을 클릭하여 회원가입을 진행해주세요.
메일 인증까지 완료하셔야 계정생성이 완료됩니다.
만약 아이디 또는 비밀번호를 잊어버리셨다면 지원팀에 문의해주세요
2. 에이전트 생성
•
에이전트 생성 버튼을 클릭하여 새로운 에이전트를 생성합니다.
•
에이전트가 수행해야할 태스크의 성격에 따라 템플릿을 활용하여 빠르게 시작하실 수도 있습니다.
•
•
에이전트가 사용할 언어를 선택합니다.
◦
선택한 언어에 따라 RAG 검색 모델, 문서 학습, LLM 프롬프트에 등에 적용됩니다.
3. 지식 등록하기
문서는 2가지 방식을 통해 등록할 수 있습니다. 
문서 파일 직접 업로드하기 구글 드라이브 링크를 통해 업로드하기
문서 파일 직접 업로드하기 구글 드라이브 링크를 통해 업로드하기 문서 파일 직접 업로드
•
PC의 문서를 선택하여 업로드해주세요.
•
파일로 업로드시 지원하는 확장자는 다음과 같습니다.
◦
PDF, DOCX, DOC, XLSX, XLS, PPTX, PPT, HWP, HWPX
◦
◦
한글 파일도 지원합니다
•
단, 이미지로만 구성된 문서의 경우 베타기능인 STORM Parse를 이용해서 업로드해주세요.
[베타기능] STORM Parse 활용해보기
STORM Parse는 VisionLLM 기술을 활용하여 복잡한 문서 요소를 AI가 해석하기 용이한 형태로 변환합니다. 일반 파서가 놓치기 쉬운 시각적 정보와 구조적 데이터를 정확하게 인식하여 처리하기 때문에 AI 에이전트가 더 정확한 답변을 응답할 수 있습니다.
이럴 때 사용하세요:
•
복잡한 표 데이터가 포함된 문서: 일반 파서로 처리하기 어려운 복잡한 표 구조를 가진 문서
•
이미지가 포함된 문서: 텍스트뿐만 아니라 차트, 그래프, 다이어그램 등 시각적 요소가 포함된 문서
•
레이아웃이 복잡한 문서: 여러 열, 텍스트 상자, 특수 서식 등 복잡한 레이아웃 구조를 가진 문서
•
스캔된 문서나 PDF: 텍스트 추출이 어려운 이미지 기반 PDF나 스캔된 문서
지원중인 확장자는 다음과 같습니다
•
PDF, PNG, JPG, JPEG, PPT, PPTX, DOCX, DOC
참고: 현재 베타 서비스로 제공 중이며, 최적의 성능을 위해 파일 1건당 500페이지 미만으로 업로드를 권장합니다.
구글 드라이브 링크로 업로드
•
링크로 업로드시 지원하는 확장자는 다음과 같습니다.
◦
google sheet, google drive
◦
•
구글 드라이브 링크로 등록하시는 경우, 꼭 구글 드라이브 링크의 공유설정을 확인해주세요.
◦
액세스 권한을 “링크가 있는 모든 사용자”로 설정해주셔야 에이전트가 문서를 학습할 수 있습니다.
4. LLM 설정하기
LLM 모델 선택
•
에이전트가 사용할 LLM 모델을 선택할 수 있습니다.
•
이용중이신 과금 Plan 별로 사용가능한 모델이 제한될 수 있습니다.
◦
상세한 모델 제약사항은 영업팀에게 문의해주세요.
시스템 프롬프트
•
시스템 프롬프트는 모델의 기본 동작이나 태도를 설정하는 데 사용됩니다. 이 프롬프트는 모델이 어떻게 응답할지에 대한 지침을 제공하며, 모델의 스타일, 톤, 행동 양식을 지정합니다.
•
사용 예시:
◦
"당신은 친절하고 상세하게 설명하는 방식으로 답변해주세요."
◦
"간결하고 정확한 정보를 제공해 주세요."
◦
"사용자의 요청을 최대한 자연스럽게 이어가 주세요."
시스템 프롬프트는 일반적으로 사용자와의 상호작용 전에 설정되어, 모델이 어떻게 반응할지를 정의합니다. 예를 들어, 내가 "사용자가 편안하게 느끼도록 존중하는 방식으로 대화하라"는 지침을 시스템 프롬프트로 제공하면, 모델은 항상 그 방식대로 답변을 제공합니다.
프롬프트 작성 가이드 를 참조하여 서비스에 적합한 프롬프트를 작성해주세요.유저 프롬프트
•
유저 프롬프트는 실제로 사용자 요청이나 질문이 포함되는 부분입니다. 사용자는 모델에게 질문을 던지거나, 특정 작업을 요청하는 등의 방식으로 유저 프롬프트를 사용합니다. 모델은 유저 프롬프트에 따라 답변을 제공합니다.
•
사용 예시:
◦
"어떻게 피자를 만들어요?"
◦
"영업시간 알려주세요."
◦
"정수기 모델명은 무엇인가요?"
유저 프롬프트는 사용자가 원하는 정보나 서비스를 요청하는 부분이므로, 시스템 프롬프트에서 설정된 방식에 따라 모델은 그 요청에 응답합니다.
프롬프트에 변수 삽입
프롬프트에는 필요에 따라 변수를 입력할 수 있습니다.
•
{{검색된정보}}
◦
검색모듈(RAG)를 사용하는 에이전트에서만 사용가능한 변수입니다.
◦
탐색해온 정보를 해당 위치에 삽입하게됩니다.
•
{{입력된메시지}}
◦
유저가 입력한 텍스트를 담는 변수입니다.
◦
해당 변수의 위치에 유저가 입력한 인풋 텍스트가 삽입되게 됩니다.
검색된 정보 커스텀
•
검색모듈(RAG)를 사용하는 에이전트에서만 커스텀 가능한 영역입니다.
•
검색된 정보를 어떤 방식으로 삽입할 지, 템플릿을 직접 커스텀할 수 있습니다.
•
검색된 정보의 템플릿에는 다음의 변수들이 지원됩니다
◦
{{인덱스}}
▪
검색된 정보의 개수만큼 자동으로 넘버링을 매겨줍니다.
◦
{{파일명}}
▪
검색된 정보가 포함되어있던 파일명을 표시해줍니다.
◦
{{페이지}}
▪
일부 한글 문서는 페이지 메타정보가 포함되지 않습니다.
◦
{{내용}}
▪
검색된 정보의 본문 내용입니다.
•
예를들어 검색된 정보의 내용만을 삽입할 수도 있고, 파일명이 주요 정보라면 파일명도 포함할 수 있습니다.
•
또한 검색된 정보를 삽입할 최대 개수를 직접 선택할 수 있습니다
◦
검색된 정보가 20개더라도, 해당 설정을 활용한다면 5개의 정보만 프롬프트에 삽입할수도 있습니다.
◦
답변의 정확도가 중요하다면 검색된 정보의 최대 개수를 큰 값(예를들어 20)으로 설정하시고, 정확도보다 비용효율화가 더 중요하다면 검색된 정보의 최대 개수를 작은값(예를들어 10)으로 설정하시는 것을 권장드립니다.
LLM 파라미터
•
LLM의 상세 파라미터를 직접 커스텀할 수 있습니다.
•
파라미터 가이드 를 참조하여 서비스에 적합한 파라미터를 설정해주세요.5. 테스트하기
테스트 방법
•
하단의 채팅창에 유저가 입력할 법한 텍스트를 입력해보세요.
데브 라이브 환경 설정
•
데브 또는 라이브를 선택하여 환경별로 구분하여 테스트할 수 있습니다
•
라이브 환경은 사전에 배포를 완료하신 후 테스트가능하며, 라이브된 버전의 에이전트를 구분하여 테스트하실 수 있습니다
◦
폴더 지정하기
•
특정 폴더만 지정하여 테스트할 수 있습니다.
•
이 경우 선택된 폴더에 저장된 문서 안에서만 탐색하여 활용하게됩니다.
답변 출처 확인하기
답변 출처 기능은 LLM이 생성한 응답이 어떤 데이터를 기반으로 구성되었는지를 확인할 수 있도록 지원하는 기능입니다. 테스트 및 검증 과정에서 응답의 신뢰성과 정확도를 평가하는 데 활용됩니다.
•
출처 청크
◦
답변에 활용된 지식 청크(knowledge chunk)의 목록이 레이블링된 형태로 표시됩니다. 이를 통해 사용자는 응답이 어떤 근거 자료에 기반했는지를 쉽게 식별할 수 있습니다.
◦
각 지식 청크는 고유 번호로 구분되어 있으며, 번호를 클릭하면 해당 지식이 포함된 원문 내용을 바로 열람할 수 있습니다. 이를 통해 관리자나 검토자는 지식의 맥락과 실제 내용을 직관적으로 확인할 수 있습니다.
•
출처 문서
◦
지식 청크가 추출된 원문 문서는 내장 문서 뷰어를 통해 직접 확인할 수 있습니다.
◦
이 기능은 텍스트 청크만으로는 이해가 어려운 경우 유용하게 활용할 수 있습니다.
◦
단, 파일형식이 PDF인 경우에 지원합니다.
•
상세 로그
◦
답변 생성 시점에 호출된 검색 결과, 전달된 프롬프트, 응답 구성 흐름 등은 상세 로그를 통해 확인할 수 있습니다.
◦
이는 테스트 중 발견된 이슈의 원인을 분석하거나 디버깅할 때 유용하게 활용 가능합니다.
6. 배포하기
•
배포 버튼을 클릭하여 현재 dev 환경의 에이전트를 라이브 환경에 배포할 수 있습니다.
•
에이전트 버전에는 아래의 정보가 포함됩니다.
1.
지식으로 등록한 문서, 피드백
2.
시스템 에러 메시지
3.
액션도구의 내용
◦
채널 연동정보나, 권한 설정 정보, 검수 패턴 등은 에이전트 버전에 포함되지 않고 설정을 변경하는 즉시 반영되니 주의해주세요!
•
만약 배포가 완료된 후 live 환경의 에이전트에서 이슈가 발생했다면, 빠르게 바로 직전 버전의 에이전트로 롤백이 가능합니다.
◦
롤백하고자하는 버전의 더보기 버튼을 클릭하고 해당 버전으로 라이브 배포하기를 클릭해세요.
•
관리할 수 있는 에이전트 버전의 개수는 최대 10개입니다.
◦
10개의 버전을 초과하는 경우 가장 과거의 버전부터 자동삭제되니, 삭제하지 않고 관리하고자하는 버전이 있다면 주의해주세요.
7. 채널 연동하기
•
API로 직접 연동하거나 고객들이 자주 사용하는 메신저에 바로 연동할 수 있습니다.
•
N개의 채널에 연동할 수 있기 때문에 하나의 에이전트가 동시에 여러 카카오톡 채널, 채팅앱 등 여러 채널에서 동시에 활동할 수도 있어요.
•
또한, 채널별로 특정 폴더 내의 지식만을 참조해서 응답하도록 설정할 수 있습니다.
◦
예를들어 사이오닉 레스토랑의 역삼지점 카카오톡 채널에는 역삼점 폴더만을 연동하고,
◦
강남지점 카카오톡 채널에는 강남점 폴더만을 연동할 수도 있습니다.