# \[26.05.20] CHATIST 리뉴얼 및 신규 모델 적용

<figure><img src="/files/7mtCeSahq6WLLotwqAdF" alt=""><figcaption></figcaption></figure>

## 개요

`2026년 5월 20일`

CHATIST 서비스가 더 편리한 사용 경험을 제공할 수 있도록 전반적으로 리뉴얼되었습니다.

기존 기능과 데이터는 그대로 유지되며, 사용자가 더 편리하게 서비스를 이용할 수 있도록 화면 구성과 사용 흐름을 개선했습니다. 또한 신규 LLM 모델을 사용할 수 있도록 모델 관리 구조를 보완하고, 답변 품질과 운영 안정성을 함께 개선했습니다.

## 주요 업데이트 내용

{% hint style="success" icon="rotate" %}

### 업데이트 상세 내용

* **브랜드 및 공통 디자인 개선**
  * 로고, 아이콘, 버튼, 색상, 공통 레이아웃 등 서비스 전반의 디자인 요소 개선
* **좌측 메뉴 사용성 개선**
  * 메뉴 열기/접기 기능 적용해 화면 공간을 더 효율적으로 사용
  * 문서, Q\&A, 웹사이트, 폴더 등 챗봇 구성 요소를 더 이해하기 쉬운 메뉴 구조로 정리
* **챗봇 상세 화면 가독성 개선**
  * 기존 목록 중심 화면에서 채팅형 UI와 로딩 상태 중심 화면으로 개선
  * 채팅 답변 내 마크다운, 목록, 링크 표시 방식 개선
* **크롤링 기능 개선**
  * 기존에 작용하지 않던크롤링 유형별 설정 및 처리 흐름 정리
* **플로팅챗 UI 리디자인 적용**
  * 플로팅 버튼, 채팅창, 말풍선, 추천 질문, 안내 문구 디자인 개선
* **신규 LLM 모델 선택 지원**
  * 구독관리 내 신규 LLM 모델 목록 추가 및 모델 선택 순서 정리
* **기업 구독 변경 안정화**
  * 기업 구독 타입 변경 시 기존 챗봇 모델을 새 구독 설정에 맞게 자동 동기화
* **PC 웹 반응형 개선**
  * 브라우저 크기에 따라 화면 요소가 자연스럽게 배치되도록 개선
* **기타 사용성 및 안정성 개선**
  * 화면 표시 오류, 모달 동작, 답변 렌더링 등 세부 오류 개선
    {% endhint %}

## 안내사항

신규 모델을 사용하거나 웹사이트에 플로팅챗 리디자인을 반영하려는 경우, 아래 내용을 참고해 주세요.

### <mark style="background-color:yellow;">1. 신규 구독 모델 사용 방법</mark>

신규 LLM 모델을 사용하려면 구독 설정에 사용할 모델을 추가해야 합니다.\
구독 모델을 적용하는 방법은 두 가지입니다.

{% tabs %}
{% tab title="방법 1. 기존 구독에 모델 추가하기" %}

#### **기존 구독에 모델 추가하기**

기존에 사용 중인 구독에 필요한 모델을 추가하는 방식입니다.

1. `슈퍼관리자` 권한을 가진 계정으로 관리자 페이지에 접속합니다.

<figure><img src="/files/Dbiz2Bd0uNjDZFLlcFZo" alt="" width="375"><figcaption></figcaption></figure>

2. `기업 관리` 메뉴에서 해당 기업이 사용 중인 구독 이름을 확인합니다.

<figure><img src="/files/ky0EdzhrUVwVaUzzCGGa" alt=""><figcaption></figcaption></figure>

3. `구독 관리` 메뉴로 이동해 기존에 사용 중이던 구독을 선택합니다.

<figure><img src="/files/E4qndrLOrwGZPm4lnhWE" alt=""><figcaption></figcaption></figure>

4. `LLM Model(for chatting)` 항목에 필요한 모델을 추가합니다.

<figure><img src="/files/J9ZudP2FRW6twMLTVhO9" alt="" width="563"><figcaption></figcaption></figure>

> 실제 챗봇 답변에 사용할 모델은 `LLM Model 관리(for Chatting)`에 추가해야 합니다. \
> `LLM Model 관리(for Table Tag)`는 표 데이터를 텍스트로 변환할 때 사용하는 별도 LLM 설정입니다.
> {% endtab %}

{% tab title="방법 2. 새 구독 등록 후 기업 구독 타입 변경하기" %}

#### **새 구독 등록 후 기업 구독 타입 변경하기**

신규 모델 구성을 별도의 구독으로 관리하고 싶은 경우, 새 구독을 등록한 뒤 기업의 구독 타입을 변경할 수 있습니다.

1. `슈퍼관리자` 권한을 가진 계정으로 관리자 페이지에 접속합니다.

<figure><img src="/files/FJJc3b9vWULUgGlvEXib" alt="" width="375"><figcaption></figcaption></figure>

