> 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` 파일이나 연결한 코드베이스에서 찾아낸 재사용 가능한 지시 세트입니다. 특정 진행 방식으로 AI에게 작업을 시키고 싶을 때 삽입합니다.

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

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

## 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 제공자를 설정할 수 있는 사람은 **조직 소유자**뿐입니다. |


---

# 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://help.genesis.autify.com/features-ko/ai-assistant/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.