メインコンテンツまでスキップ

データのインポートとエクスポート

Elftia はさまざまなデータ形式のインポートとエクスポートに対応しており、デバイス間でのデータ移行、設定のバックアップ、他のユーザーとの設定共有を簡単に行えます。

インポート / エクスポートできるデータの種類​

データの種類エクスポート形式エクスポート場所インポート方法
LLM プロバイダー設定JSON設定 → プロバイダー設定設定 → プロバイダー設定
MCP サーバー設定JSON設定 → MCP設定 → MCP
Agent 定義Markdown (.md)Agent ページAgent ページ
キャラクターカードPNG(メタデータ付き)/ JSONロールプレイ設定ロールプレイ設定
チャット履歴JSONサイドバーの右クリックメニューサイドバーでインポート
テーマ設定JSON設定 → 外観設定 → 外観
診断情報JSON / ZIP設定 → システムインポート非対応

LLM プロバイダー設定​

プロバイダー設定をエクスポートする​

複数の LLM プロバイダーを設定したら、すべての設定を JSON ファイルとしてエクスポートし、バックアップや移行に利用できます。

  1. 設定 → プロバイダー設定 を開きます。
  2. プロバイダー一覧の上にある エクスポート ボタンをクリックします。
  3. 保存先を選択します。ファイルは JSON 形式で保存されます。

エクスポートされた JSON には次の内容が含まれます。

  • プロバイダー ID と名前
  • Base URL 設定
  • 有効化状態
  • モデル一覧とパラメーター設定
注意

セキュリティ上の理由により、エクスポートされた設定には API Keys が 含まれません。インポート後に、各プロバイダーの API Key を再入力する必要があります。

プロバイダー設定をインポートする​

  1. 設定 → プロバイダー設定 を開きます。
  2. プロバイダー一覧の上にある インポート ボタンをクリックします。
  3. 以前にエクスポートした JSON ファイルを選択します。
  4. システムにインポートのプレビューが表示されます。確認して設定を適用します。
  5. 各プロバイダーの API Key を再入力し、接続をテストします。

MCP サーバー設定​

MCP 設定をエクスポートする​

  1. 設定 → MCP(または機能レール内の MCP ページ)を開きます。
  2. MCP サーバー一覧でエクスポート機能を探します。
  3. 設定は、すべての MCP サーバー接続情報を含む JSON 形式で保存されます。

MCP 設定をインポートする​

Elftia は、標準の MCP 設定 JSON ファイルからサーバー定義をインポートできます。

  1. MCP 管理ページを開きます。
  2. Import JSON ボタンをクリックします。
  3. MCP 設定 JSON ファイルを選択します。形式の例:
{
"mcpServers": {
"my-server": {
"command": "npx",
"args": ["-y", "@my-org/my-mcp-server"],
"env": {
"API_KEY": "your-key"
}
}
}
}
  1. システムが設定を解析し、設定内で定義された MCP サーバーを追加します。
ヒント

Elftia は Claude Desktop 形式の MCP 設定ファイル(claude_desktop_config.json)と互換性があり、直接インポートできます。

Agent 定義​

Agent をエクスポートする​

Agent 定義は Markdown ファイルとして保存されており、直接エクスポートできます。

  1. Agent ページ を開きます。
  2. エクスポートする Agent を選択します。
  3. エクスポート機能を使用して、Agent 定義を .md ファイルとして保存します。

Agent の Markdown ファイルには次の内容が含まれます。

  • Agent の名前と説明
  • システムプロンプト
  • ツール権限設定
  • MCP サーバーの割り当て
  • その他の動作設定

Agent をインポートする​

  1. Agent ページ を開きます。
  2. 作成ボタンの横にあるインポートオプションをクリックします。
  3. Agent の .md ファイルを選択します。
  4. システムがファイルを解析し、対応する Agent を作成します。

キャラクターカード​

Elftia は標準的なキャラクターカード形式に対応しており、一般的なコミュニティのキャラクターカード仕様と互換性があります。

