> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ko/ai-assistant/chat.md).

# 채팅 기능

이 문서에서는 채팅 기능(AI 어시스턴트)을 설명합니다. 채팅 기능은 워크스페이스 관련 질문에 대한 답변, 사양서 생성, 테스트 케이스 작성 등 QA 업무를 지원하는 대화형 AI 기능입니다. 연결한 리소스(코드베이스·사양서)를 컨텍스트로 참조하면서 자연어로 대화할 수 있습니다.

## 채팅 시작하기

1. 대상 워크스페이스를 여십시오.
2. 페이지 헤더의 **Genesis에게 질문**을 클릭하십시오.
   * 워크플로 에디터에서는 **Genesis에게 질문** 대신 **워크플로우 빌더**를 클릭하십시오.
   * 모바일에서는 채팅이 전체 화면 오버레이로 열립니다.

<figure><img src="/files/lMu8LixxqKtoX7uZ3wnh" alt="Genesis에게 질문 사이드 패널 스크린샷"><figcaption><p>Genesis에게 질문 사이드 패널</p></figcaption></figure>

3. 패널 하단의 입력란에 질문이나 지시를 입력하십시오.
4. **Enter** 키를 누르거나 보내기 아이콘을 클릭하십시오.

{% hint style="success" %}
줄을 바꾸려면 **Shift+Enter** 키를 사용하십시오.
{% endhint %}

5. AI가 실시간으로 답변을 생성합니다. 답변 생성 중에 중지하려면 중지 아이콘을 클릭하십시오.

<figure><img src="/files/JaIysgI4vj8Vz1oFEBn6" alt="채팅에서 스트리밍되는 AI 응답 스크린샷"><figcaption><p>채팅에서 스트리밍되는 AI 응답</p></figcaption></figure>

{% hint style="info" %}
리소스(코드베이스·사양서)를 워크스페이스에 연결하지 않은 경우, AI는 일반적인 지식만으로 답변합니다. 컨텍스트를 고려한 답변을 얻으려면 미리 리소스를 연결하십시오.
{% endhint %}

## 페이지 컨텍스트 사용하기

워크스페이스 안의 페이지에서 채팅을 열면, 현재 보고 있는 페이지를 컨텍스트로 자동 포함할 수 있습니다.

* 파일, 워크플로 템플릿, 워크플로 실행, 스페이스 등의 페이지에서는 입력란 위에 컨텍스트 칩이 표시됩니다.
* 그대로 메시지를 보내면 AI는 해당 페이지를 고려하여 답변합니다.
* 현재 페이지를 컨텍스트에 포함하지 않으려면 칩의 **x**를 클릭하십시오.

## 파일 참조하기

채팅 입력란에서 파일을 참조하면 AI에게 워크스페이스 안의 특정 문서나 파일을 읽게 할 수 있습니다.

1. 입력란 아래의 **파일 추가**를 클릭하거나, 입력란에 `@`를 입력하십시오. 파일 선택기가 표시됩니다.
2. 참조할 파일을 키워드로 검색하거나 목록에서 선택하십시오.
3. 특정 버전을 지정하려면 입력란에서 `@`를 입력하고 파일 이름 옆의 메뉴에서 대상 버전을 선택하십시오.
4. 선택한 파일에 대한 참조가 입력란에 삽입됩니다.
5. 이어서 메시지를 입력하고 보내십시오.

{% hint style="success" %}
워크스페이스에 아직 업로드하지 않은 파일을 참조하려면 파일 선택기에서 **파일 업로드**를 선택하여 새로 업로드할 수 있습니다.
{% endhint %}

<figure><img src="/files/pDq78L1SpaisDg3hcDsO" alt="입력란에 표시되는 파일 선택기 스크린샷"><figcaption><p>입력란에 표시되는 파일 선택기</p></figcaption></figure>

## 스킬 사용하기

스킬은 워크스페이스에 업로드한 `SKILL.md` 파일, 연결한 코드베이스에서 찾아낸 스킬, 또는 Genesis가 워크스페이스에 기본 제공하는 내장 스킬로 이루어진 재사용 가능한 지시 세트입니다. 특정 진행 방식으로 AI에게 작업을 시키고 싶을 때 삽입합니다.

1. 입력란 아래의 **스킬 추가**를 클릭하거나, 입력란에서 새 토큰의 시작에 `/`를 입력하십시오.
2. 사용할 스킬을 검색하십시오.
3. 목록에서 스킬을 선택하십시오.
4. 입력란에 `/skill-name`으로 삽입됩니다.
5. 이어서 메시지를 입력하고 보내십시오.

