# Archisketch AI Agent

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

#### 👋 Archisketch AI Agent를 만나보세요!

> Archisketch AI Agent가 인테리어 디자인 작업을 도와드립니다.

***

## Archisketch AI란?

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

**Archisketch AI**는 아키스케치 내부에서 사용할 수 있는 AI 에이전트 기능입니다. 채팅창에 원하는 것을 입력하기만 하면, AI가 공간 분석, 아이디어 제안, 이미지 생성, 포트폴리오 작성 등 다양한 작업을 도와줍니다.

{% hint style="info" %}
Archisketch AI Agent는 현재 베타 버전으로 제공되고 있습니다.

<mark style="color:$info;">일부 기능이 불안정하거나 예상과 다르게 동작할 수 있으며, 서비스 개선 과정에서 기능과 정책이 변경될 수 있습니다.</mark>
{% endhint %}

***

## ✨ 주요 기능

현재 Archisketch AI는 **Basic Mode**와 **Expert Mode** 두 가지 모드로 제공됩니다. Basic Mode는 인테리어 탐색 초기 단계에, Expert Mode는 도면 분석부터 가구 배치, 연출 이미지 생성, 포트폴리오 작성까지 실제 디자인 작업 전 과정에서 활용할 수 있습니다.

### <mark style="background-color:$success;">Part 1. Basic Mode</mark>

**주요 기능**

* **도면 검색 및 3D 이미지 생성** : 실제 도면 기반으로 이미지를 생성할 수 있어요.
* **인테리어 가견적 생성** : 도면 기준 인테리어 비용의 대략적인 가견적을 생성할 수 있어요.
* **인테리어 스타일 상담** : 공간 구성 아이디어와 방향을 제안해요.

#### 1. 우리 집 주소로 도면 검색

주소를 입력하면 해당 주거 공간에 맞는 도면을 검색하고, 유사한 도면을 추천해 드립니다.

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

**요청 예시**

* "서울시 마포구 OO아파트 84㎡ 도면 찾아줘."
* "우리 집 주소 기반으로 유사한 도면 추천해줘"

**유의사항**

* 검색된 도면은 실제 주거 공간과 다를 수 있습니다. AI가 불러온 도면이 정확한지 반드시 확인 후 사용해 주세요.
* 원하는 도면을 찾지 못하셨나요? 도면 제작을 원하시면 아키스케치에 문의해 주세요.

#### 2. 우리 집 기반 3D 이미지 생성

도면 검색 결과를 바탕으로 인테리어 이미지를 생성합니다. 원하는 스타일이나 분위기를 함께 알려주면 더 정확한 이미지를 얻을 수 있습니다.

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

**요청 예시**

* "이 도면으로 북유럽 스타일 거실 이미지 만들어줘."
* "밝고 따뜻한 느낌의 인테리어 이미지로 만들어줘."

**유의사항**

* AI가 생성하는 이미지로 왜곡이 발생할 수 있으니 유의해 주세요.

#### 3. 인테리어 가견적

도면과 이미지를 기반으로 인테리어 비용의 대략적인 가견적을 제공합니다.

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

**요청 예시**

* "이 공간 인테리어하면 얼마 정도 들어?"
* "이 도면 기준으로 가견적 내줘."

**유의사항**

* 가견적은 참고용 정보이며, 실제 시공 비용과는 차이가 있을 수 있습니다.

#### 4. 인테리어 스타일 상담

원하는 스타일이나 취향을 이야기하면 공간 구성 아이디어와 방향을 제안해 드립니다.

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

**요청 예시**

* "20평대 거실을 카페 분위기로 꾸미고 싶어. 어떻게 하면 좋을까?"
* "미니멀하면서도 따뜻한 느낌의 침실을 만들고 싶은데 어떤 포인트가 중요할까?

***

### <mark style="background-color:blue;">Part 2. Expert Mode</mark>

**주요 기능**

