AI Agent平臺 新手指南：AI 自動化從入門到精通

一、問題：想用 AI 實現多平臺自動化，但不知從何入手？

你試過用 AI 接入 WhatsApp、Telegram 或 Discord，卻卡在環境配置、API 密鑰申請、模型對接這些環節？不是代碼寫不出來，而是光搞清“誰調誰”“在哪填什么”就花掉半天。

• 痛點 1：工具繁多，無從下手
  LangChain、LlamaIndex、AutoGen……每個框架文檔都像教科書，但沒人告訴你：哪個能直接連上 Telegram 而不改三遍配置？
• 痛點 2：部署復雜，門檻高
  本地跑大模型要 CUDA 版本對齊，調用云端 API 要處理 rate limit 和 token 過期，一個 pip install 后的報錯信息比任務邏輯還長。
• 痛點 3：平臺整合困難
  WhatsApp 需要 Business API 審核，Telegram 用 Bot Token，Discord 要 OAuth2 和 Gateway WebSocket——同一套意圖，在三個平臺得寫三套膠水代碼。

二、方案：AI Agent平臺 —— 本地化、多平臺、AI 驅動的自動化框架

AI Agent平臺 是一個開箱即用的 CLI 工具，目標很直接：讓你在 10 分鐘內讓 AI 在 Telegram 上自動回復，在 20 分鐘內把 WhatsApp 消息轉成 Slack 通知，全程不碰 Docker、不配反向代理、不申請任何第三方密鑰（除非你主動選）。

• 本地化部署：所有數據留在你機器上。沒有賬號、不傳日志、不連廠商服務器。
• 跨平臺支持：已內置 WhatsApp（通過 WebKit 協議）、Telegram（Bot API）、Discord（Gateway）、Slack（Events API）、LINE、飛書等 30+ 平臺。新增平臺只需寫一個 50 行以內的適配器。
• AI 靈活調度：默認走本地 Ollama（llama3:8b），也支持 OpenAI、Anthropic、Groq、DeepSeek 的 API；本地模型路徑可直接填絕對路徑或 HuggingFace repo id。
• 可定制性強：YAML 定義任務流，Python 寫自定義 action，插件目錄放 .py 文件就能加載。
• 免 API 密鑰起步：Telegram 和 Discord 可零配置啟動（只讀模式），WhatsApp 用官方網頁版掃碼登錄，不依賴商業網關。

三、步驟：AI Agent平臺 安裝、配置與使用指南

1. 環境準備

確認系統滿足：

• 操作系統：Windows 10+、macOS 10.14+、Linux（Ubuntu 18.04+ / Debian 11+ / CentOS 8+）
• Python：3.7+
• 基礎工具：Git、pip（Python 自帶）

# 驗證 Git 和 Python
git --version
python --version

不需要手動裝 Git 或 Python：Windows 用戶直接下 Git for Windows，macOS 用戶 brew install git python，Linux 用戶 apt install git python3-pip（Ubuntu/Debian）或 dnf install git python3-pip（Fedora/RHEL）。

2. 安裝 AI Agent平臺

# 克隆倉庫
git clone https://github.com/your-repo/AI Agent平臺.git
cd AI Agent平臺

# 創建并激活虛擬環境（強烈建議）
python -m venv venv
# Windows：
venv\Scripts\activate
# macOS/Linux：
source venv/bin/activate

# 安裝依賴
pip install -r requirements.txt

虛擬環境不是儀式感——AI Agent平臺 依賴 playwright 和 ollama，和系統全局 Python 沖突概率極高。跳過這步，大概率卡在 chromium download failed。

3. 配置平臺（以 Telegram 為例）

1. 打開 @BotFather，發 /newbot，按提示取名，拿到 token（形如 1234567890:ABCdefGhIJKlmNoPQRstUvwXYZ123456789）
2. 編輯 config.yaml，填入：

telegram:
  token: "1234567890:ABCdefGhIJKlmNoPQRstUvwXYZ123456789"

不用改端口、不用開 webhook、不用配域名。AI Agent平臺 默認輪詢 Bot API，適合開發調試。生產環境再切 long polling 或 webhook。

4. 集成 AI 模型（以本地 Ollama 為例）

先確保 Ollama 已安裝并運行（官網下載），然后拉取模型：

ollama pull llama3:8b

再在 config.yaml 中指定：

llm:
  provider: "ollama"
  model: "llama3:8b"
  base_url: "http://localhost:11434"  # 默認地址，不用改

如果要用 OpenAI：把 provider 改成 openai，加 api_key 和 model 字段即可。AI Agent平臺 不校驗密鑰格式，輸錯只會報 401，日志里一眼可見。

5. 編寫自動化腳本

新建 tasks/greet.yaml：

tasks:
  - name: "Greet User"
    platform: "telegram"
    trigger:
      type: "message"
      pattern: "^hello$|^hi$"
    action:
      type: "reply"
      message: "Hello! How can I assist you today?"

pattern 支持正則，^hello$ 表示精確匹配 hello，不是包含 hello。想響應 “hey there hello world”，改成 hello（去掉 ^$）就行。

四、驗證：測試你的自動化任務

# 啟動 AI Agent平臺（會自動加載 config.yaml 和 tasks/ 下所有 YAML）
python main.py

然后：

• 打開 Telegram，找到你的 Bot
• 發送 hello
• 看它是否秒回

如果沒反應：

• 檢查終端有沒有 Connected to Telegram Bot 日志
• 查看 logs/ai-agent.log，常見錯誤是 token 復制漏了末尾字符，或網絡被公司防火墻攔截（換手機熱點試試）

五、常見問題

• Telegram 連不上

  • 復制 token 時多了一個空格（前后 trim 一下）
  • 終端報 401 Unauthorized → token 錯；報 Connection refused → 本地網絡問題；報 429 Too Many Requests → 別狂刷，等 1 分鐘

• AI 沒輸出，卡在 loading

  • Ollama 沒運行？執行 ollama list 看模型是否存在
  • 用 OpenAI 時 api_key 寫在了 gpt: 下層？正確位置是 llm: 下的 api_key
  • 模型太大，內存爆了？換 phi3:3.8b 或 tinyllama 試試

• 任務不觸發

  • platform 名字拼錯了（比如寫成 telgram）
  • trigger.pattern 正則語法不對（用 regex101.com 實時驗證）
  • tasks/ 目錄沒放在項目根目錄，或文件后綴不是 .yaml

六、下一步學習建議

• 改一個現有 task：把 message trigger 換成 command，試試 /status 返回當前時間
• 加一個本地 action：在 plugins/ 下寫 time_reply.py，def run(context): return f"Server time: {datetime.now()}"，然后在 YAML 里 action.type: "time_reply"
• 串兩個平臺：寫一個 task，當 Telegram 收到 @ 開頭的消息，自動轉發到 Discord 指定頻道（需先配好 Discord 配置）
• 看源碼：core/platforms/telegram.py 只有 120 行，core/llm/ollama.py 60 行——適配新平臺真沒那么玄乎

GitHub 倉庫里有完整示例：examples/ 目錄下全是可直接跑的 YAML，包括天氣查詢、RSS 推送、PDF 總結。遇到問題，先搜 issue，90% 的坑前人踩過。