這是一個基於 Python 與 Discord 打造的全自動 AI 代理 (AI Agent) 系統。它不僅具備與人類自然對話的能力,更能透過 ReAct (Reasoning and Acting) 迴圈,實際操作本地端檔案系統來協助撰寫程式碼、建立專案與除錯。
- 🧠 跨平台瀑布式模型調度 (Waterfall Fallback Routing)
- 內建智能路由機制 (
AgentRouter),根據使用者提示詞的長度與複雜度,自動選擇最適合的模型池。 - Pro 旗艦池:
gemini-2.5-pro,command-r-plus(負責複雜架構與除錯) - Flash 高速池:
llama-3.3-70b,gemini-3-flash(負責快速生成與日常對話) - 本地備援防線:當雲端 API 額度耗盡 (429) 或斷線時,自動無縫降級至本地端的
gemma2接管任務,確保系統永不崩潰。
- 內建智能路由機制 (
- 🛡️ 企業級安全沙盒 (Strict Security Sandbox)
- 實作嚴格的路徑解析 (
pathlib.resolve(strict=True))。 - 防禦 目錄穿越攻擊 (Directory Traversal)。
- 防禦 符號連結攻擊 (Symlink Attack)。
- 防禦 系統隱藏檔/設定檔竄改 (Dotfile Protection),確保
.env與 SSH 私鑰絕對安全。
- 實作嚴格的路徑解析 (
- 🛠️ 工具呼叫擴充包 (Tool Calling & ReAct Loop)
- 將實體操作工具封裝於
basic_agent_tools套件中。 - AI 可自主決定何時輸出 JSON 格式指令來呼叫
read_file,write_file,list_files等工具,並根據執行結果自我修正。
- 將實體操作工具封裝於
- 💬 Discord 雙向通訊介面
- 支援在頻道內標記 (
@) 喚醒機器人,或透過私訊 (DM) 進行一對一開發協作。
- 支援在頻道內標記 (
agentic_ai_project/
├── .env # 環境變數與 API 金鑰 (不加入版控)
├── requirements.txt # Python 依賴套件清單
├── README.md # 專案說明文件
├── main.py # Discord 機器人主程式 (系統入口)
├── model_router.py # 核心大腦:模型調度與 ReAct 代理迴圈
└── basic_agent_tools/ # 工具箱套件 (Subpackage)
├── __init__.py # 套件初始化檔
└── file_manager.py # 檔案操作與沙盒安全檢查邏輯