前情提要：為何選擇 Hermes Agent？

在第 1 篇與第 2 篇中，我們探討了為何「Hermes Agent AI」對於台灣的中小企業及半導體相關服務領域至關重要，以及 Agentic Workflow（代理工作流）與傳統聊天機器人有何本質上的差異。特別是根據台灣經濟部（MOEA）的調查顯示，導入基於代理的自動化後，客戶服務部門的營運成本平均降低了 38%，這點極具指標意義。現在，我們將跨越理論階段，進入實戰環節，將這套強大的工具部署到您的伺服器與本地環境中。

1. 系統需求與事前準備

Hermes Agent 不僅僅是安裝函式庫，它還需要系統級的權限與網路環境支援。安裝前請務必確認以下事項：

<h3>硬體與作業系統環境</h3> - **OS:** 建議使用 Ubuntu 22.04 LTS（台灣研究機構與企業標準）。 - **CPU:** 至少 4 核心以上（平行處理代理任務時資源佔用較高）。 - **RAM:** 至少 16GB（對於嵌入模型與本地上下文快取至關重要）。 - **GPU:** 必須支援 NVIDIA CUDA（建議至少 8GB VRAM，運行 Llama 3 或 Mistral 模型時效能差異顯著）。 <h3>必要軟體堆疊</h3> - **Python 3.10+:** 管理虛擬環境的必要版本。 - **Docker & Docker Compose:** 服務容器化的必備工具。 - **Git:** 用於原始碼版本控制。 - **Conda 或 venv:** 用於依賴隔離的環境管理器。

2. 開發環境建置：虛擬環境與依賴管理

由於 Hermes Agent 需要連接多種外部 API，為了避免函式庫之間的版本衝突，務必在虛擬環境中進行操作。

<h3>使用 Conda 建立隔離環境</h3> 1. 開啟終端機並執行以下指令建立環境： `conda create -n hermes_env python=3.10 -y` 2. 啟用環境：`conda activate hermes_env` 3. 更新必要建置工具：`pip install --upgrade pip setuptools wheel` <h3>原始碼複製與依賴安裝</h3> 1. 從官方儲存庫取得程式碼：`git clone https://github.com/hermes-agent/core.git` 2. 進入資料夾：`cd core` 3. 安裝依賴：`pip install -r requirements.txt` - *注意：* 若受限於台灣網路環境導致 Python 套件索引 (PyPI) 鏡像伺服器速度緩慢，可使用 `--index-url https://pypi.tuna.tsinghua.edu.cn/simple` 選項進行加速。

3. 初始設定與環境變數配置

為了讓安裝好的 Hermes Agent 正常運作，需要設定安全金鑰與 API 端點。請將根目錄下的 .env.example 檔案複製為 .env 並進行設定。

<h3>核心設定項目</h3> - **LLM_API_KEY:** 設定 OpenAI、Anthropic 或本地 Ollama 端點。 - **DATABASE_URL:** 儲存代理記憶（Memory）的 PostgreSQL 連接字串。 - **AGENT_ROLE:** 設定代理的角色，如 'CustomerService'、'Logistics'、'Inventory' 等。 - **LOG_LEVEL:** 初次建置時建議設為 'DEBUG'，以便即時監控代理的推理過程。 <h3>安全注意事項</h3> - 請勿將 `.env` 檔案上傳至 Git 儲存庫。務必確認其已包含在 `.gitignore` 中。 - 台灣企業環境多使用內部網路（Intranet），若需要代理伺服器，請額外設定 `HTTP_PROXY` 與 `HTTPS_PROXY` 環境變數。

4. 首次執行與健康檢查

安裝完成後，請測試代理是否正常運作。

<h3>執行測試步驟</h3> 1. **啟動伺服器：** `python main.py --mode=dev` 2. **確認連接：** 檢查日誌是否出現 `Hermes Agent Initialized: Ready for Tasks` 訊息。 3. **執行簡單請求：** `curl -X POST http://localhost:8000/api/v1/task -d '{"task": "Hello, Hermes!"}'`

若發生錯誤，請檢查 logs/error.log 檔案。通常多為 API Key 權限問題，或是向量資料庫連接失敗所致。

下期預告

本篇我們介紹了 Hermes Agent 的穩健安裝與環境設定。在第 4 篇中，我們將以**「代理大腦調校：利用 RAG（檢索增強生成）連接企業內部數據」**為主題，深入分析代理如何學習並運用台灣企業實際的 ERP 資料。敬請期待更深入的技術細節。