설정 내보내기 및 가져오기

조직 설정을 이동 가능한 번들로 내보낸 뒤 다른 조직에 적용할 수 있습니다. 해당 기능은 다음 경로에서 확인할 수 있습니다:설정 → 데이터 → 설정 내보내기.

이 기능은 세 가지 상황에서 활용됩니다: 기존 조직과 동일하게 구성된 새로운 조직을 생성하거나, 체험판 작업 영역의 설정을 실제 조직으로 승격하거나, 작업 영역의 구성 내용을 추후 검토할 수 있도록 기록해두는 경우입니다.

번들에 포함되는 내용#

이 번들은 조직 수준의 설정을 모두 포함합니다:

가져오기 작업 시에는 서비스 계정이 생성되지 않습니다. 동일한 이름의 기존 계정이 존재하는 경우, 해당 계정이 자격 있는 작업을 자동으로 시작할지 여부는 번들에 정의된 값을 따릅니다.

번들에 포함되지 않는 내용#

비밀번호는 절대 번들에 포함되지 않습니다.공급자 키, 토큰 및 인증 정보는 플레이스홀더 형태로 내보내집니다. 번들은그것을키가 존재하며 어떤 항목에서 사용되는지만 기록하고 값은 저장하지 않습니다. 가져온 뒤에는 직접 비밀번호를 다시 입력해야 합니다.

제외되는 항목에는 조직 이름, 구성원, 결제 관계 등 작업 영역의 식별 정보와 작업 내역, 실행 기록, 감사 이벤트 등 운영 관련 데이터도 포함됩니다.

번들의 규칙은 작업 영역이 어떻게구성되어 있는지를 나타내며,이미 발생한 사항은 반영하지 않습니다.

번들 적용 방법#

포털에서는 번들을 내보낼 수는 있지만 가져오기는 지원하지 않습니다. 번들을 적용하려면 Hermes와 같은 에이전트를 Coroid의 MCP 서버에 연결해야 합니다. 에이전트는 번들 내용을 미리 확인한 뒤 적용합니다. 또한 스크린샷, 파일 또는 설명을 바탕으로 번들을 먼저 생성하여 조직을 구성할 수도 있습니다.

번들 적용을 위해서는 소유자에게 속한 연결이 필요하며, 소유자 또는 관리자가 모든 적용 작업을 승인해야 합니다. coroid.ai에서는 아직 이러한 관리 도구가 활성화되지 않았습니다. 자세한 내용은MCP를 통한 조직 설정.

적용 전 미리보기 기능#

번들 적용 시에는 먼저 미리보기를 통해 각 섹션별로 적용 결과를 확인할 수 있습니다:

미리보기 내용을 꼼꼼히 확인하세요.needsRebind가 가장 중요합니다. 이 항목은 대상 조직에 동일하게 존재하지 않는 항목(주로 리포지토리 연결 정보나 비밀번호)을 참조하는 설정을 표시하므로, 구성 내용이 실제로 동일해지려면 이 부분을 반드시 확인해야 합니다.

번들을 버전 관리 시스템에 저장하는 방법#

내보낸 번들은 파일 형태이므로 리포지토리에 저장하고 차이점을 비교하며 검토할 수 있습니다. 설정을 코드로 취급하는 팀에게는 조직 정책 변경 내용이 단순한 클릭 작업이 아닌 검토 가능한 차이점으로 관리된다는 점이 큰 장점입니다.

비밀번호는 플레이스홀더 형태이므로 번들을 커밋해도 안전합니다. 다만 공개하기 전에 자신의 구성 내에 식별 정보가 포함되어 있지 않은지 반드시 확인하세요.

관련 항목#

• 설정 개요
• 공급자 키
• 데이터 보존