> 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/spaces/about-spaces.md).

# 스페이스 개요

스페이스는 테스트 케이스·기능 목록·시나리오 등의 구조화된 QA 데이터를 유형이 지정된 테이블로 관리하는 워크스페이스 탭입니다.

{% hint style="info" %}
이 기능은 일부 고객부터 순차적으로 공개되고 있습니다.
{% endhint %}

## 개요

QA 팀이 테스트 설계 작업을 협업할 때, 테스트 케이스 목록·상태·리뷰 현황 등을 기록하고 추적하기 위한 공유된 구조화 공간이 필요합니다. 스페이스는 Genesis 내에서 그 역할을 담당하며, AI 어시스턴트 및 워크플로와 함께 구조화된 데이터를 AI 기반 작업과 가까운 곳에서 관리할 수 있게 합니다.

스페이스는 하나 이상의 **컬렉션**(유형이 지정된 테이블)을 담는 컨테이너입니다. 각 행은 하나의 레코드(예: 테스트 케이스)를 나타내며, 행이 가지는 컬럼을 정의하고 하위 컬렉션을 사용하여 행 아래에 추가 데이터를 중첩할 수 있습니다.

## 주요 개념

### 스페이스

스페이스는 스페이스 탭 내의 최상위 컨테이너입니다. 워크스페이스 안에 여러 스페이스를 만들 수 있으며, 제품 영역·테스트 단계·용도 등으로 구분하여 관리할 수 있습니다.

### 컬렉션

컬렉션은 스페이스 안의 유형이 지정된 테이블입니다. 각 스페이스에는 최소 하나의 컬렉션이 있습니다. 같은 스페이스에 컬렉션을 추가하여 서로 다른 종류의 데이터를 저장할 수 있습니다(예: "결제 흐름" 스페이스에 테스트 케이스용과 알려진 버그용 컬렉션을 각각 만들기).

### 행

행은 컬렉션 안의 하나의 레코드입니다. 각 행은 컬렉션의 **스키마**에서 정의한 필드 값을 가집니다. 행을 열면 세부 보기에서 모든 필드를 확인하고 편집할 수 있으며, 저장할 때마다 행 기록에 새 버전이 생성됩니다.

### 하위 컬렉션

하위 컬렉션은 상위 컬렉션의 각 행 아래에 중첩된 테이블입니다. 스키마에 **하위 컬렉션** 필드를 추가하면 만들어집니다. 예를 들어 "테스트 스위트" 컬렉션에 "테스트 케이스" 하위 컬렉션 필드를 추가하면 각 테스트 스위트 행이 자체 테스트 케이스 테이블을 가지고, 각 테스트 케이스 행이 "테스트 실행" 하위 컬렉션을 가지는 구성도 가능합니다.

## 필드 유형

컬렉션의 각 컬럼에는 다음 유형 중 하나를 설정할 수 있습니다.

| 유형          | 설명                      |
| ----------- | ----------------------- |
| **텍스트**     | 한 줄 텍스트                 |
| **긴 텍스트**   | 여러 줄 텍스트                |
| **URL**     | URL 문자열                 |
| **숫자**      | 숫자 값                    |
| **예 / 아니오** | 불리언 체크박스                |
| **날짜**      | 날짜                      |
| **선택**      | 사용자 정의 옵션의 드롭다운(단일 선택)  |
| **하위 컬렉션**  | 중첩된 행 테이블(위의 하위 컬렉션 참고) |

## 기본 제공 템플릿

새 스페이스를 만들 때 네 가지 기본 제공 템플릿 중에서 선택하거나 빈 상태로 시작할 수 있습니다.

| 템플릿         | 설명                                               |
| ----------- | ------------------------------------------------ |
| **테스트 케이스** | 제목·설명·단계·예상 결과·우선순위·상태 필드를 포함한 테스트 케이스 목록        |
| **테스트 스위트** | 테스트 스위트 → 테스트 케이스 → 테스트 실행의 3단계 계층 구조(모두 하위 컬렉션) |
| **기능 목록**   | 제목·요약·상태 필드를 포함한 간단한 기능 추적기                      |
| **비어 있음**   | 제목 필드만 있음. 스키마를 처음부터 구성합니다                       |

## 스키마 편집

컬렉션의 컬럼은 언제든지 스키마를 편집하여 사용자 지정할 수 있습니다. 컬렉션에서 **열 편집**(연필 아이콘)을 선택하면 스키마 편집기가 열리며, 필드 추가·이름 변경·순서 변경·유형 변경·보관이 가능합니다. 보관한 필드는 테이블과 양식에서 숨겨지지만 데이터는 유지됩니다.

## 행 기록

행을 저장할 때마다 새 버전이 자동으로 기록됩니다. 행을 열고 **기록** 탭으로 전환하면 이전 버전을 확인하고 값을 비교할 수 있습니다. 이전 버전으로 복원하여 변경 사항을 되돌릴 수도 있습니다.

## AI 어시스턴트 및 워크플로 연동

스페이스는 AI가 읽고 쓸 수 있습니다. AI 어시스턴트는 대화 중에 스페이스의 행을 검색하고 내용을 보고할 수 있습니다. 워크플로는 스페이스 데이터를 읽고 쓰기 위한 다음 기본 제공 도구를 사용할 수 있습니다.

| 도구        | 기능                                     |
| --------- | -------------------------------------- |
| 스페이스 목록   | 현재 워크스페이스의 모든 스페이스를 반환합니다              |
| 컬렉션 목록    | 스페이스 아래의 컬렉션 또는 행 아래의 하위 컬렉션을 나열합니다    |
| 스키마 가져오기  | 컬렉션의 현재 컬럼 정의를 반환합니다                   |
| 행 목록      | 컬렉션의 행을 제목과 마지막 업데이트 시간과 함께 나열합니다      |
| 검색        | 스페이스 전체 또는 워크스페이스 전체의 행을 전문 검색합니다      |
| 행 가져오기    | 단일 행의 모든 필드 값을 반환합니다                   |
| 행 만들기     | 컬렉션에 새 행을 추가합니다                        |
| 행 업데이트    | 기존 행의 필드 값을 업데이트합니다(병합 또는 덮어쓰기)        |
| 스페이스 만들기  | 새 스페이스와 첫 번째 컬렉션을 만듭니다                 |
| 컬렉션 만들기   | 스페이스에 최상위 컬렉션을 추가합니다                   |
| 하위 컬렉션 열기 | 행의 하위 컬렉션 필드에 해당하는 테이블을 열고 그 ID를 반환합니다 |

예를 들어 리소스 및 컨텍스트에서 사양을 읽어 테스트 케이스를 생성하고, 스페이스 컬렉션에 직접 기록하는 워크플로를 실행할 수 있습니다.

## 참고 자료

* [스페이스 및 컬렉션 관리](/features-ko/spaces/manage-spaces.md)
* [행 관리](/features-ko/spaces/manage-rows.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://help.genesis.autify.com/features-ko/spaces/about-spaces.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.