---
id: workspaces
title: ワークスペースとメンバー
category: basic
order: 15
keywords: [ワークスペース, 個人ワークスペース, 案件ワークスペース, スペース, メンバー, 招待リンク, 共有, 可視性, 資格情報, principal]
---

# ワークスペースとメンバー

**ワークスペース** は、タスク・ファイル・メモリ・piece・スキル・MCP/SSH 接続・ブラウザセッションといった「作業に必要なもの一式」をまとめる入れ物です。MAESTRO のデータと共有範囲は、すべてワークスペース単位で決まります。

## 2 種類のワークスペース

| 種類 | 一覧での区分 | 用途 | 共有 |
|---|---|---|---|
| 個人ワークスペース | 統合スペース | あなた専用の作業場。既定の入口で、毎アカウントに 1 つ用意されます | 自分だけ（管理者は閲覧可） |
| 案件ワークスペース | 個別スペース | チームや案件ごとに作る共有の作業場 | 招待したメンバー全員 |

ワークスペース一覧では、作業が集まる中心となる個人ワークスペースを **統合スペース**、案件ごとに分かれる作業場を **個別スペース** としてグループ分けし、左端の色帯で区別しています。

起動すると、まず **個人ワークスペース** が開きます。案件ワークスペースは同じ **ワークスペース** タブの一覧から選んで開きます。すべての作業はワークスペース経由で行います。

## ワークスペースを切り替える

上部の **ワークスペース** タブを開くと、参加しているワークスペースの一覧が出ます。選ぶと、そのワークスペースのチャット・ファイル・設定に切り替わります。新規作成は一覧上部のボタンから行います（作った人がオーナーになります）。

一覧では、いま実行中のタスクがあるワークスペースに緑の **「● N 実行中」** バッジが行の右端に付きます（実行中が 0 件のときは表示されません）。どのワークスペースで作業が動いているかを開かずに把握できます。件数は自動で更新されます。公開範囲は **組織 / 公開** のときだけ小さく表示し、既定の **非公開** は表示しません（その分ワークスペース名を広く見せています）。

## 名前・色・説明を編集する

ワークスペースを開いたヘッダーで、タイトル横の鉛筆ボタン（管理権限がある人だけに出ます）を押すと、**名前・ブランド色・説明** をまとめて編集できます（新規作成と同じダイアログ）。ブランド色は一覧や各所のドット・色帯に反映されます。説明を入れると、ヘッダーのタイトルのすぐ右に薄い文字で表示され、そのワークスペースが何のための場所か一目で分かります。

## チャットを探す

ワークスペースの「チャット」一覧には、検索・絞り込みバーがあります。キーワード（タイトル・本文・Piece・作成者名）での検索、状態（実行中・待機・失敗など）のタブ絞り込み、並び替え（更新順・状態・タイトル）が使えます。共有ワークスペースで「自分 / 他のメンバー」を切り替えている場合は、その範囲の中で絞り込みます。

**「自分 / 他のメンバー」の切り替えについて**: 共有ワークスペースでは、メンバーが作成したチャットを「他のメンバー」で見られます。個人ワークスペースは作成者本人だけのものなので、通常この切り替えは出ません。例外として**管理者（admin）**は、個人ワークスペースの「他のメンバー」から他ユーザーの個人ワークスペースの内容を確認できます（全ユーザーの監視のため）。一般ユーザーには、共有されていない他人のチャットは見えません。

## ファイルを置く（エージェントの入力にする）

ワークスペースの **Files** にファイルを置くと、そのワークスペースのチャットで **エージェントの入力**になります。チャットを始めると、エージェントへ「ワークスペースの既存ファイル一覧」が自動で渡るので、`input/` フォルダに入れなくても置いたファイルは認識されます。新しく作ったワークスペースには `input/`・`output/` フォルダが最初から用意されています。ファイルがまだ 1 つもないときは、Files にその旨の案内が控えめに出ます。

エージェントが作った **成果物** は、Files タブの `output/` に保存されます。チャット一覧や成果物プレビューが空のときにもその旨を案内するので、できあがったファイルの探し場所に迷いません。

### ファイルの来歴（どのタスクが作ったか）

共有ワークスペースでは、複数のタスクが同じファイルツリーを使うため、あるファイルが「今の作業のもの」か「別タスクのもの」か分かりにくくなります。ファイルを開いてプレビューすると、ヘッダーのすぐ下に小さな **来歴** 行が出ます。表示するのは次のとおりで、どのタスクに由来するかを一目で確認できます。

