> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/tech/ja/platform-development/onlyoffice-online-editing.md).

# ファイルライブラリでの Office オンライン編集（ONLYOFFICE Docs 連携）

ファイルライブラリの Office オンライン編集（ONLYOFFICE Docs）のネットワーク接続方向と利用条件を説明します。お客様のネットワーク管理者がファイアウォールとドメインの許可リストを計画するための情報です。現在は SaaS のみで提供しています。

ファイルライブラリ内の Office ファイル（`.docx`、`.xlsx`、`.pptx`）は、ブラウザ内でオンライン編集できます。エディタは MaiAgent が運用する ONLYOFFICE Document Server（以下「ドキュメントサーバー」）が提供します。ユーザーがエディタを閉じると、編集結果が新しいバージョンとしてファイルライブラリに保存されます。

このページは、お客様のネットワーク管理者と情報セキュリティ担当者向けです。ユーザーのブラウザに必要な接続先、各コンポーネント間のドキュメントの流れ、利用条件を説明します。編集操作については、ユーザーマニュアルの[ファイルライブラリ：オンライン編集](https://docs.maiagent.ai/work/file-library#online-editing)をご覧ください。現在、この機能は SaaS のみで提供しています。オンプレミス版については[ページ末尾の説明](#on-premise-deployment)をご覧ください。

## サービスの構成要素 <a href="#components" id="components"></a>

| コンポーネント                                | 役割                                                       |
| -------------------------------------- | -------------------------------------------------------- |
| ドキュメントサーバー（ONLYOFFICE Document Server） | ブラウザ内のエディタと共同編集機能を提供し、編集終了後に完成したファイルの取得を MaiAgent に通知します |
| MaiAgent プラットフォーム                      | 編集セッションを発行し、保存通知を受信して、編集結果をファイルの新しいバージョンとして書き込みます        |
| オブジェクトストレージ                            | ファイルライブラリの元のファイルと各バージョンを保存します                            |

## 接続方向 <a href="#network-paths" id="network-paths"></a>

### ユーザー側で許可が必要な接続 <a href="#client-network" id="client-network"></a>

| 接続元 → 接続先                             | 用途                             |
| ------------------------------------- | ------------------------------ |
| ユーザーのブラウザ → MaiAgent 管理画面のドメイン（HTTPS） | ファイルライブラリを開き、編集セッションを取得します     |
| ユーザーのブラウザ → ドキュメントサーバーのドメイン（HTTPS）    | エディタを読み込み、編集中にドキュメントサーバーと通信します |

エディタは MaiAgent 管理画面のドメインではなく、ドキュメントサーバー自身のドメインから読み込まれます。社内ネットワークでドメインの許可リスト、プロキシサーバー、SSL 検査を使用している場合は、ドキュメントサーバーのドメインも許可してください。ドメインについては MaiAgent の担当者にお問い合わせください。

### プラットフォーム内部の接続 <a href="#platform-network" id="platform-network"></a>

以下の接続はすべて MaiAgent が運用する環境内で行われるため、お客様による設定は不要です。セキュリティ評価でドキュメントの流れを確認できるように記載しています。

| 接続元 → 接続先                      | 用途                                           |
| ------------------------------ | -------------------------------------------- |
| ドキュメントサーバー → オブジェクトストレージ       | ドキュメントを開く際に、有効期間の短いダウンロード URL で元のファイルを読み込みます |
| ドキュメントサーバー → MaiAgent プラットフォーム | 編集終了時に保存を通知します                               |
| MaiAgent プラットフォーム → ドキュメントサーバー | ヘルスチェック、編集後のファイル取得、ユーザーがエディタを閉じた後の保存要求を行います  |

プラットフォームとドキュメントサーバー間の編集設定と保存通知は、共有シークレットによる署名で認証します。

## 利用条件 <a href="#requirements" id="requirements"></a>

* 組織でファイルライブラリとオンライン編集を有効にする必要があります。有効でない場合、ファイルメニューに編集項目は表示されません。
* メンバーには、そのスペースの編集権限が必要です。
* 対応形式は `.docx`、`.xlsx`、`.pptx` のみで、1 ファイルあたり 10 MB 以内です。旧形式（`.doc`、`.xls`、`.ppt`）のオンライン編集には対応していません。
* アクセス制御を維持するため、エディタ内のダウンロードと印刷は無効にしています。ファイルはファイルライブラリからダウンロードしてください。
* 編集中の自動保存ではバージョンは作成されません。全員がエディタを閉じた後に、内容が新しいバージョンとして保存されます。

## サービスが利用できない場合 <a href="#availability" id="availability"></a>

プラットフォームは編集項目を表示する前に、ドキュメントサーバーが正常に動作しているか確認します（確認結果は約 30 秒間保持されます）。確認に失敗すると Office の編集項目が無効になり、直接エディタを開いた場合は、サービスが一時的に利用できないため新しいバージョンをアップロードするよう案内されます。ドキュメントサーバーが復旧すると、約 30 秒以内に編集項目が自動で復旧します。

## 代替方法 <a href="#fallback" id="fallback"></a>

編集サービスが利用できない場合やファイルがサイズ上限を超える場合は、パソコン上で編集し、ファイルライブラリの <mark style="color:blue;">新しいバージョンをアップロード</mark> からアップロードできます。この方法はドキュメントサーバーに依存しません。

保存に失敗すると、ファイル名の横に <mark style="color:blue;">保存に失敗しました。クリックして再試行</mark> と表示され、関係するメンバーにもアプリ内のお知らせが届きます。クリックすると保存を再試行できます。

## オンプレミス版 <a href="#on-premise-deployment" id="on-premise-deployment"></a>

{% hint style="info" %}
Office オンライン編集は現在 SaaS のみで提供しています。オンプレミス版への対応時期については MaiAgent の担当者にお問い合わせください。
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/tech/ja/platform-development/onlyoffice-online-editing.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.