キャラクターカードをエクスポートする​

  1. ロールプレイチャットで、RP 設定パネルを開きます。
  2. キャラクターカードのエクスポート機能を探します。
  3. エクスポート形式を選択します。
    • PNG(推奨): PNG テキストチャンクにメタデータを埋め込んだ画像ファイルです。完全なキャラクター情報を含んだまま、画像として直接共有できます。
    • JSON: すべてのキャラクター定義データを含むプレーンテキスト形式です。

キャラクターカードをインポートする​

  1. ロールプレイ設定で Import Character Card をクリックします。
  2. PNG または JSON 形式のキャラクターカードファイルを選択します。
  3. システムがキャラクター情報を自動的に解析し、フォームに入力します。
  4. インポート後にキャラクター設定を変更してから保存できます。

チャット履歴​

チャットをエクスポートする​

  1. サイドバーで、エクスポートするチャットを右クリックします。
  2. エクスポート を選択します。
  3. 保存先を選択します。チャットは JSON 形式で保存されます。

エクスポートされたチャットには次の内容が含まれます。

  • すべてのメッセージ(ユーザーメッセージと AI の返信)
  • ブランチ情報
  • メッセージのタイムスタンプ
  • 使用されたモデル情報
  • 添付ファイルの参照情報

一括エクスポート​

  1. サイドバーで一括選択モードに入ります。
  2. 複数のチャットを選択します。
  3. 一括操作バーのエクスポート機能を使用して、選択したすべてのチャットを一度にエクスポートします。

チャットをインポートする​

  1. サイドバーでインポート機能を使用します。
  2. 以前にエクスポートしたチャット JSON ファイルを選択します。
  3. チャットがセッション一覧に復元されます。

テーマ設定​

テーマをエクスポートする​

テーマモード、アクセントカラー、フォント、壁紙、カスタム CSS などを含むテーマ設定をカスタマイズし、その内容を保存したい場合は、テーマ設定ファイルとしてエクスポートできます。

  1. 設定 → 外観 を開きます。
  2. テーマ設定 エリアを探します。
  3. テーマをエクスポート ボタンをクリックします。
  4. 保存先を選択します。設定は JSON 形式で保存されます。

エクスポートされる内容は次のとおりです。

  • テーマモード(ライト / ダーク / システム)
  • アクセントカラー設定
  • フォントの上書き設定
  • 壁紙設定(ぼかし、マスク不透明度、その他のパラメーター)
  • カスタム CSS コード
備考

壁紙画像ファイル自体はエクスポートに含まれず、壁紙設定パラメーターのみが含まれます。ローカルの壁紙画像を使用している場合は、インポート後に壁紙パスを再設定する必要があります。

テーマをインポートする​

  1. 設定 → 外観 → テーマ設定 を開きます。
  2. テーマをインポート ボタンをクリックします。
  3. テーマ JSON ファイルを選択します。
  4. システムがインポートによるテーマ差分をプレビュー表示します。確認して適用します。

診断情報のエクスポート​

診断情報は、トラブルシューティング時にテクニカルサポートへ提供するためのものです。インポートはサポートされていません。

  1. 設定 → システム を開きます。
  2. 診断情報をエクスポート ボタンをクリックします。
  3. システムが実行時情報、ログ、設定などを収集し、診断ファイルを生成します。
  4. 単一の JSON ファイルまたは完全な ZIP アーカイブとしてエクスポートできます。

詳細は 診断ツール を参照してください。

注意事項​

  • API Key のセキュリティ: どのエクスポート機能でも、API Keys などの機密認証情報はエクスポートされません。インポート後に手動で再入力する必要があります。
  • バージョン互換性: エクスポートされたデータファイルにはバージョン情報が含まれます。新しいバージョンでエクスポートされたファイルは、古いバージョンではインポートできない場合があります。
  • ファイルサイズ: 多数の添付ファイル参照を含むチャットをエクスポートすると、大きなファイルが生成される場合があります。添付ファイル自体はエクスポートに含まれません。
  • 文字エンコーディング: すべてのエクスポートファイルは、クロスプラットフォーム互換性のために UTF-8 エンコーディングを使用します。

インポート / エクスポート中に問題が発生した場合は、よくある問題 を参照してください。