* **AI 스냅샷 촬영**: 최적의 구도를 찾아 고화질 이미지를 생성해요.
* **포트폴리오 마스터**: 프로젝트 설명글과 마케팅 콘텐츠를 자동으로 작성해요.
* **스마트 견적서**: 대화 한 번으로 견적서를 PDF로 즉시 내려받습니다.
* **공간 분석 리포트**: 디자인 스타일과 색상 구성을 전문가처럼 분석해 드려요.
* **간편 저장 및 내보내기**: 작업 결과를 안전하게 저장하고 외부로 공유해요.

#### 1. AI 스냅샷 촬영

현재 프로젝트 공간을 바탕으로 AI가 자동으로 적절한 카메라 구도를 선정하여 고화질 연출 이미지를 생성하는 기능입니다. 기존 렌더링 대비 장점은 카메라 각도 자동 추천, 빠른 이미지 생성, 감성 연출 최적화가 있어요.

**사용 방법:**

1. AI 채팅창에 촬영 요청을 입력해 주세요.
2. 원하는 분위기, 시간대, 스타일을 함께 설명해요.
3. 생성된 이미지를 확인해 보세요.

**요청 예시**

* 👍 **좋은 예**: "거실 공간을 따뜻한 저녁 분위기로 연출해줘.", "간접 조명이 켜진 아늑한 느낌으로 표현해줘."
* 👎 **비추천 예**: "예쁘게 만들어줘." (구체적인 분위기나 조명, 목적을 명시하는 것이 좋습니다.)

**유의사항**

* 현재는 AI가 추천한 카메라 뷰 기준으로 촬영돼요.
* 동일한 요청이라도 결과는 달라질 수 있으며, 실제 시공 사진이 아닌 연출용 이미지입니다.
* AI 스냅샷은 유료 포인트를 차감하고 사용되는 기능입니다. 현재 Archisketch AI Agent에서 채팅으로 요청 시 무료로 제공되나, 향후 가격 정책이 변경될 수 있습니다.

#### 2. 도면 기반 가구 일괄 배치

원하는 인테리어 스타일을 텍스트로 설명하거나 이미지를 첨부하면, AI가 빈 도면의 구조를 분석하여 취향을 반영한 가구 배치 시안을 도출합니다.

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

**요청 예시**

* "카페 같은 거실 만들어줘."
* "따뜻하고 아늑한 느낌의 침실로 가구 배치해줘."
* "미니멀 스타일 거실 배치 만들어줘."

**유의사항**

* 가구 일괄 배치는 도면 분석과 배치 계산을 동시에 처리하는 작업으로, 완료까지 다소 시간이 걸릴 수 있어요. 작업 중 화면을 유지한 채 잠시 기다려 주세요.
* 배치 결과에 오류가 포함되거나 의도와 다르게 표현될 수 있으며, 함께 생성되는 견적 정보도 참고용으로만 활용하시기 바랍니다.

#### 3. 도면 기반 적합한 가구 추천

현재 설계 중인 공간을 다각도로 분석하고, 공간의 구조와 사용자의 취향에 맞는 가구를 엄선하여 추천합니다.

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

**요청 예시**

* "이 거실에 어울리는 소파 추천해줘."
* "북유럽 스타일에 맞는 가구 조합 추천해줘."

**유의사항**

* 추천 결과는 AI가 자동으로 생성한 제안이며, 실제 공간과 완벽하게 맞지 않을 수 있어요.
* 추천된 제품 중 일부는 판매 중단되었거나 정보가 부정확할 수 있으므로, 실제 구매 전 확인이 필요해요.

#### 4. 참조 기반 타겟 작업

에디터 화면에서 원하는 가구 또는 방 바닥을 클릭하면 채팅 입력창에 참조 버튼이 나타납니다. 이 버튼을 눌러 참조를 설정한 뒤 요청하면, AI가 해당 가구나 공간만을 기준으로 작업을 수행합니다.

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

