AI에게 관계도를 보여주기

한 줄로: view_relationship_map으로 외부 AI 도구가 노드 id 더미를 읽는 대신 관계도를 실제로 「보게」 하는 방법입니다.

이 글이 해결하는 문제

.map 파일은 캔버스입니다. 그 원본에 들어 있는 것은 노드 id, 픽셀 좌표, 그룹 구성원 목록입니다. 사람이 읽기 어렵고, AI가 쓰기에도 어렵기는 마찬가지입니다. read_file로 관계도를 열면 AI가 받는 것은 JSON 덩어리 하나이고, 거기서 좌표를 역산해 「누가 누구 옆에 그려져 있는가」를 재구성해야 합니다.

view_relationship_map은 다른 길로 갑니다. 서버가 그림을 그려 PNG로 돌려주고, 여기에 읽을 수 있는 요약을 덧붙입니다.

view_relationship_map({
  "book_token": "bk_...",
  "path": "세계관/인물 관계도.map"
})

요약이 항상 그림 앞에 오는 이유

응답은 반드시 텍스트 요약으로 시작하고 그림이 그 뒤에 붙습니다. 이유는 아주 현실적입니다. 일부 MCP 클라이언트는 이미지 블록을 버립니다. 현재 일부 원격 커넥터가 그렇습니다. 그림만 돌려준다면 그 환경에서는 빈 턴을 하나 소모한 셈이 됩니다.

요약에는 세 가지가 담깁니다.

• 모든 노드. 인물, 장소, 세력 등 지도에 올라간 것 전부
• 모든 관계. 한 줄에 하나씩(심연 —사제→ 고수)
• 모든 그룹 상자와 그 안에 든 대상

그래서 그림이 끝내 도착하지 않아도 AI는 이 관계도가 무슨 말을 하는지 압니다. 이미지를 렌더링하는 클라이언트에서는 둘 다 얻습니다. 전체 배치는 눈으로, 세부는 글로 파악합니다.

만나게 될 응답들

응답	뜻	다음에 할 일
요약 + PNG 한 장	정상	—
요약 + 「이번에는 그림을 그리지 못했다」는 한 줄	렌더링만 실패했고 요약은 그대로입니다	요약을 근거로 그냥 진행하십시오
「이 파일은 팀의 기밀 스킬 파일이며 이 연결에는 내용이 열리지 않는다」는 한 줄	팀 설정이 의도적으로 막아 둔 것입니다	다른 경로를 찾지 마십시오. 그 길은 전부 닫혀 있고 기록이 남습니다
「이 팀 스킬 파일의 오늘 읽기 한도를 다 썼다」는 한 줄	파일이 비어 있는 게 아니라 한도 문제입니다	나중에 다시 시도하십시오

이제 .map을 고칠 수 있습니다

실제로는 update_relationship_map과 한 쌍으로 씁니다. 먼저 view_relationship_map으로 지금 형태를 파악하고 노드 id를 모은 다음, update_relationship_map으로 손을 댑니다. 구조화 편집 도구에 자세히 적어 두었습니다.

이럴 때는 쓰지 마십시오

• 백업하거나 다른 곳으로 옮길 때. 그건 내보내기이고 앱에서 합니다. 관계도 내보내기와 공유를 보십시오.
• 인물 목록만 필요할 때. get_book_structure로 등장인물/ 폴더를 보는 편이 빠르고, 그림을 그릴 필요도 없습니다.
• .geomap 세계 지도. 이 도구는 .map만 받습니다. 세계 지도는 read_file을 쓰십시오. 세 장의 지형 격자를 한 줄 설명으로 바꿔서 돌려줍니다.

관련 문서

• Docs: 관계도
• Docs: 관계도를 화이트보드처럼 쓰기
• Docs: 관계도 내보내기와 공유
• Docs: 구조화 편집 도구