본문으로 건너뛰기

데이터 가져오기 및 내보내기

Elftia는 다양한 데이터 형식의 가져오기와 내보내기를 지원하여, 기기 간 데이터 마이그레이션, 구성 백업, 다른 사람과 설정 공유를 쉽게 할 수 있습니다.

가져오기/내보내기 데이터 유형​

데이터 유형내보내기 형식내보내기 위치가져오기 방법
LLM Provider 구성JSONSettings → Provider SettingsSettings → Provider Settings
MCP Server 구성JSONSettings → MCPSettings → MCP
Agent 정의Markdown (.md)Agent PageAgent Page
Character CardPNG(메타데이터 포함) / JSONRole-Play SettingsRole-Play Settings
채팅 기록JSON오른쪽 클릭 사이드바 메뉴사이드바에서 가져오기
테마 구성JSONSettings → AppearanceSettings → Appearance
진단 정보JSON / ZIPSettings → System가져오기 지원 안 함

LLM Provider 구성​

Provider 설정 내보내기​

여러 LLM Provider를 구성한 후에는 백업이나 마이그레이션을 위해 모든 구성을 JSON 파일로 내보낼 수 있습니다.

  1. Settings → Provider Settings를 엽니다.
  2. Provider 목록 위의 Export 버튼을 클릭합니다.
  3. 저장 위치를 선택합니다. 파일은 JSON 형식으로 저장됩니다.

내보낸 JSON에는 다음이 포함됩니다.

  • Provider ID와 이름
  • Base URL 구성
  • 활성화 상태
  • 모델 목록과 매개변수 구성
주의

보안상의 이유로 내보낸 구성에는 API Keys가 포함되지 않습니다. 가져온 후에는 각 Provider의 API Key를 다시 입력해야 합니다.

Provider 설정 가져오기​

  1. Settings → Provider Settings를 엽니다.
  2. Provider 목록 위의 Import 버튼을 클릭합니다.
  3. 이전에 내보낸 JSON 파일을 선택합니다.
  4. 시스템이 가져오기 미리보기를 표시합니다. 확인한 뒤 구성을 적용합니다.
  5. 각 Provider의 API Key를 다시 입력하고 연결을 테스트합니다.

MCP Server 구성​

MCP 설정 내보내기​

  1. Settings → MCP(또는 기능 레일의 MCP 페이지)를 엽니다.
  2. MCP server 목록에서 내보내기 기능을 찾습니다.
  3. 구성은 모든 MCP server 연결 정보를 포함하는 JSON 형식으로 저장됩니다.

MCP 설정 가져오기​

Elftia는 표준 MCP 구성 JSON 파일에서 server 정의를 가져올 수 있습니다.

  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 servers를 파싱하고 추가합니다.
팁

Elftia는 Claude Desktop 형식의 MCP 구성 파일(claude_desktop_config.json)과 호환되며, 이를 직접 가져올 수 있습니다.

Agent 정의​

Agent 내보내기​

Agent 정의는 Markdown 파일로 저장되며, 직접 내보낼 수 있습니다.

  1. Agent Page를 엽니다.
  2. 내보낼 Agent를 선택합니다.
  3. 내보내기 기능을 사용해 Agent 정의를 .md 파일로 저장합니다.

Agent의 Markdown 파일에는 다음이 포함됩니다.

  • Agent 이름과 설명
  • 시스템 프롬프트
  • 도구 권한 구성
  • MCP server 할당
  • 기타 동작 설정

Agent 가져오기​

  1. Agent Page를 엽니다.
  2. 생성 버튼 옆의 가져오기 옵션을 클릭합니다.
  3. Agent의 .md 파일을 선택합니다.
  4. 시스템이 파일을 파싱하고 해당 Agent를 생성합니다.

Character Card​

Elftia는 표준 Character Card 형식을 지원하며 일반적인 커뮤니티 Character Card 사양과 호환됩니다.

Character Card 내보내기​

  1. 역할극 채팅에서 RP 설정 패널을 엽니다.
  2. Character Card 내보내기 기능을 찾습니다.
  3. 내보내기 형식을 선택합니다.
    • PNG(권장): PNG 텍스트 청크에 메타데이터가 포함된 이미지 파일입니다. 완전한 캐릭터 정보를 포함하면서 이미지로 직접 공유할 수 있습니다.
    • JSON: 모든 캐릭터 정의 데이터를 포함하는 일반 텍스트 형식입니다.

