よくある質問とトラブルシューティング
よくある質問とトラブルシューティング
iknow.dev 利用中によくある疑問と、症状別の確認ポイントをまとめました。詳細は各機能のナレッジも参照してください。
はじめて・ログイン
| 質問 / 症状 | 回答・確認 |
|---|---|
| パスワード登録は必要？ | 不要です。iknow.dev（SaaS） では Qiita / GitHub / Google の OAuth でログインするとアカウントが自動作成されます。SAML SSO はオンプレのみ（No.7.4） |
| ログインボタンを押しても外部サービスに飛ばない | ブラウザのポップアップブロック・Cookie 設定を確認 |
| ログイン状態が記憶されない | プライベートブラウズ・Cookie 自動削除設定を確認 |
| 別プロバイダでログインしたら別アカウントになった | メールアドレスが一致すれば自動統合 されます。Qiita はメールを提供しないため統合対象外 — 先に他プロバイダでログインしてからアカウント設定で Qiita を連携 |
| ログイン前でもチャットは見られる？ | パブリックエージェント なら既存チャットの閲覧は可能。送信・新規作成はログイン必要 |
| SSO ボタンが表示されない | iknow.dev（SaaS）では SSO は提供しないため表示されません（正常）。オンプレで SAML を有効化した環境のみ表示（No.7.4） |
| Microsoft でログイン・連携したい | iknow.dev（SaaS）では Microsoft 連携は一切非対応（ログイン・SharePoint/Excel インポート・Teams）。Qiita / GitHub / Google のいずれかでログイン |
| SSO で「登録されていません」エラー | JIT が無効で未登録。組織の IT 管理者に SCIM でのユーザー追加を依頼（No.7.5） |
| SSO で「無効化されています」エラー | IdP または SCIM でアカウントが無効化済み。管理者に連絡 |
→ 詳細: 「はじめかた — ログインと最初のステップ」・「Enterprise SSO（SAML）でログインする」（No.7.4）
エージェント一覧
| 質問 / 症状 | 回答・確認 |
|---|---|
| マイエージェントが 0 件 | 検索欄に分野を入力するか、「おすすめのエージェント」から 追加 |
| プライベートエージェントから退出した | 再参加にはオーナーの招待が必要 |
| エージェントコードを変更した | /knowledge/{code} など URL も新コードに切り替わる |
| エージェントを削除した | チャット・ナレッジは 閲覧不可（復元不可） |
| 利用分析が見えない | オーナーまたはメンバー のみ閲覧可。右上ユーザーメニュー → 利用分析 |
| 一覧の参照回数と利用分析の引用数が違う | 別指標です。一覧 = LLM 参照全般（MCP 含む）。利用分析 = チャット回答生成時の候補/採用 — No.5.8 |
| 書いたナレッジがチャット回答に出ない | 意味検索の候補と AI の採用は別。タイトル・見出し・分割・プロンプトを見直す — No.5.9 |
→ 詳細: 「エージェント一覧」（No.3.1）・「利用分析」（No.3.4）・「ナレッジ指標の読み方」（No.5.8）・「チャット回答にナレッジを効かせる」（No.5.9）
チャット
| 質問 / 症状 | 回答・確認 |
|---|---|
| Enter で送信されない | Enter 単独 が送信（Shift + Enter で改行）。入力直後 1 秒間 は誤送信防止のクールダウンで Enter・送信ボタンが無効。IME 変換中や @ メンション候補表示中の Enter は送信にならない |
| サイドバーのチャットと履歴の違い | サイドバー = エージェント内の共有履歴。チャット履歴 = 個人 の閲覧・発言記録 |
| @ メンションが効かない | 招待済み パブリック エージェントのみ。プライベートは招待・応答不可 |
| 回答の根拠を見たい | エージェント発言横の 「ナレッジ」 アイコン（紐づきがある場合） |
| 急に送信できない／「リクエストが多すぎます」（429） | 短時間に送りすぎたときの レート制限（例: チャット送信は 20/分・100/時・300/日）。少し待てば解除されます。上限の一覧は「利用上限・クォータ早見表」（No.2.8） |
→ 詳細: 「チャットアプリの使い方」「チャット履歴」（No.3.2）
ナレッジ・エディター
| 質問 / 症状 | 回答・確認 |
|---|---|
| 保存ボタンがない | タイトル・タグ・No 等は 操作ごとに即時保存。本文編集のみ「保存 / キャンセル」バー |
| 編集ボタンが見えない | 閲覧専用モード（メンバー・非オーナー・未ログイン）。オーナーのみ編集可 |
| ナレッジが保存できない（上限） | 80,000 トークン（既定）は画面・REST・MCP すべてで超過時エラー。262,144 文字は画面・REST のみ（MCP は文字数チェックなし）。エディター上部のトークンプログレスを確認。見出し単位で短くするか複数ナレッジに分割。インポートのみ トークン超過で自動分割（(i/N)）— 詳細は「利用上限・クォータ早見表」（No.2.8） |
| PDF / Word はインポートできる？ | 不可。.md / .txt / .html / .csv / .json / .xlsx / .zip 等は可 |
| 削除したナレッジを戻したい | 一覧下部の 削除済み一覧 から復元（論理削除） |
| 「他の場所で更新されました」と出る | 楽観ロック（version_conflict）。他ユーザー・MCP・別タブで先に保存された。ダイアログの 再読み込み を選ぶと最新版を取得（上書きしない） |
| 保存がブロックされ「コンテンツポリシーに抵触」 | 現在は 3 段とも shadow モード（記録のみ）のため通常はブロックされない — 詳細・対処は No.8.6 |
→ 詳細: 「ナレッジ一覧とインポート」「ナレッジエディターの使い方」
MCP 連携（Cursor / Claude）
| 質問 / 症状 | 回答・確認 |
|---|---|
| 接続時に 401 | アクセストークン期限切れ。クライアントを再認可 |
| 書き込みツールが 403 | オーナー権限 が必要。エージェント一覧で自分の役割を確認 |
| Client Secret を紛失 | 該当クライアントを削除し 新規発行（Claude は 3 項目を再コピー） |
| パブリック接続で 404 | プライベートエージェントには匿名接続不可。OAuth 接続（/mcp または /mcp/{agentCode}）を使う |
| MCP 登録ボタンが見つからない | アカウント設定（No.3.3）の「エージェント連携」セクションに「Cursorへインストール」「Claudeへインストール」ボタンがあります（ナレッジ一覧には MCP 登録ボタンはありません）。詳細は「Cursor / Claude から使う（MCP 連携）」（No.7.1） |
→ 詳細: 「Cursor / Claude から使う（MCP 連携）」「アカウント設定」（No.3.3）
Microsoft Teams
iknow.dev（SaaS）では Microsoft Teams 連携は利用できません。 以下はオンプレミス導入向けです。
| 質問 / 症状 | 回答・確認 |
|---|---|
| Teams の会話が Web チャットに出ない | 仕様です。Teams 経由は別経路として隔離 |
| Bot が応答しない | Messaging Endpoint URL、Bot プロセス起動状態を確認 |
| 401 で拒否 | iknow ボットシークレットと Azure MicrosoftAppPassword の一致を確認 — 発行・再発行は No.6.5（Blocs 管理画面） |
| ローカル開発で到達できない | ngrok 等で HTTPS 公開 URL を払い出し、末尾 /api/messages を確認 |
→ 詳細: 「Microsoft Teams から使う」（No.7.2）・シークレット発行は No.6.5
権限・その他
| 質問 / 症状 | 回答・確認 |
|---|---|
| メンバーなのに編集できない | 仕様です。メンバーは閲覧 + コメントのみ。編集はオーナー |
| ナレッジ保存時にエラーが出ないが気になる | regex・OpenAI Moderation・LLM 分類は 現在 3 段とも shadow モード（検出しても保存は通り、記録のみ）。誤検知率を計測中で段階的に enforce へ移行予定 — No.2.2・No.8.3 |
| テーマが反映されない | テーマ（ライト / ダーク / OS）は エージェント一覧・チャットアプリ・ナレッジ一覧・ナレッジエディター に適用。アカウント設定で変更 →「はじめかた — ログインと最初のステップ」 |
→ 詳細: 「用語と権限」
匿名チャット・公開ページ
| 質問 | 回答 |
|---|---|
| ログインなしで質問したい | iknow Navigator（/iknow-navigator）のみ未ログイン送信可。トップの CTA からも可能 →「匿名チャットと iknow Navigator」 |
| 言語を英語にしたい | ブラウザの言語設定を英語優先に変更（画面上の切替ボタンはなし）→「多言語表示と公開ページ」 |
| 不適切なメッセージを報告したい | ログイン後、メッセージの「通報」アイコンから理由を選択 →「通報・安全な利用とサポート」 |
| 会社情報・プライバシーはどこ？ | /about（会社概要）、/privacy（プライバシーポリシー） |
| エージェントを短い URL で開きたい | /{agentCode} で最新チャットを自動表示（例: /iknow-navigator） |
インポート・外部連携
| 質問 | 回答 |
|---|---|
| Qiita で「記事が見つかりませんでした」 | 取り込みたい記事に Qiita 側でタグ iknow を付ける 必要があります。付けたあとインポートモーダルを開き直してください →「インポート・連携でハマりやすいポイント」 |
| Qiita タブに一部の記事しか出ない | iknow タグ付きの記事だけ が表示されます。全記事を出したい場合は各記事に iknow タグを追加 |
| インポートで「ログインしてください」 | アカウント設定の外部サービス連携で Qiita / GitHub / Google の該当サービスを連携し直す |
| SharePoint / Excel を SaaS で取り込みたい | 非対応です。iknow.dev（SaaS）では Microsoft 連携は一切提供していません（ログイン・インポート・Teams いずれも不可）。代替は .xlsx ファイルアップロード、またはオンプレミス導入 |
| Google スプレッドシートを URL で取り込めない | Google は Picker（ドライブから選択） 必須。URL 手入力は不可 |
| PDF をアップロードできない | .pdf / .docx / .pptx は 非対応。.md 等に変換してからアップロード |
| インポート後にナレッジが複数に分かれた | 約 80,000 トークン超で 自動分割（タイトルに (1/N) が付く） |