- **種別**: ユーザーがアップロード / エージェント生成 / コマンドで生成 / エージェントが編集 など
- **作成したタスク番号** と **最後に変更したタスク番号・日時**

エージェント側も同じ来歴を参照します。別タスクが作ったファイルやユーザーがアップロードした資料を編集する前に関連性を確認し、迷ったときは上書きせず新しい出力ファイルを作るようになっています。来歴に出るのはタスク番号だけで、タイトルやユーザー名は表示しません。

### フォルダの役割（書き込める場所・書き込めない場所）

Files タブの各フォルダには役割バッジが付き、エージェントが書き込める場所が一目で分かります。

| フォルダ | バッジ | 意味 |
|---|---|---|
| `input/` | 入力 | あなたがエージェントに渡すファイル |
| `output/` | 成果物 | エージェントが結果を書き出す場所 |
| `logs/` | 作業ログ | チェックリスト・実行ログなど |
| `apps/` | アプリ | ワークスペース・アプリの HTML |
| `readonly/` | 🔒 閲覧のみ | **エージェントは書き込めません**。編集されたくないファイルの置き場 |
| `source/` | ソース | エージェントが取得した情報源（ソース）を自動で蓄積する場所 |
| `skills/` | スキル | エージェントが使うスキルの作業コピー（自動で展開・参照） |

**`readonly/` に置いたファイルは、エージェントが読むことはできても、書き換え・上書き・削除はできません**（ツール側で拒否されます）。「参考にしてほしいが触ってほしくない」資料は、ここに置いてください。

`source/` と `skills/` はエージェントが自動で作って使う構造フォルダです。中身は見られますが、フォルダ自体の移動・リネームはできません（無ければ「新規フォルダ」で作れます）。

### フォルダを自分で整理する

ファイルタブは、ファイル管理アプリのように自分で整理できます（オーナー / 編集者のみ）。

- **新規フォルダ**: 上部の「新規フォルダ」ボタンで、今いる場所にフォルダを作成
- **名前変更**: ファイルやフォルダにマウスを重ねると出る鉛筆アイコンでリネーム（一覧表示・アイコン表示のどちらでも）
- **ドラッグで移動**: ファイルやフォルダをつかんで、別のフォルダや上部パンくずの階層名へドロップすると移動します
- **まとめて移動**: チェックを付けて選んだファイルは、選択バーの「移動」ボタンから移動先を選んで一括で移せます
- **削除・アップロード・ダウンロード**: 従来どおり

`input/` `output/` `logs/` `apps/` `readonly/` `source/` `skills/` はエージェントの仕事に使う構造フォルダなので、誤操作防止のため、これら自体の名前変更・移動はできません（中のファイルや、自分で作ったフォルダは自由に整理できます）。ファイルを `readonly/` などの構造フォルダの中へ移すのは問題ありません。既存ワークスペースに `readonly/` がまだ無い場合は、「新規フォルダ」で `readonly` という名前のフォルダを作れば使えるようになります。

> **一時的モードに注意**：チャット作成時に **一時的** を選ぶと、その作業は使い捨てになり、ワークスペースに置いたファイルは引き継がれません。置いたファイルを使ってほしいときは **永続（既定・推奨）** のまま始めてください。一時的を選ぶと、その場で引き継がれない旨の警告が出ます。

## メンバーと招待

案件ワークスペースは複数人で共有します。メンバーの追加方法と招待リンクの作り方・参加の流れは [個人の資産（ワークスペース設定）](./09-userfolder.md) にまとめています。要点だけ挙げると:

- **ピッカー追加**: 同じ組織のユーザーを一覧から選ぶ
- **招待リンク**: 組織に関係なくリンクを知っている相手を招待する（役割と有効期限を指定）
- 役割は **オーナー / 編集者 / 閲覧者**。閲覧者はファイルのダウンロードや閲覧はできるが、編集・削除はできません

## 共有範囲の考え方

ワークスペースの中で始めたタスク（チャット）は、**常にそのワークスペースのメンバー全員に公開**され、メンバー以外には見えません。タスクごとに公開範囲を選ぶ設定はありません。「誰に見せるか」はメンバー構成で決まります。

個人ワークスペースのタスクだけは、作成時に **非公開 / 組織 / 公開** の公開範囲を選べます（→[タスクを作って実行する](./02-tasks.md)）。公開範囲を変えると、選択欄の下に「何が・誰に共有されるか」のプレビューが出ます。

組織・公開にしたとき、実際に共有されるもの／されないものは次のとおりです。

