基本用法 🧰

如果說 16 AI 代理講的是「這是什麼」，那從這裡開始講的就是「怎麼把它用到 200%」。先從最該學會的基本功開始吧！（僅限桌面版）

← 回首頁：ObsiKO 101 · 上一層：16 AI 代理

代理不是「聊天機器人」，而是「工作夥伴」

ObsiKO 的代理不是只會回話的聊天機器人，而是直接在你的筆記庫裡讀寫檔案的工作夥伴。懂了這個差別，就能發揮 200% 的功力。

像「幫我整理○○／幫我寫草稿／幫我做成表格」這樣要它做出成果時 → 不會在對話裡寫一大串，而是存成乾淨的 .md 檔案，只告訴你一行摘要。
「這是什麼？／要怎麼做？」這類簡短的問題、說明，就直接在對話裡回答。
所以需要成果時，動詞要說清楚 — 用「幫我寫／幫我做／幫我整理」來拜託它。

按下輸入框下方工具列的引擎按鈕 (✨)，選單會往上展開 — 在 Claude／Gemini／Codex 之間挑選。
掃描 PDF 的 OCR、看圖片僅限 Claude，其他資料蒐集、搜尋工具三個引擎大多都能用。不過 Codex 要在選項 (≡) 打開「把 obsiko 工具連給 Codex」才會接上這些工具（預設關閉）。🪟 Windows 上看不到 Gemini 代理引擎 — Gemini 請填入 API 金鑰、當對話引擎用。
就算是同一個要求，每個引擎的語氣、強項也有點不同。卡住的時候換個引擎試試也是個辦法！→ 各引擎說明請看 16 AI 代理

在輸入框只要打 /，就會跳出各領域的助手清單（寫作、讀書、資料蒐集、結構化等）。
在筆記庫建立 Markdown 檔案，也能加入自己的命令。資料夾有兩個 — .claude/commands/（僅限桌面版代理，相容 Claude Code）／_ObsiKO/commands/（桌面版 + 手機、網頁版對話都能用）。想在哪裡都能用，就放在 _ObsiKO/commands/（同名時以這邊為準）。
詳細的命令清單請看 16 AI 代理，寫作命令請看 16-3 寫作與創作應用。

代理只在目前的筆記庫裡活動。碰筆記庫外面的檔案、執行危險的指令，ObsiKO 都會擋下來。
修改檔案後會更新檔案樹給你看；你正在編輯（還沒存檔）的檔案不會被隨便覆寫，而是先發出警告。
還原安全網：不喜歡 AI 改的內容時，可以在右側邊欄的時鐘圖示（AI 變更紀錄）依每次執行比較變更前／後並還原（單一檔案或全部，三個引擎都支援）。→ 16 AI 代理

要求越具體，結果越好。與其說「幫我整理」→ 不如說「以○○為標準、用△△格式、附上出處幫我整理」。
指定輸出格式 — 「做成表格」「列成清單」「300 字以內」「做成檢查清單」。
中途停下來就說「請接著做」 — 長的作業會分段進行。
省 Token 模式（面板選項 (≡) 選單的「代理 Token 最佳化」，預設開啟）：平常會簡潔回答，說「詳細一點／深入一點／寫長一點」就會回答得比較長。
自己檢查的迴圈（Claude，面板選項 (≡) →「迴圈」）：代理每次儲存筆記，都會自己檢查、修正語法，結束時再做最後檢查。品質很重要的話，連評論者迴圈也打開；想讓它咬住不放、做到最後，就打開無限嘗試（會有 Token 警告）。→ 16 AI 代理
免費的外部工具（pandoc、whisper、yt-dlp、poppler）只有在你要用那個功能時，才會跳出一行安裝說明。不必事先安裝。（轉錄就算沒有 whisper，只要有 OpenAI／Gemini API 金鑰就會走雲端 — whisper 是選用的！）
結果不滿意的話，像「再短一點／再簡單一點／加上例子／換個語氣」這樣用一句話再拜託一次就行。