**1️⃣ 방을 참조한 경우** — 선택한 방의 구조에 집중하여 가구 추천과 배치를 실행합니다. 해당 공간의 공간감을 극대화할 수 있는 카메라 뷰를 추천받거나, 해당 방에만 제품이 배치될 수 있도록 요청해 보세요.

**2️⃣ 가구를 참조한 경우** — 전체 배치는 유지한 채 해당 가구만 교체합니다. 기존 가구의 위치와 크기를 고려하여 원하는 스타일에 맞는 제품을 추천하고, 해당 위치에 즉시 교체(Swap)할 수 있어요.

**요청 예시**

* *<mark style="color:$info;">(안방 바닥 클릭 후 참조)</mark>* "이 방에 가구 배치해줘."
* *<mark style="color:$info;">(안방 바닥 클릭 후 참조)</mark>* "이 공간에 맞는 가구 추천해줘."
* *<mark style="color:$info;">(소파 클릭 후 참조)</mark>* "이 소파를 모던한 1인 소파로 바꿔줘."
* <mark style="color:$info;">(테이블 클릭 후 참조)</mark> "이 테이블을 원형 테이블로 교체해줘."

**유의사항**

* 방을 참조할 때 해당 공간의 타입이 올바르게 설정되어 있어야 AI가 공간의 특성을 정확히 이해하고 더 적합한 결과를 제공할 확률이 높아요.
* 작업 전에 에디터에서 해당 방의 공간 타입이 None이 아닌 침실, 거실, 주방 등 적절한 타입으로 설정해주는 것을 권장해요.

#### 5. AI 지능형 Planning

사용자의 요청을 분석하여 최적의 작업 계획안을 먼저 도출합니다. 정보가 부족한 경우 AI가 추가 질문을 통해 계획을 다듬고, 사용자가 코멘트를 남겨 세부 조율한 뒤 '실행' 버튼 하나로 모든 작업을 자동 진행해요.

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

**사용 방법**

* 채팅 입력창의 **계획** 토글 버튼을 켠 뒤 요청하면 AI가 작업을 바로 실행하는 대신 최적의 작업 계획안을 먼저 도출합니다.
* 계획안은 단락별로 구성되며, 각 단락에 직접 코멘트를 달아 수정을 요청할 수 있습니다.
* 검토가 끝난 뒤 **실행 시작** 버튼을 누르면 모든 작업이 중단 없이 자동으로 진행됩니다.

**요청 예시**

* *<mark style="color:$info;">(계획 토글 켜고)</mark>* "이 공간 전체를 모던 스타일로 바꿔줘."
* *<mark style="color:$info;">(계획 토글 켜고)</mark> "*&#xCE68;실과 거실을 통일된 분위기로 꾸며줘."

**유의사항**

* 계획 수립부터 실행까지 처리해야 할 작업량이 많아 완료까지 상당한 시간이 걸릴 수 있어요. 실행 중에는 화면을 유지한 채 기다려 주세요.

#### 6. 포트폴리오 조회 / 작성 / 수정

완성된 공간을 소개하는 글이나 마케팅 콘텐츠 초안을 AI가 자동으로 작성해 드립니다. 생성한 3D 인테리어 프로젝트 설명을 마케팅 콘텐츠나 고객 제안용으로 자유롭게 활용할 수 있어요.

목적, 컨셉, 강조하고 싶은 포인트, 원하는 톤앤매너를 알려주면 자동으로 생성을 시작합니다.

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

**사용 방법**

1. 프로젝트를 기반으로 작성을 요청하세요.
2. 목적과 톤앤매너, 강조하고 싶은 포인트를 함께 입력해요.
3. 생성된 초안을 확인하고 필요한 경우 추가 수정을 요청해 보세요. 직접 수정도 가능해요.

**요청 예시**

