콘텐츠로 이동

번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.

이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. 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.