先知道你會學到什麼
把 AI 從「回答問題」帶進真正的工作流程
AI Agent 不只是更會聊天的工具。它能在明確的目標下，整理脈絡、使用工具、讀寫檔案、提出下一步，並在需要時停下來請人確認。這份入門教材會用教師行政情境，帶你從安全設定開始，完成一個可檢查的文書成果。
建立正確心智模型
認識 AI Agent
一般聊天常在一輪問答中提供文字；Agent 則會把你的目標拆成多個步驟，依照權限使用檔案、網頁或其他工具，再把進度與成果交回來。
- 一般聊天：適合問答、改寫、腦力激盪。
- Agent：適合有檔案、有步驟、有成果的任務。
- 人類：負責目標、權限、事實與最後責任。
先把工作基地裝好
安裝 Agent 桌面版
依課程選用一種 Agent 工具即可，不必兩種都安裝；先確認所選工具能完成課程需要的檔案讀寫與操作。
安裝後先做四件事
- 登入自己的帳號。
- 建立「測試」資料夾。
- 只把測試資料夾加入 Project，不直接開放整台電腦。
- 用一個小任務測試讀取、規劃、確認與輸出。
先確認現有環境，再依任務補裝
依任務準備工作環境
選配程式：影音處理
如果課程或行政工作需要處理具備授權的影音素材，可以再安裝以下工具。請先確認下載、轉換與使用內容符合著作權及平台規範。
按文件用途選用，不必一次裝齊
依用途選擇文件處理 Python 套件
這些文件處理工具是 Python 套件，不是 Skill 檔，由 Agent 在可用的 Python 環境中呼叫。依用途選擇即可，沒有必須先裝完某一組才能使用另一組的順序。本教材的 Word 練習可先準備 python-docx；其他套件依任務補裝，已有可用套件就不必重複安裝。
PDF 處理
- PyMuPDF：擷取文字、圖片、頁面資訊，或將頁面轉成圖片
- pypdf：合併、分割與旋轉頁面
- pdfplumber：擷取文字與表格
- ReportLab：建立 PDF
依實際操作選用，不必全部安裝；文字擷取工具不等於 OCR。
掃描文件與 OCR
- pytesseract：由 Python 呼叫 Tesseract 辨識圖片文字
- Tesseract：另需安裝的辨識程式，繁體中文還需 chi_tra 語言資料
需要這套本機 OCR 流程時再安裝。Agent 若已有可用的頁面影像檢視或其他 OCR 工具，也可能處理圖片型 PDF。
查看文件讀取與 OCR 說明 ↗多格式文件轉文字
- MarkItDown：將 Word、Excel、PPT、PDF 等文件轉成便於閱讀的文字
有多格式轉換需求時再選用，並依格式安裝對應依賴，例如 python -m pip install "markitdown[docx,pdf,pptx]"。
控制範圍，才能穩定工作
全域設定、專案設定與 Skill 管理
影響多數專案與整個應用程式的偏好、工具與權限。
限制目前 Project 可讀寫的資料夾、命令與工作脈絡。
針對特定工作提供可重複使用的方法、格式與檢查規則。
可直接套用的範例
全域設定提示詞
我是一名國中國文教師，主要使用 AI 協助處理教學、教材設計、課堂活動、作業規劃，以及學校行政文書。請使用繁體中文回答，內容要清楚、實用，並適合國中教師使用。可直接套用的範例
Skill 設定提示詞
1. 當我說「開始工作」時，請先檢查目前專案是否已建立 Git 版本控制。\n\n 如果尚未建立，請自動在專案根目錄初始化 Git，建立名為 output 的資料夾，並建立適合本專案的 .gitignore 檔案。\n\n 之後產生的報告、文件、圖片、資料表與其他成果，優先放入 output 資料夾中。Git 版本控制必須涵蓋 output 資料夾。\n\n .gitignore 至少應排除：個人密碼、API Key、Token；.env 與機密設定檔；暫存檔與快取檔；Python 虛擬環境；Node.js 依賴套件；系統產生的隱藏檔；不需要納入版本控制的大型暫存資料。\n\n 請保留原始檔案，不要直接覆寫或刪除原始資料。涉及刪除、移動、覆寫或執行外部指令時，請先說明影響並等待我確認。\n\n2. 當我說「結案」、「收工」、「專案結束」、「開發完成」或「存檔並更新說明」時自動觸發。\n\n執行動作：\n檢查 Git 狀態：檢查當前專案是否有 Git 倉庫及未提交的變更（若無則詢問是否 git init）。\n自動建立／更新 README.md：在「開發歷史／Changelog」自動追加當天工作成果與日期記錄。\n自動 Git Commit：自動執行 git add . 與 git commit -m "docs: 專案結束存檔，更新 README 說明文件"。\n回報存檔摘要：向您報告 Commit 狀態與更新內容。初學者安全基準
- 只加入當前任務需要的資料夾。
- 命令與外部網站先逐次確認。
- 先複製練習資料，不直接改原始檔。
- 個資先去識別化，再交給 Agent。
請只使用目前 Project 中的虛構資料，先列出處理步驟；任何需要存取專案外資料夾或執行命令的動作，都先停下來請我確認。
遇到陌生詞，先查這裡
常見專有名詞
詞彙牆以參考詞彙頁的基礎項目重新分類，再補充教師實務常見用語。每個詞彙都會提供白話定義、工作例子、使用時機與提醒。
展開常見專有名詞
詞彙解釋預設收合；請按下「全部」或任一分類按鈕，查看對應的解釋。
找不到符合的詞彙，試試其他關鍵字。
詞彙說明為入門教學用途，正式工作仍需依工具官方文件與專案權限確認。
把六章內容串起來
教師行政文書整理 Agent
使用虛構的會議紀錄、校務通知、課程規劃與待辦事項，讓 Agent 先盤點資料，再整理成一份可審閱的行政報告。
- 盤點讀取檔案清單，不修改原始資料。
- 整理標示來源，抽取日期、人物、重點與待辦事項。
- 產出形成報告草稿與檢查清單。
- 驗證由人確認內容，再輸出最終檔案。
卡住時先看這裡
常見問答集
三個程式一定要全部安裝嗎？
不需要。先確認所選 Agent 已提供哪些環境，再依任務補裝。本機 Python 文書處理需要可用的 Python 與對應套件；本教材的 Word 練習可先用 python-docx。要實作 Git 初始化與結案提交，再準備 Git；只有需要 Node.js 程式、npm 或以 Node.js 執行的工具時，才準備 Node.js。
我不會寫程式，也需要安裝 Python、Node.js 和 Git 嗎？
依任務需要準備，不必全部安裝。Agent 可以協助撰寫與執行程式，但需要對應環境與操作權限。先請它檢查現有環境，說明缺少的工具、用途與安裝範圍，再依課程需要補裝；若工具已提供可用環境，就不必重複安裝。
文件處理套件一定要全部安裝嗎？
不需要。依 Word、PDF、Excel、掃描辨識、圖片或多格式轉換等用途選擇即可。這些套件是不同任務的工具，沒有必須先裝完「核心」才能使用「進階」的順序；也應先確認 Agent 的執行環境是否已備有所需套件。
沒裝 pytesseract，就無法辨識圖片型 PDF 嗎？
不一定。圖片型 PDF 若沒有文字層，單靠文字擷取通常讀不到內容；但 Agent 若能檢視頁面圖片，或有其他 OCR 工具，仍可能辨識。pytesseract 只是其中一種本機方案，使用時還需 Tesseract 與對應語言資料。若目前只有文字擷取工具，就需要補上影像辨識能力；不能把擷取不到文字當成文件沒有內容。辨識後仍要核對姓名、日期、數字與表格。
Agent 遇到缺少 OCR 工具，會自動上網搜尋並安裝嗎？
可能會協助，但不能保證自動完成。它需要具備連網查詢、執行命令與安裝工具的能力，且符合目前權限與設定。請要求它先檢查文字層與既有工具；能力不足時再查詢官方解法，說明工具來源、用途與安裝範圍，依權限取得確認後補裝。需要管理員權限、無法連網或安裝失敗時，應回報原因與替代方案。不要把文件上傳到外部辨識服務視為已獲授權。
安裝並使用 Agent 需要很高效能的電腦嗎？
不需要！AI Agent 最核心的深度思考與運算都在雲端伺服器（Google、OpenAI 等）進行，電腦本機主要只負責接收文字指令、讀寫本機檔案與執行輕量自動化腳本。只要是一般能正常開機上網、進行文書處理的 Windows 10/11 電腦（即使是老舊筆電或文書機），都能順暢安裝與使用。
為什麼開啟 ChatGPT 桌面版的時候，有當機或卡頓的感覺，是不是我電腦太舊了？
請放心，這並不是您的電腦太舊或效能不足！這是目前 ChatGPT 桌面版在啟動或載入大量專案/對話時的已知現象，許多使用者都遇到剛開啟時有短暫卡頓或反應延遲的情況。通常開啟後稍等幾秒即可正常操作，未來待 OpenAI 釋出軟體版本更新後應會陸續改善優化。
為什麼 Agent 讀不到我明明看得到的檔案？
常見原因包括檔案未加入專案範圍或權限未開放。最快速的解決方法如下：
1. 使用 @ 符號標記檔案：在對話輸入框輸入 @ 並選擇或搜尋檔案，直接精確指定給 Agent 讀取。
2. 提供指定檔案路徑：直接複製並貼上該檔案的完整絕對路徑（如 C:\Users\...\文件.docx）。
3. 確認專案資料夾範圍：確認該檔案已放置在當前開啟的工作專案資料夾內，避免跨目錄權限被系統阻擋。
Agent 可以直接修改我的原始資料嗎？
技術上可能可以，但教學建議先建立副本與練習資料夾，設定清楚的 Project 邊界，並在輸出前由使用者檢查。
全域設定和專案設定哪個要先改？
初學者先保持全域設定保守，再在單一專案內調整需要的資料夾、權限與工具，避免一次影響所有工作。
Skill 越多越好嗎？
不是。Skill 應該依任務選擇，先用小資料測試，再確認它的輸入、輸出、權限與限制。
一定要建立專案資料夾嗎？
不一定。單純問答或整理少量已上傳檔案，可以不建立本機資料夾；但只要要讓 Agent 反覆讀寫檔案、保存成果或限制工作範圍，就建議建立專用專案資料夾。資料夾是安全邊界，不是使用 Agent 的硬性門檻。
ChatGPT 的 Project 和本機資料夾是一樣的東西嗎？
不是。ChatGPT Project 主要整理對話、檔案與專案指示；本機資料夾則是電腦上的實際檔案位置。兩者可以搭配，但不能把其中一個直接當成另一個。
Antigravity 一次可以使用多個資料夾嗎？
可以依目前版本與專案設定加入一個或多個工作資料夾。初學者仍建議先從單一練習資料夾開始，確認讀寫範圍與輸出位置後再擴大。
Agent 會不會自動刪除或改壞檔案？
有可能，因此不要直接把原始資料夾交給 Agent。先複製練習資料、要求先提出計畫，再逐次批准寫入、移動、刪除或執行命令等敏感操作。
可以把學生姓名、電話或成績直接交給 AI 嗎？
不建議直接這樣做。先依學校規範與服務條款判斷，再盡量去除姓名、聯絡方式、學號與其他可識別資訊，使用虛構資料或去識別化資料練習。
Agent 產出的報告可以直接交出去嗎？
不應直接交付。請檢查日期、人名、數字、來源、格式與是否遺漏內容；重要行政文件應由負責人完成最後審閱與批准。
如何知道該用一般聊天、ChatGPT 桌面版或 Antigravity？
單次問答用一般聊天；需要跨對話保存檔案與指示時用 ChatGPT Project；需要在本機資料夾中反覆讀寫檔案、執行命令或管理程式專案時，再考慮 Antigravity。