* 🕴 고객 제안용: "이 프로젝트를 고객 설명용 포트폴리오 글로 작성해줘. 아늑한 거실 중심의 공간 구성이라는 점을 강조하고, 친절하고 이해하기 쉬운 톤으로 써줘."
* 💬 마케팅 콘텐츠용: "이 공간을 SNS 홍보용 콘텐츠로 작성해줘. 카페 같은 분위기와 감각적인 조명을 강조해서 트렌디하고 감성적인 톤으로 만들어줘."
* ✏️ 수정 요청 예시: "조금 더 전문적인 톤으로 수정해줘.", "길이를 절반으로 줄여줘."

**유의사항**

* AI가 자동으로 생성한 초안이므로 최종 사용 전 검토를 권장해요.
* AI 생성물 특성 상 동일한 요청에도 표현 방식은 달라질 수 있어요.

#### 7. 견적서 PDF 다운로드

기존 실시간 견적 기능을 기반으로 프로젝트 견적서를 PDF 파일로 간편하게 다운로드할 수 있어요.

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

**사용 방법**

1. 프로젝트를 선택해요.
2. 채팅창에 "PDF 다운로드"를 요청하세요.
3. 생성된 PDF 파일을 다운로드해요.

**요청 예시**

* "이 프로젝트 견적서를 PDF로 다운로드해줘."
* 견적서 PDF로 다운로드해줘

**유의사항**

* 견적 가격은 참고용이며, 실제 구매 및 시공 비용과는 차이가 있을 수 있어요.
* 일부 제품의 가격 데이터가 부정확할 수 있어요.

#### 8. 공간 분석

디자인 전문 지식이 없어도 현재 공간의 특징을 객관적으로 파악할 수 있도록 스타일, 색상 구성, 가구 특성, 분위기 등을 분석해 정리해 드려요. 현재 작업 중인 공간의 스타일과 분위기를 분석하고, 더 발전시킬 수 있는 아이디어를 제안해 드립니다.

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

**사용 방법**

* 프로젝트가 열린 상태에서 분석을 요청하세요. 원하는 분석 방향을 함께 입력하실 수 있어요.

**요청 예시**

* "이 공간이 어떤 인테리어 스타일인지 분석해줘."
* "현재 디자인의 색상 구성과 분위기 특징을 정리해줘."

**제공 정보**

* 주요 색상 팔레트, 가구 스타일 특성, 공간 분위기, 디자인 포인트, 개선 아이디어 제안 등

**유의사항**

* AI 분석 결과는 참고용이며, 전문가의 디자인 검토를 완전히 대체하지는 않습니다.

#### 9. 프로젝트 저장 및 내보내기

AI 작업 결과가 반영된 프로젝트를 저장하거나 외부 파일 형태로 내보낼 수 있어요.

* 사용 방법:

1️⃣ 작업 완료 후 저장을 요청하세요.

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

2️⃣ 지원되는 형식 중 원하는 파일 형식을 지정해요.

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

3️⃣ 다운로드를 진행해 주세요.

**요청 예시**

* "현재 작업 내용을 저장해줘.", "이 프로젝트를 내보내기 해줘."

**유의사항**

* 저장 전 내용을 다시 한번 확인해 주시기 바랍니다.
* 일부 외부 포맷의 경우 변환 과정에서 미세한 차이가 발생할 수 있어요.

***

## ℹ️ 참고사항

#### 서비스 정책

* Archisketch AI는 서비스 개선 및 기술 발전에 따라 일부 기능이 변경되거나 업데이트될 수 있어요.
* 일부 기능은 베타 기능으로 제공될 수 있으며, 사용 과정에서 결과 품질이나 동작 방식이 달라질 수 있어요.
* 기능, 사용 방식, 가격 정책 등의 변경 사항은 서비스 공지 또는 업데이트 안내를 통해 사전에 안내드려요.

{% hint style="info" icon="q" %}
**자주 묻는 질문 (FAQ)**
{% endhint %}

**Q. Archisketch AI는 어떤 기능을 하는 서비스인가요?**

