> For the complete documentation index, see [llms.txt](https://genos-docs.gitbook.io/default/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://genos-docs.gitbook.io/default/v1.9.2/basic-tutorials/guides/application/dev-chat/chat-app-multi-deploy.md).

# 채팅 앱 다중 배포와 버전 관리

## 개요

채팅 앱은 워크플로우를 연결해 대화형 서비스를 만들고 배포하는 기능입니다. 사용자 포털 사이드바의 **앱 > 채팅 앱** 메뉴에서 진입하며(화면 경로 `홈 > 앱 > 채팅 앱`), 채팅 앱을 목록에서 관리하고 생성·수정·공유하며, 하나의 채팅 앱 안에서 여러 버전을 만들어 배포합니다.

v1.9.1에서는 두 가지 축으로 개선되었습니다.

* **메뉴 사용성 개선** — 기존 '채팅 애플리케이션' 메뉴명이 **'채팅 앱'** 으로 변경되었고, 상세 화면이 **운영 정보 · 버전 정보 · 변경 이력 · 채팅 이용** 4개 탭으로 재편성되었습니다.
* **다중 배포 지원** — 하나의 채팅 앱에 여러 **버전**을 만들고, 각 버전을 독립적으로 배포·배포 중지·배포 취소하며, 여러 배포 버전 중 실제 사용자에게 서비스되는 **운영 버전**을 교체할 수 있습니다. 모든 배포 관련 작업은 **결재(승인 대기)** 흐름을 거칩니다.

기본적인 채팅 생성 절차는 [채팅 애플리케이션 만들기](/default/v1.9.2/basic-tutorials/guides/application/dev-chat.md) 문서를 함께 참고해 주세요.

<figure><img src="/files/a3PeuuRQ0aOijx3pBQd8" alt=""><figcaption><p>채팅 앱 목록 화면</p></figcaption></figure>

## 주요 개념

| 개념              | 설명                                                                                                                                                                                                               |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 채팅 앱            | 워크플로우를 연결해 만든 대화형 서비스입니다. 기존 명칭은 '채팅 애플리케이션'이었습니다.                                                                                                                                                               |
| 버전              | 하나의 채팅 앱 안의 개별 설정 묶음입니다. 채팅 앱은 여러 버전을 가질 수 있고, 버전 단위로 배포·중지됩니다.                                                                                                                                                  |
| (새) 버전 생성       | 채팅 앱을 처음 만들면 첫 버전이 함께 생성되고, 이후에는 기존 버전을 기반으로 `새 버전 생성`을 통해 버전을 추가합니다. 새 버전은 기존 버전의 설정값을 그대로 복사해 시작하며, 각 버전은 독립적으로 배포·관리됩니다. 기존 버전의 설정을 바로 수정할 수는 없으므로, 프로필·인터랙션·운영 정책 등 설정을 바꾸려면 `새 버전 생성`으로 새 버전을 만들어 진행해야 합니다. |
| 운영 상태           | 각 버전이 실제로 어떻게 서비스되고 있는지를 나타내는 **확정된 상태**입니다. **미배포**(아직 한 번도 배포되지 않음) / **정상**(배포되어 서비스 중) / **배포 중지**(서비스에서 내려간 상태) 3종입니다.                                                                                      |
| 신청 상태           | 운영 상태를 바꾸기 위한 **결재가 진행 중(대기)** 인 상태입니다. **배포 승인 대기**(미배포·배포 중지 → 정상으로 배포 신청) / **배포 중지 승인 대기**(정상 → 배포 중지 신청) / **운영 버전 변경 승인 대기**(운영 버전 교체 신청)가 있으며, 결재가 승인되어야 비로소 운영 상태가 바뀝니다.                                 |
| 운영 버전           | 여러 버전 중 현재 실제 사용자에게 서비스되는(라이브) 버전입니다. 버전 카드에 `운영 버전` 태그로 표시됩니다. 채팅 앱을 생성할 때의 버전이 기본으로 운영 버전이 됩니다.                                                                                                                |
| 운영 버전 변경        | 운영 버전을 다른 버전으로 교체하는 작업입니다. 결재를 거칩니다.                                                                                                                                                                             |
| 전용 채팅 앱         | 특정 벡터 DB에 연결된 채팅 앱입니다. 상세 화면에 `[전용]` 배지와 연결된 벡터 DB 항목이 추가로 표시됩니다.                                                                                                                                                |
| 세션              | 사용자가 채팅 앱에서 대화를 시작해 메시지를 주고받은 하나의 대화창(대화 묶음) 단위입니다. 세션 수·이용 로그는 이 단위를 기준으로 집계됩니다.                                                                                                                                |
| 사용 / 사용·관리 (권한) | 공유 시 대상에게 부여하는 권한입니다. '사용'은 채팅 이용, '사용·관리'는 관리까지 가능합니다.                                                                                                                                                          |

## 탭 구조 개편

이번 개선으로 상세 화면의 정보 구성이 아래와 같이 바뀌었습니다.

| 항목                    | 기존          | 변경 후                                           |
| --------------------- | ----------- | ---------------------------------------------- |
| 생성 시 설정 정보            | 중요 정보 탭에 위치 | 상세 화면 첫 번째 탭인 **운영 정보**에 노출(운영 버전만)            |
| 전체 버전 상세 정보           | —           | 운영 버전을 포함한 **모든 버전 상세는 버전 정보 탭**에서 확인          |
| 배포 이력                 | 기본 정보에 위치   | **변경 이력 탭**으로 이동 — 배포 이력 + 운영 버전 변경 이력(신규)을 통합 |
| 채팅 로그                 | '채팅 로그'     | **'채팅 이용'** 으로 명칭 개편                           |
| STT, TTS, TTS 스트리밍 기능 | 플러그인 탭에 위치  | 채팅 앱(버전) **생성 시 설정값**으로 이동                     |
| 공유                    | 공유 탭        | **타이틀 영역(상단)** 으로 이동                           |

{% hint style="info" %}
STT · TTS · TTS 스트리밍은 더 이상 플러그인 탭에서 설정하지 않습니다. 채팅 앱(또는 새 버전)을 만들 때 **② 인터랙션** 단계의 `음성 입출력` 항목에서 설정하며, 이미 만들어진 버전의 설정을 바꾸려면 `새 버전 생성`으로 새 버전을 만들어야 합니다. 각 기능이 채팅 화면에서 어떻게 동작하는지는 [SST/TTS 활용하기](/default/v1.9.2/basic-tutorials/guides/application/dev-chat/sst-tts.md) 문서를 참고하시되, 설정 위치는 이 문서의 안내를 따라 주세요.
{% endhint %}

## 채팅 앱 목록

사이드바 **앱 > 채팅 앱** 을 클릭하면 목록으로 진입합니다. 목록에서는 채팅 앱을 검색·필터링하고, 우측 상단 `+ 채팅 앱 생성` 버튼으로 새 채팅 앱을 만듭니다. 상단 필터는 **채팅 앱 이름 검색 · 운영 상태 · 신청 상태** 3종입니다.

<figure><img src="/files/a3PeuuRQ0aOijx3pBQd8" alt=""><figcaption><p>채팅 앱 목록과 컬럼 구성</p></figcaption></figure>

목록 컬럼은 다음과 같습니다.

| 컬럼         | 설명                                                                                                                                                                               |
| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID         | 채팅 앱의 ID입니다.                                                                                                                                                                     |
| 채팅 앱 이름    | 길이가 넘치면 말줄임 처리되고, 마우스를 올리면 전체 이름이 툴팁으로 표시됩니다.                                                                                                                                    |
| 운영 상태      | 컬럼에는 **운영 버전의 상태만** 표시합니다(미배포/정상/배포 중지). 마우스를 올리면 운영 버전의 상태와 함께 **운영 버전 외 나머지 버전들의 상태별 개수**가 툴팁으로 노출됩니다(예: `운영 버전: 정상` / `정상 2 · 배포 중지 1 · 미배포 3`). 나머지 버전이 없으면 운영 버전 상태만 표시됩니다. |
| 신청 상태      | 결재 대기 상태를 표시합니다. 최대 1종류만 노출하고 2종류 이상이면 `상위 1종류 + 외 {N}개`(예: 배포 승인 대기 1개 외 1개)로 표시하며, `외 {N}개`에 마우스를 올려야 나머지가 노출됩니다. 정렬 순서는 운영 버전 변경 승인 대기 → 배포 승인 대기 → 배포 중지 승인 대기입니다.           |
| 최근 7일 세션   | 오늘 포함 최근 7일간 발생한 세션 수입니다.                                                                                                                                                        |
| 관리 그룹      | 채팅 앱의 관리 그룹입니다. 드롭다운되는 메뉴에서 관리 그룹의 이름, 상세 설명(작성된 경우만), 관리 그룹 인원수가 표시됩니다.                                                                                                         |
| 생성자 / 생성일시 | 생성한 사용자 이름과 `YYYY-MM-DD HH:MM:SS`입니다. 생성자 이름에 마우스를 올리면 해당 사용자 ID가 툴팁으로 표시됩니다.                                                                                                    |
| 앱 열기       | 운영 상태가 '정상'일 때만 활성화되며, 클릭하면 **사용자 화면**(대화 시작 화면)이 새 탭으로 열립니다. '미배포·배포 중지'는 비활성입니다.                                                                                               |

정렬은 생성일시(최근 생성순이 기본 → 오래된 생성순 → 정렬 없음)와 채팅 앱 이름(가나다순 ↔ 내림차순)으로 할 수 있습니다. 행 전체를 더블 클릭하면 채팅 앱 상세 화면으로 이동합니다.

읽기·사용 권한 사용자에게는 `채팅 앱 생성` 버튼이 보이지 않습니다. 검색 결과가 없거나 데이터를 불러오지 못하면 빈 상태 화면이 노출됩니다.

## 채팅 앱 생성

목록에서 `+ 채팅 앱 생성` 을 누르면 생성 화면(`홈 > 앱 > 채팅 앱 > 채팅 앱 생성`)으로 진입합니다. 읽기·쓰기 권한이 있는 사용자만 진입할 수 있고, 권한이 없는 사용자가 주소로 직접 접근하면 접근 권한 안내 화면이 표시됩니다.

생성 화면은 **단일 페이지 + 좌측 3단계 스텝 인디케이터**로 구성됩니다 — ① 기본 정보 ② 인터랙션 ③ 운영 정책. 스크롤하거나 스텝을 클릭해 각 섹션으로 이동하며, 스크롤 위치에 따라 현재 단계가 활성 표시됩니다. 하단에는 `나가기` · `생성` 버튼이 항상 고정되어 있습니다.

<figure><img src="/files/eDk0yP0CNWmwPTPtAUzt" alt=""><figcaption><p>채팅 앱 생성 화면</p></figcaption></figure>

### ① 기본 정보

| 필드                | 설명                                                                                        |
| ----------------- | ----------------------------------------------------------------------------------------- |
| 채팅 앱 이름 (필수)      | 최대 64자입니다.                                                                                |
| 상세 설명             | 최대 1024자입니다.                                                                              |
| 관리 그룹 (필수)        | 검색을 지원하는 단일 선택 항목입니다. 다른 워크스페이스의 관리 그룹은 선택할 수 없습니다.                                       |
| 채팅 앱 '사용' 권한 (필수) | `모든 사용자 바로 사용`(기본) / `지정한 대상만 사용` 탭입니다. '지정한 대상만 사용'은 사용자·관리 그룹·역할을 다중 선택합니다.             |
| 프로필 사진            | 80×80px, 1MB 이하의 JPG 또는 PNG를 업로드합니다.                                                      |
| 인사말 (필수)          | 최대 64자입니다.                                                                                |
| 테마 (필수)           | 챗봇형(기본), 문서형 중 선택합니다.                                                                     |
| 워크플로우 (필수)        | 채팅 앱을 연결할 워크플로우를 선택합니다. 검색을 지원하는 단일 선택 항목입니다.                                             |
| CoT 태그            | 모델의 사고 과정(Chain of Thought)을 감싸는 **열림 태그 / 닫힘 태그 쌍**을 등록합니다(예: 열림 `think` / 닫힘 `answer`). |

표의 일부 필드는 다음과 같은 추가 동작이 있습니다.

* **채팅 앱 '사용' 권한** — `모든 사용자 바로 사용`으로 두면 별도 결재 없이 누구나 채팅을 시작할 수 있습니다. `지정한 대상만 사용`을 고르면 지정 대상 외의 사용자에게는 서비스 목록에는 보이되 채팅 클릭 시 접근 권한 요청 화면으로 안내되고, 사용 신청이 승인되어야 이용할 수 있습니다(아무도 지정하지 않으면 나만 사용할 수 있는 채팅 앱이 됩니다). 대상 선택 시 관리 그룹·역할은 이름 + 상세 설명 + 인원 수로, 사용자는 이름 + 소속 관리 그룹 + 사용자 ID로 표시되며, 선택하면 칩(이름 + 지우기 버튼)으로 담깁니다.
* **워크플로우** — 드롭다운 항목은 워크플로우 이름 + 상세 설명 + `열기` 버튼으로 표시되며, `열기`를 누르면 해당 워크플로우 상세 화면으로 이동합니다.
* **CoT 태그** — 기본 1행 빈 상태로 노출되며 행 수 제한 없이 추가할 수 있습니다. 각 행은 열림 태그·닫힘 태그 텍스트 필드로 구성되고 각 최대 100자입니다. 열림·닫힘 중 한쪽만 입력하거나, 열림과 닫힘이 같거나, 이미 등록된 태그 쌍과 중복되면 인라인 오류가 표시됩니다.

### ② 인터랙션

| 필드        | 설명                                                                                                                                                                                          |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 예시 질문     | 예시 질문 제공 여부를 설정합니다. `제공` 선택 시 예시 질문을 최대 6개(각 최대 40자)까지 추가할 수 있으며, '예시 질문으로 채팅 시작하기'를 켜면 사용자가 예시 질문 중에서만 대화를 시작할 수 있습니다.                                                                     |
| 부정 피드백 수집 | 사용자가 답변에 부정 피드백을 눌렀을 때 피드백을 받는 방식을 설정합니다. `사용자 직접 입력`(기본)은 주관식으로 받고, `선택지 제공`은 선택지 목록 중에서 고르게 합니다(주관식 기타 의견 받기 옵션 추가 가능). 선택지 목록은 기본 2행·최대 10행, 각 항목 최대 40자입니다.                             |
| 음성 입출력    | STT(음성으로 메시지 입력) · TTS(음성으로 답변 듣기) · TTS 스트리밍(실시간 음성으로 답변 듣기) 사용 여부를 설정합니다. 자세한 사용자 화면 동작은 [SST/TTS 활용하기](/default/v1.9.2/basic-tutorials/guides/application/dev-chat/sst-tts.md)를 참고해 주세요. |

### ③ 운영 정책

| 필드             | 설명                                 |
| -------------- | ---------------------------------- |
| 토큰 크레딧 배수 (필수) | 스텝퍼 필드이며 기본값은 0, 범위는 0\~99,999입니다. |
| 추가 크레딧         | 스텝퍼 필드이며 기본값은 0, 범위는 0\~99,999입니다. |

### 메모

폼 마지막에는 **메모** 필드가 있습니다. 플레이스홀더는 "예) 이 버전의 변경 사항"이고 띄어쓰기 포함 최대 64자까지 입력할 수 있습니다. 메모는 생성 이후에도 언제든 수정할 수 있습니다.

### 생성과 배포 신청

`생성` 버튼은 필드에 입력·설정이 1개 이상 발생하면 활성화됩니다. 클릭 시 유효성 검증이 실행되며, 실패하면 미충족 필드에 인라인 오류 메시지가 표시되고 수정이 필요한 첫 필드로 포커스가 이동합니다.

검증을 통과하면 **생성 재확인 모달**이 뜹니다. 이 모달에는 **`배포까지 진행하기` 체크박스**(기본 미체크)가 있습니다.

<figure><img src="/files/YEV7GSc4iexgySmb7h7o" alt=""><figcaption><p>생성 재확인 모달의 '배포까지 진행하기' 옵션</p></figcaption></figure>

| 배포까지 진행하기 | 동작                                                                 |
| --------- | ------------------------------------------------------------------ |
| 미체크       | 생성만 완료 → 완료 안내와 함께 생성된 채팅 앱 상세 화면으로 이동                             |
| 체크        | 생성 + **배포 신청까지 자동 진행** → 상세 화면으로 이동하고, 결재 권한이 있는 계정에 결재 요청이 전달됩니다. |

배포까지 체크한 경우 상황별로 안내 메시지가 분기됩니다 — 생성 완료 / 배포 신청 완료 / 생성 실패 / 배포 신청 실패. 결재 권한이 있는 계정에는 결재 요청 알림이 표시되며, 알림의 `검토` 버튼을 클릭하면 승인(결재) 메뉴로 이동합니다. 배포·배포 중지·운영 버전 변경·공유 등 모든 결재 요청 알림이 동일하게 동작합니다.

`나가기`는 입력·설정 값이 있으면 이탈 재확인 모달을, 없으면 즉시 이탈합니다.

## 채팅 앱 상세 — ① 운영 정보 탭

목록에서 행을 더블 클릭하면 상세 화면으로 이동하고, 첫 화면은 **운영 정보 탭**입니다. 상단 타이틀 영역에는 채팅 앱 이름·설명·편집 아이콘과 우측 `채팅 앱 열기` · `공유` · `⋮ 더보기` 버튼이 있으며, 그 아래 **운영 정보 · 버전 정보 · 변경 이력 · 채팅 이용** 4개 탭이 있습니다.

사용 권한 사용자에게는 새 버전 생성 버튼·운영 상태 변경 버튼·테스트 버튼·채팅 이용 탭이 보이지 않으며, 권한이 없는 사용자가 주소로 직접 진입하면 접근 권한 안내 화면이 표시됩니다.

### 채팅 앱 '사용' 권한

운영 정보 탭 최상단에는 생성할 때 설정한 채팅 앱의 **'사용' 권한 설정값**이 표시됩니다 — 생성 시 설정한 `모든 사용자 바로 사용` 또는 `지정한 대상만 사용`이 노출됩니다. `수정`(전용 채팅 앱으로 생성한 경우 `보기`) 버튼을 누르면 '사용' 권한 사이드 패널이 열립니다.

사이드 패널에서는 `모든 사용자 바로 사용` ↔ `지정한 대상만 사용`을 전환할 수 있습니다. 지정한 대상만 사용일 경우 대상(관리 그룹·사용자·역할)이 노출되며, 클릭으로 해당 대상의 상세 화면으로 이동할 수 있습니다. 저장 전까지 기존 설정이 유지되며, 취소 시 변경사항이 있으면 이탈 재확인 모달이 뜹니다.

공유 대상에 대한 추가 설정(권한 추가, 권한 변경, 권한 삭제)은 `공유 대상 전체 보기` 버튼 또는 상세 화면 상단의 `공유` 버튼으로 진입하는 공유 사이드 패널에서 할 수 있습니다.

### 운영 현황 카드

운영 정보 탭의 핵심은 **운영 현황 카드**입니다. 운영 버전을 기준으로 다음 정보를 보여줍니다.

* **운영 상태 배지** — 미배포 / 정상 / 배포 중지 (마우스를 올리면 상태 설명 툴팁이 표시됩니다)
* **신청 상태** — 배포 중지 승인 대기 (없을 경우 표시되지 않습니다)
* **운영 신청자**
* **운영 시작일**
* **세션 수** — 기간 필터(전체 / 오늘 / **최근 7일**(기본) / 최근 30일)로 조회합니다. 미배포 버전은 `-`로 표시되고, 실제 사용자 세션만 집계되어 채팅 앱 테스트는 포함되지 않습니다.

<figure><img src="/files/PMYQi8Kd2zUOijUQoj47" alt=""><figcaption><p>운영 정보 탭의 운영 현황 카드</p></figcaption></figure>

카드의 액션 버튼은 버전 상태에 따라 달라집니다.

| 운영 버전의 운영 상태 | 운영 버전의 신청 상태 | 주요 버튼    |
| ------------ | ------------ | -------- |
| 미배포 또는 배포 중지 | 없음           | 배포       |
| 미배포 또는 배포 중지 | 배포 승인 대기     | 배포 취소    |
| 정상(운영 중)     | 없음           | 배포 중지    |
| 정상(운영 중)     | 배포 중지 승인 대기  | 배포 중지 취소 |

공통으로 `테스트` · `새 버전 생성` 버튼이 있으며, 배포 관련 버튼(`배포` / `배포 취소` / `배포 중지` / `배포 중지 취소`)은 각각 **재확인 모달**을 띄운 뒤 결재(승인 대기) 흐름을 시작합니다.

* **테스트** — 클릭 시 테스트 사이드 패널이 열립니다. 실제 채팅과 동일한 환경에서 테스트하며, 테스트 대화는 세션 수에 포함되지 않고 채팅 내용은 '채팅 이용' 탭에서 확인할 수 있습니다.
* **새 버전 생성** — 클릭한 버전을 기준으로 새로운 버전을 생성하는 화면으로 전환합니다(선택한 버전의 설정값이 기본값으로 표시됩니다).
* **채팅 앱 설정값(아코디언)** — 해당 버전의 기본 정보·인터랙션·운영 정책 설정값을 읽기 전용으로 펼쳐 볼 수 있습니다.

## 채팅 앱 상세 — ② 버전 정보 탭

버전 정보 탭은 해당 채팅 앱의 **모든 버전을 카드 형태로 관리**합니다. 상단에는 버전 검색 · 정렬(최근 생성순 기본) · **`배포된 버전만 보기` 체크박스** · `+ 버전 생성` 버튼이 있고, 카드가 3열 그리드로 배치되며 9개씩 페이지네이션됩니다.

<figure><img src="/files/dONt3JrD9qHxJPyaNuBs" alt=""><figcaption><p>버전 정보 탭의 버전 카드 그리드</p></figcaption></figure>

각 버전 카드는 버전명 + **운영 상태 배지** + **신청 상태** + 생성일 + 워크플로우 이름 + **메모** + 액션 버튼 + `⋮ 더보기`로 구성됩니다. 사용자 화면에서 라이브 중인 버전에는 **`운영 버전` 태그**가 표시되며, 운영 버전은 항상 최상단에 위치합니다.

카드에 노출되는 액션 버튼은 그 버전이 운영 버전인지, 그리고 운영 상태·신청 상태가 무엇인지에 따라 다음과 같이 분기됩니다.

| 운영 버전 여부 | 운영 상태 | 신청 상태          | 노출 버튼                                                                            |
| -------- | ----- | -------------- | -------------------------------------------------------------------------------- |
| 공통       | 미배포   | 없음             | `배포`                                                                             |
| 공통       | 미배포   | 배포 승인 대기       | `배포 취소`                                                                          |
| 운영 버전    | 정상    | 없음             | `배포 중지`                                                                          |
| 일반 버전    | 정상    | 없음             | `운영 버전 변경` · `배포 중지`                                                             |
| 일반 버전    | 정상    | 운영 버전 변경 승인 대기 | `운영 버전으로 변경 취소` · `배포 중지`(비활성, 마우스를 올리면 "운영 버전 변경 승인 대기 중에는 배포를 중지할 수 없습니다." 툴팁) |
| 일반 버전    | 정상    | 배포 중지 승인 대기    | `배포 중지 취소`                                                                       |
| 공통       | 배포 중지 | 없음             | `배포`                                                                             |
| 공통       | 배포 중지 | 배포 승인 대기       | `배포 취소`                                                                          |

* **운영 버전 여부** — `운영 버전`은 현재 라이브 중인 버전, `일반 버전`은 그 외 버전이며, `공통`은 운영 버전·일반 버전 모두에 해당하는 경우입니다.
* **결재 여부** — `배포` · `배포 중지` · `운영 버전 변경`은 재확인 모달을 거쳐 **결재(승인 대기)** 로 진행되고 결재 권한 계정에 결재 요청 알림이 전달됩니다. 반면 `배포 취소` · `배포 중지 취소` · `운영 버전으로 변경 취소` 등 **취소 계열은 결재 없이 즉시 반영**됩니다.
* **운영 버전 변경 제약** — 어떤 버전이 운영 버전 변경 승인 대기 중이면, 다른 `정상` 버전들의 `운영 버전 변경` 버튼은 비활성화되고 마우스를 올리면 사유 툴팁("운영 버전 변경 대기 중인 버전이 처리된 후 변경할 수 있습니다.")이 표시됩니다.

이 외에 `⋮ 더보기`에는 `새 버전 생성` · `테스트`가 있으며, 운영 상태에 따라 노출이 달라집니다.

* 운영 상태가 **미배포 · 배포 중지**인 버전은 `새 버전 생성`만 노출됩니다.
* 운영 상태가 **정상**인 버전은 `새 버전 생성`과 함께 `테스트` 버튼도 노출됩니다.

{% hint style="info" %}
**다중 배포의 핵심 — 운영 버전 변경**: 한 채팅 앱에 여러 버전이 배포 상태로 존재할 수 있고, 그중 실제 사용자에게 서비스되는 '운영 버전'을 다른 버전으로 교체하는 것이 `운영 버전 변경`입니다. 이 변경도 결재를 거칩니다.
{% endhint %}

### 버전 상세 사이드 패널

카드를 클릭하면(또는 변경 이력 탭에서 대상을 클릭하면) 버전 상세 사이드 패널이 열립니다. 타이틀은 `버전 {NNN}` + 운영 버전 태그 + (`테스트` 버튼) + 닫기입니다.

<figure><img src="/files/xTxwdTLALuIWhbSY4SRN" alt=""><figcaption><p>버전 상세 사이드 패널</p></figcaption></figure>

상단 카드에는 운영 상태 · 신청 상태 · 버전 생성(생성자·생성일시) · 배포(배포 신청자·배포 승인일시) · 운영 시작(운영 버전 변경 신청자·운영 시작일시) · **메모** 가 표시되고, 그 아래 기본 정보 · 인터랙션 · 운영 정책 설정값이 읽기 전용으로 나옵니다. 하단 버튼은 상태에 따라 `새 버전 생성` · `운영 버전으로 변경` · `배포 중지` 등으로 달라지며, 각 버전 카드 하단에 노출되는 버튼과 동일합니다.

메모는 **버전 생성 시점과 무관하게 언제든 수정할 수 있습니다.** `수정` 버튼을 누르면 편집 모드로 전환되어 기존 값이 채워진 상태로 노출되며(미입력이면 `-`), `취소` 버튼은 항상 활성, `저장` 버튼은 변경사항이 있을 때만 활성화됩니다. 저장에 성공하면 완료 안내와 함께 편집 모드가 해제되고, 실패하면 실패 안내가 표시되며 편집 모드가 유지됩니다.

### 새 버전 생성

운영 정보 탭이나 버전 정보 탭의 `새 버전 생성` 버튼을 누르면 "버전 {N}을 기반으로 새로운 버전을 생성합니다." 안내와 함께 생성 화면으로 진입합니다(`홈 > 앱 > 채팅 앱 > {채팅 앱 이름} > 새 버전 생성`).

버전 정보 탭 상단의 `버전 생성` 버튼을 누르면 "가장 최근에 생성된 버전 {N}을 기반으로 새로운 버전을 생성합니다." 안내와 함께 생성 화면으로 진입합니다(`홈 > 앱 > 채팅 앱 > {채팅 앱 이름} > 버전 생성`).

<figure><img src="/files/5TgpxnaHJjVbdxwMgQpo" alt=""><figcaption><p>기존 버전을 기반으로 한 새 버전 생성 화면</p></figcaption></figure>

채팅 앱 생성 화면과 동일한 3단계 구조(기본 정보 / 인터랙션 / 운영 정책)를 따르되, 버전 단위이므로 **채팅 앱 이름·관리 그룹·채팅 앱 '사용' 권한 필드는 없고**, 그 외에는 최근 버전 또는 선택한 버전의 설정값이 기본값으로 채워진 형태로 표시됩니다. 생성 재확인 모달에는 채팅 앱 생성과 동일하게 **`배포 신청까지 진행하기` 체크박스**가 있습니다.

## 채팅 앱 상세 — ③ 변경 이력 탭

변경 이력 탭은 채팅 앱의 **운영 상태 변경(배포·배포 중지·운영 버전 변경) 이력**을 관리합니다. 상단 필터는 신청자 검색 · 버전 · 결재 유형 · 결재 상태입니다. 행을 클릭하면 해당 버전 상세 사이드 패널이 열립니다.

<figure><img src="/files/CN7Hh3cyQGxEam3Ek8rW" alt=""><figcaption><p>변경 이력 탭</p></figcaption></figure>

| 컬럼         | 설명                                                                      |
| ---------- | ----------------------------------------------------------------------- |
| 버전         | 해당 행의 버전 번호입니다.                                                         |
| 결재 유형      | **배포 / 배포 중지 / 운영 버전 변경** 3종입니다.                                        |
| 신청자 / 신청일시 | 사용자 이름 + `YYYY-MM-DD HH:MM:SS`입니다. 사용자 이름에 마우스를 올리면 사용자 ID가 툴팁으로 표시됩니다. |
| 결재자 / 결재일시 | 사용자 이름 + `YYYY-MM-DD HH:MM:SS`입니다. 사용자 이름에 마우스를 올리면 사용자 ID가 툴팁으로 표시됩니다. |
| 결재 상태      | **대기 / 승인 / 반려 / 신청 취소** 입니다.                                           |
| 반려 사유      | 반려 시 결재자가 입력한 사유가 표시되고, 그 외에는 `-`입니다.                                   |

정렬은 신청자·신청일시(최근순 기본)와 결재자·결재일시로 하며, 행이 11개 이상이면 페이지네이션됩니다. 검색 결과가 없거나 데이터를 불러오지 못한 경우에는 빈 상태 화면이 표시됩니다.

## 채팅 앱 상세 — ④ 채팅 이용 탭

채팅 이용 탭은 채팅 앱의 **서비스 이용 로그(세션)를 요약·확인**합니다. 읽기 권한 사용자는 탭을 볼 수 없습니다. 상단 필터는 사용자 검색 · 버전 · **`테스트 채팅 포함` 체크박스**입니다.

<figure><img src="/files/ryi1ZytaM0NYAdAuRVA7" alt=""><figcaption><p>채팅 이용 탭의 세션 목록</p></figcaption></figure>

| 컬럼     | 설명                                |
| ------ | --------------------------------- |
| (체크박스) | 여러 건을 한 번에 선택할 때 사용합니다.           |
| 버전     | 세션 시작 시점 기준 버전입니다.                |
| 사용자    | 이름이 표시되며, 마우스를 올리면 사용자 ID가 표시됩니다. |
| 관리 그룹  | 사용자가 소속된 관리 그룹이 표시됩니다.            |
| 질문     | 해당 세션에서 발생한 질문 수 총합입니다.           |
| 긍정 피드백 | 긍정 피드백 개수 총합입니다.                  |
| 부정 피드백 | 부정 피드백 개수 총합입니다.                  |
| 워크플로우  | 워크플로우 이름이 표시됩니다.                  |
| 시작일시   | `YYYY-MM-DD HH:MM:SS`입니다.         |
| 종료일시   | `YYYY-MM-DD HH:MM:SS`입니다.         |
| 다운로드   | 아이콘 클릭 시 채팅 다운로드 재확인 모달이 뜹니다.     |

정렬은 시작일시(최근순 기본) 등으로 하고, 행이 11개 이상이면 페이지네이션됩니다.

### 여러 세션 한 번에 다운로드

행을 다중 선택하면 하단에 **일괄 작업 바**(`N개 중 M개 선택` + `채팅 다운로드` + 닫기)가 나타납니다. 선택은 현재 보고 있는 페이지를 대상으로 합니다. `채팅 다운로드`를 누르면 재확인 모달을 거쳐 **CSV로 다운로드**되며, 다운로드 시작 안내가 표시됩니다(진행 중 취소 가능).

### 채팅 이용 상세 모달

행을 클릭하면 채팅 이용 상세 모달이 열립니다.

<figure><img src="/files/hQxeEwCnYkmHvPUBroI7" alt=""><figcaption><p>채팅 이용 상세 모달</p></figcaption></figure>

* **좌측** — 실제 채팅 앱 화면과 동일한 형태로 사용자 질문·AI 답변이 표시되며, 답변에 남긴 긍정·부정 피드백이 선택 상태로 표시됩니다.
* **우측** — **피드백 패널**입니다. 분류 필터(전체(기본)/긍정/부정)와 접기·펼치기가 있고, 부정 피드백은 사용자가 입력한 내용(직접 입력 또는 선택지)이 노출됩니다.

좌우 영역은 각각 독립적으로 스크롤됩니다.

## 전용 채팅 앱

전용 채팅 앱은 특정 벡터 DB에 연결된 채팅 앱입니다. **생성 절차는 기존과 동일**하고, 상세 화면만 개선된 UI로 노출됩니다. 일반 채팅 앱과의 차이는 다음과 같습니다.

<figure><img src="/files/vjl6i0m6t8XNzL7fakDx" alt=""><figcaption><p>전용 채팅 앱 상세 화면</p></figcaption></figure>

| 항목           | 전용 채팅 앱 특이사항                                    |
| ------------ | ----------------------------------------------- |
| 채팅 앱 '사용' 권한 | **지정한 대상만 사용**으로만 노출되고, `보기` 클릭 시 사이드 패널이 열립니다. |
| 연결된 벡터 DB    | 전용 채팅 앱에만 있는 항목으로 **연결된 벡터 DB 이름**이 표시됩니다.      |

그 외 운영 현황·설정값·버전 관리·배포·변경 이력·채팅 이용은 일반 채팅 앱과 동일합니다.

## 채팅 앱 이름·설명 수정과 삭제

상세 화면 상단 타이틀 영역에서 채팅 앱 이름·상세 설명을 수정하고, 더보기 메뉴로 삭제합니다. 타이틀 영역은 채팅 앱 이름 + 수정 아이콘 + 상세 설명(없으면 미노출) + 메타 정보(ID · 관리 그룹 · 생성자 · 생성일시)와 우측 `채팅 앱 열기` · `공유` · `⋮ 더보기` 버튼으로 구성됩니다. 읽기·쓰기 권한 사용자에게는 더보기·수정 버튼이 노출되지 않습니다.

### 이름·설명 수정

수정 아이콘을 누르면 수정 모달이 열립니다. 저장 버튼은 채팅 앱 이름과 상세 설명 중 변경사항이 발생하면 활성화되고, 이름이 중복이면 인라인 오류가 표시됩니다. 저장이 완료되면 완료 안내가 표시됩니다.

<figure><img src="/files/Ccmm3lxW7GAPRkEIXLzQ" alt=""><figcaption><p>채팅 앱 이름·상세 설명 수정 모달</p></figcaption></figure>

### 삭제

`⋮ 더보기 > 삭제`로 삭제합니다. 삭제할 수 없는 상태에서는 삭제 버튼이 비활성화되고, 마우스를 올리면 사유가 툴팁으로 표시됩니다.

| 삭제 불가 상황                 | 툴팁 문구                      |
| ------------------------ | -------------------------- |
| 배포 중(운영 상태 정상 버전이 1개 이상) | 배포를 중지한 후 삭제할 수 있습니다.      |
| 운영 상태 변경 승인 대기 중         | 승인 대기 진행 중일 때는 삭제할 수 없습니다. |

삭제가 가능하면 삭제 확인 모달이 뜹니다. 되돌릴 수 없는 작업이므로 `삭제`를 직접 입력해야 삭제 버튼이 활성화됩니다. 공유 중인 채팅 앱은 "현재 공유 중인 채팅입니다. 삭제하면 공유된 대상도 더 이상 확인할 수 없습니다." 문구가 추가됩니다.

<figure><img src="/files/O7lAJ6XOjQE70bxyCrXE" alt=""><figcaption><p>삭제 확인 모달</p></figcaption></figure>

삭제 결과는 성공·실패 안내로 표시됩니다.

## 공유

타이틀 영역의 `공유` 버튼을 누르면 공유 사이드 패널이 열립니다. 패널은 **공유 현황**(기본)과 **변경 이력** 두 탭으로 구성됩니다.

<figure><img src="/files/4aCOMng7huCb1EQu2LMs" alt=""><figcaption><p>공유 사이드 패널</p></figcaption></figure>

### 공유 현황 탭

상단 요약 카드에 권한별 대상 수가 표시됩니다 — **사용**(사용자 N명 / 관리 그룹 N개 / 역할 N개), **사용·관리**(동일 구성), **결재 대기**(N건). 채팅 앱이 '모든 사용자 바로 사용'이면 사용 권한이 "모든 사용자 바로 사용"으로 표기됩니다.

사용 권한 사용자에게는 공유 대상 추가 버튼과 관리 컬럼이 보이지 않습니다.

공유 대상 목록에는 대상 이름 검색 · 대상 유형 필터(전체·사용자·관리 그룹·역할) · 권한 필터(전체·사용·사용·관리) · `+ 공유 대상 추가` 버튼이 있습니다. 목록 컬럼은 대상 유형 / 대상 이름 / **권한(사용, 사용·관리)** / 신청 상태 / 수정·추가일시 / 관리입니다. 승인 대기 건은 관리 열에 `신청 취소`가, 그 외에는 편집 아이콘이 표시됩니다.

**공유 대상 추가**는 대상(전체/사용자/관리 그룹/역할)을 검색·선택한 뒤 권한(`사용`(기본) / `사용·관리`)을 지정하고 완료합니다. **한 번에 여러 대상을 함께 추가할 수 있습니다.** 공유 신청은 승인 대기 상태로 전환되고 결재 권한 계정에 결재 요청 알림이 전달됩니다. 권한 변경·삭제도 재확인 모달을 거쳐 승인 대기로 진행됩니다.

여러 대상을 함께 추가한 경우 처리 방식은 다음과 같습니다.

* **변경 이력 탭에서는 대상별로 개별 행**으로 확인할 수 있습니다.
* **승인·반려·신청 취소는 함께 추가한 대상 전체에 대해 한 번에 처리**됩니다(개별 대상만 따로 승인·반려·취소할 수는 없습니다).

### 변경 이력 탭

공유 권한의 부여·변경·삭제 결재 이력을 관리합니다. 상단 필터는 대상 이름 검색 · 결재 유형 · 결재 상태입니다.

<figure><img src="/files/z1FyIgxxhvWUbgWDMTf5" alt=""><figcaption><p>공유 사이드 패널의 변경 이력 탭</p></figcaption></figure>

| 컬럼    | 설명                     |
| ----- | ---------------------- |
| 결재 유형 | 권한 변경 / 권한 추가 / 권한 삭제  |
| 대상 유형 | 관리 그룹 / 사용자 / 역할       |
| 대상 이름 | 대상 유형의 이름              |
| 기존 권한 | 사용 / 사용·관리 / 없음        |
| 변경 권한 | 사용 / 사용·관리 / 삭제        |
| 결재 상태 | 승인 / 반려 / 신청 취소 / 대기   |
| 상세    | 아코디언(∨)으로 펼쳐 볼 수 있습니다. |

상세를 펼치면 신청자·신청일시와 결재자·결재일시가 표시됩니다. 결재 대기 행이면서 사용·관리 권한이 있는 계정에는 `신청 취소` 버튼이, 결재 권한이 있는 계정에는 `검토`(승인 메뉴로 이동) 버튼이 노출되고, 반려 행에는 반려 사유가 표시됩니다.

## 사용자 시나리오

### 새 채팅 앱을 만들어 바로 배포하기

목록에서 `+ 채팅 앱 생성` → 기본 정보·인터랙션·운영 정책을 입력 → `생성` → 생성 재확인 모달에서 **`배포까지 진행하기` 체크** → 상세 화면으로 이동하고 배포 신청이 함께 접수됩니다. 결재 권한 계정이 승인하면 운영 버전으로 서비스가 시작됩니다.

### 새 버전을 만들어 운영 버전 교체하기

상세 > 버전 정보 탭에서 `+ 버전 생성`(또는 운영 현황 카드의 `새 버전 생성`)으로 기존 버전을 기반으로 새 버전을 만들고 배포합니다. 새 버전이 정상 배포되면 해당 카드의 `운영 버전으로 변경`을 눌러 결재를 신청하고, 승인되면 실제 서비스되는 운영 버전이 새 버전으로 교체됩니다.

### 이용 로그·피드백 확인 후 다운로드

상세 > 채팅 이용 탭에서 세션 목록을 확인하고, 행을 클릭해 대화 내용과 피드백(긍정·부정)을 확인합니다. 필요한 세션을 다중 선택해 `채팅 다운로드`로 CSV를 내려받습니다.

### 특정 대상에게만 채팅 앱 공유하기

상세 > `공유` → 공유 현황 탭에서 `+ 공유 대상 추가` → 대상(사용자·관리 그룹·역할) 선택 후 `사용` 또는 `사용·관리` 권한 지정 → 완료. 공유 신청이 결재를 거쳐 승인되면 대상이 채팅 앱을 이용할 수 있습니다.

## 관련 문서

* [채팅 애플리케이션 만들기](/default/v1.9.2/basic-tutorials/guides/application/dev-chat.md)
* [SST/TTS 활용하기](/default/v1.9.2/basic-tutorials/guides/application/dev-chat/sst-tts.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://genos-docs.gitbook.io/default/v1.9.2/basic-tutorials/guides/application/dev-chat/chat-app-multi-deploy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.