使用 Eigent 建構完全本機 AI 團隊指南

如果你想部署強大的 AI 工具，你很可能已經遇到一個關鍵挑戰：如何在不影響敏感資料安全的情況下，釋放它們的全部潛力。

大多數平台都會把一切推到雲端，起初雖然方便，但當你處理客戶資料、財務數據或內部 IP 時，很快就會亮起警號。你想要多代理系統的能力，同時也想要私隱、控制權，以及在自己電腦上運行一切的能力。

這就是 Eigent 的用武之地——透過 Eigent open source cowork，你可以建立一個完全本機的多代理團隊，整個系統都運行在你自己的基礎設施上。

什麼是 Eigent？

Eigent 是一個本機優先的多代理桌面應用程式。它不會把你的資料傳送到外部伺服器，而是在你的電腦上執行所有工作。你可以完整看到每個步驟的運作，並且確信你的檔案、憑證和日誌都留在你手上。

你可以把它想像成建立屬於你自己的 AI 團隊。你可以啟動不同的代理，每個都有自己的技能：搜尋代理負責瀏覽網頁、開發代理執行程式碼、文件代理撰寫和編輯檔案，甚至還有處理圖片和音訊的多模態代理。Eigent 會替你協調它們，讓它們可以平行處理任務、在需要時交接工作，並交付精緻的成果。

在這份指南中，我們會確切示範如何在本機完成設定。到最後，你會在自己的桌面上執行 Eigent，並讓代理按照你的方式協作工作。

前置條件

Node.js（v18 或更新）和 npm：Eigent 是一個 Node/Electron 應用程式。如果你還未安裝，請先安裝 Node.js（建議 18–22）。 記憶體和硬件：建議至少有 8 GB RAM。如果你連接外部 API，Eigent 可以完全在 CPU 上運行。若要在本機進行大型模型推論，具備效能的 GPU（例如 NVIDIA RTX）會有幫助。 作業系統：Eigent 支援 Windows 和 macOS。 Docker：請安裝 Docker 並確認它正在執行。https://docs.docker.com/get-docker/ ‍

1. 複製 repo 並啟動 PostgreSQL 後端

複製 Eigent repository 並安裝相依套件：

git clone https://github.com/eigent-ai/eigent.git
cd eigent

切換到 server 目錄並啟動 Docker：

cd server
cp .env.example .env
docker compose up -d

這會啟動兩個容器：

一個 PostgreSQL 資料庫（Eigent 資料儲存） Eigent API 伺服器 兩者都會在你的電腦本機上運行，API 地址為 localhost:3001。預設情況下，Docker 會為 PostgreSQL 建立一個 volume，因此資料庫檔案會儲存在磁碟上。

2. 驗證本機資料儲存

到這一步，所有東西都已在本機運行。PostgreSQL 容器（eigent_postgres）保存著資料庫。你可以透過列出 Docker 容器，或在容器內使用像 psql 之類的工具來再次確認。Eigent 所做的一切（代理訊息、使用者資料、任務日誌等）都會寫入本機 Postgres 實例。沒有任何資料會傳送到你電腦以外的地方。

所有 Eigent 資料都儲存在本機的 Dockerized PostgreSQL 資料庫中。

這確保了設計上的私隱。如文件所述，自架部署的一大優勢是資料私隱——你可以將敏感資料保留在自己的基礎設施內。事實上，當你使用這個設定時，任何工作區或登入資訊都不會離開你的本機網絡。Eigent 預設就是完全本機，因此你可以審核並信任你的資料會留在原地。

3. 修改 .env.development 以使用本機 Proxy

接下來，我們需要告訴前端使用本機後端，而不是任何雲端服務。在專案根目錄 (eigent/.env.development) 中，啟用本機 proxy 設定。用文字編輯器打開 .env.development，並確認它包含：

VITE_BASE_URL=/api
VITE_PROXY_URL=http://localhost:3001
VITE_USE_LOCAL_PROXY=true

透過設定 VITE_USE_LOCAL_PROXY=true 並將 VITE_PROXY_URL 指向 http://localhost:3001，你就能設定前端把所有 API 請求送到本機 Docker 後端。

請確保這些行前面沒有 # 或註解符號，否則設定不會生效。完成這個設定後，前端應用程式會把請求代理到你的本機伺服器，而不是外部示範 API。

4. 執行前端應用程式

現在返回 repo 根目錄，安裝 JavaScript 相依套件，然後啟動開發伺服器：

cd ..
npm install
npm run dev

這會在本機啟動 Eigent 前端。預設情況下，它會在 http://localhost:3000 運行。配合 .env 的變更，前端會與位於 http://localhost:3001 的 API 通訊——全部都在你的電腦內完成。

> eigent@* dev
> vite

  VITE vX.X.X  ready in Y ms

  ➜  Local:   http://localhost:3000/

這裡不需要任何特別的雲端憑證——這只是一個正常的 Node 開發版本。

5. 在本機存取 Eigent UI

Eigent 的登入畫面會在本機提供服務並載入。雖然需要登入，但這個實例是自架的，並不涉及任何外部服務。

這個登入純粹是為了本機應用程式——你的憑證和資料會儲存在你剛剛啟動的本機 Postgres 資料庫中，而不是某個雲端伺服器。即使 UI 顯示的是 OAuth 風格的登入介面，所有驗證和使用者資料都只會存在於你的電腦上。文件強調了這種本機優先的設定：「Your data stays on your own device, addressing privacy and security concerns」。登入後，你就會進入主儀表板，在那裡你可以建立自訂代理、定義工作流程，以及設定工具。

例如，工具／設定頁面可讓你啟用或停用內建整合（網頁搜尋、Google docs、Slack 等），而模型選擇畫面則可讓你挑選或設定偏好的 LLM。從這裡開始——代理訊息、工具輸出、知識庫——除非你明確匯出，否則都會保留在你的 PostgreSQL 資料庫和本機檔案系統中。

Eigent UI 讓你在本機實例中設定整合工具（Slack、網頁搜尋等）。在本機的 Eigent 設定中，選擇代理要使用哪些模型或 API。

注意：在本機模式下，使用者需要自行設定模型的 API 金鑰或端點。

觀看完整教學

偏好視覺化指引？我們已錄製一段逐步教學，帶你走過整個流程，從啟動 Docker 到在本機登入 Eigent。

教學連結：在 YouTube 觀看