채팅으로 자연어를 입력하면 공간 분석, 아이디어 제안, 연출 이미지 생성, 포트폴리오 작성, 견적 조회 등 인테리어 디자인 작업 전반을 도와주는 AI 에이전트입니다.

**Q. AI 스냅샷은 기존 렌더 이미지와 무엇이 다른가요?**

기존 렌더링은 물리 엔진을 기반으로 빛, 재질, 공간을 정밀하게 계산해 실제에 가까운 이미지를 만듭니다. AI 스냅샷은 이미지 생성 AI를 활용하기 때문에 훨씬 빠르게 연출 이미지를 얻을 수 있지만, 실제 배치된 가구나 공간 구조와 다르게 표현되는 왜곡이 발생할 수 있습니다. 분위기나 스타일을 빠르게 확인하는 용도로 활용하시고, 정확한 공간 표현이 필요한 경우에는 렌더링을 사용하시기를 권장합니다.

**Q. AI가 생성한 결과를 바로 실제 시공에 사용할 수 있나요?**

AI가 생성한 결과는 아이디어 탐색과 작업 보조를 위한 제안입니다. 정확한 치수 설계, 구조적 안정성은 보장되지 않으므로, 실제 시공 전에 전문가의 검토가 필요합니다.

**Q. 견적 금액이 실제 비용과 동일한가요?**

AI가 생성하는 견적은 참고용입니다. 미판매 제품이나 부정확한 정보가 포함될 수 있으며, 실제 구매 가격이나 시공 비용과 차이가 있을 수 있습니다.

**Q. 원하는 결과가 잘 나오지 않을 때는 어떻게 해야 하나요?**

요청을 더 구체적으로 작성해 보세요. 스타일, 분위기, 목적, 강조 포인트 등을 함께 입력하면 더 좋은 결과를 얻을 수 있습니다. 같은 요청이라도 AI의 생성 결과는 매번 달라질 수 있으니 여러 번 시도해 보세요.

**Q. Archisketch AI 기능 사용 시 비용이 발생하나요?**

현재는 전면 무료로 제공됩니다. 단, AI 스냅샷의 경우 향후 크레딧 기반 과금이 도입될 예정이며, 관련 내용은 사전에 공지됩니다.

{% hint style="success" icon="thumbtack" %}
**AI 이용 시 참고사항**
{% endhint %}

* AI가 생성하는 결과는 **자동 생성된 제안**이며, 실제 작업에 활용하기 전 사용자의 검토 및 수정이 필요할 수 있습니다.
* **같은 요청을 입력하더라도 생성 결과는 매번 달라질 수 있습니다.**
* AI를 통해 생성된 이미지와 텍스트는 프로젝트 작업 및 콘텐츠 제작에 활용하실 수 있습니다. 단, 서비스 이용약관에 따라 일부 사용 방식에 제한이 있을 수 있습니다.
* AI가 생성한 견적 정보는 참고용이며, 실제 구매 가격이나 시공 비용과 차이가 발생할 수 있습니다.
* **최종 판단은 항상 사용자에게 있습니다.** AI의 결과는 작업을 보조하기 위한 도구입니다.
* 사용 중 문제가 발생하거나 개선 아이디어가 있으시면 언제든지 알려주세요. 여러분의 피드백이 Archisketch AI를 더 나은 서비스로 만드는 데 큰 도움이 됩니다.
  * **오류 제보** — 예상과 다른 결과, 기능 오작동, 화면 오류 등 불편한 점을 알려주세요.
  * **기능 건의** — 추가되었으면 하는 기능이나 개선 방향에 대한 의견을 자유롭게 남겨주세요.

*<mark style="color:$info;">본 가이드의 내용은 서비스 업데이트에 따라 변경될 수 있습니다.</mark>*


---

# Agent Instructions: 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:

```
GET https://docs.archisketch.com/guide/archisketch-ai/ai-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.