{% hint style="info" %}
워크스페이스의 스킬 모드가 **자동**인 경우, AI가 관련 스킬을 자동으로 선택할 수도 있습니다. `/skill-name`을 명시하면 해당 메시지에는 항상 그 스킬이 적용됩니다.
{% endhint %}

모든 워크스페이스에는 `/xlsx-processing`, `/pdf-processing`, `/docx-reports`, `/pptx-processing` 같은 내장 스킬도 기본으로 포함됩니다. Office 파일 처리나 보고서 작성을 별도 설정 없이 바로 시작할 수 있습니다.

## AI 모델 전환하기

용도에 따라 AI 모델을 전환할 수 있습니다. 사용 가능한 모델의 종류와 특징은 [AI 모델](/features-ko/ai-feature/ai-models.md) 참조.

1. 입력란 왼쪽 아래에 있는 모델 선택 메뉴를 클릭하십시오.
2. 사용할 AI 모델을 선택하십시오.

<figure><img src="/files/6fGyrOWHE8JMOt3Nuosb" alt="입력란의 모델 선택기 스크린샷"><figcaption><p>입력란의 모델 선택기</p></figcaption></figure>

## AI 응답 확인하기

### 텍스트 응답

AI의 답변은 마크다운 형식으로 렌더링됩니다. 코드 블록·목록·표·제목 등이 적절하게 표시됩니다. 매니지드 크레딧을 사용하는 조직에서는 응답이 완료되면 해당 응답에 사용된 **크레딧**도 푸터에 표시됩니다.

### 추론 블록

추론 모델은 답변을 생성하기 전에 내부적으로 단계적인 사고 과정을 실행합니다. 이 사고 과정은 **추론** 블록으로 접힌 상태로 표시됩니다.

* **추론** 블록을 클릭하면 AI의 사고 과정 세부 내용을 펼쳐서 확인할 수 있습니다.
* 사고에 걸린 시간이 블록 안에 표시됩니다.

### 도구 실행

AI가 코드베이스 탐색·파일 읽기·지식 베이스 검색·외부 서비스 연동 등의 도구를 사용하는 경우, 그 실행 상황이 카드로 표시됩니다.

* 카드에는 사용한 도구 이름과 실행 상태가 표시됩니다.
* 카드를 클릭하면 입력 파라미터와 출력 결과의 세부 내용을 펼쳐서 확인할 수 있습니다.
* 사용 가능한 도구의 종류는 [도구](/features-ko/ai-feature/tools.md) 참조.

### 컨텍스트 요약

긴 대화가 컨텍스트 상한에 가까워지면 AI는 자동으로 과거 메시지를 요약합니다. 요약이 이루어진 부분에는 배너가 표시됩니다.

{% hint style="info" %}
요약이 이루어지면 요약 이전 메시지의 세부 내용은 AI가 참조하지 않게 됩니다. 중요한 내용은 필요에 따라 다시 입력해 주십시오.
{% endhint %}

## 채팅 기록 관리하기

{% hint style="info" %}
채팅 기록은 본인만 열람할 수 있습니다. 같은 워크스페이스의 다른 구성원과는 공유되지 않습니다.
{% endhint %}

### 새 채팅 시작하기

채팅 패널 헤더의 **새 채팅**을 클릭하면 새 채팅이 생성됩니다.

### 지난 채팅 참조하기

채팅 패널 헤더의 **채팅 기록**을 클릭한 다음, 열고 싶은 대화를 선택하십시오.

## 문제 해결

### 사용 한도 오류

| 오류 메시지                               | 원인                | 해결 방법                                                                      |
| ------------------------------------ | ----------------- | -------------------------------------------------------------------------- |
| 사용 한도에 도달했습니다. 한도 상향은 관리자에게 문의해 주세요. | 조직의 AI 사용 한도에 도달함 | **조직 소유자**에게 사용 한도 상향을 문의하십시오. 상향 작업 자체는 소유자 또는 관리자가 Autify 지원팀에 요청해 주십시오. |

### AI 제공자 미설정 오류

| 오류 메시지                                            | 원인                     | 해결 방법                                                                                                 |
| ------------------------------------------------- | ---------------------- | ----------------------------------------------------------------------------------------------------- |
| AI 제공자가 설정되지 않았습니다. 설정 > AI 제공자에서 API 키를 설정해 주세요. | AI 제공자의 API 키가 설정되지 않음 | 클라우드 버전의 경우 Autify 지원팀에 문의하십시오. 온프레미스 버전의 경우 자사 서버 관리자에게 연락하십시오. AI 제공자를 설정할 수 있는 사람은 **조직 소유자**뿐입니다. |