Office SDK の概要
Office SDK の 3 つの部分 (Web SDK、Server SDK、AI SDK) と、それらが Office アプリケーション内でどのように連携するかについて説明します。
Univer Office SDKは3つの部分から成っています:Web SDK、Server SDKおよびAI SDK。それはスプレッドシート、文書、スライド、リレーショナルテーブル、キャンバスおよびPDFをカバーします。
Web SDKは共有コンテンツエンジンです。ブラウザエディタを実行し、UIなしでコンテンツを処理するためにヘッドレスを実行します。他の2つのSDKは、そのヘッドレスランタイムで構築します。Server SDKでは、コラボレーションとファイル処理を追加し、AI SDKには、コンテンツの操作とエージェントの結果を検査します。
機能を調べる
機能カタログは、製品とカテゴリによってグループ化され、各製品がサポートしているもののリストです。 また、機能がオープンソースであるか、統合の範囲であるかにかかわらず、サポートレベルも記録します。 チャート、ファイル変換、コラボレーション、Worktree、および埋め込みは、製品間で共有されます。
はじめる は 1 つの要件テンプレートと 3 つの実行可能な例を提供し、アプリケーションを接続、ビルド、デプロイする方法を説明しています。
SDK のアーキテクチャと役割
Web SDK: 共有コンテンツ エンジン
Web SDKを使用して、アプリケーション内のOfficeコンテンツを表示、編集、または処理します。 ファサードAPIは、コードがブラウザエディタで実行するか、ヘッドレスNode.jsプロセスで実行されるかにかかわらず、コンテンツ、データ、UIのインターフェイスです。
Web SDKは、製品の機能、エディタUI、および個々の機能を含むプラグインから完全に構築されています。 アプリケーションはプリセットから始めるか、製品や機能のプラグインを選択して、依存関係でそれらを組み立てることができます。
Univerのコアコードを変更することなく、カスタムプラグインでビジネス固有の機能を実行できます。同じコンテンツエンジンは、プラグインセットを使用して各環境に適応します。ブラウザアプリケーションは、エディタUIをロードし、ヘッドレスアプリケーションはこれらのUIプラグインを省略します。 Univerアーキテクチャ:プラグイン設計を参照してください。
共有キャンバスレンダリング。 すべてのオフィスコンテンツは同じキャンバスアーキテクチャを介してレンダリングされます。そのため、コンテンツタイプはレイアウトと描画コードを再利用し、ネストされたコンテンツを保持することができます。例えば、スプレッドシートのセルテキストは、ドキュメントレイアウトとレンダリングパスに従い、プレゼンテーションを一貫して維持します。 レンダリングエンジンのアーキテクチャを参照してください。
ハイブリッド計算。 式エンジンは、フロントエンドとサーバー側のRustエンジンで計算します。 フロントエンドの計算は、Rustエンジンが大きな式ワークロードを処理する間、応答性を編集します。 方式の機能とサーバ側計算を参照してください。
スプレッドシート で起動します。同じ SDK は ドキュメント、スライド, リレーショナルテーブル・ボードと PDFファイルもカバーしています。
Server SDK: コラボレーションとファイルを接続する
Server SDKは、共有編集、ファイル変換、およびバックエンド拡張機能を追加します。Web SDKのヘッドレスコンテンツ機能上に構築します。モジュールは、独自のバックエンド内で実行され、アプリケーション自身のアイデンティティ、パーミッション、ストレージを使用します。
リアルタイムコラボレーション OT(Operational Transformation)は、行や列の変更やコンテンツ編集などの同時操作を処理します。編集はローカルで最初に適用され、各ユーザーの意図を可能な限り保存している間、レプリカはコンバージされます。履歴、コメント、Worktreeは、アプリケーションが必要に応じて追加するモジュールを別々に提供しています。共同編集設計とコラボレーションクイックスタートを参照してください。
ファイル変換。 変換は、Office ファイルと Univer の文書データ間でコンテンツを移動し、インポート、編集、およびエクスポートの手順を接続します。 これは、コラボレーションの有無にかかわらず動作します。 アップロード、タスク、およびダウンロードのコンバージョン API と ファイル交換統合 については、オフィスファイルのインポートとエクスポート を参照してください。
展開とスケーリング。 モジュールは、独自のNode.jsアプリケーション内で組み立てられ、単一のマシンは起動するのに十分です。 負荷が増加するにつれて、アプリケーションは別のサービスにファイル変換を移動し、複数のコラボレーションノードにスケールを移動することができます。 アプリケーションアーキテクチャと展開ガイドを参照してください。
Server SDKの概要はモジュールを詳しく説明しています。
AI SDK: エージェントにエントリ ポイントを与える
AI SDKは、既存のエージェント、自動化、およびアプリケーション固有のCLIにオフィス機能を追加します。これは、コンテンツ操作、計算、および検査のためのWeb SDKのヘッドレスランタイムとファサードAPI上に構築されます。
**既存のエージェントスタックを接続します。**オフィスツールは、TypeScript API や、SDK から組み立てられた CLI として公開することができます。モデル選択、タスクオーケストレーション、スキルはアプリケーションにとどまります。エージェントは、実行結果と検査フィードバックを受信し、ワークフローを継続します。
編集可能なコンテンツを作成する。 エージェントは、ドキュメント構造を読み、必要な範囲または段落を見つけ、Facade API を使用して、式計算を含むスプレッドシート、文書、スライド、その他のコンテンツを作成および変更します。 結果は、そのコンテンツ構造を維持し、編集可能なままにし、人々がそれを改良し続けることができます。 コンテンツの操作を参照してください。
その後、修正します。 エージェントは、バック値と式の結果を読み、実際のページのスクリーンショットを検査します。 スライドの場合、レイアウトは、ページ、オーバーフロー、またはオーバーラップを解除するテキストも識別します。 エージェントはこのフィードバックを使用して、コンテンツを修正し、再びそれを検証し、読み取り→編集を完了し、→検査→リベスループを計算します。 ビジュアル検査を参照してください。
Server SDKでは、Worktreeはエージェントが作った中間変更を、個人レビューまで分離し、Webアプリケーションに統合します。 AI SDKの概要から始めます。
アプリケーションの処理フロー
- 組込みエディタ:Web SDKは、アプリケーション内のコンテンツを表示および編集します。
- 連携アプリケーション: Web SDKとServer SDKは、ユーザーが共有文書を編集できるようにします。
- 人間とエージェントのコラボレーション:AI SDK、Server SDKによるエージェントの編集と検証は、バージョンとマージを管理し、Webアプリケーションは閲覧、比較、およびヒューマンレビューを提供します。 完全なレビューワークフローには、すべての3が含まれます。
基礎と依存関係の共有
Web SDKは、エディタとして、またはヘッドレスのコンテンツエンジンとして独立して実行します。 Server SDKとAI SDKの両方がWeb SDKのヘッドレス機能に依存します。ブラウザUIなしで実行しても、コンテンツランタイムが必要です。アプリケーションは、必要なサービスとモジュールを有効にし、完全なヒューマンエージェントワークフローは通常、すべての3つのSDKを組み合わせます。
ユースケースから始める
| 目的 | 参照先 |
|---|---|
| スプレッドシートエディタを埋め込む | Web SDK クイック スタート |
| 別の Office エディターを選択する | 書類, スライド, リレーショナルテーブル, ボード、または PDF |
| 複数のユーザーが同じドキュメントを編集できるようにする | コラボレーションのクイックスタート |
| Office ファイルのインポートまたはエクスポート | Server SDK ファイル変換 |
| エージェントまたは CLI を介してドキュメントを操作する | AI SDK の概要 |
| 共有ドキュメントに対するエージェントの変更を確認する | AI SDK Worktree |
次のステップ
Web SDKコンテンツランタイムから始めましょう。Server SDKとAI SDKは最初のアプリケーションワークフローを完了し、必要に応じて追加のモジュールを追加できます。関連するUniverパッケージのバージョンを揃えて、選択したモジュールが必要とする環境、認可、およびライセンスを準備してください。
事例紹介は、オープンソースアプリケーション、エージェントの統合、デモ、およびリポジトリを収集します。また、オンラインショーケースのOffice製品を試すことができます。
このガイドはいかがですか?