본문으로 건너뛰기

가져오기·내보내기

에이전트·도구·액터·프롬프트와 시맨틱 레이어 자산을 JSON으로 내보내 다른 컬렉션이나 환경에 가져옵니다. 에이전트는 직접 참조하는 자산을 ZIP으로 함께 묶을 수 있습니다.

JSON·ZIP 업로드 영역과 대상 컬렉션 선택이 표시된 리소스 가져오기 창

지원 자산

다음 목록의 헤더 더보기 메뉴에는 가져오기, 각 행 작업에는 내보내기가 있습니다.

  1. 값 사전
  2. 시맨틱 테이블
  3. 질의 템플릿
  4. 프롬프트
  5. 도구
  6. 액터
  7. 에이전트

자산 가져오기

  1. 지원 자산 목록에서 헤더 더보기 메뉴의 가져오기를 선택합니다.
  2. .json 파일 하나 이상 또는 .zip 번들을 선택하거나 끌어다 놓습니다.
  3. 가져올 자산을 저장할 컬렉션을 선택합니다. 컬렉션을 비우면 전역 자산으로 등록합니다.
  4. 자동으로 판별된 자산 종류와 오류를 검토합니다.
  5. 가져오기를 실행하고 항목별 성공·실패 결과를 확인합니다.

JSON 파일과 ZIP 안의 각 JSON 항목은 5MB 이하여야 합니다. ZIP 압축을 푼 JSON 항목의 합계는 50MB 이하여야 합니다. 지원 구조와 name이 없는 항목은 등록하지 않습니다.

여러 항목 중 일부가 실패해도 나머지는 계속 등록합니다.

참조 연결 순서

같은 작업에서 선택한 파일은 다음 순서로 등록합니다.

값 사전 → 시맨틱 테이블 → 질의 템플릿 → 프롬프트 → 도구 → 액터 → 에이전트

참조는 같은 배치에서 새로 만든 자산, 기존의 같은 ID, 기존의 같은 이름 순으로 찾습니다. 같은 이름이 여러 개면 대상 컬렉션의 자산을 우선합니다. 질의 템플릿의 테이블이나 에이전트의 프롬프트·시맨틱 자산 참조를 찾지 못하면 해당 항목이 실패합니다.

개별 자산 내보내기

행 작업에서 내보내기를 선택하면 다시 가져올 수 있는 정의 JSON을 내려받습니다. 컬렉션·폴더·소유자·분류 라벨·생성 및 수정 시각처럼 서버가 관리하는 값은 제외됩니다. 값 사전은 현재 페이지뿐 아니라 전체 항목을 포함합니다.

에이전트 참조 포함 내보내기

에이전트 행의 참조 포함 내보내기는 다음 자산을 ZIP으로 묶습니다.

  • 에이전트 정의
  • 직접 참조하는 프롬프트·시맨틱 테이블·질의 템플릿·도구·액터
  • 질의 템플릿이 참조하는 시맨틱 테이블

기본 제공 자산, 사용자 역할, LLM·데이터 연결 이름, 외부 값 사전과 테이블 링크는 번들에 포함되지 않습니다. 대상 환경에서 별도로 준비합니다.

값 사전의 원시 값 가져오기와 다릅니다

이 페이지의 가져오기는 자산 정의 전체를 옮깁니다. CSV·TSV 값 목록을 기존 값 사전에 합치는 작업은 값 사전에서 수행합니다.