번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.
이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.
mentor 오퍼레이션
각 mentor.* 오퍼레이션이 받고 반환하는 정확한 필드입니다.
모든 op는 HTTP의 POST /v1/<op>와 MCP 도구 loom_<op>로 제공됩니다. 식별 필드(org, namespace, agent, user_id, session_id)는 전송 방식이 가능한 경우 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하면, code.*와 tracker.*(각자 플레인의 값을 유지함)를 제외한 모든 op에서는 설치의 org가 사용되고, 일부 op에서는 네임스페이스와 에이전트도 채워집니다. 식별자와 네임스페이스를 참고하세요. 오퍼레이션 색인에서 역할, 종류, MCP all 목록을 설명합니다. 알 수 없는 입력 필드도 처리되며 ignored_args에 이름이 표시됩니다.
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 |
경고 또는 치명적 힌트가 없음. |
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 형식의 가이드. |