> 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-jp/archisketch-ai/ai-finishing-swap/ai.md).

# AI仕上げ材登録ガイド

壁紙・床材・キッチン材・窓製品をAI仕上げ変更に表示させるには、企業ライブラリに **AI Studio** フォルダを作成し、製品をエリアフォルダに入れてください。壁紙・床材・キッチン材は **仕上げ材ライブラリ**に、窓は **家具ライブラリ**に作成します。

設定が終わると、ユーザーがAI仕上げ変更で床・壁・キッチン・窓の各エリアを選択したとき、該当フォルダに入れた製品が右側の一覧にすぐ表示されます。フォルダ名と製品名も入力したとおりに画面に表示されるので、ユーザーに見せる名前として設定してください。

始める前に2つ確認してください。

* このガイドは **ライブラリにすでに登録されている製品**をAI Studioフォルダへ移す方法です。まだ登録されていない製品は、先に登録してください。
* フォルダを作成したり製品カテゴリを変更したりするには **別途権限**が必要です。

***

### 1. 全体フォルダ構成

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

どちらのライブラリも最上位（企業名）フォルダの下にAI Studioを作成し、エリアフォルダの中に製品を直接入れるか、さらに下位フォルダにまとめます。

### 2. 設定手順

下の画面はサンプルアカウントの例で、実際のフォルダ名は企業名で表示されます。

{% stepper %}
{% step %}

### **仕上げ材ライブラリを開く**

ダッシュボードでライブラリ > 企業ライブラリ > 仕上げ材ライブラリへ移動します。

<figure><img src="https://1692356280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-48f1915d95c081f114b32fa6b3382c63898b7521%2Fai-finishing-swap_ai-2.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **AI Studioフォルダを作成し、エディター非表示にする（推奨）**

企業名の最上位フォルダを選択し、「下位カテゴリ作成」で `AI Studio`を作成します。続いて「エディター非表示」を押すと、フォルダに赤い「エディター非表示」表示とツリーの目アイコンが付きます。通常の3DエディターライブラリにAI Studio用製品が混ざって見えないようにする設定です。

今後フォルダを作成するときは、必ず **フォルダを作成する場所（上位フォルダ）を先に選んでから** 右上の「下位カテゴリ作成」を押してください。

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

<figure><img src="https://1692356280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-d53fbc1ff2fdb246bb731a5c3586ef45988ecfa2%2Fai-finishing-swap_ai-4.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **エリアフォルダを作成する**

AI Studioフォルダを選択し、「下位カテゴリ作成」で `Wall`, `Floor`, `Kitchen` フォルダを作成します。 `AI Studio`とエリアフォルダ名は **スペル・大文字小文字・スペースまで同じように** 入力しないと認識されません。その下の下位フォルダ名は自由に設定してかまいません。

| AI仕上げ変更エリア | ライブラリ     | フォルダ名     | 入れる製品                     |
| ---------- | --------- | --------- | ------------------------- |
| 壁          | 仕上げ材ライブラリ | `Wall`    | 壁紙                        |
| 床          | 仕上げ材ライブラリ | `Floor`   | 床材                        |
| キッチン       | 仕上げ材ライブラリ | `Kitchen` | 上部キャビネット・下部キャビネット・カウンター天板 |
| 窓          | 家具ライブラリ   | `Window`  | 窓                         |

<figure><img src="https://1692356280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-bf78aa2bf8683825cd4c8858dc3ca8bf53a43251%2Fai-finishing-swap_ai-5.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **製品を入れる（必要なら下位フォルダにまとめる）**

エリアフォルダに製品を直接入れるか、1段下の下位フォルダを作成して入れます。以下は Floor > 「秋に似合うウッドトーンの床」 > 床材1、床材2 の例です。

<figure><img src="https://1692356280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-97555988a0bdece8d384481d05a816f92fc7bf87%2Fai-finishing-swap_ai-6.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1692356280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-6bd53ebfa8f72a23c23c37fbe199eaa8f226ada2%2Fai-finishing-swap_ai-7.png?alt=media" alt=""><figcaption></figcaption></figure>

**製品をフォルダに入れる方法** — すでに登録されている製品のカテゴリを変更して、AI Studioフォルダへ移します。

* 製品1件：仕上げ材一覧で製品サムネイル右上の「⋯」→「カテゴリ修正」

<figure><img src="https://1692356280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-52104fa60de852b66e603bf30a1a60c6850a7740%2Fai-finishing-swap_ai-8.png?alt=media" alt=""><figcaption></figcaption></figure>

* 複数件：製品左上のチェックボックスで選択→右上の「一括修正」→「カテゴリ修正」

<figure><img src="https://1692356280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-4165cf2f9063e2c33a42786cf3d98deadcb02277%2Fai-finishing-swap_ai-9.png?alt=media" alt=""><figcaption></figcaption></figure>

* 「カテゴリ修正」画面で入れるフォルダ（例：AI Studio > Floor > 秋に似合うウッドトーンの床）にチェックし、下の「修正後カテゴリ」パスを確認してから「修正」を押します。
* 一括修正で移すと、元のフォルダからは外れ、選択したフォルダにのみ残ります。

<figure><img src="https://1692356280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-e8121d5e810e69e042dde59f2d15724ab034b1ef%2Fai-finishing-swap_ai-10.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **窓は家具ライブラリで繰り返し**

企業ライブラリ > 家具ライブラリで2番と同じようにAI Studioフォルダを作成し、その下に `Window` フォルダに窓製品を入れます。フォルダの作成と製品の移動方法は仕上げ材ライブラリと同じです。
{% endstep %}

{% step %}

### **AI仕上げ変更で確認**

