> 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.8.7/basic-tutorials/guides/application/dev-chat.md).

# 채팅 앱 만들기

### 채팅 앱 생성

* 앱 > 채팅 앱 메뉴에서 '채팅 앱 생성' 버튼을 눌러 생성을 시작합니다.

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

***

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

* **기본 정보**
  * 채팅 앱 이름(필수): 사용자 화면에도 동일하게 보여지는 채팅 앱의 이름입니다.
  * 상세 설명 : 사용자 화면에도 동일하게 보여지는 채팅 앱의 상세 설명입니다.
  * 관리 그룹(필수) : 생성하는 채팅 앱의 관리 그룹을 설정합니다.
  * 채팅 앱 '사용'권한(필수)
    * '모든 사용자 바로 사용'과 '지정한 대상만 사용' 중 선택합니다.
    * '지정한 대상만 사용'은 사용자, 관리 그룹, 역할을 선택하며 아무도 지정하지 않으면 '나'만 사용할 수 있는 채팅이 됩니다.
    * 채팅 생성 후에도 '사용' 권한을 제공할 사용자 추가 및 제거할 수 있습니다.
  * 프로필 사진 : 직접 사진을 업로드할 수 있습니다. (80×80px, 1MB, JPG 또는 PNG)
  * 인사말(필수) : 채팅 앱 사용 시 가장 먼저 보여지는 텍스트입니다.
  * 테마(필수) : 챗봇형과 문서형 중 하나를 선택할 수 있습니다.
  * 워크플로우(필수) : 채팅 앱에 연결할 워크플로우를 선택합니다.
  * CoT 태그 : 열림 태그 / 닫힘 태그 쌍을 등록합니다.
* **인터랙션**
  * 예시 질문(선택) : 제공 선택 시 예시 질문을 최대 6개까지 추가할 수 있으며, '예시 질문으로 채팅 시작하기'를 켜면 사용자가 예시 질문 중에서만 대화를 시작할 수 있습니다.
  * 부정 피드백 수집(선택) : 사용자가 답변에 thumbs down(부정)을 눌렀을 때 피드백을 받는 방식을 설정합니다. '사용자 직접 입력'은 주관식으로 받고, '선택지 제공'은 선택지 목록 중에서 고르게 합니다. 선택지 목록은 기본 2개, 최대 10개까지 추가할 수 있습니다.
  * 음성 입/출력(선택) : STT(음성으로 메시지 입력) / TTS(음성으로 답변 듣기) / TTS 스트리밍(실시간 음성으로 답변 듣기) 사용 여부를 설정합니다.
* **운영 정책**
  * 토큰 크레딧 배수 (필수)
  * 추가 크레딧
* **메모** : 추가 메모가 있을 경우 입력합니다.

***

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

* 생성 버튼을 클릭하면 위와 같은 재확인을 진행합니다.
* 배포까지 한번에 진행하기를 클릭하면 배포 신청까지 자동으로 진행합니다.

***

### 채팅 앱 상세 화면

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

* 채팅 리스트에서 생성한 채팅을 더블 클릭하면 **채팅 앱의 상세 화면**으로 이동합니다.
* 운영 정보 탭
  * 채팅 앱 '사용'권한 : 생성 할 때 설정한 채팅 앱의 '사용' 권한 설정값이 표시됩니다. 수정(전용 채팅 앱으로 생성한 경우 보기) 버튼을 누르면 '사용' 권한 사이드 패널이 열립니다.
  * 운영 현황 카드 : 운영 버전의 정보를 보여줍니다. (채팅 앱 생성 시 초기 버전이 자동으로 운영 버전이 됩니다.)
    * 운영 상태 : 미배포 / 정상 / 배포 중지
      * **신청 상태** : 없을 경우 표시되지 않습니다.
      * **운영 신청자, 운영 시작일**
      * **세션 수** : 미배포 버전은 - 로 표시되고, 실제 사용자 세션만 집계되어 채팅 앱 테스트는 포함되지 않습니다.
      * 운영 버전의 운영 상태와 신청 상태에 따라 **운영 버전 변경 버튼**(배포/배포 취소/배포 중지/배포 중지 취소)이 표시됩니다.
      * **테스트 버튼** : 정상 상태에서만 보여지는 버튼입니다. 실제 채팅과 동일한 환경에서 테스트하며, 테스트 대화는 세션 수에 포함되지 않고 채팅 내용은 '채팅 이용' 탭에서 확인할 수 있습니다.
      * **새 버전 생성 버튼** : 채팅 앱을 처음 만들면 첫 버전이 함께 생성되고, 이후에는 기존 버전을 기반으로 새 버전 생성을 통해 버전을 추가합니다.
        * 새 버전은 기존 버전의 설정값을 그대로 복사해 시작하며, 각 버전은 독립적으로 배포·관리됩니다.
        * 기존 버전의 설정을 바로 수정할 수는 없으므로, 프로필·인터랙션·운영 정책 등 설정을 바꾸려면 새 버전 생성으로 새 버전을 만들어 진행해야 합니다.
      * **채팅 앱 설정값** : 해당 버전의 기본 정보, 인터랙션, 운영 정책 설정값을 읽기 전용으로 펼쳐 볼 수 있습니다.

***

### 채팅 앱 배포하기

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

* 배포 버튼을 눌러 채팅 앱의 배포를 신청합니다.

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

* 승인자의 승인이 완료 되면 배포상태가 정상으로 바뀌게됩니다.

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

* 해당 채팅 앱의 모든 버전은 **버전 정보 탭**에서 확인할 수 있습니다.
  * 버전 생성 : 가장 최근에 생성된 버전을 기본값으로 새로운 버전을 생성합니다.
  * 운영 버전으로 변경 : 한 채팅 앱에 여러 버전이 배포 상태로 존재할 수 있고, 그중 실제 사용자에게 서비스되는 '운영 버전'을 다른 버전으로 교체하는 것입니다.
  * 버전 카드를 클릭하면 버전 상세 사이드패널이 열립니다. 해당하는 버전의 상세 정보를 확인할 수 있습니다.
  * 배포, 배포 중지, 운영 버전 변경은 승인이 완료된 후 적용됩니다.

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

* 운영 버전이 정상 상태가 되면 사용자 화면에서 채팅 앱을 사용할 수 있습니다.
* 운영 버전이 배포 중지 상태가 되면 사용자 화면에 해당 채팅 앱이 표시되지 않습니다.

***

### 채팅 관리 - 채팅 이용

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

* 채팅 이용 탭으로 이동하면 채팅의 이용 로그를 확인할 수 있습니다.
* 상세 정보를 보고싶은 행을 클릭하면 해당 세션에서 발생한 대화와 피드백을 확인할 수 있습니다.
* 필요한 대화를 선택해서 CSV로 다운로드할 수 있습니다.

***

### 채팅 앱 공유 (사용, 사용 · 관리)

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

* 상단 '공유' 버튼에서 사용 또는 사용·관리 권한으로 대상에게 채팅 앱을 공유하고 관리할 수 있습니다.

***


---

# 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.8.7/basic-tutorials/guides/application/dev-chat.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.