번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.
이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.
profile_schema 작업
각 profile_schema.* 작업이 받고 반환하는 정확한 필드입니다.
모든 op는 HTTP로는 POST /v1/<op>이고 MCP 도구로는 loom_<op>입니다. 전송 방식이 가능하면 ID 필드(org, namespace, agent, user_id, session_id)는 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하면, code.*와 tracker.*(해당 플레인의 값을 유지함)를 제외한 모든 op에서 설치의 org가 채워지고, 일부 op에서는 네임스페이스와 에이전트도 채워집니다. ID와 네임스페이스를 참고하세요. 작업 인덱스에서 역할, 종류, MCP all 목록을 설명합니다. 알 수 없는 입력 필드는 처리되며 ignored_args에 이름이 표시됩니다.
profile_schema.clear
스키마를 지웁니다. 이 네임스페이스에 대해 프로필을 새로 만들거나 다시 만들지 않으며, 읽기 요청은 no_schema로 응답합니다.
POST /v1/profile_schema.clear · MCP loom_profile_schema_clear · 역할 admin · 멱등 · 감사 대상 · MCP all 툴셋에 나열되지 않음
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(ID 튜플의 첫 번째 요소). |
namespace |
str |
필수 | op가 읽거나 쓰는 네임스페이스. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
found |
bool |
네임스페이스에 프로필 스키마가 없으면 False. |
json_schema |
dict[str, Any] |
관리자가 설정한 그대로의 스키마이며 키 순서를 유지합니다. 찾지 못하면 {}. |
schema_sha256 |
str |
스키마의 properties(제목이나 순서는 제외)에 대한 SHA-256이며, 각 프로필이 이 값을 가리킵니다. |
updated_by |
str |
마지막으로 스키마를 설정하거나 지운 행위자(human:<subject> 또는 process:<subject>). 찾지 못했거나 토큰이 한 사용자로 제한된 경우 비어 있습니다. |
updated_at |
datetime \| None |
마지막으로 설정하거나 지운 시각. 찾지 못하면 None. |
profile_schema.get
네임스페이스의 프로필 스키마, 그 해시, 그리고 누가 언제 설정했는지를 반환합니다.
POST /v1/profile_schema.get · MCP loom_profile_schema_get · 역할 viewer · 읽기 · MCP all 툴셋에 나열되지 않음
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(ID 튜플의 첫 번째 요소). |
namespace |
str |
필수 | op가 읽거나 쓰는 네임스페이스. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
found |
bool |
네임스페이스에 프로필 스키마가 없으면 False. |
json_schema |
dict[str, Any] |
관리자가 설정한 그대로의 스키마이며 키 순서를 유지합니다. 찾지 못하면 {}. |
schema_sha256 |
str |
스키마의 properties(제목이나 순서는 제외)에 대한 SHA-256이며, 각 프로필이 이 값을 가리킵니다. |
updated_by |
str |
마지막으로 스키마를 설정하거나 지운 행위자(human:<subject> 또는 process:<subject>). 찾지 못했거나 토큰이 한 사용자로 제한된 경우 비어 있습니다. |
updated_at |
datetime \| None |
마지막으로 설정하거나 지운 시각. 찾지 못하면 None. |
profile_schema.set
네임스페이스의 프로필 스키마를 설정합니다.
POST /v1/profile_schema.set · MCP loom_profile_schema_set · 역할 admin · 멱등 · 감사 대상 · MCP all 툴셋에 나열되지 않음
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(ID 튜플의 첫 번째 요소). |
namespace |
str |
필수 | op가 읽거나 쓰는 네임스페이스. |
json_schema |
dict[str, Any] |
필수 | 1~64개의 properties를 가진 JSON Schema 객체이며, 각 속성에는 type과 description이 있어야 합니다(최대 16 KiB). 네임스페이스의 스키마를 대체하며, properties가 변경되면 모든 프로필이 오래된 상태가 됩니다. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
found |
bool |
네임스페이스에 프로필 스키마가 없으면 False. |
json_schema |
dict[str, Any] |
관리자가 설정한 그대로의 스키마이며 키 순서를 유지합니다. 찾지 못하면 {}. |
schema_sha256 |
str |
스키마의 properties(제목이나 순서는 제외)에 대한 SHA-256이며, 각 프로필이 이 값을 가리킵니다. |
updated_by |
str |
마지막으로 스키마를 설정하거나 지운 행위자(human:<subject> 또는 process:<subject>). 찾지 못했거나 토큰이 한 사용자로 제한된 경우 비어 있습니다. |
updated_at |
datetime \| None |
마지막으로 설정하거나 지운 시각. 찾지 못하면 None. |