> For the complete documentation index, see [llms.txt](https://genos-docs.gitbook.io/default/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://genos-docs.gitbook.io/default/v1.8.8/basic-tutorials/guides/catalog.md). # 카탈로그 카탈로그는 프롬프트·모델·워크플로우·평가지표·전처리기 5종 리소스를 사내에 게시하고, 다른 사용자가 검색해 복제할 수 있게 해 주는 리소스 마켓플레이스입니다. 소유자가 리소스의 특정 리비전을 동결해 등록을 신청하면 관리자가 승인해 게시하고, 다른 사용자는 게시된 카탈로그를 자신의 새 리소스로 복제하거나 기존 리소스에 리비전으로 추가할 수 있습니다. 각 카탈로그에는 좋아요·평점·복제수가 함께 표시됩니다. ## 주요 개념 | 개념 | 설명 | | -------- | ----------------------------------------------------------------------------- | | 카탈로그 | 리소스를 게시·공유하는 마켓플레이스 항목입니다. | | 리소스 타입 | 프롬프트·모델·워크플로우·평가지표·전처리기 5종을 지원합니다. | | 리비전 동결 | 등록 신청 시점의 리소스 버전을 고정하는 것입니다. 원본이 이후 변경되어도 카탈로그는 신청 시점의 버전을 유지합니다. | | 등록 신청 | 소유자가 리소스를 카탈로그에 게시하기 위해 신청하는 것입니다. 승인 대기 상태로 생성됩니다. | | 승인·게시 | 관리자가 신청을 승인하면 카탈로그가 게시되어 다른 사용자에게 노출됩니다. | | 복제(사용하기) | 게시된 카탈로그를 자신의 리소스로 가져오는 것입니다. 새 리소스로 만들거나(새로 복제), 기존 리소스에 리비전을 추가(기존에 추가)합니다. | | 해제 신청 | 게시된 카탈로그를 내리기 위한 신청입니다. 해제 대기 상태가 됩니다. | | 좋아요·평점 | 카탈로그에 남기는 좋아요와 별점(0.5\~5, 0.5 단위)·코멘트입니다. 사용자당 1건으로 관리됩니다. | ## 진입 경로 * **카탈로그 둘러보기**: 각 리소스 목록 화면 우측 상단의 `카탈로그 보기` 버튼을 누르면 화면 오른쪽에 카탈로그 사이드 패널이 열립니다. * **카탈로그 상세**: 사이드 패널의 카드를 클릭하면 읽기 전용 카탈로그 상세 화면으로 이동합니다. * **등록 신청**: 원본 리소스의 상세 화면에서 `카탈로그 등록` 버튼으로 신청합니다. ## 카탈로그 등록 신청 (소유자) 리소스 소유자는 리소스 상세 화면에서 `카탈로그 등록` 버튼을 눌러 등록 신청 창을 엽니다. 1. 카탈로그명(기본값은 리소스명)과 설명을 입력합니다. 2. 동결할 리비전을 선택합니다. 5종 리소스 모두 상세 화면에서 리비전 목록을 불러와 선택할 수 있습니다. 3. 확인하면 등록 신청이 생성되고 승인 대기 상태가 됩니다. 이때 선택한 리비전이 동결됩니다. 4. 신청 후에는 원본 리소스 상세의 버튼이 `카탈로그 신청 취소`로 바뀝니다. 5. 관리자가 승인하면 카탈로그가 게시되어 다른 사용자에게 노출됩니다. 원본 리소스 상세 화면의 버튼은 현재 카탈로그 상태에 따라 다음과 같이 바뀝니다. | 카탈로그 상태 | 노출되는 버튼 | | -------------------- | ---------- | | 등록한 적 없음 · 반려됨 · 취소됨 | 카탈로그 등록 | | 승인 대기 | 카탈로그 신청 취소 | | 게시 중 | 카탈로그 해제 | | 해제 대기 | 해제 신청 취소 | ## 카탈로그 검색·복제 (사용자) 리소스 목록에서 `카탈로그 보기`를 누르면 사이드 패널이 열립니다. 패널은 검색·정렬·무한 스크롤을 제공합니다. 1. 검색 필드(이름·설명·생성자·태그 등)를 선택하고 검색어를 입력합니다. 2. 정렬을 선택합니다. 최근 등록순(기본값)·등록 오래된순·평점순·복제순을 지원합니다. 3. 목록을 아래로 스크롤하면 다음 항목이 이어서 로드됩니다. 4. 카드를 클릭하면 읽기 전용 카탈로그 상세 화면으로 이동합니다. 5. `사용하기`를 누르면 복제 창이 열립니다. * **새로 복제**: 새 이름과 관리 그룹을 입력해 새 리소스를 생성합니다. * **기존에 추가**: 대상 리소스를 선택해 그 리소스에 리비전을 추가합니다. 6. 복제가 완료되면 결과 리소스 화면으로 이동합니다. 7. 복제 이력이 기록되고 카탈로그의 복제수가 증가합니다. 카탈로그 상세는 읽기 전용이며 기본 정보와 리소스 목록 탭, 평점·복제수, `사용하기`와 해제 신청을 제공합니다. 리소스 목록 탭에서는 동결된 리비전에 포함된 파일 목록을 확인할 수 있고, 모델·전처리기 카탈로그에서는 필요한 파일을 내려받을 수 있습니다. 아래는 전처리기 카탈로그 상세 화면 예시입니다.

읽기 전용 카탈로그 상세 화면 (전처리기 예시)

## 복제(사용하기) 동작 복제 창에서 새로 복제와 기존에 추가 두 가지 모드를 선택할 수 있으며, 입력값 검증과 확인 창을 거친 뒤 복제가 수행됩니다. * **새로 복제**: 카탈로그에 동결된 리비전을 원본 삼아 내 리소스를 새로 만듭니다. 5종 리소스 모두 지원합니다. * **기존에 추가**: 내가 이미 가지고 있는 리소스를 대상으로 선택하면, 카탈로그의 동결 리비전이 그 리소스의 새 리비전으로 추가됩니다. 본문·작업본·코드·의존성은 서버에서 함께 복사됩니다. * 복제가 끝나면 새로 만들어진 리소스나 리비전이 추가된 리소스의 상세 화면으로 이동합니다. * 모델을 새로 복제하는 경우에는 모델 파일 복사가 백그라운드에서 진행되므로, 상세 화면 대신 모델 목록 화면으로 이동합니다. 복사가 끝나면 목록에서 상태를 확인한 뒤 상세로 들어갈 수 있습니다. ## 평점·좋아요 게시 중인 카탈로그 상세에서 `평가하기`를 누르면 평점 창이 열립니다. * 별점은 0.5점에서 5점까지 0.5점 단위로 부여합니다. 코멘트(500자 이하)는 선택 입력입니다. * 평점은 사용자당 1건으로 관리됩니다. 다시 평가하면 기존 평점이 갱신됩니다. * 평점을 남기면 평균 평점과 평가자 수가 함께 갱신됩니다. 이미 남긴 평점은 삭제할 수도 있습니다. * 좋아요는 평점과 별개로 동작하며, 버튼을 눌러 켜고 끌 수 있습니다. * 평점과 좋아요는 게시 중인 카탈로그에만 남길 수 있습니다. ## 리소스별 카탈로그 패널 카탈로그 사이드 패널은 리소스 종류에 따라 검색 필드와 카드에 표시되는 정보, 펼침(아코디언) 영역이 조금씩 다릅니다. | 리소스 | 검색 필드 | 복제 모드 | 카드 펼침 영역 | | ----- | ---------------------------- | ------- | -------------------------------------------------------------------------------- | | 프롬프트 | 이름 · 설명 · 프롬프트 본문 · 생성자 · 태그 | 새로 / 기존 | 프롬프트 보기 | | 모델 | 이름 · 설명 · 생성자 · 태그 | 새로 / 기존 | 메타 정보 | | 워크플로우 | 이름 · 설명 · 생성자 · 태그 | 새로 / 기존 | 워크플로우 설정값 보기 | | 평가지표 | 이름 · 설명 · 생성자 | 새로 / 기존 | 평가지표 설정값 보기 | | 전처리기 | 이름 · 설명 · 확장자 · 생성자 | 새로 / 기존 | [전처리기 관리](/default/v1.8.8/admin-management/settings/resource/preprocessor.md) 참조 | 정렬은 5종 공통으로 최근 등록순(기본값)·등록 오래된순·평점순·복제순을 지원합니다. 프롬프트 패널은 태그·평점·복제수를 카드에 표시하고, `프롬프트 보기`를 펼쳐 본문을 확인할 수 있습니다.

프롬프트 카탈로그 패널

모델 패널은 모델 타입과 태그를 표시하고, `메타 정보`에서 상세 정보를 확인할 수 있습니다.

모델 카탈로그 패널

워크플로우 패널은 태그를 표시하고, `워크플로우 설정값 보기`에서 설정값을 확인할 수 있습니다.

워크플로우 카탈로그 패널

평가지표 패널은 `평가지표 설정값 보기`에서 설정값을 확인할 수 있으며, 리비전 동결과 새로 복제·기존에 추가를 모두 지원합니다.

평가지표(LLM) 카탈로그 패널

전처리기 카탈로그 패널의 상세한 사용법은 [전처리기 관리](/default/v1.8.8/admin-management/settings/resource/preprocessor.md) 문서를 참조하세요. ## 게시 해제 게시된 카탈로그는 원본 리소스 상세 화면에서 `카탈로그 해제`를 눌러 해제를 신청합니다. 신청하면 해제 대기 상태가 되고, 마음이 바뀌면 `해제 신청 취소`로 되돌릴 수 있습니다. ## 목록·상세 화면 상태 카탈로그 패널은 상황에 따라 다음과 같이 표시됩니다. | 상황 | 화면 | 안내 문구 | | ---------------- | ----------- | ------------------ | | 게시된 카탈로그가 하나도 없음 | 안내만 표시 | 아직 카탈로그가 없습니다. | | 검색 결과가 없음 | 초기화 버튼 제공 | 조건에 맞는 카탈로그가 없습니다. | | 불러오는 중 | 카드 자리 표시자 | — | | 불러오기 실패 | 다시 시도 버튼 제공 | 목록을 불러올 수 없습니다. | 목록을 불러오지 못했다면 `다시 시도`를 눌러 재요청하고, 계속 실패하면 잠시 후 다시 접속해 주세요. 검색 결과가 없을 때는 `초기화`로 검색 조건을 지우고 다시 검색합니다. ## 권한과 접근 제한 | 상황 | 동작 | | -------------------- | --------------------------------------------------- | | 카탈로그 상세 열람 | 원본 리소스 종류(프롬프트·모델·워크플로우·평가지표·전처리기)에 대한 열람 권한을 따릅니다. | | 원본 리소스 수정 | 원본을 수정할 권한이 있는 사용자에게만 관련 기능이 노출됩니다. | | 평점·좋아요 남기기 | 게시 중인 카탈로그에만 허용됩니다. | | 카탈로그 상세 화면 | 읽기 전용입니다. 원본을 수정할 수 없고 확인·복제·평점만 가능합니다. | | 게시 중이 아닌 카탈로그 | 게시가 해제되었거나 취소·반려된 카탈로그는 상세를 열 수 없습니다. | | 권한 없는 원본에 접속한 뒤 뒤로가기 | 데이터가 없는 화면으로 처리됩니다. 목록에서 다시 진입해 주세요. | ## 사용자 시나리오 ### 시나리오 1 — 내 리소스를 카탈로그에 게시하기 리소스 상세에서 `카탈로그 등록`을 눌러 카탈로그명·설명과 동결할 리비전을 입력하면 신청이 생성되고 버튼이 `카탈로그 신청 취소`로 바뀝니다. 관리자가 승인하면 카탈로그가 게시되어 다른 사용자에게 노출됩니다. ### 시나리오 2 — 카탈로그를 검색해 복제하기 리소스 목록에서 `카탈로그 보기`로 패널을 열어 검색·정렬한 뒤 카드를 클릭해 읽기 전용 상세로 들어갑니다. `사용하기`로 새 리소스를 만들거나 기존 리소스에 리비전을 추가하면 결과 리소스 화면으로 이동하고, 복제 이력과 복제수가 반영됩니다. 모델을 새로 복제한 경우에는 파일 복사가 끝날 때까지 목록 화면에서 대기합니다. ### 시나리오 3 — 평점·좋아요 남기기 게시 중인 카탈로그 상세에서 `평가하기`로 별점과 코멘트를 남기면 평균 평점과 평가자 수가 갱신됩니다. 사용자당 1건으로 관리되므로 다시 평가하면 기존 평점이 바뀌며, 좋아요는 별도로 토글합니다. ### 시나리오 4 — 게시 해제하기 게시된 카탈로그의 원본 상세에서 `카탈로그 해제`로 해제를 신청하면 해제 대기 상태가 되고, 필요하면 `해제 신청 취소`로 되돌릴 수 있습니다. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://genos-docs.gitbook.io/default/v1.8.8/basic-tutorials/guides/catalog.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.