Troubleshooting

このページは、Cogno の setup、import、integration、worker、docs が期待通りに動かない時に、次に行う具体的な操作を選ぶためのものです。

最初に見る場所

Sign-inとworkspace access

Sign inできない

確認します。

1. account 作成時と同じ sign-in method を使っている。
2. browser が auth callback を完了できる。
3. invite link から来た場合は、sign in 後に invite link をもう一度開く。
4. auth callback が error page を表示する場合は、visible error text を控える。

Workspaceが表示されない

確認します。

1. workspace selector を開く。
2. 期待する account で sign in している。
3. workspace owner に Settings > Members から新しい invite link を送ってもらう。
4. 自分で作成できる場合は Create workspace を使う。

Invite linkで追加されない

確認します。

1. 先に sign in する。
2. 同じ browser で invite link を開く。
3. Settings > Members から fresh invite link をもらう。
4. accept 後、workspace owner が member list で自分を確認できる。

Workspace settings

Settingsがinvalid workspaceになる

URLの workspace ID が current account から使えない可能性があります。

次の操作を行います。

1. Cogno app root に戻る。
2. workspace selector から workspace を選ぶ。
3. workspace owner に membership を確認してもらう。

General settingsが読み込めない

次の操作を行います。

1. page を refresh する。
2. main Tasks page から同じ workspace を開けるか確認する。
3. 自分の account が Settings > Members に残っているか確認する。
4. visible error text を控える。

Workspace deleteがdisabled

確認します。

1. workspace title が空ではない。
2. confirmation dialog に exact workspace title を入力している。
3. deletion により notes、chat history、members、workspace data が消えることを理解している。

Task CSV import

CSV fileがrejectedされる

Cogno は header row と少なくとも1件の task row を必要とします。

次の操作を行います。

1. spreadsheet または text editor でCSVを開く。
2. row 1 が headers になっていることを確認する。
3. 2行目以降に task data があることを確認する。
4. CSVとして export し直す。

Mapping completeがdisabled

すべてのCSV column は map するか、明示的に ignore する必要があります。

確認します。

Imported rowsがskippedされる

validation に失敗した rows は skipped されます。

よくある原因です。

Parent tasksがlinkされない

次の操作を行います。

1. stable parent ID、title、source URL、external key を Parent Task に map する。
2. 可能なら parent row を同じ import に含める。
3. source IDs または URLs を Source または Metadata に残す。
4. file を分けて migration する場合は、parents を先に import してから children を再 import する。

Imported tasksのcontextが足りない

次の操作を行います。

1. source URL を Source として残す。
2. labels、priorities、milestones、numbers、issue keys、custom fields を Metadata に map する。
3. 長い context が複数 columns に分かれている場合は、複数の Description columns を使う。
4. 直接対応する Cogno field がない comments や detailed text は metadata に残す。

詳しくは タスクCSVをCognoにインポートする を見てください。

Integrations

Integration cardがclickできない

integration が Soon の場合があります。available integrations は detail page を開き、chevron が表示されます。

Google Calendarがconnectしない

次の操作を行います。

1. Integrations > Google Calendar を開く。
2. Connect my Google Calendar を選択する。
3. Google account flow を完了する。
4. integration page に戻り、自分の member row が connected になっていることを確認する。

Google Calendar は各 member が自分の account を接続します。

Calendar meetingsにnotetakerが入らない

確認します。

1. meeting に招待されている member 自身が Google Calendar を接続している。
2. meeting が Google Meet event である。
3. event が connected calendar 上にある。
4. integration page で account が connected になっている。

API keysとworkers

Raw API keyが見えなくなった

新しい key を作成してください。Cogno は raw key を作成直後に1回だけ表示し、その後は再表示しません。

API key creationが失敗する

確認します。

1. 自分が workspace member である。
2. current user / workspace の active keys が25個未満である。
3. key name が255文字以下である。

Workerが表示されない

次の操作を行います。

1. valid API key を作成または再利用する。
2. 次を実行する。

cogno login --token <key>
cogno

1. Settings > Workers を開く。
2. Refresh を選択する。

Workerがstaleまたはofflineになる

確認します。

1. worker process がまだ動いている。
2. machine に network access がある。
3. API key が revoke されていない。
4. root cogno worker daemon を restart し、worker list を再確認する。

Revokeでworkerが切れた

replacement key を作成し、worker machine で cogno login --token <key> を実行し、root cogno worker daemon を restart します。

Memory

Memoryがsaveできない

次の操作を行います。

1. Settings > Memory を refresh する。
2. sign in 状態を確認する。
3. 小さな edit を行い、もう一度 save する。
4. save が失敗し続ける場合は visible error text を控える。

Memoryのrenderingがおかしい

Memory は Markdown です。headings、bullet indentation、fenced code blocks、閉じていない links を確認します。

DocsとCopy for LLM

Copy for LLMがcopyしない

確認します。

1. browser clipboard permission。
2. page に focus がある。
3. browser privacy settings が clipboard writes を block していない。

page-level LLM context は直接開けます。

https://cogno.studio/docs/<slug>/llms.txt

違う言語が表示される

language switcher を使うか、language query を追加します。

https://cogno.studio/docs/task-import?lang=en
https://cogno.studio/docs/task-import?lang=ja

Escalation package

teammate または assistant に相談する時は、次を集めます。

1. workspace name または ID
2. page URL
3. exact visible error text
4. problem を起こした action
5. refresh 後も再現するか
6. sanitized screenshot または terminal output
7. CSV import 問題の場合は related file header または sample row

共有前に API keys、private tokens、customer data、personal contact details を削除してください。