> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ワークスペース設定（Settings › Workspace）：概要、シークレットと環境変数、プロジェクト

> ワークスペースの設定について説明します。Overview、Secrets & variables（プロジェクト単位とすべてのプロジェクト共通、一括追加）、プロジェクト一覧とプロジェクト設定への入口を扱います。

**ワークスペース**は、プロジェクト、セッション、シークレット、環境変数が属する範囲です。**Settings** のナビゲーションにある **Workspace** グループには、**Overview**、**Machines**、**Secrets & variables**、**Projects**、**Archived chats** があります。このページでは Overview、Secrets & variables、Projects を説明します。Machines については [実行環境：あなたのデバイス上とクラウドサーバー](https://docs.aihubmix.com/jp/cloud/projects/run-environment.md) を、Archived chats については [アーカイブ](https://docs.aihubmix.com/jp/cloud/settings/archived.md) を参照してください。

## 利用できる環境

デスクトップアプリ、Web アプリ、モバイル Web で利用できます。モバイル Web では、設定のナビゲーションは、グループ化された一覧から詳細を開く形式になります。

## 場所

アカウントメニュー › **Settings**、左側のナビゲーションの **Workspace** グループ。

## Overview

| 行 | 表示内容 | 操作 |
| - | - | - |
| ワークスペース名 | 現在の名前。名前がない場合は **Untitled** | **Edit** |
| Projects | **N projects** | **View** で **Settings › Workspace › Projects** を開きます |
| Members | 個人ワークスペースには **Just you · owner**、チームワークスペースには **Team workspace · member management coming soon** と表示されます | なし |

名前を変更する場合、名前は 1〜64 文字で、空にすることはできません。

### クラウドサーバーの管理者権限

**Overview** の下には **Admin access on cloud server** スイッチ（オンの場合、Agent はクラウドサーバー上でソフトウェアをインストールしたりシステム設定を変更したりできます。デフォルトでオン）と、その現在の状態があります。[クラウドサーバーの管理者権限](https://docs.aihubmix.com/jp/cloud/cloud-host/admin-permission.md) を参照してください。

## Secrets & variables

ページは 2 つの部分で構成されています：

* **Projects**：プロジェクトごとに 1 グループで、プロジェクト名、ソース、概要（例：**2 variables · 1 secret**）が表示されます。
* **All projects**：ワークスペース単位で、すべてのプロジェクトに適用されます。

ルール：

* 名前が一致する場合は、プロジェクトの値が優先されます。**All projects** の値は、プロジェクトに同じ名前の項目がない場合にのみ使用されます。プロジェクトのグループ内でワークスペースの項目を上書きしている項目には **Overrides workspace** のラベルが付き、ワークスペースのグループ内でプロジェクトに上書きされている項目には **Overridden in N projects** のラベルが付きます。
* シークレットは暗号化して保存され、AI は元の値を参照できません。シークレットの値はインターフェースでは点で表示されます。
* 各グループの右上には **Bulk add** と **Add secret or variable** があります。各行には編集ボタンと削除ボタンがあります。削除に確認はありません。

### 追加と編集

| 項目 | 説明 |
| - | - |
| Name | 自動的に大文字に変換され、スペースはアンダースコアに置き換えられます（例：`API_BASE_URL`）。編集時は変更できません |
| Value | 必須。編集時は元の値は表示されず、新しい値を入力して置き換えます |
| Type | **Variable**（デフォルト）または **Secret** |

### 一括追加

**Bulk add** をクリックし、1 行に 1 つずつ `KEY=value` を記述します。`.env` ファイルの内容をそのまま貼り付けることもでき、同じ名前の項目は置き換えられます：

* KEY、TOKEN、SECRET、PASSWORD を含む名前はシークレットとして保存されます。それ以外は変数として保存されます。
* 空行と `#` で始まる行は無視されます。`export KEY=value` の形式も使用できます。値を囲む対応する引用符は削除されます。
* 名前に使用できるのは英字、数字、アンダースコアのみで、数字で始めることはできず、最大 64 文字です。値を空にすることはできません。同じ名前を 2 行に記述することはできません。
* 無効な行は **Line N: reason** の印が付いてテキストボックスに残ります。その他の行は通常どおり保存されます。

### シークレットが使用される場所

* クラウドサーバー上のプロジェクト環境：値は上記の同名時の優先ルールに従います。
* あなたのデバイス上で実行する場合：デバイスの **Allowed secrets** によって、どのワークスペースのシークレットがそのパソコンに提供されるかが決まります。[実行環境：あなたのデバイス上とクラウドサーバー](https://docs.aihubmix.com/jp/cloud/projects/run-environment.md) を参照してください。
* 環境構築中に AI が不足しているシークレットや変数を見つけた場合、[環境チェック](https://docs.aihubmix.com/jp/cloud/projects/environment-setup.md)で入力を求められ、その結果もここに保存されます。

## Projects

**Settings › Workspace › Projects** には、ワークスペース内のすべてのプロジェクトが一覧表示されます。各行には、名前、ソース（GitHub リポジトリまたはフォルダ）、状態（**Environment not set up**、**Setup failed**、**This computer only** など）、変数の数が表示されます。行をクリックするとプロジェクトページが開き、行の末尾にある歯車をクリックするとプロジェクトの設定が直接開きます。各状態の意味については、[プロジェクト環境](https://docs.aihubmix.com/jp/cloud/projects/environment-setup.md) と [プロジェクト](https://docs.aihubmix.com/jp/cloud/projects/projects.md) を参照してください。

## プロジェクト設定

個別のプロジェクトの設定は、プロジェクト一覧の歯車、プロジェクトページ右上の **Project settings**、またはプロジェクトメニューの **Edit** から開けます：

| エリア | 内容 | 変更が反映されるタイミング |
| - | - | - |
| プロジェクト情報 | 名前、説明、リポジトリまたはソースフォルダ、ベースブランチ、コミット方法、コミットの作成者、追加でクローンするリポジトリ | **Save** をクリックした後。**Discard** もできます |
| 環境 | セットアップスクリプト、起動コマンド | 再度実行して公開した後 |
| シークレットと変数 | プロジェクト単位の項目、および **Inherited from workspace** の項目 | 削除はすぐに反映されます。項目の追加と編集は **Settings › Workspace › Secrets & variables** で行います |
| プロジェクトの削除 | **Delete project…** | 確認した直後 |
| プロジェクトのエクスポート | **Download project archive** | クリックするとダウンロードが始まります |

詳細は、[プロジェクト](https://docs.aihubmix.com/jp/cloud/projects/projects.md) と [プロジェクト環境](https://docs.aihubmix.com/jp/cloud/projects/environment-setup.md) を参照してください。

## よくある質問

### プロジェクトとワークスペースの両方に同じ名前の変数がある場合、どちらが使用されますか？

プロジェクトの値です。**All projects** の値は、プロジェクトに同じ名前の項目がない場合にのみ適用されます。

### 入力したシークレットは AI から見えますか？

いいえ。シークレットは暗号化して保存されます。インターフェースとチャットには名前のみが表示され、値は実行時に環境に提供されます。

## 関連ページ

* [プロジェクト](https://docs.aihubmix.com/jp/cloud/projects/projects.md)
* [プロジェクト環境](https://docs.aihubmix.com/jp/cloud/projects/environment-setup.md)
* [実行環境：あなたのデバイス上とクラウドサーバー](https://docs.aihubmix.com/jp/cloud/projects/run-environment.md)
* [クラウドサーバーの管理者権限](https://docs.aihubmix.com/jp/cloud/cloud-host/admin-permission.md)
* [アーカイブ](https://docs.aihubmix.com/jp/cloud/settings/archived.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.