> Source: https://clickhouse.github.io/loom/ko/reference/operations/mentor/ (Markdown: https://clickhouse.github.io/loom/ko/reference/operations/mentor.md)

<!-- i18n: source=docs/reference/operations/mentor.md blob=7893c77086ab087e1a7a997a0a406af5c6c3016a model=claude-sonnet-5-5 -->
> 이 페이지는 [영어 원문](https://clickhouse.github.io/loom/reference/operations/mentor/)을 기계 번역한 것이며, 영어 원문이 기준입니다.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/mentor/), which is authoritative.

<a id="mentor-operations"></a>

# `mentor` 오퍼레이션

각 `mentor.*` 오퍼레이션이 받고 반환하는 정확한 필드입니다.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

모든 op는 HTTP의 `POST /v1/<op>`와 MCP 도구 `loom_<op>`로 제공됩니다. 식별 필드(`org`, `namespace`, `agent`, `user_id`, `session_id`)는 전송 방식이 가능한 경우 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하면, `code.*`와 `tracker.*`(각자 플레인의 값을 유지함)를 제외한 모든 op에서는 설치의 org가 사용되고, [일부 op](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request)에서는 네임스페이스와 에이전트도 채워집니다. [식별자와 네임스페이스](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)를 참고하세요. [오퍼레이션 색인](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)에서 역할, 종류, MCP `all` 목록을 설명합니다. 알 수 없는 입력 필드도 처리되며 `ignored_args`에 이름이 표시됩니다.

<!-- prettier-ignore-start -->

<a id="mentorbrief"></a>

## `mentor.brief`

에이전트 한 개의 사용 프로필과 저장소의 힌트입니다.

`POST /v1/mentor.brief` · MCP `loom_mentor_brief` · 역할 `viewer` · 읽기

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(식별 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | op가 읽거나 쓰는 네임스페이스. |
| `agent` | `str` | `''` | 쓰기 또는 읽기를 수행하는 에이전트. `'-'` 또는 `'*'`는 op가 허용하는 경우 모든 에이전트를 의미합니다. |
| `window_seconds` | `int` | `604800` | 원장 읽기가 거슬러 올라가는 범위(초). 1시간에서 90일까지. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `org` | `str` | 테넌트(식별 튜플의 첫 번째 요소). |
| `namespace` | `str` | op가 읽거나 쓰는 네임스페이스. |
| `agent` | `str` | 쓰기 또는 읽기를 수행하는 에이전트. `'-'` 또는 `'*'`는 op가 허용하는 경우 모든 에이전트를 의미합니다. |
| `window_seconds` | `int` | 프로필을 계산한 구간(초). 캐시에서 제공된 프로필은 계산 당시의 구간을 유지합니다. |
| `computed_at` | `datetime` | 프로필을 계산한 시각(UTC). 캐시에서 제공되면 호출 시점보다 이전입니다. |
| `sessions` | `int` | 구간 내 이 에이전트의 고유한 클라이언트 지정 세션 수(`-`와 `*`는 세지 않음). |
| `usage` | `dict[str, int]` | 구간 내 이 에이전트의 오퍼레이션별 호출 수. |
| `planes` | `list[MentorPlane]` | 멘토가 아는 모든 플레인과, 이 에이전트의 해당 플레인 호출 수 및 사용 가능 여부. |
| `hints` | `list[MentorHint]` | 이 에이전트에 적용된 규칙과 규칙을 발동시킨 횟수. 없으면 비어 있습니다. |
| `adoption` | `list[MentorAdoption]` | 힌트 코드별로, 힌트가 표시된 세션과 이를 따른 세션 수(많이 표시된 순). 에이전트에 도달한 힌트가 없거나 읽기에 실패하면 비어 있습니다. |
| `usage_evidence` | `list[UsageRung]` | 구간 내 에이전트의 Loom 사용을 단계별로 하나씩, 약한 주장부터 나열: 단순 호출부터 평가된 실행까지. |
| `ledger_from` | `datetime \| None` | 구간 내 이 에이전트의 가장 오래된 원장 행(종류 무관). 행이 없거나 읽기에 실패하면 None. |
| `ledger_retention_days` | `int \| None` | 설정된 보존 기간 동안 이 네임스페이스의 호출 원장 행을 유지하는 일수. 0은 삭제할 때까지 유지하며, 읽기에 실패하면 None. |
| `agents` | `list[str]` | 구간 내 네임스페이스의 작성자(활동이 많은 순). 호출자에게 고유한 에이전트 이름이 없으면(대시보드) 브리프는 첫 번째를 기본값으로 사용하며, `agent_defaulted`로 알려 줍니다. |
| `agent_defaulted` | `bool` | 호출자가 실제 에이전트를 지정하지 않아 브리프가 `agents`의 최상위 작성자를 선택했으면 True. |
| `skipped` | `list[str]` | 브리프가 읽지 못한 사실. "step: reason" 형식. |
| `healthy` | `bool` | 경고 또는 치명적 힌트가 없음. |

<a id="mentorguide"></a>

## `mentor.guide`

이 서버가 제공하는 에이전트 가이드로, 모든 호출자에게 동일합니다.

`POST /v1/mentor.guide` · MCP `loom_mentor_guide` · 역할 `viewer` · 읽기 · MCP `all` 툴셋에는 표시되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | `''` | 테넌트(식별 튜플의 첫 번째 요소). |
| `part` | `Literal['skill', 'reference', 'all']` | `'skill'` | 반환할 부분: `skill`(루프와 규칙, 기본값), `reference`(각 플레인) 또는 `all`. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `version` | `str` | 가이드의 버전(skills/loom/SKILL.md의 `metadata.version`). |
| `part` | `Literal['skill', 'reference', 'all']` | 요청한 대로 반환된 부분. |
| `text` | `str` | 스킬의 frontmatter를 제외한 Markdown 형식의 가이드. |

<!-- prettier-ignore-end -->
