> For the complete documentation index, see [llms.txt](https://studio-docs.japan-ai.co.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://studio-docs.japan-ai.co.jp/guan-li-yun-yong/plan-project-migration.md).

# Project間の移行を計画する

Projectを切り替えるときは、一括移行を前提にせず、リソースごとに**リンクする・コピーする・移行先で作り直す**を決めます。同名のAgentやWorkflowを作るだけでは、Dataset、Skill、接続、Secret、Storage、Page、Objectなどの依存先はそろいません。

この記事では、移行前の棚卸しと確認順を説明します。リンクの操作と解除は[既存リソースをリンク・解除する](/rupageskillrissu/link-and-unlink-resources.md)、Pageの設計は[配布可能なPageの設定設計](/gaidopage/design-distributable-page-config.md)、配布時の制約は[配布対象・依存・認証設定の制約](/appno/distribution-scope-dependencies-auth.md)を参照してください。

## この記事の範囲

ここでいう移行は、同じ組織内で構成とデータを移すための計画です。Projectの削除、Appの配布・導入、外部サービス側のデータ移管、認証情報の値の受け渡しは扱いません。

現行の「リソースを追加」でリンク対象として確認できるのは、**エージェント、ワークフロー、ナレッジ（Datasetを含む）、スキル**です。Object、Storage、Page、コネクタ、Project Secretを同じ画面でリンクできるとは確認できません。候補や操作が表示されない場合は、対象Project、権限、組織の提供条件を確認してください。

> Projectをまたいで参照できることと、独立して編集・運用できることは別です。リンクは元への参照であり、移行先だけを変更したい場合は、恒久的な移行完了と扱わないでください。

## 移行方式を先に選ぶ

各対象について、次の3方式のどれにするかを記録します。

| 方式   | 適する目的                    | 元Projectとの関係                       | 移行後に確認すること              |
| ---- | ------------------------ | ---------------------------------- | ----------------------- |
| リンク  | 同じ定義を複数のProjectで利用する     | 元の定義を参照する。元の変更がリンク先にも影響し得る         | 元の管理者・更新手順を明確にする        |
| コピー  | 移行先で独立して変更する必要がある        | 新しいリソースを作成する。元の後続変更が自動反映される前提にはしない | コピー範囲、依存先、公開・有効状態を確認する  |
| 作り直し | Project固有の設定、データ、認証情報を持つ | 移行先に新規の設定またはデータを用意する               | 元と移行先を照合し、切替後の実行結果を確認する |

コピーだけで依存設定・データ・認証情報まで複製されるとは限りません。

## 対象別の移行方針

次表を初期台帳として使います。最終判断は、実際の画面に表示される候補、権限、利用中の依存関係で確認してください。

| 対象             | 方針                             | 主な確認                                  |
| -------------- | ------------------------------ | ------------------------------------- |
| Agent          | 組織・公式のものはリンク候補。独立編集ならコピー。      | 指示、モデル、Dataset・Skill・接続、既定Agent。      |
| Workflow       | 組織・公式のものはリンク候補。固有変更ならコピー。      | テスト・公開、開始条件、実行先。                      |
| Dataset        | 組織・公式のものはナレッジとしてリンク候補。         | 共有範囲、処理状態、参照設定。独立資料は取り込み直す。           |
| Skill          | 組織・公式のものはリンク候補。固有変更ならコピー可否を確認。 | 添付ファイル、公開範囲、Agentへの追加。                |
| Object         | 移行先で構造を作り直し、必要なレコードを移す。        | フィールド、アクセス条件、リレーション、取込結果。参照先から先に用意する。 |
| Storage        | 移行先にフォルダとファイルを用意する。            | 構成、版、権限、Agent・Workflow・Pageのパス。       |
| Page           | 移行先でPageと成果物・設定を用意する。          | 適用中の版、アクセス条件、Storage参照、Secret名。       |
| コネクタ           | 移行先で選択・作成・認証する。                | 認証アカウント、個人／共有、Appの共通コネクタ。             |
| Project Secret | 移行先で新規登録し、参照先を設定する。            | 実値は記録せず、代表操作を確認する。                    |

> 認証情報とSecretは、設定名だけを移す対象ではありません。移行先の外部サービス権限、認証アカウント、共有範囲、実行結果を確認して初めて切替完了と判断します。値そのものを移行用の表や問い合わせに記載しないでください。

## 1. 移行台帳を作る

元Projectを変更する前に、対象を一覧化します。画面の一覧だけでなく、Agent・Workflow・Pageが参照する先も確認します。

| 台帳に記録する項目 | 記録例                                                                  |
| --------- | -------------------------------------------------------------------- |
| 対象        | Agent、Workflow、Dataset、Skill、Object、Storage、Page、コネクタ、Project Secret |
| 名前と用途     | 一覧で判別できる名称、業務上の利用目的                                                  |
| 移行方式      | リンク、コピー、作り直し、移行不要                                                    |
| 元・移行先     | 元Project、移行先Project、元の管理者                                            |
| 依存関係      | Agent→Skill／Dataset、Workflow→Agent／Skill、Page→Storage／接続など           |
| 責任者・確認方法  | 内容確認者、認証者、代表操作、切替承認者                                                 |
| 切替・戻し方    | 切替日時、旧構成を残す期間、連絡先                                                    |

外部サービスへ送信・更新するWorkflow、定期実行、Webhook、公開中のPage、共有接続、Secretは影響がある対象として記録します。影響が分からない対象は担当者へ確認します。

## 2. 依存関係を元から外へたどる

移行対象を単位ごとに確定します。

1. Agentごとに、「プラグイン」「データ連携」、モデル、指示、利用対象者を記録します。
2. Workflowごとに、利用するAgent、Workflow、Skill、Dataset、開始条件、入力、公開状態、実行先を記録します。
3. Workflowをリンクする場合は、確認画面の\*\*「依存リソースの自動追加」**と**「スキップされた依存リソース」\*\*を確認します。必要なAgent・Workflow・Skillが自動追加される場合があります。
4. Object、Storage、Pageについて、名前だけでなく、参照先のObject、ファイルパス、登録済みの版、接続・Secret名を記録します。
5. コネクタとProject Secretについて、実値を書かずに、用途、認証担当者、接続先、参照する機能、更新時の連絡先を記録します。

「スキップされた依存リソース」には、アクセス権限不足、見つからない、無効、削除済み、Project固有、スコープ外などが表示される場合があります。スキップされたまま移行完了にせず、依存先を作り直すか、管理者と利用可否を確認してください。

## 3. 依存先から順に移行する

利用する定義より先に、その定義が参照するデータ・認証・設定を用意します。

1. 移行先Projectのメンバー、役割、移行担当者、テスト用のデータと外部サービスの検証先を決めます。
2. Objectの構造と必要なレコード、Storageのフォルダとファイルを移行先に用意します。
3. コネクタとProject Secretを移行先で設定し、外部サービスの最小限の代表操作を確認します。
4. DatasetとSkillをリンク、コピー、または作り直し、共有範囲と利用可否を確認します。
5. Agentをリンクまたはコピーし、移行先のDataset・Skill・接続の前提が満たされることを確認します。
6. Workflowをリンクまたはコピーします。依存リソースの自動追加・スキップを確認し、コピーしたものはテスト後に公開します。
7. Pageを移行先へ登録し、Storage参照、認証、Pageの表示と代表操作を確認します。
8. 定期実行、Webhook、通知など、実行を重複させるおそれのある設定を最後に切り替えます。

> 元Projectと移行先Projectの両方で自動実行を有効にすると、同じ通知、送信、更新が重複する可能性があります。切替時刻、旧構成を停止する担当者を決めてから有効化してください。

## 4. 切替前後を照合する

移行先で設定が見えることと、利用者の操作が成功することを分けて確認します。

### 移行前チェックリスト

* [ ] 元・移行先のProject、管理者、切替日時、戻し方を記録した
* [ ] 対象をAgent、Workflow、Dataset、Skill、Object、Storage、Page、コネクタ、Project Secretに分けて棚卸しした
* [ ] 各対象をリンク・コピー・作り直し・移行不要に分類した
* [ ] Workflowの依存リソース、自動追加、スキップ理由を確認した
* [ ] 外部送信、データ更新、定期実行、Webhook、公開Pageを影響ありとして確認した
* [ ] Secret値やトークンを台帳へ記録していない

### 切替後チェックリスト

* [ ] リンク対象が移行先で「読み取り専用」となる場合の更新担当を確認した
* [ ] コピー対象が元とは別のリソースとして作成され、必要な変更を移行先で行えることを確認した
* [ ] Datasetの処理状態、Skillの公開範囲、Objectの構造・レコード、Storageのファイルを確認した
* [ ] Agent、Workflow、Pageの代表操作を、許可されたテストデータで確認した
* [ ] 外部サービス側で送信先・更新先・実行アカウントが正しいことを確認した
* [ ] 旧Projectの自動実行・Webhook・利用案内を整理し、重複実行しないことを確認した
* [ ] 旧構成を削除する前に、移行先の運用担当者が確認を完了した

## 確認できない場合

候補にない種別を無理にリンクせず、コピー操作だけでデータ・認証・実行設定まで移ると判断しないでください。

次を記録して、管理者または担当者へ確認します。

1. 元・移行先の組織とProject、対象種別・名称、利用目的。
2. 選んだ移行方式、画面に表示された候補・スキップ理由・エラーメッセージ。
3. 依存するAgent、Workflow、Dataset、Skill、Object、Storage、Page、接続、Secret名。
4. 外部送信・更新の有無、切替希望時刻、すでに実施したテスト結果。

Secret値、APIキー、トークン、パスワード、機密データ、不要なファイル本文は問い合わせに含めません。

## 関連記事・次に読む記事

* [既存リソースをリンク・解除する](/rupageskillrissu/link-and-unlink-resources.md)
* [Workflow・自動実行の仕様・制限](/shi-yang-zhi-xian/workflow-and-automation-specs.md)
* [Pageの仕様・制限](/shi-yang-zhi-xian/page-specs-and-limits.md)
* [Project・Appの共有接続を設定する](/guan-li-yun-yong/configure-shared-connections.md)
* [Project Secretを登録・更新・削除する](/guan-li-yun-yong/manage-project-secrets.md)
* [配布可能なPageの設定設計](/gaidopage/design-distributable-page-config.md)
* [配布対象・依存・認証設定の制約](/appno/distribution-scope-dependencies-auth.md)
