Workspace
Univer Office SDK で構築したオープンソース Workspace。クラウド体験、セルフホスト、既存 Agent の CLI 接続、Desktop をひとつの流れで紹介します。
Univer ワークスペースは、**Univer Office SDK**上に構築されたオープンソースのオフィスワークスペースです。これにより、人々とエージェントが連携しています。編集可能なOfficeコンテンツとデータバウンドWebアプリは、個人とチームスペースに編成され、共有、コラボレーション、バージョン、およびレビューを変更します。 ソースリポジトリには、アプリケーション、デプロイメント構成、CLI、デスクトップクライアントが含まれています。
ワークスペースを自分のインフラにデプロイしたり、クラウドトライアル で起動したりすることができます。既存のエージェントは、ワークスペース CLI を介して接続します。ワークスペースデスクトップは、エージェントの会話と、ローカルアプリケーションに同じワークスペースをもたらします。これらのすべてのルートは、同じサービスと同じファイルで動作します。
クラウド体験 · Agent を接続 · セルフホスト · Desktop 体験 · ソースとカスタマイズ
まずクラウドで Workspace を体験する
クラウドトライアルを開き、サインインして、アクセスできるパーソナルスペースまたはチームスペースを入力します。ドキュメントを作成または開いたり、直接編集、ファイル組織、共有を試したりします。ワークスペースサービスは既に実行中なので、エージェントは下記のCLIを通して接続することもできます。トライアルはサンプルデータのために意図されており、そのデータはリセットされる可能性があります。
ワークスペース サーバーは、アイデンティティ、スペース、パーミッション、ストレージ、コラボレーション、およびバージョンを管理します。 ウェブページ は、編集とレビューのためのブラウザインターフェイスです。 プライベートのデプロイメントは、同じサーバーとWebアプリケーションを実行します。
既存 Agent をクラウド Workspace に接続する
エージェントが実行する環境でCLIと発見スキルをインストールします。 Node.js 22.12 または newer が必要です。Node.js 24 が推奨されます。 コマンドを実行できるエージェントは、独自のモデルと会話を提供し続けます。 ブラウザとエージェントが同じワークスペースで動作するように、クラウドサービスを明示的に設定します。
npm install --global univer-workspace-cli@latestnpx skills add dream-num/univer-workspace --skill univer-workspace-cli -guvw --versionuvw config set workspace.origin https://space.univer.ai初回接続:ブラウザで一度ログイン
有効なセッションが既に存在すると、このステップはスキップできます。 サインインが必要な場合は、次の手順を実行します。
uvw auth login返されたリンクを開き、サインインし、ブラウザのコードを確認します。 ユーザーが完了を確認した後、実行します。
uvw auth login --completeこの手順は、セッションの確立時にのみ必要です。 ワークスペース CLIガイド は、完全なコマンドセットと認証を文書化します。
ブラウザがCLIを一度承認した後、CLIは、後続のタスクのセッションを再利用します。エージェント固有のログインページや認証統合は必要ありません。接続されたエージェントをタスクにし、Webで返されるリンクを開きます。コンテンツは同じです。エージェントのネイティブオフィスの変更は、マージする前に確認することができます。
計算とレビューができる文書から始める
個人 Workspace Space に英語の月次支出表を作成してください。日付、分類、金額と5件のサンプルデータを入れ、合計式と分類別グラフを追加してください。独立した下書きでデータ、数式、表示を検証し、プレビューまたはレビューリンクを渡してください。私の確認前にはマージしないでください。このテキストをコネクティッドエージェントに送信するか、デスクトップで使用してください。エージェントは文書を作成して検証し、変更を要求し、結果を確認し、マージするかどうかを決定します。同じコンテンツもオンライン版で開きます。
同じワークフローを自社環境へ移す
オープンソースリポジトリはサーバーおよびWebを含んでいます。展開ガイドと適用を造り、そしてドメイン、印、永続的な貯蔵およびランタイム設定を構成して下さい。源からの開発はNode.js 24およびpnpm 11を使用します;ガイドは生産の配置の細部を維持します。
導入前に、4つの部品を用意します。
| 項目 | 設定内容 |
|---|---|
| サービス | 到達可能なワークスペース URL と Server + Web アプリケーション。デスクトップと CLI は、このデプロイメントに接続します。 |
| 永続データ | 製品データベース、コラボレーションデータベース、アップロードされたファイルをまとめて保存します。デフォルトのデプロイメントは、.dataで保存されます。Dockerの場合、永続的なボリュームをマウントします。 |
| 認証 | サインインの設定。デスクトップ接続時に、エージェント OAuth クライアントに正確なコールバック URL マッチを登録します。 |
| SDK ライセンス | デプロイドメイン用のWebを構築し、Node.jsコンテンツの実行時間別に必要なライセンスを設定する際に、VITE_UNIVER_LICENSEを提供します。 |
モデルの資格情報は、エージェントホストに属し、ワークスペースのサインインから別々に設定されています。 展開ガイドとエージェントのセットアップは、現在の設定を記述します。
同じCLIを設定して、プライベート展開を使用して、そのサービスのアカウントを承認します。 実際のサービス起源で、以下の例アドレスを置き換えます。
uvw config set workspace.origin https://workspace.example.comuvw auth loginエージェントは、同じツールとスキルを維持し、プライベートサービスのファイルと権限で動作します。デスクトップは、そのサービスに接続することもできます。 エージェント接続ガイドドキュメントクライアント登録とコールバック設定。
Workspace をローカル Desktop クライアントへ
ワークスペースデスクトップは、ワークスペース、エージェントのランタイム、オフィスツール、コンテンツプレビューをローカルクライアント1つにまとめています。オフィスワークは、コーデックスやコワークからよく知られる会話とレビューパターンに従います。目的の結果を記述し、会話の横にあるドキュメントまたはWebアプリを調べ、修正をリクエストし、結果を見直します。
デスクトップは、上記のクラウドワークスペースに接続したり、プライベート展開や、ローカルマシン上で実行されるワークスペースサービスに接続することができます。接続されたワークスペースがファイルとアクセスを管理している間、モデルと会話は、構成されたエージェントホストを介して実行されます。下のデスクトップの例では、作成、管理、コラボレーションがどのように接続するかを示しています。
インストールして接続する · 最初のタスク:2つの文書で予算をレビューする
日常の Office 作業にエージェントの流れを取り入れる
会話がダウンロード可能なファイルを返すと、オフィスワークは継続します。 人々は、編集を維持し、実際のデータから計算し、チームメイトと連携し、どの変更を受け付けるかを決定します。 デスクトップは、これらの活動を1つの作業環境に配置します。
- **コンテキストを保ちましょう:**の会話、ファイル、ローカルリファレンス、およびワークスペースの資料は利用できます。
- ネイティブ Office コンテンツと Web App: スプレッドシート、文書、スライド、Relational Tables、Canvases の作成・プレビュー・編集に対応し、Office データを使った対話型ページも構築できます。
- **結果を見て、修正します。**は会話の横にコンテンツを開き、式とレイアウトを調べ、特定の変更を要求します。
- レビューを通して渡して下さい: エージェントのネイティブオフィスの変更は、Worktreeに残り、人がレビューし、共有されたワークスペースに統合します。
依頼からレビュー可能な成果物へ
オフィス文書とWebアプリは、通常の会話で生成され、変更され、スペースで管理され、共有されます。 ネイティブオフィスは、彼らが合併する前に、Worktreeレビューを通過します。 HTMLの出版物と結合は、独自の保存と承認の流れに従います。 後で会話は、同じファイルとデータを参照することができます。
デスクトップに統合される機能
| 機能 | 体験 |
|---|---|
| エージェントセッション | ローカルで管理されるプロバイダおよびモデル構成と会話およびタスクのコンテキスト。 |
| ファイルと参照 | アクセスできるスペースをブラウズします。@を使用してワークスペースファイルやフォルダ、ローカル素材を参照します。 |
| コンテンツのプレビュー | ネイティブなOfficeファイルやWeb Appsを会話の横に開くと、コンテンツ、インタラクション、データが確認できます。 |
| レビューと引き渡し | Worktreeを追加、修正、または削除した文書を参照し、リビジョン、マージ、または廃棄を要求します。 |
| ローカルとオンライン | チームのオンラインサービスに接続したり、ローカルマシンでワークスペースサービスを実行したりできます。 |
| Space の管理と共同作業 | ファイルの会話を整理し、共有を管理し、同じコンテンツをチームメイトで編集します。 |
Workspace と Agent の実際の連携
下のスクリーンショットは、ローカルのワークスペースに接続された実際のmacOSデスクトップとフィクションランス素材を使用して表示されます。 この統合プレビューは、拡張可能なエージェントホスト、スペース機能プラグイン、およびUniverブランドスキンを組み合わせます。 利用可能なプロジェクトリリースは以下の通りです。
通常の会話で作成し、その場で確認する
通常の会話で要件を記述し、Agent はOffice 文書と Web Apps を作成または改訂します。 プレビューは右に表示され、さらにはリファインメントは会話を続けていきます。 スペースはファイル、共有、コラボレーションを管理するワークスペースに保存されます。
01 スタートアップ予算は、予算、実際の支出、予測、分散式、および合計を1枚のシートにまとめています。チャートは実際の支出と予算を比較し、各ワークストリームの分散を示しています。
02 起動の短いは目標、計画、成功対策、所有者の行動を編集可能な文書に変換します。
03 スタートストーリーは、計画を立ち上げステージ、承認ゲート、成功対策でプレゼンテーションに変え、チームレビューの準備をします。
04 打ち上げプランは、フェーズ、ステータス、優先順位、所有者によってタスクを追跡し、グリッド、ステータスボード、およびフェーズビューを作業進捗として切り替えるサポートを行います。
05 スタートマップは、キャンバス上の打ち上げステージを接続します, 成果物を配置, 所有者, そして、承認チェックポイントを1つの視覚計画で.
同じ会話ワークフローでは、Web Apps も生成します。06 ダッシュボードを起動 は、予算、実際の支出、および KPI カード、チャート、およびワークストリームの詳細として分散を提示します。HTMLビューのバインディングでは、ページがスプレッドシートのデータを読み込むことができます。そのため、チームは、Office ファイルの横にあるインタラクティブなレポートを使用できます。ビンディングは実験的ままです。
作成した成果を Space で管理する
会話の結果は、チームが引き続き使用できるファイルになります。スペースは、オフィスコンテンツとWeb Appsを1か所にまとめ、製品カテゴリ、最近のファイル、お気に入り、個人またはチームスペースを備えています。以下のすべて すべてビューは、オーロラ・ローンチ・スタジオとチーム紹介から材料を収集します。
Space から編集と共同作業を続ける
スペースから01 スタートアップ予算を開き、ネイティブスプレッドシートエディタを続行します。予算ライン、式、および合計は編集可能であり、コメント、編集履歴、共有も同じビューで利用できます。Webとデスクトップは同じワークスペースファイルを読みます。後者のエージェントリビジョンは、レビューまで別のWorktreeに残ります。
Worktree と Compare:レビューしてからマージする
インテリジェントなワークベンチでは、エージェントの提案された変更の横にある公式の予算を比較します。ドラフトは2つのラインアイテムを追加し、合計を更新し、変更リストとハイライトは、影響を受けるセルを識別します。コンテンツ、フォーマット、または式を調べて、ドラフトをマージまたは破棄します。 Worktreeはドラフト、比較するが差を示します。
ドキュメントや Web App をチームに共有する
シェアするをダッシュボードで開くと、ページにアクセスしてリンクをコピーすることができます。このチームスペースでは、ページは、メンバーの許可をスペースから継承し、スペースアクセスの管理は、それらの権限が管理される場所を開きます。リンクをコピーすると、追加のアクセスを許可しません。
インストールして接続する
拡張可能なエージェントデスクトップが既に使用している場合は、統合パスはスペース機能プラグインをインストールして有効化し、スペースから接続し、モデルを設定し、ブランドスキンを追加します。このページのスクリーンショットは、この構成を使用します。フルワークスペースデスクトップリリースとプラグインプレビューは、別々のデリバリーパスに従います。公開されたリリースまたはインストールされたバージョンのリポジトリの指示を使用してください。
-
GitHubリリースからデスクトップインストーラを選択します。デスクトップリリースはエージェントvタグを使用していますので、Windows x64、macOS Apple Silicon、またはLinux x64のアーティファクトを選択します。 デスクトップデリバリーは実験的であり、公開されたリリースに従います。
-
設定 → ワークスペースでは、ワークスペースサービスを選択し、ブラウザでサインインし、アクセスを承認します。 デプロイされたサービスに接続するか、ローカルセットアップに従ってローカルサービスを実行します。
-
モデル設定では、サポートされているプロバイダ、モデル、および認証情報を設定します。 ワークスペースのサインインとモデルアクセスは別々に設定されています。 モデル構成を参照してください。
-
アクセス可能な個人またはチームスペースを追加し、会話を開始し、@を使用してソース素材を参照します。 下のタスクを実行し、コンテンツのプレビューと変更レビューを開きます。
インストーラには、エージェントアプリケーションとOfficeツールが含まれています。ワークスペースサービスは、ローカルまたはリモートで実行され、モデルアクセスは、設定されたプロバイダを使用します。
最初のタスク:2つの文書で予算をレビューする
現在の Space に英語の Budget Review シートを作成してください。Department、Budget、Actual、Variance の8行の部門サンプルを入れ、差異と合計を数式にし、予算と実績のグラフを追加してください。超過支出を説明しシートにリンクする短い文書も作成してください。Office 変更は同じ Worktree に保持し、データ・数式・結果を検査してプレビューと差分を開き、私の承認までマージしないでください。フォローアップ:「マーケティングの予算を10%削減し、まとめを更新する」。 修正された値と文書の変更を確認 草案を受け入れる前に。
リポジトリを基に独自の Workspace を作る
上記のアプリケーションは、適応可能なOffice SDK構成です。 ワークスペースリポジトリから始めて、コンテンツのランタイムとコラボレーション機能を再使用し、チームの要件に関するワークフロー、スキル、ツール、インターフェイスを再構築します。
変更する場所を見つける
| リポジトリ内の場所 | 役割 |
|---|---|
apps/workspace | Server、Web、製品 API、デプロイ設定。 |
apps/cli | 既存 Agent と稼働中 Workspace の接続。 |
apps/agent | Agent ホスト、接続ライフサイクル、ネイティブ Desktop シェル。 |
skills/univer-workspace-cli | 既存のエージェントにインストールされたディスカバリースキル。 |
packages/client-core | Node ホストで共有する Workspace コンテンツ操作。 |
packages/dsh-univer-workspace-plugin | Office ツール、ネイティブプレビュー、作業ガイド。 |
packages/dsh-univer-workspace-skin-plugin | Workspace のブランドとビジュアルトークン。 |
packages/workspace-html-viewer | HTML Webアプリ用のサンドボックスとデータ結合ホストを表示します。 |
Skills:作業環境の理解からタスクの完了まで
これらのスキルは、既存のエージェントが接続されたワークスペースでOfficeコンテンツとWeb Appsを作成および編集し、レビューのために変更をオフにすることができます。 エージェントをワークスペースに接続するは、最初に、以下のガイダンスは、そのサービスのファイルと権限で動作します。
既存 Agent 向けの Skills
既存のエージェントにインストールされたuniver-workspace-cli スキルは、検出エントリポイントです。 ターゲットを接続、検索し、運用ガイダンスをロードする方法を説明しています。 完全なランタイムスキルは、CLIで出荷し、そのコマンドとFacade APIにマッチします。 デスクトップの組み込み機能プラグインは、タスクガイダンスとツールを提供します。
| ガイド | 対象 |
|---|---|
core | スペースとファイルを取り込む, タスクドラフトで作業, コンテンツをチェックし、レビューのためにオフに渡す. |
sheet · doc · slide · base · board | 表計算、文書、プレゼンテーション、Relational Table、Canvases。 |
blob | 元のファイルをアップロード、ダウンロード、および置き換えます。 |
html-view | インタラクティブなWebアプリ用のライブHTMLページの作成と管理。 |
embed · cross-unit-formula | 他のコンテンツの埋め込みや、コンテンツタイプ間でのデータと式を繋ぐ。 |
uvw skills listuvw skills get coreuvw skills get sheetuvw skills get html-viewcoreを最初にロードし、タスクで必要な製品やトピック。 skills getは参照パスをリストします。 uvw skills read <name> <path>で1つのドキュメントを読み、 --fullを追加して、それらすべてを読みます。 既存のエージェントは、CLIを通してこれらの機能を使用します。デスクトップはツールと会話ワークフローにガイダンスを統合します。
Desktop 内の作業ガイド
デスクトップ機能プラグインには、ユニバー スキルとその参照が含まれています。 スペースと文書がどのように関連するか、Office API の使用方法、および Worktreeの作成、チェック、および配信方法について説明します。 手順は実行可能なツールに同行しているため、エージェントは API を調べ、ネイティブコンテンツで実行し、結果を検査することができます。
機能プラグインは、ファイル検出、ヘッドレスファサード編集、構造化された検査、インポートおよびエクスポート、およびWorktreeライフサイクルツールを組み合わせています。 このプレビューでは、レビュー用のドラフトを用意します。 公開は、デプロイされたアプリケーションのレビューとマージワークフローを通過します。 アプリケーションは、同じOfficeランタイムにドメインスキル、テンプレート、およびビジネスツールを追加できます。
プレビュープラグインには、9つのスキルが含まれています。 一般的なスキルは、発見、アイデンティティ、および配信をカバーし、各製品スキルは、そのAPIと結果を確認する方法をカバーしています。 エージェントは、現在のタスクで必要なガイダンスを読みます。
| Skill | 操作ガイド |
|---|---|
univer | Space、ファイル、ドラフトのライフサイクルと納品 |
univer-sheet | 数式、スタイル、グラフ、表計算の検証 |
univer-doc | 文書構造、段落、表 |
univer-slide | スライド作成と視覚的なレイアウト検査 |
univer-base | フィールド、レコード、ビュー |
univer-board | 図形、コネクター、キャンバス配置 |
univer-embed | 別の内部に1つのオフィス製品を埋め込む |
univer-cross-unit-formula | ユニット間での参照と計算 |
univer-html-view | オフィスデータに縛られたHTMLページの構築と検査 |
Office SDK が Workspace を支える仕組み
Workspace は、ネイティブ エディター、エージェント コンテンツ オペレーション、チーム コラボレーションを同じドキュメントとパーミッションに接続します。このオープンソース アプリケーションと Office SDK 上でビルドでき、ビジネス ワークフロー、インターフェイス、統合に関する作業に集中できます。
エージェントは、CLI またはデスクトップを介して Node.js でコンテンツを操作し、Web またはデスクトップエディタで表示、編集、およびレビューします。ワークスペース サーバーは、共有文書、ドラフト、コラボレーション状態を保存し、プライベートサーバー、またはクラウド上でローカルで実行できます。
| 層 | 役割 |
|---|---|
| Web SDK | コンテンツモデル、数式、公開 Facade API、ネイティブエディター。 |
| AI SDK | API 検索、構造化された内容検査、指定文書に対する Facade 実行。 |
| Server SDK | 共同編集、リビジョン、Worktree の下書き、ファイル変換。 |
| アプリケーション層 | Workspace は Space、ファイル、権限、共有、レビューを担当。Agent ホストは会話、モデル呼び出し、ツール実行を担当します。 |
CLI とデスクトップは コンテンツオペレーションレイヤー を共有します。ランタイムプールは、ホストの寿命を延ばし、実行前にバージョンを同期させます。異なるクライアントは、同じ編集と送信ロジックを再利用します。ランタイムリユースを参照してください。
外観検査は構造化された点検を補足します。スクリーンショットはブラウザのレンダリングから来、自動レイアウトの診断は現在のスライドのテキストの流出および重複を検出します。
Agent の編集からレビュー可能な変更へ
予算レビュー例では、エージェントは式とスタイルを含むスプレッドシートを編集します。 ネイティブオフィス編集パスは次の通りです。
- 積荷を積んで下さい。 エージェントは、ドキュメントとWorktreeを選択し、スナップショットとチェンジセットをロードし、選択したリビジョンに同期します。 ユニットは、ワークブックなどの1つのドキュメントインスタンスです。
- ファサードを通して編集する。 Node.jsのランタイムは、そのユニットに対するパブリックファサード呼び出しを実行します。 コンテンツの変更は、変化に収集され、ドラフトに提出されたミューテーションを生成します。
- 結果を確認してください。 エージェントは、必要に応じて、値と式を読み取り、レンダリングされた出力を検査します。 編集は、結果がレビューの準備ができるまで、同じ草案で継続します。
- レビューしてマージする。 人が内容比較で変更を確認し、Worktree を共有版へマージするか決めます。
ドラフトへのチェンジセットを節約することは、それをマージしません。 ワークスペースは、投稿が確認された直後にのみ、書き込みを成功に報告します。 競合と未確認の投稿は、エラーを返します。 デスクトッププラグインでは、マージと廃棄ツールは、アプリケーションのツールワークフローが強制するユーザーの承認を必要とします。
Web App を同じ Office データにつなぐ
起動ダッシュボードは、同じスプレッドシートを予算エディタとして使用しています。 HTMLビューは、サンドボックス化されたiframeのページをレンダリングします。 Workspaceホストは、ユーザーが許可されたコンテンツエンジンにアクセスし、供給できるソース文書を解決します。 メトリックカードとチャートは、ソースデータに購読しますので、予算の2番目のコピーは必要ありません。
編集可能なバインディングでは、帳票は署名入りのアイデンティティと編集権限をソース文書に要求します。ユーザーがページを離れると、ホストは書き込みとコラボレーションの確認を保留し、エラーを保存します。HTMLページのパブリッシングとバインディングの書き込みは、独自の保存パスを使用しており、ネイティブOffice Worktreeのマージフローは自動的に従わない。実験的なデータ結合とHTML ホストの実装を見るを参照してください。
自社の業務フローへ拡張する
| 目的 | 開始場所 |
|---|---|
| 業界固有の文書やタスク | ドメインスキル、テンプレート、ツールガイドを追加し、コンテンツとビジュアルチェックを保持します。 |
| 独自の ID、ストレージ、共有 | Workspace アプリとサーバー側の業務ポリシーを拡張します。 |
| 独自のエージェントベースのOfficeクライアント | エージェントホスト、機能プラグイン、ブランドスキンを組み合わせて、選択したモデルとビジネスツールを接続します。 |
例:予算レビュー用 Skill を追加する
ドメインスキルは、既存のOfficeツールを再利用しながら、チームのレビュールールをエンコードできます。
- ソースのワークブック、期間、予算/実例の列を探し、編集前に欠落したビジネス定義について尋ねます。
- スプレッドシートのガイドを読み、Worktree を作成し、Facade で数式を更新してレビュー文書を用意します。
- 合計、式の結果、およびプレゼンテーションをチェックし、変更されたファイルとチェックを報告し、レビューのために人に草案を渡します。
ビジネスルールとテンプレートは、スキルに所属しています。アクセスチェック、永続草案、および合併承認は、アプリケーションに残ります。ERPまたはCRMを接続するには、必要なデータを返すアプリケーションツールを追加し、同じOffice編集とレビューフローを再使用してください。スキルガイド実行。それはファイルへのアクセスを許可しません。
実装を確認する
このガイドはいかがですか?