> 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.9.4/common-features/list-favorite.md).

# 목록 즐겨찾기

목록 즐겨찾기는 관리자 화면의 주요 목록에서 자주 쓰는 항목에 별(★)을 달아 두고, 「즐겨찾기만 보기」로 그 항목만 걸러 보는 기능입니다. 즐겨찾기는 **사용자 개인 설정**이라 같은 목록을 보는 다른 사용자에게는 영향을 주지 않습니다.

각 목록 테이블 맨 앞에 별 컬럼이 생기고, 목록 상단 필터 영역에 `즐겨찾기만 보기` 체크박스가 추가됩니다. 별을 누르면 그 자리에서 등록·해제되며 별도의 저장 버튼이나 결재 절차는 없습니다.

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2FYqpZ4IdJi0ofeXeqbYk3%2F01_serving_list_star_column.png?alt=media&amp;token=b0e4f91c-9d9c-453c-9c7f-a45f45a55d56" alt=""><figcaption></figcaption></figure>

### 적용 대상 목록

#### 리소스 목록

| 화면              | 경로                  |
| --------------- | ------------------- |
| 앱 > 채팅 앱        | `/application/chat` |
| 에이전트 > 워크플로우    | `/agent/workflow`   |
| 에이전트 > A2A 에이전트 | `/agent/a2a`        |
| 서빙 > 모델 서빙      | `/serving/model`    |
| 서빙 > 코드 서빙      | `/serving/code`     |
| 도구 > MCP 서버     | `/tools/mcp/server` |

#### 리비전 목록

같은 기능이 아래 상세 화면의 리비전 목록 탭에도 적용됩니다. 리비전은 리소스가 아니라 리소스와 리비전 쌍으로 저장되므로, 다른 서빙의 리비전 목록에는 영향을 주지 않습니다.

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2Fq3BD7LObKZCUA2OX8Cw9%2F04_revision_list_star.png?alt=media&amp;token=6ac00da9-8343-4590-8ddf-33a24d87b2e7" alt=""><figcaption></figcaption></figure>

| 화면                                     |
| -------------------------------------- |
| 모델 서빙 상세 > 리비전 목록 (LLM · 임베딩 · Triton) |
| 코드 서빙 상세 > 리비전 목록                      |
| 워크플로우 상세 > 리비전 목록                      |

### 즐겨찾기 등록·해제

목록 테이블 맨 앞 별 컬럼에서 바로 토글합니다.

* 별 컬럼의 헤더는 빈칸이고 정렬할 수 없습니다. 즐겨찾기 항목이 목록 위로 고정되지도 않으며, 정렬은 기존 기준을 그대로 따릅니다.
* 별에 마우스를 올리면 다음 동작이 툴팁으로 표시됩니다 — 해제 상태면 `즐겨찾기 추가`, 등록 상태면 `즐겨찾기 해제`.
* 별을 누르면 요청이 끝날 때까지 그 별은 잠시 비활성으로 표시되고, 같은 행을 연타해도 요청은 한 번만 나갑니다.
* 처리에 성공하면 목록을 다시 불러와 별 상태를 갱신합니다. 즐겨찾기만 보기가 켜진 상태에서 해제하면 그 행은 목록에서 사라집니다.
* 목록 행을 더블클릭하면 상세로 이동하지만, 별 위에서의 클릭·더블클릭·Enter·Space는 상세 이동으로 이어지지 않습니다.
* 실패하면 오류 안내가 표시되고 별 상태는 바뀌지 않습니다.

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2FqDtaXzMjcVRgMBPQfXtt%2F02_star_tooltip_add.png?alt=media&amp;token=01f69771-3f59-4fe7-a6a8-9c0aef7e8bc7" alt=""><figcaption></figcaption></figure>

### 즐겨찾기만 보기

목록 상단 필터 영역의 맨 뒤에 `즐겨찾기만 보기` 체크박스가 있습니다.

* 체크하면 내가 즐겨찾기한 항목만 조회됩니다. 다른 사용자의 즐겨찾기는 반영되지 않습니다.
* 체크·해제하면 목록이 1페이지로 돌아갑니다. 필터를 바꾸면 전체 건수가 달라지므로 보고 있던 페이지 번호를 유지하지 않습니다.
* 검색어·다른 필터와 함께(AND) 적용됩니다. 즐겨찾기한 항목 중에서 검색 결과만 보는 식으로 좁힐 수 있습니다.
* 켠 상태는 주소창 쿼리(`favoriteOnly=true`)에 남습니다. 새로고침하거나 뒤로 가기로 돌아와도 필터가 유지되고, 링크를 공유하면 같은 필터 상태로 열립니다. 다만 즐겨찾기 자체는 개인 설정이므로 상대는 자기 즐겨찾기 기준으로 봅니다.
* 초기화 버튼은 앱 > 채팅 앱 목록에만 있습니다. 그 화면에서는 초기화 시 검색어·다른 필터와 함께 즐겨찾기만 보기도 해제됩니다. 나머지 목록에는 초기화 컨트롤이 없으므로 체크박스를 다시 눌러 해제합니다.
* 조건에 맞는 항목이 없으면 목록의 검색 결과 없음 상태가 표시됩니다.

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2FcPcfdBcQ2nhQj0Fe0lVN%2F03_favorite_only_filtered.png?alt=media&amp;token=4f2e9f0d-5eb1-4b4a-af73-4446e259069e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2FOfcuXxJhfY4UniDABYTJ%2F05_favorite_only_no_result.png?alt=media&amp;token=3b4502bc-a078-4eb1-90e0-d3b7a230268d" alt=""><figcaption></figcaption></figure>

### 권한과 공유

* 즐겨찾기는 조회 권한이 있는 리소스에만 등록할 수 있습니다. 별을 누른 시점에 서버가 해당 리소스의 조회 권한을 확인하고, 권한이 없거나 이미 삭제된 대상이면 등록되지 않습니다.
* 등록한 뒤 권한이 회수되면 그 항목은 목록에서 보이지 않습니다. 권한이 다시 부여되면 즐겨찾기 상태는 그대로 살아납니다.
* 즐겨찾기는 사용자 단위로 저장되므로 공유·이관 대상이 아니며, 다른 사용자의 목록에는 영향을 주지 않습니다.

### 자주 마주치는 안내 문구

| 상황                                    | 문구                            |
| ------------------------------------- | ----------------------------- |
| 대상이 없거나 삭제됐거나 조회 권한이 없는 리소스에 즐겨찾기를 시도 | 즐겨찾기 대상을 찾을 수 없거나 접근 권한이 없습니다 |

대상 없음·삭제됨·권한 없음은 하나의 안내로 합쳐 표시됩니다. 리소스 존재 여부를 떠보는 통로가 되지 않도록 사유를 구분하지 않습니다.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://genos-docs.gitbook.io/default/v1.9.4/common-features/list-favorite.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