2. `구독 관리` 메뉴에서 새 구독을 등록합니다.

<figure><img src="/files/xDpEkTdPNS7nzoOVEK5f" alt=""><figcaption></figcaption></figure>

3. 새 구독에 사용할 LLM 모델과 임베딩 모델을 설정합니다.

<figure><img src="/files/SWrcAsPX4SpwLdhU1zaf" alt="" width="563"><figcaption></figcaption></figure>

> **임베딩 모델 설정 시 유의사항**
>
> 새 구독을 등록할 때 임베딩 모델은 기존 문서를 임베딩했던 모델과 동일하게 설정해야 합니다.
>
> 기존 문서가 다른 임베딩 모델로 만들어진 상태에서 임베딩 모델을 변경하면, 벡터 차이로 인해 오류가 발생하거나 검색 결과가 정상적으로 나오지 않을 수 있습니다.
>
> 임베딩 모델을 변경하려면 기존 문서를 새 모델 기준으로 다시 임베딩해야 합니다.&#x20;

4. `기업 관리` 메뉴로 이동합니다.

<figure><img src="/files/Q7zwnutAPWZLYmwC19k2" alt=""><figcaption></figcaption></figure>

5. 해당 기업의 구독 타입을 새로 등록한 구독으로 변경합니다.

<figure><img src="/files/b0hit7Vte2BGAp5XmLVH" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### <mark style="background-color:yellow;">2. 플로팅챗 리디자인 반영 방법</mark>

플로팅챗을 사용하는 방식에 따라 리디자인 반영 방법이 다릅니다.

{% tabs %}
{% tab title="경우 1. 플로팅챗 URL을 그대로 사용하는 경우" %}

#### ChatBot 팝업 URL**을 그대로 사용하는 경우**

ChatBot 팝업 URL을 통해 챗봇을 사용하는 경우, 관리자 페이지에서 저장을 한 번 더 진행하면 최신 리디자인이 반영됩니다.

1. 관리자 페이지에 접속합니다.

<figure><img src="/files/PSU0Q7TpL5uOu4l31fZM" alt="" width="375"><figcaption></figcaption></figure>

2. `ChatBot 설정 관리` 메뉴로 이동해 해당 챗봇의 `플로팅 설정` 화면을 엽니다.

<figure><img src="/files/xpgzvGw2swcgfVyhrrRt" alt=""><figcaption></figcaption></figure>

3. 설정 내용을 확인한 뒤 `저장` 버튼을 클릭합니다.

<figure><img src="/files/8lppuz9rZnhJwDVhuHdL" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="경우 2. JS 파일을 다운로드하여 연결한 경우" %}

#### JS 파일을 다운로드하여 연결한 경우

고객사 웹사이트에 플로팅챗 JS 파일을 직접 다운로드하여 연결한 경우, 기존 파일을 새 파일로 교체해야 합니다.

1. 관리자 페이지에 접속합니다.

<figure><img src="/files/klFMaO3fXSL9SC7cDbiX" alt="" width="375"><figcaption></figcaption></figure>

2. `ChatBot 설정 관리` 메뉴로 이동해 해당 챗봇의 `플로팅챗 설정` 화면을 엽니다.

<figure><img src="/files/idCXt1UCgM13mkIQo9bo" alt=""><figcaption></figcaption></figure>

3. `저장` 버튼을 클릭합니다.

<figure><img src="/files/s2ByDWBMgh5qlb3RdBTt" alt="" width="563"><figcaption></figcaption></figure>

4. 새로 생성된 JS 파일을 다시 다운로드합니다.

<figure><img src="/files/owg9qinQL0gr3D4Sad6Q" alt=""><figcaption></figcaption></figure>

5. 고객사 웹사이트에 연결된 기존 JS 파일을 새 JS 파일로 교체합니다.

> **참고사항**
>
> * 새 JS 파일 적용 후 문제가 발생할 경우를 대비해, 기존 JS 파일은 즉시 원복할 수 있도록 별도로 보관하는 것이 좋습니다.
> * 기존 JS 파일을 고객사 서버나 페이지에 직접 연결한 경우에는 새 JS 파일로 교체해야 최신 리디자인이 반영됩니다.
>   {% endtab %}
>   {% endtabs %}

> **캐시 관련 안내**
>
> JS 파일을 교체한 뒤에도 구버전 화면이 보이는 경우, 브라우저 또는 서버 캐시가 남아 있을 수 있습니다.
>
> 이 경우 다음 항목을 확인해 주세요.
>
> * 브라우저 새로고침(`F5`) 또는 강력 새로고침(`ctrl`+`F5`)
> * 고객사 서버에 업로드된 JS 파일 교체 여부
> * CDN 또는 웹서버 캐시 갱신 여부
> * 실제 페이지에서 불러오는 JS 파일 경로가 최신 파일인지 여부


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ixpert-product.gitbook.io/chatist/updates/undefined/26.05.20-chatist-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