- **共有される**: タスクの詳細・コメント、ファイル（`input/` `output/`）、サブタスク
- **共有されない**: AGENTS.md・メモリ・カレンダー（これらは公開範囲ではなく、**ワークスペースのメンバーシップ**で決まります）
- **閲覧者は読み取り専用**: 見ることはできますが、編集・実行・Continue はできません
- **「公開」= ログイン済みの全ユーザー**。未ログインの人には公開されません（未ログイン向けの共有は別機能の共有リンク）

## 資格情報はワークスペースが持つ

メモリ・piece・スキル・MCP サーバー・SSH 接続・ブラウザセッション・自動学習（Reflection）は、**作業中のワークスペースに属します**。

- 個人ワークスペースで登録・作成したものは自分専用
- 案件ワークスペースで登録・作成したものはメンバー共有

token・API key・SSH 秘密鍵などの機密値は、そのワークスペースの鍵で暗号化して保存されます。メンバーは登録済みの接続を **使えます** が、生の資格情報そのものは見えません。秘匿したい情報や自分だけの手順は、個人ワークスペースで登録してください。

> Google ログインのアカウント連携（OAuth）だけは例外で、引き続きユーザー個人に紐づきます。共有されるのは「サーバーへの接続設定」であって、あなた個人の Google アカウントではありません。

## ツールポリシー（使えるツールを制限する）

ワークスペースの **設定 → ツール** タブで、そのワークスペースのエージェントが使えるツールカテゴリを制御できます。

| グループ | デフォルト | 説明 |
|---|---|---|
| 標準カテゴリ（core / web / office 等） | **有効** | カテゴリ単位でオフにできます |
| センシティブ（ssh / browser / Bash）| **無効** | 必要なときだけ明示的にオンにします |

- センシティブなツールは強力な操作（遠隔シェル・実ブラウザ操作・任意コマンド実行）を伴います。不要なワークスペースでは有効にしないことを推奨します。
- 設定変更はオーナーのみ行えます。変更するとその場でワークスペース内の新規タスクに即時反映されます。

## Python パッケージ（ワークスペース単位で追加する）

エージェントの Python 実行環境には、あらかじめよく使うライブラリ（pandas・openpyxl・requests 以外は基本入っていません）が入っています。それ以外のライブラリが必要なときは、ワークスペースの **設定 → Python** タブから、オーナー / 管理者がパッケージ名を直接入力して追加できます。

- ここで追加したパッケージは、**そのワークスペースの中だけ** で `import` できます。他のワークスペースには影響しません。
- インストールは **wheel があるパッケージのみ** 許可します（`requests` や `requests==2.32.3` のように、バージョンは `==` で固定できます）。標準ライブラリやプリインストール済みの名前は追加できません。
- ダウンロードはサーバー側で安全に隔離して実行されます。エージェント自身は引き続きネットワークから遮断されたまま、追加されたライブラリだけを読み込めます。
- この機能は既定でオフです。管理者が `config.yaml` の `python_packages.enabled` を有効にすると、タブに入力フォームが現れます。無効のとき、またはサーバー側の準備（サンドボックスや `pip`）が整っていないときは、その旨が画面に表示されます（黙って失敗しません）。インストールは安全なサンドボックスが使える環境でのみ実行できます。

### エージェントからのパッケージ申請

作業の途中でエージェント自身が「このライブラリが要る」と気づいたときは、チャットに **承認カード** が出ます。パッケージ名と理由が示されるので、内容を見て「許可」か「拒否」を選んでください。

- 「許可」を押すと、そのパッケージがこのワークスペースに追加され、止まっていた処理が自動で再開します。以後 `import` できます。
- 「拒否」を押すと、エージェントはそのパッケージ無しで先に進みます。
- 承認できるのは、そのタスクを編集できる人（オーナー / 管理者 / スペースの編集者）だけです。エージェントが勝手に入れることはありません。
- 追加されるのは、上のフォームで足したものと同じ扱い（wheel のみ・このワークスペース限定）です。設定 → Python の一覧にも並び、あとから削除できます。
- サブタスクや定期実行など、その場に人がいない実行では、申請は記録だけされて処理はパッケージ無しで続きます（あとから一覧で確認できます）。

## 関連

- 各設定（AGENTS.md / メモリ / Pieces / スキル / MCP / SSH / ブラウザ / ツール / メンバー / 招待リンク）の詳しい場所と操作 → [個人の資産（ワークスペース設定）](./09-userfolder.md)
- ワークスペースの活動を日付で振り返る → [カレンダー](./22-calendar.md)
- メンバーの役割・権限・安全管理（admin） → [ユーザー管理 / 安全性](./19-admin.md)
