---
id: workspace-apps
title: ワークスペース・アプリ
category: advanced
order: 200
keywords: [アプリ, app, GUI, apps, サンドボックス, ワークスペース, ツール, 共有, 共有リンク, 公開, share, read-only]
---

## ワークスペース・アプリとは

ワークスペース・アプリは、そのワークスペースの中で動く小さな HTML 製の道具です。たとえば「`output/` のファイルを一覧して選んだものにメモを付ける」「集めたデータを表やグラフで見る」といった、チャットの往復だけでは面倒な作業を、ボタンやフォームのある画面で片付けられます。

アプリはワークスペースの **「アプリ」タブ** に並びます。「開く」を押すとその場で起動し、ワークスペースのファイルを読み書きできます。

## エージェントに作ってもらう

アプリは自分で書く必要はありません。チャットで **「ワークスペース・アプリを作って」** と頼めば、エージェントが用途に合わせた HTML を組み立て、ワークスペースの `apps/` フォルダに保存します。保存されると「アプリ」タブに表示され、すぐ開けます。

例: 「このワークスペースの請求データから請求書を作るアプリを作って」「`output/` のレポートを並べて読めるビューアがほしい」。

作成後はヘッドレスブラウザで **自動 E2E テスト** が走り、アプリがファイルを読み書きできることを確認してから完了を報告します。テストに引っかかった場合はエージェントが自動で修正を試みます。

## 安全な動き方

アプリは隔離された領域（サンドボックス）で動きます。**外部ネットワークには一切つながりません** — 外部サイトへデータを送ったり、外部から何かを読み込んだりはできない設計です。ファイルの読み書きは、すべてあなたのログイン権限の範囲内で、ワークスペースの中だけに限られます。`output/` 以外への書き込みや削除は、実行のたびに確認が出ます。

## 公開リンクで共有する

作ったアプリを、ログインしていない相手にも見せたいときは **公開共有リンク** を発行できます。「アプリ」タブの各アプリカードにある「公開リンクを作成」を押すと、`/ui/app/...` の URL ができます。この URL を知っている人は、ログインせずにブラウザでアプリを開けます。発行・失効ができるのはワークスペースの管理者（オーナー）だけです。

公開リンクは安全側に振ってあります。覚えておくとよい点は次のとおりです。

- **read-only（読み取り専用）です。** 公開リンクで開いたアプリは、ファイルの読み取りはできますが、**書き込み・削除は一切できません**。
- **公開されるのは限られた範囲だけです。** そのアプリ自身（`apps/{名前}/`）と、ワークスペースの `output/` フォルダのファイルだけが見えます。ワークスペースの他のファイル（入力データ・メモ・設定など）は公開されません。
- **`output/` はワークスペースの共有フォルダです。** `output/` には、そのワークスペースの**すべてのチャットの成果物**が集まります。アプリ1つの公開リンクでも、`output/` 配下にある他のチャットの成果物まで一緒に見えてしまう点に注意してください。社外秘の成果物がある場合は、共有前に `output/` の中身を確認してください。
- **誰でも開けます。** URL を知っていれば誰でもアクセスできるので、社外秘の内容を含むアプリのリンクは扱いに注意してください。
- **いつでも失効できます。** カードの「失効」を押すと、その URL はすぐ使えなくなります。再び共有したいときは作り直してください。

URL は「URL をコピー」ボタンでコピーできます。発行済みのアプリには「公開リンク発行済み」のバッジが付きます。

## どこに置かれるか

アプリはワークスペースの `apps/{名前}/index.html` に置かれます。ファイルタブの `apps/` を開けば実体を確認でき、「アプリとして実行」からも起動できます。各アプリには表示名・説明を持たせる `app.json` を任意で添えられます（無ければフォルダ名が表示名になります）。

アプリの作り方の技術仕様（エージェント向け）は、リポジトリの `docs/workspace-apps-bridge.md` にまとまっています。