設定を終えたら **AI仕上げ変更画面を必ず再読み込み**してください。左側メニューのAI製品変更 > AI仕上げ変更で空間写真をアップロードし、左の「適用した製品」でエリア（床1など）を選択します。右の3D編集モードに下位フォルダ名がグループタイトルとして、製品がサムネイルとして表示されれば完了です。写真アップロード、エリア編集、クレジットなどの機能の使い方は [AI仕上げ変更の使い方ガイド](https://docs.archisketch.com/guide/user/archisketch-ai/ai-finishing-swap)を参照してください。

<figure><img src="https://1692356280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-963aeedd691981443e3f5aa25c2142670c4ecad7%2Fai-finishing-swap_ai-11.png?alt=media" alt=""><figcaption></figcaption></figure>

下位フォルダを複数作成すると、下のようにフォルダごとにグループが1行ずつ積み上がり、4件を超える製品は+Nでまとめられます。

<figure><img src="https://1692356280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs45pRyTQeyYi0T0toKii%2Fuploads%2Fgit-blob-4bd61805f1fbc3795b9b9d4f0772fb10068dd2f6%2Fai-finishing-swap_ai-12.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### 3. 下位フォルダと画面表示のルール

製品が入っているフォルダだけが画面にグループとして表示され、空のフォルダは表示されません。下位フォルダはエリアフォルダの下に自由に作成できます（例：Floor > 「秋に似合うウッドトーンの床」 > 床材1、床材2）。

| フォルダ状態                                | AI仕上げ変更画面                                |
| ------------------------------------- | ---------------------------------------- |
| エリアフォルダ（Wall・Floor…）に製品が1つもない         | 「適用する製品がありません」という案内が表示されます               |
| 下位フォルダに製品がない                          | その下位フォルダ自体が表示されません                       |
| 下位フォルダAに直下の製品がなく、製品が入っている下位フォルダBだけがある | Aは無視され、Bだけがグループとして表示されます                 |
| 製品が入っている下位フォルダが複数ある                   | フォルダごとにグループが1行ずつ表示され、4件を超える製品は+Nでまとめられます |

* **並び順**: フォルダと製品はどちらもあいうえお順でのみ並び替えられます。
* **Kitchen**: Kitchenフォルダに入れた製品は、上部キャビネット・下部キャビネットのどのエリアを選択してもすべて一緒に表示されます。ユーザーが区別して見られるように、「家具材」「天板」などの下位フォルダに分けてください。
* **言語**: フォルダ名・製品名は入力した言語のまま表示されます。

### 4. 注意事項

* `AI Studio`, `Wall`, `Floor`, `Kitchen`, `Window` フォルダ名はスペル・大文字小文字・スペースまで正確に入力してください。その下の下位フォルダ名は自由です。
* フォルダや製品を変更した後は、AI仕上げ変更画面を再読み込みしないと反映されません。
* 窓製品は仕上げ材ではなく **家具ライブラリ**のAI Studioフォルダに入れてください。

### 5. 設定後の確認Q\&A

<details>

<summary><strong>AI仕上げ変更に製品が表示されません。</strong></summary>

まずAI仕上げ変更画面を再読み込みしてください。それでも表示されない場合は `AI Studio`とエリアフォルダ（`Wall`, `Floor`, `Kitchen`, `Window`）の名前がスペル・大文字小文字・スペースまで正確か確認してください。

</details>

<details>

<summary><strong>「適用する製品がありません」という案内が出ます。</strong></summary>

該当エリアフォルダに製品が1つもない場合です。エリアフォルダか、その下の下位フォルダに製品を1つ以上入れてください。

</details>

<details>

<summary><strong>作成した下位フォルダが画面に表示されません。</strong></summary>

製品が入っていない下位フォルダは表示されません。下位フォルダ内に製品があるか確認してください。

</details>

<details>

<summary><strong>窓製品が一覧に出ません。</strong></summary>

窓は仕上げ材ライブラリではなく、家具ライブラリのAI Studio > Windowフォルダに入れる必要があります。

</details>

<details>

<summary><strong>3DエディターライブラリにもAI Studio製品が表示されます。</strong></summary>

AI Studioフォルダにエディター非表示が設定されているか確認してください。フォルダツリーでAI Studioの横に目アイコンが見えれば非表示状態です。

</details>

<details>

<summary><strong>フォルダや製品の順番を変えたいです。</strong></summary>

フォルダと製品はあいうえお順でのみ並び替えられます。名前はユーザー画面にそのまま表示されるため、見せたい名前と順序を合わせて設定してください。

</details>

<details>

<summary><strong>製品を移したら元のフォルダから消えました。</strong></summary>

一括修正でカテゴリを変更すると、元のフォルダからは外れ、選択したフォルダにのみ残ります。製品を複製してから移してください。

</details>

<details>

<summary><strong>「下位カテゴリ作成」や「カテゴリ修正」ができません。</strong></summary>

フォルダと製品カテゴリは、マネージャー以上の権限でのみ変更できます。アカウント権限を確認してください。

</details>

<details>

<summary><strong>アップロードしたい製品がライブラリにありません。</strong></summary>

AI Studioフォルダへは、すでに登録済みの製品のみ移せます。製品を先に登録してからカテゴリを変更してください。

</details>

<details>

<summary><strong>上部キャビネットを選択したのに、天板製品も一緒に表示されます。</strong></summary>

Kitchenフォルダの製品は、キッチンエリアのどこを選択してもすべて表示されます。「家具材」「天板」などの下位フォルダに分けると、グループごとに分けて表示されます。

</details>


---

# 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-jp/archisketch-ai/ai-finishing-swap/ai.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.
