受け取ったリンクから始める — URLパターン別ガイド
受け取ったリンクから始める — URLパターン別ガイド
誰かから送られた URL やブックマークから iknow.dev を開いたとき、今どこにいるか と 次に何をすればよいか を URL パターン別にまとめます。
画面全体の導線は「画面の移動とヘッダー・サイドバー」（No.1.5）、やりたいこと別の逆引きは「やりたいことから探す」（No.1.1）を参照してください。
URL パターン早見表
| URL パターン | 例 | 開く画面 | 未ログイン | ログイン済み |
|---|---|---|---|---|
| トップ | / |
ランディング | 閲覧可。CTA から Navigator へ | エージェント一覧へ誘導されることも |
| ショート URL | /{agentCode} |
そのエージェントの最新チャット | パブリックのみ閲覧可 | 閲覧・送信可（権限内） |
| 新規チャット | /chat/{agentId}/new |
空の新規チャット | パブリック閲覧のみ。送信はログイン | 初回送信で /chat/{chatId} に移る |
| 既存チャット | /chat/{chatId} |
共有チャットルーム | パブリック閲覧可。送信はログイン | 閲覧・送信・招待等 |
| ナレッジ一覧 | /knowledge/{agentCode} |
エージェントのナレッジ一覧 | パブリック閲覧可 | 権限に応じた操作 |
| ナレッジ本文 | /knowledge/{code}/{id} |
ナレッジエディター（閲覧 or 編集） | パブリック閲覧専用 | オーナーのみ編集 |
| Navigator 直リンク | /iknow-navigator |
iknow Navigator のチャット | 未ログインでも送信可 | 通常チャット |
| ログイン復帰 | /?return_url=... |
トップ（ログイン後に元画面へ） | ログイン導線 | ログイン後に return_url へ |
| ログイン必須画面 | エージェント一覧・チャット履歴・利用分析・アカウント設定等 | 上記各画面 | ログイン必須（トップへリダイレクト） | 利用可 |
| 公開ページ | /about /privacy |
会社概要・プライバシー | 閲覧可 | 閲覧可 |
/chat/{chatId} — 共有チャット URL を開いたとき
- パブリックエージェントのチャット — 未ログインでも過去のやりとりを閲覧できます。質問するにはログイン（入力欄の「ログインすると質問できます」→ ゲストログインモーダル）。
- プライベートエージェントのチャット — 未ログインなら
/?return_url=<元のパス>にリダイレクト。ログイン後もオーナー・メンバーでなければアクセス拒否。 - サイドバーの一覧はそのエージェント内の 全ユーザー共有履歴 です。自分だけの履歴は チャット履歴（No.3.2）。
- 次のステップ: 質問したい → ログインして入力欄に書く（No.4.1）。内容を読みたい → 回答横の「ナレッジ」アイコンから根拠ページへ。
/{agentCode} — ショート URL を開いたとき
エージェントコードだけの短い URL（例: /iknow-navigator）は、そのエージェントの最新チャット を自動表示します。
- チャットが無い場合は新規作成画面（
/chat/{agentId}/new相当）に近い空状態になります。 - ブックマークや名刺・資料に載せるときに便利です（No.1.4・No.4.2）。
/knowledge/{code}/{id} — ナレッジ直リンクを開いたとき
特定ナレッジの本文ページに直接着地します。
| あなたの状態 | 画面の見え方 |
|---|---|
| 未ログイン（パブリック） | 閲覧専用。編集ボタンなし |
| メンバー・一般ユーザー | 閲覧専用。セクションコメントは追加可（No.1.6） |
| オーナー | フル編集 |
| プライベート・権限なし | トップへリダイレクト or アクセス拒否 |
エージェント一覧へ戻るには — ナレッジエディターにはエージェント一覧導線のヘッダーがありません。サイドバー上部の エージェント行 をクリック → ナレッジ一覧 →「戻る」で エージェント一覧（No.1.5）。
/?return_url=... — ログイン途中でトップに戻されたとき
エージェント一覧・チャット履歴・利用分析・アカウント設定やプライベート画面に未ログインでアクセスすると、トップ /?return_url=<元のパス> に飛ばされます。
- トップまたはモーダルから ログイン（Qiita / GitHub / Google。有効時は SSO も可）
- 認証完了後、自動的に
return_urlの画面へ復帰 - 元がトップページだけの場合は エージェント一覧に着地することがあります（No.2.6）
うまく開けないとき
| 症状 | 確認すること |
|---|---|
| トップに戻される | ログインが必要な URL か、プライベートか確認 → No.2.6 |
| 編集できない | 閲覧専用モード（権限不足）→ No.2.2・No.1.2 |
| 404・存在しない | エージェント削除済み、チャット削除済みの可能性 → No.8.1 |
| 別アカウントになった | OAuth プロバイダの違い。メール一致で統合される場合あり → No.2.6 |