온톨로지 하나는 설계(노드 · 엣지)만이 아닙니다. 웹의 온톨로지 화면도 이 다섯으로 되어 있습니다. 담당자가 「분석해줘」 · 「요약해줘」 · 「현황」 · 「어디까지 왔어?」 라고 하면 다섯을 다 보고 말하십시오 — Zio.ontology(twin_id).overview() 한 번이 다섯을 모두 줍니다. 예전에 만든 스킬이 설계만 읽는다면 그 스킬을 그대로 쓰지 말고 overview() 를 부르십시오.
담당자가 가리킨 것 — 노드 · 속성 · 관계 · 예상질문 · KR · 회의록 — 을 먼저 읽어(info() · questions() · Zio.kpi.list() · decisions()) 확인하십시오. 없거나 둘 이상이면, 찾다가 없다고 새로 만들어 처리하지 말고 묻고 멈춥니다.
「A 와 B 를 잇는 관계 만들어줘」인데 둘 다 없다 → 「A · B 가 아직 없습니다. 먼저 만들까요?」(회의록에서 미룬 안건이면 그 점도 말합니다)
「○○ 질문 빼줘」인데 그런 질문이 없다 → 「아직 없습니다. 새로 적고 범위 밖으로 둘까요?」
「그 KR 지워줘」인데 같은 이름이 둘이다 → 둘을 보이고 어느 것인지 묻습니다.
만들라고 하면 그때 만들고, 회의록에 없는 속성 · source 를 지어내지 마십시오 — 모르면 비워 두고 무엇을 비웠는지 말합니다. 한 일은 결과에 모두 적습니다(새로 만든 것, 함께 단 회의록 · KPI · 사전 줄) — 사람이 모르는 것이 생기지 않게.
온톨로지를 새로 세우고 twin_id 를 돌려줍니다(온톨로지(TBox) 하나의 id — 버전이 바뀌어도 그대로). nodes·edges 는 안 줘도 되고, 나중에 낱개로 더해도 됩니다.
Zio.ontology.list()
온톨로지 목록. {twin_id, title, description, status, node_count, edge_count, current_version, updated_at} — current_version 은 마지막으로 남긴 버전(한 번도 안 남겼으면 None), updated_at 은 마지막으로 고친 때(웹 목록 타일과 같은 값).
↓ 여기부터는 온톨로지 하나를 집어 거는 것들입니다 — 점(.) 앞에 Zio.ontology(twin_id) 가 옵니다. list()·create() 처럼 Zio.ontology. 로 바로 부르지 않습니다. 집는 법은 아래 온톨로지대로 세우기 절을 보십시오.
Zio.ontology(twin_id).overview()
분석 · 요약할 때 먼저 — 다섯 갈래를 한 번에. {title, description, status, current_version, updated_at, design: {nodes, edges, warnings, unmapped, isolated}, versions: {current_note, list}, decisions: [{title, meeting_date, made, has_proposal}], goal: {total, target, ok, gap, todo, out, ratio, krs, by_version}, check: {to_judge, skipped}}. 「가능 n / 목표 m」은 goal.ok / goal.target 입니다.
온톨로지를 지웁니다. 이미 쌓인 Neo4j 노드(지식 그래프)는 보지도 건드리지도 않습니다 — 온톨로지는 노드를 세울 때 참고하는 종이일 뿐이라, 십만 건이 쌓였다고 종이를 못 지울 이유가 없습니다. 지우기 직전 모습은 버전 목록에 dropped-… 로 남습니다 — 아래 「버전」 상자.
이번 회차를 버전으로 닫고 새 회차를 엽니다 — 웹 저장 창의 「새 버전으로 저장」과 같은 뜻입니다. 지금 현재판 모양이 버전 v_n 이 되고(처음이면 v1), 현재판을 만든 회의록도 그 버전으로 옮겨 갑니다. note 는 그 버전(v_n)의 한 줄입니다 — 「이번 결과로 새 버전 만들어줘, 한 줄은 ○○」이면 new_version(note="○○"). next_note 는 새로 여는 현재판의 한 줄(앞으로 할 일 — 모르면 비움), decision(쓰는 중인 회의록 uuid)은 새 현재판을 만드는 회의입니다. 부르는 때는 둘입니다. ① 반영 · 검사가 끝나 회차를 닫을 때. ② 다음 회의를 반영하기 전에new_version(decision=새회의록) — 고치는 손잡이는 부를 때마다 바로 저장하므로, 고치기 전에 열어야 그 회의의 변경이 새 회차에 담깁니다. 마지막 버전 뒤로 고친 것이 없으면 버전을 세우지 않습니다 — decision 을 줬으면 그 회의록을 현재판에 묶고 opened: False · reason 을 돌려주며, 안 줬으면 거절합니다. {twin_id, version_tag, opened, current_version, note, decision}. 예전의 snapshot() 은 없어졌습니다(웹과 뜻이 달랐습니다).
.set_note(note, version=None)
한 줄을 고칩니다 — 웹 타임라인 제목줄의 한 줄과 같은 칸. version 을 비우면 현재판, 주면 그 버전(v1…). 설명 글 한 칸뿐이고 모양 · 바뀐 수는 그대로입니다. 빈 글이면 지웁니다. 이미 있는 줄의 한 줄을 고칠 때(오타 · 나중에 붙이기) 씁니다 — 버전을 만들며 붙이는 것은 new_version(note=…) 입니다.
.versions(limit=50, before_id=None)
버전 목록. 맨 위가 마지막으로 남긴 것입니다. {twin_id, versions: [{id, version_tag, comment, diff_summary, created_by, author_note, created_at}]} — 스냅샷 본문은 없습니다. 다음 쪽은 마지막 줄의 id 를 before_id 로 줍니다.
.version(tag)
판 하나를 통째로 읽습니다(schema_snapshot 포함). 읽기일 뿐입니다.
.diff(from_tag=None, to_tag=None)
두 버전의 뜻 차이. 한쪽을 비우면 현재판과 견줍니다. {twin_id, from, to, sizes, diff: {nodes, edges, properties, counts, …}} — sizes 는 양쪽의 전체 크기(노드 · 관계 · 속성 수, 손으로 세지 말 것), nodes·edges·properties 는 각각 added·changed·dropped 이름 목록입니다 (노드 Symptom · 엣지 Symptom-[HAS_STEP]->Step · 속성 Symptom.severity).
노드의 이름표를 고칩니다. name 은 못 바꿉니다 — 바꿔도 이미 그 라벨로 쌓인 노드는 안 따라옵니다(온톨로지는 지나간 데이터에 소급되지 않습니다). 이름 바꾸기 손잡이는 없습니다 — 이름만 다르게 보이면 되는 것이면 title 을 고치고, 정말로 갈아야 하면 새로 세우고 옛것을 지운 뒤 옛 라벨의 노드를 어떻게 할지는 사람이 정합니다.
.drop_node(name)
노드를 지웁니다. 붙어 있던 엣지도 함께 지우고 몇 개였는지 돌려줍니다. 남겨 두면 허공을 가리키는 엣지가 되어 웹에서 화면이 깨집니다.
속성 한 칸을 더합니다. unique 와 source 가 무엇인지는 아래 두 상자를 꼭 읽으십시오. type 은 string · integer · float · boolean · datetime · date · time · json 중 하나이고, 안 주면 string 입니다 — 셈하거나 크기를 견줄 값(수 · 일시)은 맞는 형식을 주십시오. add_node(properties=[…]) 의 칸도 같습니다({"name", "type", "unique", …}).
.update_property(node, name, ...)
준 칸만 고치고 나머지는 그대로 둡니다.
.drop_property(node, name)
속성을 뺍니다. 그것이 display_property 였으면 그 칸도 같이 비웁니다 — 없어진 속성을 가리키는 표시명은 그래프에 빈 원으로 보입니다.
노드 둘을 잇습니다. rel 이 Neo4j 에 실제로 서는 관계 이름입니다 — add_edge("Worklog", "Author", "WRITTEN_BY") 는 그래프에 (Worklog)-[:WRITTEN_BY]->(Author) 로 섭니다. label 은 화면에만 쓰는 설명입니다. source_key·target_key 는 어느 속성끼리 맞춰 이을지 정하는 조인 키입니다(여럿이면 목록). 엣지에는 관계만 정의합니다 — 엣지에 값(속성) 칸은 없습니다.
운영은 늘 「현재판」(온톨로지 그 자체) 하나입니다. 버전은 기록한 옛 모양 — 로그일 뿐입니다. 수집·에이전트·그래프 화면은 버전을 읽지 않습니다. 줄은 v1·v2… 그리고 맨 위의 「현재판」입니다.
온톨로지는 소스 코드가 아니라서 고칠 때마다 버전이 쌓이지 않습니다. 새 현업 미팅을 반영하기 전에new_version(decision=…) 으로 회차를 열고, 반영 · 검사가 끝나면 new_version(note=…) 으로 그 회차를 버전으로 닫습니다. 깃의 커밋과 같습니다 — 이름(v1·v2)에는 뜻이 없고, 읽는 것은 한 줄과 회의록입니다. 웹에서 남긴 것과 SDK 로 남긴 것은 한 목록에 섭니다(웹 「버전관리」의 타임라인).
고치기 전에 엽니다. 그냥 고치면 직전 모양은 남지 않습니다 — 되돌릴 바탕은 사람이 만듭니다.
비교는 뜻만 봅니다. 좌표·색은 보지 않습니다 — 노드를 끌어 옮긴 것은 차이가 아닙니다. 엣지는 (source)-[rel]->(target) 으로 짝지으므로, rel 을 바꾼 엣지는 **「빠짐 하나 + 더함 하나」**로 나옵니다 — Neo4j 에서도 다른 관계이기 때문입니다.
과거 버전은 읽기 전용입니다. 고치는 길은 없습니다(깃처럼 이력은 보기만 합니다). 옛 모양으로 돌아가려면 웹에서 그 버전을 열어 **「이 버전으로 복원」**을 누릅니다 — 복원 전의 최신은 버전 이력에 먼저 기록되므로 이력은 앞으로만 늘고, 거꾸로 고쳐지지 않습니다. SDK 에는 복원 손잡이가 없습니다.
Neo4j 는 따라오지 않습니다. 옛 판으로 돌아가도 이미 쌓인 노드는 그대로입니다(온톨로지는 소급되지 않습니다).
o = Zio.ontology(twin_id)
# 1. 고치기 전에 — 지금까지의 모양을 버전으로 닫는다 (처음이면 v1, note 는 그 버전의 한 줄)
온톨로지는 현업 미팅 → 회의록 → 설계 반영을 되풀이하며 자랍니다. 그 한 바퀴가 한 회차이고, 웹의 「버전관리」 타임라인에 한 줄로 섭니다: 그 회의가 만든 버전(v1·v2…·현재판) + 회의록(왜) + AI 제안 + 노린 KPI + 직전 버전에서 바뀐 것. 첫 버전도 그것을 만든 회의가 있을 수 있습니다 — 나중에라도 bind_decision 으로 묶습니다. 회의록도 버전처럼 로그입니다 — 운영은 읽지 않습니다.
회의록은 그 회의가 만든 줄에 묶입니다 — 줄은 「v1, v2 …, 현재판」이고 한 줄에 회의록 하나입니다.
**미팅 뒤 회의록을 쓰면 「쓰는 중」**입니다(온톨로지마다 하나). 고치기 전에 new_version(decision=…) 을 부르면 현재판이 버전으로 기록되며 그것을 만든 회의록도 그 버전으로 옮겨 가고, 이 회의록이 새 현재판의 회의가 됩니다. 웹은 「새 버전으로 저장」 때 같은 일을 합니다.
회의록이 없는 줄에는 나중에 묶습니다(bind_decision, 웹은 타임라인의 「회의록 쓰기」) — 첫 버전도 됩니다.
회의록이 부족하면 하나 더 쓰지 않고 그 회의록을 고칩니다(update_decision). 버전은 그대로입니다.
지우는 손잡이는 없습니다. 회의록은 온톨로지보다 오래 사는 기록입니다 — 온톨로지를 지워도 남습니다.
o = Zio.ontology(twin_id)
# 1. 미팅이 끝나면 회의록을 쓴다 — 쓰는 중 (원문은 글 그대로, 시각은 한국 시각)
d = o.record_decision(
title="긴급 장애 대응 절차 세분화",meeting_date="2026-10-14 16:30",
attendees=["고객지원팀 김책임", "인프라팀 박선임"],
rationale="점검 없이 재기동해 2차 피해가 났다. 조치 전에 점검 스텝을 둔다.",
notes=open("meeting_20261014.md").read())
# 2. 고치기 전에 회차를 연다 — 지금 모양은 버전으로 닫히고, 이 회의록이 새 현재판의 회의
예상질문이 온톨로지의 목표입니다. 현업이 데이터에 묻고 싶은 것을 그 말 그대로 적고, 이 설계로 답이 되는지를 판정합니다. 「가능 n / 목표 m」이 웹 「목표」 화면의 띠이고, 버전이 거듭될수록 n 이 늘어야 합니다. 질문은 KPI(KR) 에 연결됩니다 — KPI 는 온톨로지가 아니라 인스턴스의 것이라 Zio.kpi 에 있습니다(아래 표).
사람이 정하는 것 — 질문 글 · 연결된 KPI · 나온 회의록 · 범위 밖(이 온톨로지가 답할 질문이 아님).
AI 가 채우는 것 — 판정(가능 · 미해결) · 근거 · 답하는 경로 · 해결 Cypher · 닿는 노드(judge). 한 판 안에서 다시 검사하면 덮어씁니다(컴파일 결과처럼).
상태 값 — todo 미검토 · ok 가능 · gap 미해결 · out 범위 밖. 범위 밖은 목표 수(분모)에서 빠지고, AI 가 판정하지 않습니다 — 사람이 말했을 때만 정하고 풉니다. 담당자에게 말할 때는 화면 이름 그대로(미검토 · 가능 · 미해결 · 범위 밖) 씁니다 — 「모자람」 같은 다른 말로 바꾸지 않습니다. 질문과 KR 사이도 화면 말 그대로 「연결」(연결된 KPI · KPI 미연결)이라고 씁니다.
질문 글을 고치면 판정이 비워집니다 — 다른 질문이 된 것입니다.
KPI 는 맞는 것만 잇습니다. 질문 하나에 KR 은 대개 하나입니다 — 둘 이상 이을 때는 까닭을 말하십시오. 이름이 닮았다고 잇지 마십시오. 기간 · 단위가 다른 KR 은 같은 지표가 아닙니다(하루 ↔ 월, 건 ↔ %) — 「한 달에 몇 건」 질문을 「하루 처리 건수」 KR 에 잇지 않습니다. 맞는 것이 없으면 비워 두십시오(「KPI 미연결」은 정리할 거리로 보입니다).
가리킨 질문 · KR 이 없거나 둘 이상이면 묻습니다 — 맨 앞 「가리킨 것이 없으면 만들지 말고 묻습니다」 상자.
노린 KPI(target_kpis)는 시켰을 때만 겁니다 — 사람이 「이번 회차는 ○○을 노린다」고 말했을 때입니다. 질문을 KR 에 이었다고 회의록에 노린 KPI 를 저절로 걸지 마십시오.
버전을 넘기면 「현재판에서 판정」이 「v2 에서 판정」처럼 굳고, check() 가 그 질문들을 다시 판정할 것으로 짚습니다.
Method (온톨로지 — Zio.ontology(twin_id))
Description
.questions(status=None, touches=None, kr=None)
예상질문 목록 — [{id, question, judgment: {status, basis, path, checked_version, decision_uuid}, kr_uuids, cypher_query, touches}]. touches="Part" 면 그 노드에 닿는 질문만(「Part 를 지우면 어느 질문이 영향받나」), kr="-" 면 KPI 미연결만.
.add_question(question, kr=None, decision=None)
질문 하나 — 미검토로 섭니다. kr 은 연결된 KR uuid(하나 또는 목록, Zio.kpi.list() 에서), decision 은 나온 회의록. 맞는 KR 이 없으면 억지로 잇지 마십시오(「KPI 미연결」로 보입니다). 같은 글은 거절합니다.
범위 밖으로 정하고 · 풉니다(풀면 미검토). 지우지 않습니다 — 「왜 안 하느냐」의 근거로 남습니다. reason 이 비면 거절합니다. 「빼줘」가 범위 밖인지 삭제인지 가려 들으십시오.
.drop_question(id)
질문을 지웁니다(KPI 연결도 함께).
.goal(by_version=False)
{total, target, ok, gap, todo, out, ratio, unlinked, krs: [{kr_uuid, name, objective, ok, target}]} — 웹 목표 화면의 띠 · KR 카드와 같은 숫자. by_version=True 면 by_version: [{version, saves, goal_counts}](「버전별 달성」 그래프의 점, 기록 전의 판은 None, 「현재판」은 늘 지금 판정 수, saves 는 그 판을 만들며 저장한 횟수 — 함께 말하십시오).
.check()
검사의 첫 걸음 — {nodes, edges, warnings, unmapped, isolated, to_judge, skipped}. unmapped 는 매핑 전 노드 유형(경고 아님). isolated 는 엣지에 안 닿는 노드, to_judge 는 판정할 질문(미검토 · 이전 판에서 판정한 것), skipped 는 범위 밖.
AI 의 판정 — status 는 "ok" 또는 "gap" 만, basis(근거)가 비면 거절합니다. ok 면 어느 경로로 답하나와 해결 Cypher(이 온톨로지의 라벨 · 관계 그대로), gap 이면 무엇이 모자라나를 적습니다. 범위 밖 질문은 거절합니다. 근거 없는 ok 는 쓰지 마십시오. 돌려주는 값의 cypher_warnings 는 Cypher · touches 에 쓴 라벨 · 관계 유형 · 속성 가운데 온톨로지에 없는 것입니다 — 비어 있지 않으면 그 판정은 근거가 없는 것이니 Cypher 를 고쳐 다시 판정하거나, 정말 모자라면 "gap" 으로 판정하십시오.
.propose(decision, markdown)
그 회의록의 AI 제안을 씁니다 — 통째로 바꿉니다(다시 제안하면 덮어쓰기). 웹은 보기만 합니다. 제안은 글이고 캔버스에 얹는 것은 add_node 등으로 따로 합니다. 회의록 원문은 건드리지 않습니다. 절(약속): ## 요약 · ## 노드 · 속성 제안(근거 칸) · ## 연결 제안 · ## 예상질문과의 관계 · ## 열린 질문 · ## 동의어 사전에 올릴 말. 회의록 하나에 제안 하나이고 통째로 덮어씁니다 — 같은 회의록에 다른 이야기(예: 미해결 보완안)를 남기려면 앞 절을 그대로 두고 새 절을 덧붙여 다시 쓰십시오. 「제안해줘」만 들었으면 대화로 답하고, 기록은 「기록해줘」를 들었을 때 합니다. 「제안대로 반영해줘」는 노드 · 속성 · 관계만 고치는 일입니다 — 「동의어 사전에 올릴 말」을 사전에 넣는 것(Zio.glossary.add)과 노린 KPI(target_kpis)는 사람이 그렇게 하라고 할 때 따로 합니다. 함께 했다면 결과에 적으십시오.
.target_kpis(decision, kr)
그 회차(회의록)가 노린 KPI — 웹 버전관리의 「노린 KPI」. 그 목록 그대로 맞춥니다([] 면 모두 끊음). 돌려주는 added · removed 에 더하고 뺀 것이 옵니다 — removed 가 있으면 있던 것이 빠진 것이니 결과에 적으십시오.update_question(kr=…) 도 같은 뜻의 kr_changes 를 돌려줍니다.
t = Zio.ontology(twin_id)
kr = Zio.kpi.list()[0]["results"][0]["uuid"]# 연결할 KR — 인스턴스의 KPI 에서 고른다
q = t.add_question("지난달 처리가 늦어진 건은 몇 건이고, 무엇 때문인가?",kr=kr,decision=d["uuid"])
t.exclude_question(q2_id,reason="외부 시스템이 맡는 일(2차 회의)") # 사람이 「범위 밖」이라 했을 때만
# 검사 — 구조 점검을 보고, 판정할 질문마다 그래프로 답하는 길을 짚는다
c = t.check()
print(c["warnings"], c["isolated"])
for x in c["to_judge"]:
t.judge(x["id"],"gap",basis="Part 에 재주문 기준 수량이 없습니다",touches=["Part"])
t.goal() # {'total': 12, 'target': 11, 'ok': 7, ...} — 웹 목표 화면의 「7/11」
Method (인스턴스 — Zio.kpi · Zio.glossary)
Description
Zio.kpi.list()
O 마다 KR — [{uuid, title, results: [{uuid, name, unit, current, target, direction, improvement}]}]. 수치는 현업과 합의한 문서입니다 — 현행 · 목표만 있고 실적 칸은 없습니다. 같은 O 를 또 만들지 않도록 먼저 봅니다.
Zio.kpi.links(kr=None)
그 KR 에 연결된 것 — 어느 온톨로지의 어느 질문(판정 포함) · 어느 회차가 노리나. 비면 인스턴스 전체.
목표(O). 돌려받은 dict 를 그대로 넘겨도 됩니다. KR 이 남은 O 는 지우지 않습니다. add_objective · add_result 는 돌려주는 값에 similar (이름이 비슷한 O · KR, [{uuid, name, objective, score}])를 붙입니다 — 막지 않습니다. 비어 있지 않으면 사람에게 「이미 있는 ○○과 같은 것인가」를 물으십시오 (「재고조사 실행시간」 ↔ 「재고 조사 실행 시간」). 같으면 방금 만든 것을 지우고 있던 것을 씁니다.
사전에 올립니다. 사전명은 대소문자를 가리지 않고 하나 — 이미 있으면 새 줄 없이 동의어만 붙입니다(merged: True). added_aliases 가 비어 있으면 바뀐 것이 없습니다 — 「이미 사전에 있다」고 말하고, 「반영했다」고 하지 마십시오. 뜻을 바꾸는 것은 update(meaning=…) 이고, 돌려주는 meaning_before(전의 뜻)를 함께 알리십시오.
사전명(또는 uuid)으로 고치고 · 지웁니다. aliases 는 더하기만 합니다(있던 동의어는 그대로) — 빼려면 remove_aliases=["말", …] 로 이름을 대십시오. 남이 넣은 동의어를 말없이 지우지 않게, 지우기는 따로 시킵니다. 돌려주는 added_aliases · removed_aliases 를 결과에 적으십시오. 이미 있는 말을 「넣어줘」는 add 하나로 끝납니다(merged: True).
온톨로지를 그리다 다른 온톨로지 안에 이미 있는 노드(예: 공용 Author·Project)에 이어야 할 때, 그 노드를 여기서 다시 정의하지 않고 이름 앞에 _ 를 붙여 가리킵니다. 화면에서 「이 노드가 저기 있는 노드와 이어진다」를 보여 주는 온톨로지 위의 표기입니다. 두 규칙만 지키면 됩니다.
노드 이름 앞에 _ 를 붙입니다. (_Author, _Project)
속성은 열쇠(PK)만 적습니다. 가리키는 데 필요한 건 짝을 맞출 열쇠뿐이라, 나머지 칸은 의미가 없습니다 — 읽기 좋으라고 열쇠 한둘만 남깁니다.
언제 _ 를 쓰나 — 이 온톨로지가 그 노드의 값을 (수집으로) 채우는 주인이면 일반 노드로, 이미 다른 온톨로지가 채우고 있고 당신은 잇기만 하면 될 때 _ 로. 「다른 온톨로지에 있는지 먼저 찾아볼」 필요는 없습니다 — 같은 이름이 같은 노드라는 보장이 없고, 판단 기준은 존재 여부가 아니라 **「내가 채울 주인인가」**입니다.
**「온톨로지에서는 만들 수 있고, Neo4j 에는 서지 않는다」**가 핵심입니다. 저장할 때 _ 는 벗겨져 같은 라벨의 그 노드로 MERGE 됩니다(_Project → 그래프의 Project) — 재정의가 아니라 가리키기라, 열쇠만 들고 와 잇기만 하고 그 노드의 제목·소속·표시명은 덮어쓰지 않습니다. 그래서 실제 insert/update 때 _ 붙은 노드가 새로 생기는 일은 없습니다.
add_node·create 로 SDK 에서 바로 만들 수 있습니다 — 웹으로 되돌아가 고칠 필요가 없습니다. 참조 노드의 열쇠에 source 를 주면 수집 데이터가 그 값을 채워 자동으로 이어지고, 값을 직접 넘길 땐 아래 .save() 에서 _Project 에 열쇠만 실어 보냅니다.
@ 뒤 경로의 앞부분이 배열이면 원소마다 노드가 하나씩 섭니다 — @issues.title 에서 issues 가 셋이면 노드도 셋입니다. 배열을 노드 여럿으로 펴는 유일한 방법입니다.
경로는 실제 수집 데이터의 칸을 알 때만 적습니다.Zio.ingestion.schemas() 의 columns(필요하면 Zio.ingestion(이름).fetch() 로 레코드 하나)를 보고 고르십시오. 회의를 반영하는 설계 단계처럼 아직 수집 데이터가 없으면 비워 둡니다 — 그런 노드 유형은 info() · check() · overview() 의 unmapped(매핑 전) 에 모입니다. 경고가 아닙니다 — 설계 단계에서는 정상이고, 매핑할 때 채울 목록입니다. 경고를 없애려고 @customer_name 같은 경로를 지어내지 마십시오 — 경고는 사라지지만 실제로는 값이 하나도 안 들어오는데, 이번에는 아무도 그것을 알아채지 못합니다.
온톨로지를 손에 쥐고 그리는 대로 세웁니다. 노드도 엣지도 온톨로지가 압니다. 스킬은 값만 넘깁니다 — 어느 엣지를 어느 방향으로 걸지는 한 줄도 쓰지 않습니다.
Zio.node().merge() 는 노드 하나를 세웁니다. 엣지는 merge_relation() 으로 직접 걸어야 합니다. 노드가 둘 셋으로 늘고 트리까지 있으면, 산업별 담당자가 온톨로지를 그려 놓고도 같은 그림을 파이썬으로 또 그리게 됩니다. 그 자리를 이 묶음이 대신합니다.
Method
Description
Zio.ontology(twin_id, entry_node=None)
온톨로지 하나를 집습니다. twin_id 는 온톨로지(TBox) 하나의 id 이고, 노드에 twin_id 속성으로 그대로 박히는 값입니다. entry_node 는 뿌리 노드 이름으로, 쓰기에만 필요합니다.
.save(data)
온톨로지에 그려진 대로 노드와 엣지를 세웁니다. data 는 {노드이름: [인스턴스, …]} 입니다.
두 인자는 에이전트의 「온톨로지 노드 연결」과 같은 것입니다. 에이전트 빌더에서 온톨로지와 진입 노드를 고르는 그 두 칸이 여기서는 인자가 됩니다.