Skip to content

About

Still exploring

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🤖 全自動 AI 軟體工程師 (Agentic AI Developer)

這是一個基於 Python 與 Discord 打造的全自動 AI 代理 (AI Agent) 系統。它不僅具備與人類自然對話的能力,更能透過 ReAct (Reasoning and Acting) 迴圈,實際操作本地端檔案系統來協助撰寫程式碼、建立專案與除錯。

✨ 核心特色 (Key Features)

  • 🧠 跨平台瀑布式模型調度 (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) 進行一對一開發協作。

📂 專案架構 (Project Structure)

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         # 檔案操作與沙盒安全檢查邏輯

About

Still exploring

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages