> For the complete documentation index, see [llms.txt](https://docs.archisketch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.archisketch.com/guide/user-en/archisketch-ai/ai-agent.md).

# Archisketch AI Agent

Now request things naturally, like having a conversation.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-a67a569be0d294b305e97ffd2fe9a5f548f562bd%2Fai-agent-1.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 👋 Meet the Archisketch AI Agent!

> The Archisketch AI Agent helps with interior design work.

***

## What is Archisketch AI?

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-5be939de6962d3fc3eea9f91e10709cc47c1eb98%2Fai-agent-2.jpg?alt=media" alt=""><figcaption></figcaption></figure>

**Archisketch AI**is an AI agent feature that can be used inside Archisketch.\
Just type what you want into the chat window, and the AI will help with various tasks such as space analysis, idea suggestions, image generation, and portfolio writing.

{% hint style="info" %}
The Archisketch AI Agent is currently available in beta.

<mark style="color:$info;">Some features may be unstable or behave differently than expected, and features and policies may change as the service improves.</mark>
{% endhint %}

***

## Get started on the Archisketch AI page

In the dashboard menu **Archisketch AI** On the page, you can start AI tasks such as floor plan search, furniture arrangement, and render shooting all in one place. Try entering the task you want in the chat window to get started.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2FMKWftQ3tSq74t50qjVhe%2Fimage.png?alt=media&amp;token=2cd47501-575d-4c60-b14c-718a397fcb78" alt=""><figcaption><p>The Archisketch AI page in the dashboard</p></figcaption></figure>

***

## ✨ Key Features

Currently, Archisketch AI **Basic Mode**and **Expert Mode** is offered in two modes.\
Basic Mode is for the early stages of interior exploration, while Expert Mode can be used throughout the actual design workflow, from floor plan analysis to furniture placement, styling image generation, and portfolio writing.

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

**Key Features**

* **Floor plan search and 3D image generation** : You can generate images based on an actual floor plan.
* **Interior rough estimate generation** : You can generate an approximate rough estimate of interior costs based on the floor plan.
* **Interior style consultation** : We suggest space composition ideas and directions.

#### 1. Search floor plans using our home address

Enter an address to search for floor plans that fit that residential space and get recommendations for similar floor plans.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-0151f22b445fc037a6ac29b9fd075ba57243cd66%2Fai-agent-3.jpg?alt=media" alt=""><figcaption></figcaption></figure>

**Example request**

* "Find the floor plan for an 84㎡ apartment in Mapo-gu, Seoul."
* "Recommend similar floor plans based on my home address"

**Notes**

* The floor plans found may differ from the actual residential space. Please be sure to verify that the floor plan pulled by the AI is accurate before using it.
* Can't find the floor plan you want? If you'd like a floor plan created, please contact Archisketch.

#### 2. Generate 3D images based on our home

Based on the floor plan search results, interior images are generated. If you also tell us the style or mood you want, you can get more accurate images.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-6273fb408b556952efadbb5f9d4f59da16cc3b5b%2Fai-agent-4.jpg?alt=media" alt=""><figcaption></figcaption></figure>

**Example request**

* "Create a Scandinavian-style living room image with this floor plan."
* "Make it into an interior image with a bright and warm feel."

**Notes**

* Please note that distortions may occur in AI-generated images.

#### 3. Interior rough estimate

Provides an approximate rough estimate of interior costs based on the floor plan and images.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-5da6269c13cf28ead1463553993cc9b0290ed8e7%2Fai-agent-5.jpg?alt=media" alt=""><figcaption></figcaption></figure>

**Example request**

* "How much would it cost to do the interior for this space?"
* "Give me a rough estimate based on this floor plan."

**Notes**

* The rough estimate is for reference only and may differ from actual construction costs.

#### 4. Interior style consultation

If you talk about the style or taste you want, we suggest space composition ideas and directions.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-2cd4a8f9c1cdaa548f1dda7a34d73b627744744c%2Fai-agent-6.jpg?alt=media" alt=""><figcaption></figcaption></figure>

**Example request**

* "I want to decorate a 20-pyeong living room with a cafe atmosphere. What should I do?"
* "I want to create a bedroom with a minimalist yet warm feel—what points are important?"

***

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

**Key Features**

* **AI snapshot capture**: Find the optimal composition and generate a high-resolution image.
* **Portfolio Master**: Automatically writes project descriptions and marketing content.
* **Smart estimate**: Download the estimate as a PDF instantly with one conversation.
* **Space analysis report**: We analyze design style and color composition like an expert.
* **Easy save and export**: Save your work securely and share it externally.

#### 1. AI snapshot capture

This feature automatically selects the appropriate camera composition based on the current project space and generates a high-resolution styling image.\
Compared to existing rendering, the advantages include automatic camera angle recommendations, fast image generation, and optimized emotional styling.

**How to use:**

1. Enter a capture request in the AI chat window.
2. Describe the desired mood, time of day, and style together.
3. Check the generated image.

**Example request**

* 👍 **Good example**: "Create a warm evening mood for the living room.", "Express it with a cozy feel and indirect lighting."
* 👎 **Not recommended**: "Make it pretty." (It's better to specify the mood, lighting, or purpose.)

**Notes**

* Currently, the photo is taken based on the camera view recommended by the AI.
* Results may vary even for the same request, and this is a styling image rather than an actual construction photo.
* AI snapshots are a feature that consumes credits.\
  Currently, they are provided for free when requested through chat in the Archisketch AI Agent, but the pricing policy may change in the future.

#### 2. Bulk furniture placement based on floor plan

If you describe the desired interior style in text or attach an image, the AI analyzes the structure of the empty floor plan and derives a furniture arrangement draft that reflects your taste.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-109cc11c09e3c3581c34b4a4e1a5dcec7099e2fe%2Fai-agent-7.jpg?alt=media" alt=""><figcaption></figcaption></figure>

**Example request**

* "Create a cafe-like living room."
* "Arrange the furniture in a warm and cozy bedroom."
* "Create a minimalist-style living room layout."

**Notes**

* Bulk furniture placement is a task that processes floor plan analysis and placement calculations at the same time, so it may take some time to complete.\
  Please keep the screen open and wait while it is in progress.
* The placement results may contain errors or be expressed differently from what you intended, and the estimate information generated together with them should also be used for reference only.

#### 3. Recommend suitable furniture based on the floor plan

We analyze the space currently being designed from multiple angles and carefully recommend furniture that suits the structure of the space and the user's taste.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-ef17f2fe6ae4d02b7e9721937ce2d73dcd0db7d1%2Fai-agent-8.jpg?alt=media" alt=""><figcaption></figcaption></figure>

**Example request**

* "Recommend a sofa that would suit this living room."
* "Recommend a furniture combination that fits the Scandinavian style."

**Notes**

* The recommendation results are suggestions automatically generated by AI and may not perfectly match the actual space.
* Some of the recommended products may have been discontinued or may have inaccurate information, so confirmation is needed before actual purchase.

#### 4. Reference-based target tasks

If you click the desired furniture or floor on the editor screen, a reference button appears in the chat input field.\
After setting the reference with this button and making a request, the AI performs the task based only on that furniture or space.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-1073995551a2f549697d51d925d79382a2889678%2Fai-agent-9.jpg?alt=media" alt=""><figcaption></figcaption></figure>

**1️⃣ When referencing a room** — Focus on the structure of the selected room and run furniture recommendations and placement.\
Try asking for a camera view that maximizes the spatial feel of that space, or request that products be placed only in that room.

**2️⃣ When referencing furniture** — Keep the overall layout and replace only the selected furniture.\
Considering the position and size of the existing furniture, we recommend products that match the desired style, and you can immediately swap them into that position.

**Example request**

* *<mark style="color:$info;">(After clicking the master bedroom floor, set as reference)</mark>* "Arrange furniture in this room."
* *<mark style="color:$info;">(After clicking the master bedroom floor, set as reference)</mark>* "Recommend furniture that fits this space."
* *<mark style="color:$info;">(After clicking the sofa, set as reference)</mark>* "Replace this sofa with a modern one-seater sofa."
* <mark style="color:$info;">(After clicking the table, set as reference)</mark> "Replace this table with a round table."

**Notes**

* When referencing a room, that space type must be set correctly so that the AI can accurately understand the characteristics of the space and provide more suitable results.
* Before working, we recommend setting the space type of that room in the editor to an appropriate type such as bedroom, living room, kitchen, or something other than None.

#### 5. AI intelligent planning

By analyzing the user's request, we first derive an optimal work plan.\
If information is insufficient, the AI refines the plan through additional questions, and after the user leaves comments to fine-tune it, everything proceeds automatically with a single 'Execute' button.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-0ccd4464d8ff07f67b80c728bc847e985d8bb58f%2Fai-agent-10.jpg?alt=media" alt=""><figcaption></figcaption></figure>

**How to use**

* In the chat input field, **Planning** turn on the toggle button and make a request, and instead of executing the task immediately, AI first derives the optimal task plan.
* The plan is organized into paragraphs, and you can request revisions by leaving comments directly on each paragraph.
* After review, **Start execution** Press the button and all tasks will proceed automatically without interruption.

**Example request**

* *<mark style="color:$info;">(After turning on the planning toggle)</mark>* "Change the entire space to a modern style."
* *<mark style="color:$info;">(After turning on the planning toggle)</mark> "*"Decorate the bedroom and living room with a unified atmosphere."

**Notes**

* Because there is a lot of work involved from planning to execution, it may take quite some time to complete.\
  Please keep the screen open and wait while execution is in progress.

#### 6. View / create / edit portfolio

AI automatically writes draft posts or marketing content that introduce the finished space.\
You can freely use the generated 3D interior project descriptions for marketing content or customer proposals.

If you tell us the purpose, concept, points you want to emphasize, and the desired tone and manner, generation will start automatically.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-fe0270ae9f4c0222c5c8eda8ee8addd8cdc90b67%2Fai-agent-11.jpg?alt=media" alt=""><figcaption></figcaption></figure>

**How to use**

1. Request writing based on the project.
2. Enter the purpose, tone and manner, and points you want to emphasize together.
3. Check the generated draft and request additional edits if needed. You can also edit it yourself.

**Example request**

* 🕴 For customer proposals: "Write this project as a portfolio article for customer explanation. Emphasize that the space composition centers on a cozy living room, and write in a friendly and easy-to-understand tone."
* 💬 For marketing content: "Write this space as SNS promotional content. Emphasize the cafe-like atmosphere and stylish lighting, and make it trendy and emotional in tone."
* ✏️ Example edit requests: "Please revise it to sound a little more professional.", "Cut the length in half."

**Notes**

* Because this is a draft automatically generated by AI, we recommend reviewing it before final use.
* Due to the nature of AI-generated content, the expression may vary even for the same request.

#### 7. Download estimate PDF

You can easily download the project estimate as a PDF file based on the existing real-time estimate feature.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-dc0b3218ac49d0900e7b99824d01be45dec89796%2Fai-agent-12.jpg?alt=media" alt=""><figcaption></figcaption></figure>

**How to use**

1. Select a project.
2. Request "PDF download" in the chat window.
3. Download the generated PDF file.

**Example request**

* "Download this project estimate as a PDF."
* Download the estimate as a PDF

**Notes**

* The estimate price is for reference only and may differ from actual purchase and construction costs.
* The price data for some products may be inaccurate.

#### 8. Space analysis

Even if you don't have design expertise, we analyze and organize the style, color composition, furniture characteristics, atmosphere, and more so you can objectively understand the features of the current space.\
We analyze the style and atmosphere of the space you are currently working on and suggest ideas for further improvement.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-d1dd171b90d82cc0f24f7bc32abedbe1781c649a%2Fai-agent-13.jpg?alt=media" alt=""><figcaption></figcaption></figure>

**How to use**

* Request analysis while the project is open. You can also include the direction you'd like the analysis to take.

**Example request**

* "Analyze what kind of interior style this space has."
* "Summarize the color composition and atmospheric characteristics of the current design."

**Information provided**

* Main color palette, furniture style characteristics, space atmosphere, design points, improvement ideas, and more

**Notes**

* AI analysis results are for reference only and do not completely replace professional design review.

#### 9. Save and export project

You can save the project with AI work applied or export it as an external file.

* How to use:

1️⃣ Request save after the task is complete.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-1f62646ddb84cc5b1a0e5807b4297dc65e639ef1%2Fai-agent-14.jpg?alt=media" alt=""><figcaption></figcaption></figure>

2️⃣ Specify the desired file format among the supported formats.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-e76dd23155f0583da5ccf9e7f6c1f76fa442d7c6%2Fai-agent-15.jpg?alt=media" alt=""><figcaption></figcaption></figure>

3️⃣ Proceed with the download.

**Example request**

* "Save the current work.", "Export this project."

**Notes**

* Please check the content once again before saving.
* For some external formats, slight differences may occur during the conversion process.

***

## Talk by voice

to the agent **Ask by voice**and **Listen to voice responses**You can. Even in situations where typing by hand is difficult or while working, you can comfortably get help.

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-1d8bb8ef6a999715ff786a5cad6b75dedc9dab20%2Fai-agent-16.png?alt=media" alt=""><figcaption></figcaption></figure>

**Follow along**

1. Open the Archisketch agent.
2. **Start voice input**and say what you want to ask or request.
3. The agent understands the question and **responds by voice**.

## ℹ️ Notes

#### Service policy

* Archisketch AI may have some features changed or updated according to service improvements and technological advances.
* Some features may be provided as beta features, and the quality of results or the way they work may vary during use.
* Changes to features, usage methods, pricing policies, and more will be announced in advance through service notices or update announcements.

{% hint style="info" icon="q" %}
**Frequently Asked Questions (FAQ)**
{% endhint %}

**Q. What kind of service is Archisketch AI?**

It is an AI agent that helps with the full range of interior design tasks, such as space analysis, idea suggestions, styling image generation, portfolio writing, and estimate lookup, when you enter natural language in chat.

**Q. How is AI Snapshot different from existing rendered images?**

Existing rendering is based on a physics engine that precisely calculates light, materials, and space to create images close to reality.\
AI Snapshot uses image generation AI, so you can get styling images much faster, but distortions may occur that make them look different from the actual furniture arrangement or space structure.\
Use it to quickly check mood or style, and if you need an accurate representation of the space, we recommend using rendering.

**Q. Can the results generated by AI be used directly for actual construction?**

The results generated by AI are suggestions for idea exploration and work assistance.\
Accurate dimensional design and structural stability are not guaranteed, so professional review is required before actual construction.

**Q. Is the estimate amount the same as the actual cost?**

Estimates generated by AI are for reference only.\
They may include unsold products or inaccurate information, and may differ from actual purchase prices or construction costs.

**Q. What should I do if I don't get the desired results?**

Try making your request more specific.\
You can get better results by including style, mood, purpose, and key points.\
Even with the same request, AI-generated results can vary each time, so try several times.

**Q. Is there a cost for using Archisketch AI features?**

Yes, credits are deducted.

AI Agent deducts credits based on token usage, and AI Snapshot and Render Shot deduct credits according to each feature's criteria.&#x20;

You can check the deduction criteria for each feature in [Credit Information](https://docs.archisketch.com/guide/faq/service/credit-guide).

<figure><img src="https://1040484064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-a89b0735d42f18456c0f37284f65f5b801875588%2F202607_README-17.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="success" icon="thumbtack" %}
**Notes for using AI**
{% endhint %}

* The results generated by AI are **automatically generated suggestions**and may require user review and editing before being used in actual work.
* **Even if you enter the same request, the generated results may differ each time.**
* Images and text generated through AI can be used for project work and content creation. However, some usage methods may be restricted according to the Terms of Service.
* AI-generated estimate information is for reference only and may differ from actual purchase prices or construction costs.
* **The final decision always rests with the user.** AI results are tools to assist with work.
* If you experience any problems while using the service or have ideas for improvement, please let us know anytime. Your feedback is a big help in making Archisketch AI a better service.
  * **Report an error** — Please let us know about any inconveniences, such as unexpected results, feature malfunctions, or screen errors.
  * **Feature suggestions** — Feel free to leave your opinions on features you'd like added or directions for improvement.

*<mark style="color:$info;">The content of this guide may change according to service updates.</mark>*


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