Character Card 가져오기​

  1. 역할극 설정에서 Import Character Card를 클릭합니다.
  2. PNG 또는 JSON 형식의 Character Card 파일을 선택합니다.
  3. 시스템이 캐릭터 정보를 자동으로 파싱하고 양식을 채웁니다.
  4. 가져온 후 캐릭터 설정을 수정한 다음 저장할 수 있습니다.

채팅 기록​

채팅 내보내기​

  1. 사이드바에서 내보낼 채팅을 오른쪽 클릭합니다.
  2. Export를 선택합니다.
  3. 저장 위치를 선택합니다. 채팅은 JSON 형식으로 저장됩니다.

내보낸 채팅에는 다음이 포함됩니다.

  • 모든 메시지(사용자 메시지와 AI 답변)
  • 브랜치 정보
  • 메시지 타임스탬프
  • 사용된 모델 정보
  • 첨부 파일의 참조 정보

대량 내보내기​

  1. 사이드바에서 대량 선택 모드로 들어갑니다.
  2. 여러 채팅을 선택합니다.
  3. 대량 작업 바의 내보내기 기능을 사용해 선택한 모든 채팅을 한 번에 내보냅니다.

채팅 가져오기​

  1. 사이드바에서 가져오기 기능을 사용합니다.
  2. 이전에 내보낸 채팅 JSON 파일을 선택합니다.
  3. 채팅이 세션 목록에 복원됩니다.

테마 구성​

테마 내보내기​

마음에 드는 테마 구성(테마 모드, 강조 색상, 글꼴, 배경화면, 사용자 지정 CSS 포함)을 사용자 지정했다면, 이를 테마 구성 파일로 내보낼 수 있습니다.

  1. Settings → Appearance를 엽니다.
  2. Theme Configuration 영역을 찾습니다.
  3. Export Theme 버튼을 클릭합니다.
  4. 저장 위치를 선택합니다. 구성은 JSON 형식으로 저장됩니다.

내보낸 내용에는 다음이 포함됩니다.

  • 테마 모드(light/dark/system)
  • 강조 색상 설정
  • 글꼴 재정의
  • 배경화면 구성(블러, 마스크 불투명도 및 기타 매개변수)
  • 사용자 지정 CSS 코드
정보

배경화면 이미지 파일 자체는 내보내기에 포함되지 않으며, 배경화면 구성 매개변수만 포함됩니다. 로컬 배경화면 이미지를 사용하는 경우 가져온 후 배경화면 경로를 다시 설정해야 합니다.

테마 가져오기​

  1. Settings → Appearance → Theme Configuration을 엽니다.
  2. Import Theme 버튼을 클릭합니다.
  3. 테마 JSON 파일을 선택합니다.
  4. 시스템이 가져올 테마의 차이를 미리 보여줍니다. 확인하면 적용됩니다.

진단 정보 내보내기​

진단 정보는 문제 해결 시 기술 지원에 제공하기 위한 것이며, 가져오기는 지원되지 않습니다.

  1. Settings → System을 엽니다.
  2. Export Diagnostics 버튼을 클릭합니다.
  3. 시스템이 런타임 정보, 로그, 구성 등을 수집해 진단 파일을 생성합니다.
  4. 단일 JSON 파일 또는 전체 ZIP 아카이브로 내보내도록 선택할 수 있습니다.

자세한 내용은 진단 도구를 참조하세요.

참고 사항​

  • API Key 보안: 어떤 내보내기 기능도 API Keys 같은 민감한 자격 증명을 내보내지 않습니다. 가져온 후에는 이를 수동으로 다시 입력해야 합니다.
  • 버전 호환성: 내보낸 데이터 파일에는 버전 정보가 포함됩니다. 새 버전에서 내보낸 파일은 이전 버전에서 가져오지 못할 수 있습니다.
  • 파일 크기: 첨부 파일 참조가 많은 채팅을 내보내면 큰 파일이 생성될 수 있습니다. 첨부 파일 자체는 내보내기에 포함되지 않습니다.
  • 문자 인코딩: 모든 내보낸 파일은 플랫폼 간 호환성을 위해 UTF-8 인코딩을 사용합니다.

가져오기/내보내기 중 문제가 발생하면 일반적인 문제를 참조하세요.