✦ 概念手冊精華

AI Agent
架構與智能自動化

從規則式流程，到會自己思考、自己動手的數位助理：核心架構、System Prompt、實戰整合與部署路線。

也可使用鍵盤 ← → 或在手機上左右滑動換頁

✦ 觀念轉變

從寫死規則到自主完成任務

比較項目	傳統自動化（Rule-based）	AI Agent
運作邏輯	每一步預先設定（If/Else、靜態串接）	依目標主動規劃與推理
彈性	很低，只能照固定規則反應	很高，依情境調整行為
決策能力	被動，無法判斷情境	主動分析，選擇工具與做法
非結構化資料	只能比對關鍵字或固定字串	理解自然語言、郵件脈絡與使用者意圖

關鍵差異：自主性（Autonomy）

你只需給出最終目標，例如「管理我的行事曆，並在對方約開會時回信」。Agent 會自行分析、規劃步驟並呼叫工具，不必逐步寫好每個動作。

✦ 核心架構

AI Agent 的四大組成

Chat Model

推理大腦。理解意圖、做決策，並決定何時動用記憶與工具。
GPT-4o / GPT-4.1 Mini

Simple Memory

短期記憶。跨回合保留對話脈絡，預設保留最近 5 輪。

System Prompt

行為準則。定義角色、回應語言、限制與輸出格式。

Tools

執行之手。操作 Google Calendar、Gmail、Contacts 等外部應用。

Chat Model 需要 API Key（如 OpenAI Platform，需綁定付款方式並儲值）。它不只回文字，也負責調度：判斷何時讀記憶、何時觸發工具，以及帶入什麼參數。

✦ 記憶與工具

讓 Agent 有記憶也能動手

Session ID

使用 Chat Trigger 時，n8n 會自動管理。接上 Siri Webhook 或 Telegram 等外部通道時，必須在 Simple Memory 手動設定固定值（例如 memory），對話歷史才會連續。

工具	可授權的操作	實際用途
Google Calendar	Create / Delete / Get Many / Update	查空檔、新增行程、衝突時調整
Gmail	Send / Reply（依 Thread ID）/ Draft	回覆夥伴、寄確認信、先存草稿待人審核
Google Contacts	Get Many（Use Query）	只給名字（如「寄給 Nam」）也能查出 Email

✦ System Prompt

設計 Prompt 的三個步驟

① 角色與語言

明確身分、職責與必用語言，避免 AI 跳回簡體中文或英文。
「你是管理行程的個人助理，請一律以標準、禮貌的越南語回覆。」

② 注入即時時間

LLM 沒有內建時鐘，只靠凍結的訓練資料。在 Prompt 加入 {{$now}}，n8n 執行時會帶入當下日期，才能算對「下週六」。

③ 行為與格式限制

Siri 語音：不換行、不放符號與網址，避免朗讀卡頓。
業務規則：建立行程前必先 Get Many 檢查是否撞期。

System Prompt 是固定的行為框架；User Prompt 是動態輸入，例如語音轉文字、郵件內容或 Telegram 訊息。

✦ 整合通道

被動回答，還是主動通知？

被動：Webhook + iPhone Siri

語音 → Shortcuts 語音轉文字 → HTTP POST → Webhook → Agent → Respond to Webhook → Siri 朗讀。

Webhook 改用 Respond to Webhook 節點；回傳型別設為 Text；加上 Response Header 指定 UTF-8，避免越南語亂碼。

主動：Telegram Bot

新事件或郵件 → Trigger → Agent 分析 → 取得 Chat ID → Send a Text Message → 推播給使用者。

BotFather Token 讓 n8n 控制 Bot；Chat ID 讓 Agent 能隨時主動通知，例如偵測到撞期立刻警示。

✦ 實戰情境

自動處理會議郵件與行程

Gmail Trigger每分鐘檢查新信

→

Text Classifier分成「會議相關／無關」

→

AI Agent帶入 Thread ID、摘要、寄件人、主旨

→

Get Many讀取當天所有行程

A　沒有撞期

Create 新行程，並用 Telegram 通知已確認。

B　發現撞期

不擅自建立，改用 Telegram 警示，列出衝突時段並提出建議。

使用者回覆「改到下午 4 點」後，Agent 更新 Calendar，並依 Thread ID 以 Gmail 建立草稿或直接回信給對方。

✦ 部署與學習

部署方式與學習路線

項目	Local Docker	Cloud VPS（如 Hostinger）
成本	完全免費	約 4.99 美元／月（官方 n8n Cloud 約 20 歐元）
安裝	Docker Desktop、Pull n8n Image、開 Port 5678	一鍵套用現成範本
穩定度	關機或關 Docker 就停擺	24/7 在遠端持續運行

OAuth：在 Google Cloud Console 啟用 Calendar / Gmail API，同意畫面選 External 並加入 Test Users；Redirect URI 本機填 localhost:5678，VPS 填 IP 或網域。

步驟 1　建立思維

用 n8n 14 天試用或本機 Docker，練習節點串接與 JSON。

步驟 2　接上大腦與工具

取得 API Key、設定 OAuth，配置 Memory、Calendar、Gmail，練習 {{$now}}。

步驟 3　上線 24/7

匯入 JSON 範本，整合 Telegram 與 Siri，部署到 Cloud VPS。

AI Agent架構與智能自動化