Wiki ツールは、Tiro が自動生成するワークスペース Wiki(ミーティングノートから抽出されたエンティティ、コンセプト、関係性)を、エージェントがトラバース可能なナレッジグラフとして公開します。4 つの読み取り専用ツールが、検索 → 読み取り → トラバースのチェーンを構成します。
search_wiki — Wiki ページに対するキーワード検索。チェーンの起点です。ランク付けされたページ(pageGuid、name、pageType、関連度)を返し、これを他の 3 つのツールに渡します。
get_wiki_page — 単一ページの本文(説明 + 生成状態)に加えて、メタデータと、構造化された mentions、aliases、links を返します。
list_wiki_mentions — ページを参照しているノートの段落(ノート全体のどこでそのページが言及されているか)を返します。
get_wiki_graph — ナレッジグラフのノード + エッジのスライスを返し、ページ同士がどうつながっているかをトラバースできます。
ノート検索に対する Wiki ならではの価値はグラフにあります。テキストを読むだけでなく、エンティティから、それが言及されている箇所(list_wiki_mentions)へ、さらにリンクされたコンセプト(get_wiki_graph)へと移動できます。
5 つ目の補助ツール list_workspaces はチェーンそのものの一部ではありません。複数ワークスペースのアカウントが、どのワークスペースを対象にすべきか(各ワークスペースの guid と Wiki が有効かどうか)を把握できるようにし、上記 4 つのツールに明示的な workspaceGuid を渡せるようにします。
読み取り専用(v1)。 これらのツールは Wiki を読み取るだけです。Wiki ページの作成、名前変更、マージ、削除は、v1 では MCP 経由で公開されていません(OAuth の書き込み同意は対応待ち)。ノートのコンテンツにはこれらを使わず、代わりに search_notes / get_note を使用してください。
アクセスとプランゲート
Wiki は有料のオプトイン機能です。4 つのツールは常に tools/list に列挙されます(すべての接続で表示されます)が、利用資格はバックエンドが呼び出し時に判定します。そのため、利用可能に見えるツールでもゲートレスポンスを返す場合があります。
ワークスペースが Wiki を利用できるのは、次の両方が満たされている場合のみです。
- 対象プラン — ワークスペースのサブスクリプションが Pro、Max、Team、または Enterprise であること。Free と Lite は対象外です。
- 有効化済み — ワークスペースの管理者が、そのワークスペースで Wiki をオンにしていること。
呼び出しがゲートされた場合、ツールは機械可読の error_code を含むエラーエンベロープ(HTTP 402)を返します。
error_code | 意味 | 呼び出し側が取るべき対応 |
|---|
WIKI_PLAN_REQUIRED | プランに Wiki が含まれていない(Free/Lite/サブスクリプションなし/非アクティブ)。 | アップグレード。action_url は料金プラン(B2C)またはチームの課金(チーム管理者)ページを指します。チームメンバーの場合は null で、メッセージには管理者に依頼するよう記載されます。 |
WIKI_NOT_ACTIVATED | プランは対象だが、管理者が Wiki を有効化していない。 | ワークスペース設定で Wiki を有効化する(管理者)か、管理者に依頼する(メンバー)。アップセルはなく、required_plans は null です。 |
エンベロープの形式(バックエンドからそのまま中継されます):
{
"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 — 操作するための Web リンク。呼び出し側自身が操作できない場合(チームメンバー、または管理者による有効化)は null。
ワークスペースの選択。 デフォルトでは、Wiki ツールは API キーからワークスペースを暗黙的に解決します。ワークスペースにバインドされたキーやチームキーは直接解決され、個人トークンや OAuth トークンはデフォルトワークスペースに解決されます。これはノートツールがスコープを決める方法と同じです。アカウントが複数のワークスペースに属している場合は、list_workspaces を呼び出して列挙し(それぞれの guid と Wiki が有効かどうかを取得)、選んだ workspaceGuid を任意の Wiki ツールに渡すことで、そのワークスペースを明示的に対象にできます。workspaceGuid を省略すると、デフォルトワークスペースの動作が維持されます。バックエンドは、渡されたワークスペースのメンバーであることを検証します。
list_workspaces
API キーがアクセスできるワークスペースを、それぞれの guid、name、Wiki が有効かどうかとともに一覧表示します。アカウントが複数のワークスペースに属している場合に、Wiki ツール用の workspaceGuid を選ぶために使用します。
このツールはパラメータを取りません。次を返します。
{
"workspaces": [
{ "guid": "ws_abc", "name": "Acme", "isWikiEnabled": true },
{ "guid": "ws_def", "name": "Personal", "isWikiEnabled": false }
]
}
- 個人/OAuth トークンは、あなたがメンバーであるすべてのワークスペースを列挙します。ワークスペースにバインドされたキーやチームキーは、その 1 つだけを列挙します。
isWikiEnabled は、そのワークスペースで Wiki がプラン対象でありかつ有効化されているかどうかを反映します。true のワークスペースを選び、その guid を workspaceGuid として渡してください。
search_wiki
キーワードで Wiki ページを検索します。最初にこれを使い、返された pageGuid を他のツールに渡します。
| パラメータ | 型 | 必須 | 説明 |
|---|
keyword | string | 必須 | ページ名に対して照合される検索語。 |
workspaceGuid | string | 任意 | 特定のワークスペース(list_workspaces から取得)を対象にします。省略するとデフォルトワークスペースを使用します。 |
ランク付けされたページ結果を返します。各結果には pageGuid、name、pageType(例: CONCEPT、ENTITY)、関連度スコアが含まれます。
get_wiki_page
pageGuid(search_wiki から取得)で 1 つの Wiki ページを取得します。
| パラメータ | 型 | 必須 | 説明 |
|---|
pageGuid | string | 必須 | search_wiki が返すページ識別子。 |
workspaceGuid | string | 任意 | 特定のワークスペース(list_workspaces から取得)を対象にします。省略するとデフォルトワークスペースを使用します。 |
ページの本文(説明 + 生成状態)とメタデータ(タイトル、種別、mention/alias/link の件数、タイムスタンプ)に加えて、ページの構造化された mentions、aliases、links を返します。続けて list_wiki_mentions を使うと、そのページがノート全体のどこで参照されているかを確認できます。
list_wiki_mentions
Wiki ページに言及しているノートの段落を一覧表示します。
| パラメータ | 型 | 必須 | 説明 |
|---|
pageGuid | string | 必須 | ページ識別子(search_wiki / get_wiki_page から取得)。 |
cursor | string | 任意 | 前回のレスポンスから得たページネーションカーソル。 |
workspaceGuid | string | 任意 | 特定のワークスペース(list_workspaces から取得)を対象にします。省略するとデフォルトワークスペースを使用します。 |
mention レコード(ソースノート、段落、抽出テキスト、種別)とページネーションカーソルを返します。
get_wiki_graph
Wiki ナレッジグラフのノード + エッジのスライスを取得します。{ nodes, edges } を返し、各エッジは 2 つのページ間の型付き関係を保持します。
| パラメータ | 型 | 必須 | 説明 |
|---|
mode | string | 必須 | seed、expand、around、links のいずれか(下記参照)。 |
pageGuid | string | 条件付き | expand / around の起点ページ。 |
pageGuids | string[] | 条件付き | links 用の明示的なページ集合。 |
depth | number | 任意 | expand のトラバース深さ。 |
radius | number | 任意 | around の近傍半径。 |
limit | number | 任意 | 返されるノードの最大数。デフォルト 50、最大 200。 |
q / type / since | — | 任意 | seed 用の概要フィルター。 |
workspaceGuid | string | 任意 | 特定のワークスペース(list_workspaces から取得)を対象にします。省略するとデフォルトワークスペースを使用します。 |
mode | 返すもの |
|---|
seed | ワークスペースの概要グラフ(必要に応じて q / type / since でフィルター)。 |
expand | pageGuid から depth の分だけ外側へトラバース。 |
around | radius で指定したページの近傍。 |
links | 明示的な pageGuids の集合内のリンク。 |
結果の上限。 get_wiki_graph は最大で limit 件のノード(デフォルト 50、最大 200)と、それら返されたノード間のエッジのみを返します(ダングリングエッジは破棄されるため、すべてのエッジの両端は nodes に含まれます)。元のグラフが上限を超えていた場合、レスポンスは truncated: true を設定します。mode / q / type で絞り込むか、より小さい radius / depth を指定して、焦点を絞ったスライスを取得してください。これにより、ハブページの近傍が無制限のペイロードを返すのを防ぎます。
クラスターベースの探索はまだ公開されていません。 Web アプリの新しいグラフ探索ビュー(overview/context/cluster)は内部専用です。MCP の get_wiki_graph ツールが公開するのは seed / expand / around / links モードです。クラスター探索の外部公開はロードマップにあります。
推奨チェーン
- まずワークスペースを選ぶ(複数ワークスペースの場合):
list_workspaces → 選んだ workspaceGuid を下記のいずれかのツールに渡します。
- トピックについて Wiki が知っていることを調べる:
search_wiki → get_wiki_page。
- ページがノートのどこに根拠を持つかを調べる:
search_wiki → list_wiki_mentions。
- コンセプト同士のつながりを探索する:
search_wiki → get_wiki_graph(mode: "around"、pageGuid)。