RuoYi AI：手把手教你打造個人專屬的 AI 助手平台！(入門篇)
嘿，各位台灣的朋友們！最近 AI 實在太夯了，不管是 ChatGPT、Midjourney 還是其他酷炫的 AI 工具，都讓人覺得好像進入了未來世界。你是不是也想擁有一個屬於自己的 AI 助手平台，但又覺得好像很難、很複雜呢？別擔心！今天就來跟大家介紹一個超棒的開源專案 RuoYi AI，讓你也能輕鬆搭建自己的 AI 助手平台！
什麼是 RuoYi AI？
RuoYi AI 是一個基於 MIT 協議的開源專案，簡單來說，它提供了一整套的解決方案，包含前端使用者介面、後台管理系統，甚至連小程序都幫你準備好了。你可以把它想像成一個 AI 樂高積木，你只需要把它們組裝起來，就可以擁有一個功能豐富的 AI 助手平台。
RuoYi AI 有什麼厲害的地方？
RuoYi AI 的特色真的不少，讓我來一一跟你介紹：
- 完全開源，免費使用： 這是最重要的！RuoYi AI 是完全開源的，你可以免費下載、修改、使用，不用擔心版權問題。
- 全套解決方案： 從前端到後端，RuoYi AI 都幫你準備好了，省去了你從零開始開發的時間和精力。
- 本地 RAG 方案： 什麼是 RAG？簡單來說，就是讓 AI 可以根據你自己的資料庫來回答問題。RuoYi AI 整合了 Milvus/Weaviate 向量資料庫、本地向量化模型與 Ollama，讓你可以在本地端實現 RAG，不用擔心資料外洩的問題。
- 豐富的插件功能： RuoYi AI 支援各種插件，例如聯網插件、SQL 查詢插件、Text2API 插件等等，讓你的 AI 助手可以做更多的事情。
- 支援多種大語言模型： RuoYi AI 可以對接多種大語言模型，例如 ChatGPT、文心一言等等，你可以根據自己的需求選擇最適合的模型。
- 多媒體功能： 除了文字對話之外，RuoYi AI 還支援 AI 翻譯、PPT 製作、語音克隆和翻唱等功能，讓你的 AI 助手更加多元。
- 可擴展性強： RuoYi AI 可以接入個人或企業微信，讓你可以在常用的通訊軟體中使用 AI 助手。
- 支援多種支付方式： 如果你想要將 RuoYi AI 應用於商業用途，它也支援易支付、微信支付等多種支付方式。
RuoYi AI 適合我嗎？
如果你有以下的想法，那麼 RuoYi AI 就非常適合你：
- 想學習 AI 相關技術： RuoYi AI 是一個很好的學習平台，你可以透過研究它的原始碼，了解 AI 助手平台的架構和實作方式。
- 想打造個人化的 AI 助手： 你可以根據自己的需求，修改 RuoYi AI 的程式碼，打造一個獨一無二的 AI 助手。
- 想將 AI 應用於商業用途： RuoYi AI 提供了完整的支付功能，你可以將它應用於電商、客服等領域。
- 想參與開源專案： RuoYi AI 是一個活躍的開源專案，你可以透過貢獻程式碼、撰寫文件等方式，參與其中。
RuoYi AI 的核心概念
在深入研究 RuoYi AI 之前，先理解一些核心概念會對你更有幫助：
- 大語言模型 (Large Language Model, LLM): 這是 AI 助手的核心，負責理解你的問題並生成回答。例如 ChatGPT 就是一個知名的大語言模型。
- 向量資料庫 (Vector Database): 用來儲存和檢索向量資料，向量資料是將文字、圖片等資料轉換成數值向量表示，方便 AI 進行相似度比較和搜尋。RuoYi AI 支援 Milvus 和 Weaviate 這兩種向量資料庫。
- RAG (Retrieval-Augmented Generation): 一種結合了資訊檢索和生成模型的技術，讓 AI 能夠根據檢索到的相關資料來生成更準確、更豐富的回答。
- 插件 (Plugin): 用來擴展 AI 助手功能的模組，例如聯網插件可以讓 AI 從網路上搜尋資訊，SQL 查詢插件可以讓 AI 查詢資料庫。
- API (Application Programming Interface): 應用程式介面，用來讓不同的軟體系統互相溝通。RuoYi AI 提供了 Text2API 插件，可以讓你透過文字指令來呼叫 API。
RuoYi AI 初體驗：快速上手指南
Okay，講了這麼多，現在就來教大家如何快速上手 RuoYi AI。以下是一些步驟和注意事項，讓你可以順利搭建自己的 AI 助手平台：
- 環境準備：
- Java Development Kit (JDK) 17： 這是 Java 的開發工具包，RuoYi AI 是用 Java 開發的，所以需要安裝 JDK 17。
- MySQL 5.7 或 8.0： 這是關聯式資料庫，用來儲存 RuoYi AI 的資料。
- Redis 5.X 或以上： 這是快取資料庫，用來加速 RuoYi AI 的執行速度。
- Maven 3.8+： 這是 Java 的專案管理工具，用來編譯和打包 RuoYi AI 的程式碼。
- Node.js 20+ & pnpm： 這是 JavaScript 的執行環境和套件管理工具，用來開發 RuoYi AI 的前端介面。
小撇步： 如果你對這些工具不太熟悉，可以先從網路上找一些教學文章或影片，了解它們的基本用法。
-
下載 RuoYi AI 原始碼：
你可以從 GitHub 或 GitCode 下載 RuoYi AI 的原始碼。以下是一些連結：
- GitHub：
- RuoYi AI 總專案: https://github.com/ageerle/ruoyi-ai
- 前端-後台管理: https://github.com/ageerle/ruoyi-admin
- 前端-用戶端: https://github.com/ageerle/ruoyi-web
- 小程序端: https://github.com/ageerle/ruoyi-uniapp
- GitCode：
小撇步： 建議你使用 Git 來下載原始碼，這樣可以方便地更新和管理程式碼。
- GitHub：
-
設定資料庫和 Redis：
- MySQL： 建立一個新的資料庫，並匯入 RuoYi AI 提供的 SQL 檔案。
- Redis： 啟動 Redis 伺服器，並設定 RuoYi AI 的連線資訊。
小撇步： 你可以參考 RuoYi AI 的官方文件，了解如何設定資料庫和 Redis。
-
編譯和執行後端程式碼：
使用 Maven 編譯 RuoYi AI 的後端程式碼，然後執行
RuoYiApplication啟動類。小撇步： 如果你遇到編譯錯誤，可以檢查你的 JDK 版本和 Maven 設定是否正確。
-
編譯和執行前端程式碼：
使用 pnpm 安裝 RuoYi AI 的前端依賴套件，然後執行開發伺服器。
小撇步： 如果你遇到安裝錯誤，可以檢查你的 Node.js 版本和 pnpm 設定是否正確。
-
瀏覽器預覽：
在瀏覽器中輸入 RuoYi AI 的網址，就可以看到你的 AI 助手平台了！
- 後台管理： https://admin.pandarobot.chat (帳號：admin，密碼：admin123)
- 使用者端： https://web.pandarobot.chat
小撇步： 如果你無法訪問網頁，可以檢查你的防火牆設定和伺服器狀態。
常見問題與錯誤排除
在搭建 RuoYi AI 平台的過程中，你可能會遇到一些問題。以下是一些常見問題和錯誤排除方法：
- 編譯錯誤：
- 檢查 JDK 版本是否為 17 或以上。
- 檢查 Maven 設定是否正確。
- 檢查是否有遺漏的依賴套件。
- 執行錯誤：
- 檢查資料庫和 Redis 是否已啟動。
- 檢查資料庫連線資訊和 Redis 連線資訊是否正確。
- 檢查是否有其他程式佔用了 RuoYi AI 的連接埠。
- 網頁無法訪問：
- 檢查防火牆設定是否允許訪問 RuoYi AI 的連接埠。
- 檢查伺服器狀態是否正常。
- 檢查網址是否輸入正確。
實作心得與建議
在實際使用 RuoYi AI 的過程中，我發現以下幾點值得注意：
- 善用官方文件： RuoYi AI 的官方文件非常詳細，包含了各種設定和使用說明，遇到問題時可以先參考官方文件。
- 加入社群： RuoYi AI 有活躍的社群，你可以在社群中尋求幫助、交流經驗。
- 客製化你的 AI 助手： RuoYi AI 提供了豐富的 API 和擴展點，你可以根據自己的需求，客製化你的 AI 助手。
- 持續學習： AI 技術不斷發展，要持續學習新的知識，才能讓你的 AI 助手更加強大。
結語
RuoYi AI 是一個非常棒的開源專案，它可以讓你輕鬆搭建自己的 AI 助手平台。雖然搭建過程可能需要一些技術知識，但只要你有耐心和熱情，一定可以成功。希望這篇文章對你有所幫助，祝你搭建 AI 助手平台順利！
下一步？
如果你成功搭建了 RuoYi AI 平台，恭喜你！接下來，你可以嘗試以下的事情：
- 探索 RuoYi AI 的各種功能： 熟悉 RuoYi AI 的後台管理介面，了解如何設定使用者、角色、權限等。
- 對接大語言模型： 嘗試對接不同的語言模型，比較它們的優缺點。
- 開發自己的插件： 根據自己的需求，開發一些實用的插件，例如翻譯插件、天氣查詢插件等。
- 將 RuoYi AI 部署到雲端： 將 RuoYi AI 部署到雲端伺服器，讓更多人可以使用你的 AI 助手。
- 參與 RuoYi AI 的開發： 如果你對 RuoYi AI 有任何建議或想法，可以參與專案的開發，共同打造更好的 AI 助手平台。
加油！台灣的 AI 開發者們！讓我們一起用 RuoYi AI 創造更美好的未來！
參考閱讀
https://github.com/ageerle/ruoyi-ai
![[無偏見報導]白沙屯媽祖遶境再掀熱潮，電信商AI加持確保網路暢通](https://s.yimg.com/fz/api/res/1.2/3rtxMPSNrZ6SjzcF9rMlYQ--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD05MjtweG9mZj0wO3B5b2ZmPTA7cT04MDtzbT0xO3c9MTY0/https://media.zenfs.com/ko/newtalk.tw/df36131c84767d679f9940a4f9c29965 "[無偏見報導]白沙屯媽祖遶境再掀熱潮，電信商AI加持確保網路暢通")