Wiki

​

개요

• search_wiki: 위키 페이지에 대한 키워드 검색입니다. 진입점 역할을 하며, 나머지 세 도구에 전달할 순위가 매겨진 페이지(pageGuid, name, pageType, 관련도)를 반환합니다.
• get_wiki_page: 단일 페이지의 본문(설명 + 생성 상태)과 메타데이터, 그리고 구조화된 mentions, aliases, links를 반환합니다.
• list_wiki_mentions: 페이지를 참조하는 노트 단락들, 즉 노트 전체에서 해당 페이지가 언급되는 위치입니다.
• get_wiki_graph: 페이지들이 어떻게 연결되는지 탐색할 수 있도록 지식 그래프의 노드+엣지 단면을 반환합니다.

​

접근 권한과 요금제 게이트

1. 자격 있는 요금제: 워크스페이스의 구독이 Pro, Max, Team, Enterprise 중 하나입니다. Free와 Lite는 자격이 없습니다.
2. 활성화됨: 워크스페이스 관리자가 해당 워크스페이스에서 위키를 켰습니다.

{
  "success": false,
  "error_code": "WIKI_PLAN_REQUIRED",
  "message": "위키 기능은 Pro 이상 요금제에서 사용할 수 있어요. 웹에서 로그인 후 요금제를 업그레이드해 주세요.",
  "current_plan": "Lite",
  "required_plans": ["pro", "max", "team", "enterprise"],
  "action_url": "https://tiro.ooo/#pricing",
  "status_code": 402
}

• current_plan: 워크스페이스의 현재 요금제 표시 이름, 구독이 없을 경우 null.
• required_plans: WIKI_PLAN_REQUIRED의 업그레이드 대상. WIKI_NOT_ACTIVATED에서는 null. (Team Free Trial은 의도적으로 제외됩니다. 이미 보유 중인 체험이지 업그레이드 대상이 아니기 때문입니다.)
• action_url: 조치를 취할 웹 링크, 호출자가 직접 조치할 수 없을 때(팀 구성원이거나 관리자에 의한 활성화)는 null.

​

list_workspaces

{
  "workspaces": [
    { "guid": "ws_abc", "name": "Acme", "isWikiEnabled": true },
    { "guid": "ws_def", "name": "Personal", "isWikiEnabled": false }
  ]
}

• 개인/OAuth 토큰은 구성원으로 속한 모든 워크스페이스를 나열하고, 워크스페이스 바인딩 키나 팀 키는 해당 워크스페이스 하나만 나열합니다.
• isWikiEnabled는 해당 워크스페이스에서 위키가 요금제 자격이 있고 동시에 활성화되어 있는지를 반영합니다. true인 워크스페이스를 골라 그 guid를 workspaceGuid로 전달하세요.

​

search_wiki

​

get_wiki_page

​

list_wiki_mentions

​

get_wiki_graph

​

권장 체인

• 워크스페이스 먼저 선택(여러 워크스페이스): list_workspaces → 선택한 workspaceGuid를 아래의 임의 도구에 전달.
• 위키가 어떤 주제에 대해 아는 내용 찾기: search_wiki → get_wiki_page.
• 페이지가 노트에서 어디에 근거하는지 찾기: search_wiki → list_wiki_mentions.
• 개념들이 어떻게 연결되는지 탐색하기: search_wiki → get_wiki_graph(mode: "around", pageGuid).