# Workspace
> Univer Office SDK で構築したオープンソース Workspace。クラウド体験、セルフホスト、既存 Agent の CLI 接続、Desktop をひとつの流れで紹介します。
- Human documentation: [https://docs.univer.ai/ja-JP/overview/examples/workspace](https://docs.univer.ai/ja-JP/overview/examples/workspace)
- Agent Markdown: [https://docs.univer.ai/ja-JP/overview/examples/workspace.md](https://docs.univer.ai/ja-JP/overview/examples/workspace.md)
- Requested language: `ja-JP`
- Content language: `ja-JP`
- Documentation version: `1.3.0`
- Source: [examples/workspace.ja-JP.mdx](https://github.com/dream-num/documentation/blob/dev/content/docs/examples/workspace.ja-JP.mdx)
---
**Univer Workspace** は **[Univer Office SDK](https://docs.univer.ai/ja-JP/overview.md)** で構築したオープンソースの Office ワークスペースです。編集できる Office コンテンツやデータ連動の Web App を Personal / Team Space にまとめ、共有、共同編集、バージョン管理、変更レビューをつなぎます。[リポジトリ](https://github.com/dream-num/univer-workspace)にはアプリ、デプロイ構成、CLI、デスクトップクライアントが含まれます。
自社環境にデプロイすることも、[クラウド体験](https://space.univer.ai)から始めることもできます。既存 Agent は Workspace CLI で接続し、Workspace Desktop は Agent の会話とワークスペースをローカルアプリにまとめます。いずれも同じサービスとファイルを利用します。
[クラウド体験](#entry-points) · [Agent を接続](#cli-start) · [セルフホスト](#self-host) · [Desktop 体験](#desktop-start) · [ソースとカスタマイズ](#build-your-own)
## まずクラウドで Workspace を体験する
[クラウド体験](https://space.univer.ai)にサインインし、Personal Space またはアクセス可能な Team Space を開きます。文書の作成、編集、整理、共有を試せます。この稼働中のサービスには、次の CLI から Agent も接続できます。体験にはサンプルデータを使用してください。データはリセットされる場合があります。
**Workspace Server** は ID、Space、権限、ストレージ、共同編集、バージョンを管理し、**Web** は編集とレビューのブラウザー画面を提供します。プライベート環境でも同じ Server と Web をデプロイします。
```mermaid
flowchart LR
H["チームメンバー"] --> W["Web オンライン版
編集 · 共同作業 · レビュー"] --> S["Workspace Server
Space · 内容 · 権限 · バージョン"]
A["既存のエージェント"] --> C["Workspace CLI
Skills · コンテンツ操作"] --> S
```
## 既存 Agent をクラウド Workspace に接続する
Agent の実行環境に CLI と発見用 Skill をインストールします。Node.js 22.12 以降が必要で、24 を推奨します。コマンドを実行できる Agent は、自身のモデルと会話を維持したまま利用できます。ブラウザーと Agent が同じ Workspace を使うよう、クラウドの接続先を明示します：
```bash
npm install --global univer-workspace-cli@latest
npx skills add dream-num/univer-workspace --skill univer-workspace-cli -g
uvw --version
uvw config set workspace.origin https://space.univer.ai
```
#### 初回接続：ブラウザで一度ログイン
有効なセッションがあれば省略できます。ログインが必要な場合は次を実行します。
```bash
uvw auth login
```
返された URL を開き、ブラウザでログインしてコードを確認します。ユーザーが完了を伝えてから次を実行します。
```bash
uvw auth login --complete
```
セッションを確立する場合の手順です。詳細は [Workspace CLI ガイド](https://github.com/dream-num/univer-workspace/blob/main/apps/cli/README.md)をご覧ください。
初回のブラウザー承認後は、CLI がセッションを再利用します。Agent ごとのログイン画面や認証統合は不要です。接続した Agent に依頼し、返されたリンクを Web で開けば、同じコンテンツを確認して Office の変更をマージ前にレビューできます。
### 計算とレビューができる文書から始める
```text
個人 Workspace Space に英語の月次支出表を作成してください。日付、分類、金額と5件のサンプルデータを入れ、合計式と分類別グラフを追加してください。
独立した下書きでデータ、数式、表示を検証し、プレビューまたはレビューリンクを渡してください。私の確認前にはマージしないでください。
```
接続済みエージェントや Desktop に同じタスクを送れます。エージェントが作成・検証し、人が修正依頼、レビュー、マージ判断を行います。オンライン版からも同じ内容を開けます。
## 同じワークフローを自社環境へ移す
[リポジトリ](https://github.com/dream-num/univer-workspace)には Server と Web が含まれます。[デプロイガイド](https://github.com/dream-num/univer-workspace/blob/main/apps/workspace/README.md#docker)に従って、ドメイン、ログイン、永続ストレージ、実行設定を構成してください。ソース開発は Node.js 24 と pnpm 11 を使用します。
同じ CLI の接続先を変更し、そのサービスのアカウントを承認します。以下の例を実際のサービス URL に置き換えてください：
```bash
uvw config set workspace.origin https://workspace.example.com
uvw auth login
```
Agent のツールと Skills は同じまま、自社サービスのファイルと権限を使います。Desktop も接続できます。クライアント登録とコールバック設定は [Agent 接続ガイド](https://github.com/dream-num/univer-workspace/blob/main/apps/agent/README.md#connect-to-a-local-workspace)を参照してください。
## Workspace をローカル Desktop クライアントへ
**Workspace Desktop** は Workspace、Agent ランタイム、Office ツール、プレビューをローカルアプリに統合します。Codex や Cowork のように、目標を伝え、会話の横で文書や Web App を確認し、修正を依頼して成果をレビューできます。
クラウド、自社環境、またはローカルで動く Workspace サービスに接続します。モデルと会話は設定した Agent ホストが担当し、ファイルとアクセス権は接続先 Workspace が管理します。以下の実際のデスクトップ事例で、作成、管理、共同作業の流れを紹介します。
[インストールして接続する](#desktop-install) · [最初のタスク：2つの文書で予算をレビューする](#desktop-first-task)
### 日常の Office 作業にエージェントの流れを取り入れる
Office の成果物には、継続的な編集、数式計算、共同作業、変更レビューが必要です。Desktop はこれらを同じ環境にまとめ、編集・計算・共有できる内容を中心に会話を進めます。
- **文脈を維持：** 会話、ファイル、Workspace 資料、ローカル参照を手元に置けます。
- **Office と Web App を作成：** 編集可能なスプレッドシート、文書、スライド、Relational Table、Canvases と、それらのデータを使う対話型ページを生成します。
- **確認しながら修正：** 横で内容を開き、数式とレイアウトを確認して具体的な変更を依頼できます。
- **レビュー後に共有：** Office の変更は Worktree に保持し、人が差分を確認して共有空間へマージします。
### 依頼からレビュー可能な成果物へ
通常の会話で Office 文書と Web App を作成・修正し、Space でまとめて管理・共有します。ネイティブ Office の変更は Worktree でレビューしてマージします。HTML 公開とバインディング書き込みは固有の保存・認可フローを使います。次の会話でも同じファイルやデータを参照できます。
```mermaid
flowchart LR
A["通常の会話
依頼と資料"]
B["Office 文書
Worktree と変更レビュー"]
C["Web App
HTML とデータバインディング"]
D["Space
管理・共有・共同作業"]
A --> B --> D
A --> C --> D
D -->|同じコンテンツで作業を続ける| A
```
### デスクトップに統合される機能
| 機能 | 体験 |
| --- | --- |
| エージェントセッション | 会話とタスクの文脈を保持し、モデルプロバイダーと認証情報をローカルで設定。 |
| ファイルと参照 | アクセス可能な Space を閲覧し、@ で Workspace ファイル、フォルダー、ローカル資料を参照。 |
| コンテンツのプレビュー | 会話の横でネイティブ Office ファイルや Web App を開き、内容・操作・データを確認。 |
| レビューと引き渡し | Worktree の追加・変更・削除を確認し、修正、マージ、破棄を選択。 |
| ローカルとオンライン | チームのサービスまたは自分のマシン上の Workspace に接続。 |
| Space の管理と共同作業 | 会話で作成したファイルを整理し、共有権限を管理して、チームで同じ内容を編集。 |
### Workspace と Agent の連携を実際の画面で見る
以下の画像と操作シーケンスは、新規のローカル Workspace に接続した macOS デスクトップアプリで撮影しています。アカウント、Space、ファイル名、本文、Agent の会話には英語の架空データを使用しています。
#### 通常の会話で作成し、その場でプレビュー
**Build Five-File Launch Demo** は、スプレッドシート、文書、スライド、Relational Table、キャンバスを作成した通常のエージェント会話です。実際の会話での引き渡しと、Desktop のブラウザーパネルで編集できる **02 Launch Brief** を並べています。会話で修正を依頼し、生成されたファイルを Space で管理・共有できます。
Agent は通常の会話で対話型レポート、業務ページ、ダッシュボードも作成できます。後続の会話では公開済み予算表から **06 Launch Dashboard** を作成しました。3つのカードが予算・実績・差額を表示し、比較グラフが HTML View のライブバインディングで6領域のデータに追従します。この例は同じネイティブ表計算を読み取るだけで、書き戻しは行いません。[双方向バインディング](https://docs.univer.ai/ja-JP/overview/features/shared/binding.md)は実験段階で、変更される可能性があります。
#### 成果物を Space で管理・共有・共同編集
会話で作成した5つのネイティブファイルと **06 Launch Dashboard** を **Aurora Launch Studio** にまとめています。同じ Space で予算、概要文書、3枚のスライド、タスク台帳、プロセス図、Web App を整理し、アクセスを管理してチームと共有します。チームがネイティブ Office 内容を共同編集すると、連携ページも元データに追従します。Web と Desktop は同じファイルを使い、Agent の追加修正は独立した Worktree でレビューを待ちます。
#### Desktop でコンテンツを開き、草稿をレビュー
実際の Desktop 操作で、ローカル Space のファイルを開き、各製品のネイティブエディターを確認して、実際の Agent 会話に戻ります。内容はアプリ内で引き続き編集できます。
#### Desktop で共有コンテンツを共同編集
Web と Desktop は同じローカルアカウントで **01 Launch Budget** を開きます。Web で入力したメモが実際の Desktop エディターに現れ、Desktop の確認メモも Web に同期されます。画像には2つのメモと同期済み状態が表示されています。これは同一アカウントのクライアント間同期の例です。Agent の草稿は Worktree に分離されています。
#### 対話で生成し、修正してレビューに渡す
Agent は独立した Worktree で **02 Launch Brief** を修正します。2週間の承認ゲートと担当者の作業を追加し、再訪率の目標を40%から45%へ変更して、リスクと対策を記録します。画像は実際の会話とネイティブ文書プレビューで、共有元の文書は変更していません。
#### Worktree と Compare：Desktop で草稿を確認
文書の Review changes から、共有内容と Worktree の提案稿をネイティブ文書ビューで並べて確認できます。スクロールして内容と差分を調べ、受け入れる変更を判断します。画像のデスクトップ統合プレビューは読み取り専用で、この例では草稿をマージしていません。
#### Desktop で共有設定を確認
Desktop の Space 共有パネルでは、チーム Space のメンバーの役割とリンクのアクセス設定を確認できます。メンバーは役割に応じて共有コンテンツにアクセスし、リンクをコピーしてもアクセス権は追加されません。撮影時に共有権限は変更していません。
### 1つのデスクトップで5種類のネイティブコンテンツを扱う
英語の Aurora プロジェクトでは架空データを使い、予算、概要文書、プレゼンテーション、タスク台帳、プロセス図をつないでいます。画面は Desktop 内のネイティブ Office エディターです。Agent が操作する同じ内容を人も編集できます。
スクリーンショットはデスクトップ統合のプレビューです。ホストの拡張ポイントで Univer のブランド外観を適用しています。拡張可能な Agent ホストと Space プラグインを組み合わせており、プレビュー版プラグインの配布状況はプロジェクトのリリースに従います。
#### Sheets：計算できる事業モデル
予算表は6つの作業領域を管理し、Budget、Actual、Variance を数式で計算し、ネイティブの比較グラフを表示します。合計は予算 USD 102,000、実績 USD 100,000、予算内の差額 USD 2,000 です。Agent は Facade API で計算結果を検証します。
#### Docs：根拠を意思決定につなげる
見出し、段落スタイル、リスト、ネイティブ表で、目的、計画、成功指標、担当者を整理します。続く会話では、同じ編集可能な文書の一部を Worktree で修正できます。
#### Slides：事業の流れを伝える
3枚のスライドは、編集可能なテキストと図形、統一したスタイルで、価値提案、4段階の計画、成功指標と担当者を説明します。同じアプリでレイアウトの調整と発表ができます。
#### Relational Table：実行と納品を管理する
6件のタスクに、ステータス、優先度、担当者、期限、メモの型付きフィールドを設定しています。色付き選択肢で進捗と優先度を確認できます。
#### Canvases：戦略と実行をつなぐ
ネイティブ図形、テキスト、コネクターで **Align → Activate → Share → Learn** の4段階を示し、短いメモで作業と根拠を結びます。
### インストールして接続する
拡張可能な Agent デスクトップに Space プラグインをインストールして有効化し、Space からサービスに接続してモデルとブランド外観を設定する方法もあります。本ページの画面はこの構成です。完成版 Desktop とプレビュープラグインは配布経路が異なるため、使用する版のリリース情報またはリポジトリの手順に従ってください。
1. [GitHub Releases](https://github.com/dream-num/univer-workspace/releases) から Desktop を選びます。agent-v タグの Windows x64、macOS Apple Silicon、Linux x64 が対象です。デスクトップ提供は実験段階で、公開版の状況を確認してください。
2. **Settings → Workspace** で接続先を指定し、ブラウザーでログイン・認可します。既存サービス、または[ローカル環境](https://github.com/dream-num/univer-workspace/blob/main/apps/agent/README.md#connect-to-a-local-workspace)に接続できます。
3. Models 設定で対応するプロバイダー、モデル、認証情報を設定します。Workspace ログインとは別の設定です。[モデル設定](https://github.com/dream-num/univer-workspace/blob/main/apps/agent/README.md#model-credentials)を参照してください。
4. アクセスできる個人またはチーム Space を追加し、会話を作って @ で資料を参照します。下のタスクでプレビューと変更レビューを試してください。
インストーラーはエージェントと Office ツールを含みます。Workspace サービスはローカルまたはサーバーで別途実行し、モデル接続も設定します。
### 最初のタスク：2つの文書で予算をレビューする
```text
現在の Space に英語の Budget Review シートを作成してください。Department、Budget、Actual、Variance の8行の部門サンプルを入れ、差異と合計を数式にし、予算と実績のグラフを追加してください。
超過支出を説明しシートにリンクする短い文書も作成してください。Office 変更は同じ Worktree に保持し、データ・数式・結果を検査してプレビューと差分を開き、私の承認までマージしないでください。
```
続けて「Marketing の予算を10%減らし、要約を更新して」と依頼し、値と文書の差分を確認してから受け入れます。
#### 実際のセッション：モデルから意思決定メモへ
Aurora のデスクトップセッションは、元ファイルの読み取り、ネイティブ文書の修訂、後続レビューをつなぎます。既存の草稿は Ready のまま人間の承認を待ちます。[実際のデスクトップ会話](#conversation-preview)と[ネイティブの Worktree 比較](#workspace-review)をご覧ください。
## リポジトリを基に独自の Workspace を作る
ここまでのアプリは Office SDK を組み合わせたものです。[Workspace リポジトリ](https://github.com/dream-num/univer-workspace)を起点に、コンテンツランタイムと共同編集を再利用し、業務フロー、Skills、ツール、画面をチームに合わせて変更できます。
### 変更する場所を見つける
| リポジトリ内の場所 | 役割 |
| --- | --- |
| [`apps/workspace`](https://github.com/dream-num/univer-workspace/tree/main/apps/workspace) | Server、Web、製品 API、デプロイ設定。 |
| [`apps/cli`](https://github.com/dream-num/univer-workspace/tree/main/apps/cli) | 既存 Agent と稼働中 Workspace の接続。 |
| [`apps/agent`](https://github.com/dream-num/univer-workspace/tree/main/apps/agent) | Agent ホスト、接続ライフサイクル、ネイティブ Desktop シェル。 |
| [`skills/univer-workspace-cli`](https://github.com/dream-num/univer-workspace/tree/main/skills/univer-workspace-cli) | 既存 Agent に導入する発見用 Skill。 |
| [`packages/client-core`](https://github.com/dream-num/univer-workspace/tree/main/packages/client-core) | Node ホストで共有する Workspace コンテンツ操作。 |
| [`packages/dsh-univer-workspace-plugin`](https://github.com/dream-num/univer-workspace/tree/main/packages/dsh-univer-workspace-plugin) | Office ツール、ネイティブプレビュー、作業ガイド。 |
| [`packages/dsh-univer-workspace-skin-plugin`](https://github.com/dream-num/univer-workspace/tree/main/packages/dsh-univer-workspace-skin-plugin) | Workspace のブランドとビジュアルトークン。 |
| [`packages/workspace-html-viewer`](https://github.com/dream-num/univer-workspace/tree/main/packages/workspace-html-viewer) | Web App の HTML View サンドボックスとバインディングホスト。 |
### Skills：作業環境の理解からタスクの完了まで
#### 既存 Agent 向けの Skills
既存のエージェントに入れる [`univer-workspace-cli` Skill](https://github.com/dream-num/univer-workspace/blob/main/skills/univer-workspace-cli/SKILL.md) は、接続、対象の特定、ガイドの読み込みを案内する入口です。完全なランタイム Skills は CLI に同梱され、コマンドと Facade API のバージョンに対応します。Desktop の内蔵プラグインもタスク向けガイドとツールを提供します。
| ガイド | 対象 |
| --- | --- |
| `core` | Space・ファイルの特定、タスク下書き、検証、レビューへの受け渡し。 |
| `sheet` · `doc` · `slide` · `base` · `board` | 表計算、文書、プレゼンテーション、Relational Table、Canvases。 |
| `blob` | 元ファイルのアップロード、ダウンロード、置き換え。 |
| `html-view` | ライブ HTML ページを生成・管理し、対話型 Web App を作成。 |
| `embed` · `cross-unit-formula` | 別コンテンツの埋め込みとコンテンツ間のデータ・数式参照。 |
```bash
uvw skills list
uvw skills get core
uvw skills get sheet
uvw skills get html-view
```
まず `core`、次に対象製品やトピックを読み込みます。`skills get` に参考パスが表示され、`uvw skills read ` で個別に、`--full` でまとめて読めます。既存エージェントは CLI、Desktop は会話に統合したツールとガイドを使います。
#### Desktop 内の作業ガイド
能力プラグインには **univer** Skill と参照資料が同梱されます。Space と文書の特定、Office API、Worktree の作成・確認・引き渡しを案内します。エージェントは API を調べ、ネイティブ内容に実行し、結果を検査できます。
[機能プラグイン](https://github.com/dream-num/univer-workspace/blob/main/packages/dsh-univer-workspace-plugin/README.md)は、ファイル探索、Headless Facade 編集、構造化検査、インポート・エクスポート、Worktree 管理をつなぎます。このプレビューは草稿をレビュー可能な状態にし、公開にはデプロイしたアプリのレビューとマージの手順を使います。同じ Office ランタイムに業務 Skills、テンプレート、ツールを追加できます。
プレビュープラグインには9つの Skills が含まれます。共通 Skill は検索、ID、納品の流れを、製品別 Skill は API と検証方法を説明します。Agent はタスクに必要なガイドを読みます。
| Skill | 操作ガイド |
| --- | --- |
| `univer` | Space、ファイル、ドラフトのライフサイクルと納品 |
| `univer-sheet` | 数式、スタイル、グラフ、表計算の検証 |
| `univer-doc` | 文書構造、段落、表 |
| `univer-slide` | スライド作成と視覚的なレイアウト検査 |
| `univer-base` | フィールド、レコード、ビュー |
| `univer-board` | 図形、コネクター、キャンバス配置 |
| `univer-embed` | 別の Office 製品を埋め込む |
| `univer-cross-unit-formula` | Unit 間の参照と計算 |
| `univer-html-view` | Office データにバインドした HTML ページの作成と検査 |
### Agent の実行ループと Office 機能を分けて組み立てる
Skills が作業を案内し、ツールが Headless ランタイムで構造化コンテンツを操作し、ネイティブエディターが人向けの表示と編集を担います。Workspace はファイルと共同作業の文脈を提供します。モデル、業務ツール、ブランド外観を変更しても、Office エンジンを作り直す必要はありません。
```mermaid
flowchart LR
A["Agent とモデル"]
B["Skills とツール"]
C["Office SDK
Headless 操作と検証"]
D["Workspace サービス
ファイル・共同作業・バージョン"]
E["デスクトッププレビュー
ネイティブエディターと Web App"]
F["Worktree と Compare
人によるレビュー"]
A --> B --> C --> D
D <--> E
D --> F
F --> E
```
| 構成要素 | 役割 |
| --- | --- |
| [Web SDK](https://docs.univer.ai/ja-JP/guides/sheets.md) | 共通モデル、Office 編集、描画、数式、Headless Facade 操作。 |
| [Server SDK](https://docs.univer.ai/ja-JP/server.md) | アプリのバックエンドにつながる共同編集、バージョン、Worktree。 |
| [AI SDK](https://docs.univer.ai/ja-JP/ai.md) | エージェント向けの内容操作、検査、検証。 |
| 実行環境と Skills | DSH が会話、モデル、ツール実行、承認を提供し、Workspace プラグインが Office に接続。 |
| Workspace と Desktop | Space、ファイル、ID 連携、レビュー画面をアプリが提供し、Electron がデスクトップとして配布。 |
依頼 → ツール → 編集可能な内容 → プレビュー → レビュー → 共有、という流れを再利用できます。Office SDK が Office 層、ホストが会話と実行ループを担います。[既存アプリとプラグイン](https://github.com/dream-num/univer-workspace/tree/main/apps/agent)を拡張することも独自ホストに接続することもできます。
### 自社の業務フローへ拡張する
| 目的 | 開始場所 |
| --- | --- |
| 業界固有の文書やタスク | 業務 Skills、テンプレート、ツールガイドを追加し、内容と表示の検証を維持します。 |
| 独自の ID、ストレージ、共有 | Workspace アプリとサーバー側の業務ポリシーを拡張します。 |
| 独自の Agent Office クライアント | Agent ホスト、機能プラグイン、ブランドを組み合わせ、モデルや業務ツールを接続します。 |
### 実装を確認する
[Desktop のビルドと配布](https://github.com/dream-num/univer-workspace/blob/main/apps/agent/desktop/README.md) · [エージェントアプリと設定](https://github.com/dream-num/univer-workspace/blob/main/apps/agent/README.md) · [すべての例](https://docs.univer.ai/ja-JP/overview/examples.md)
[Office Lab](https://docs.univer.ai/ja-JP/overview/examples/office-lab.md)