一、軟件介紹
文末提供源碼和開源擴展程序下載
? ? ?Browser Copilot 是一個開源瀏覽器擴展,允許您使用現有或定制的 AI 助手來幫助您完成日常 Web 應用程序任務。
? ? ? 目標是提供多功能的 UI 和簡單的框架,以實現和使用越來越多的 copilots(AI 助手)。這些副駕駛可以通過利用瀏覽器擴展功能來幫助完成各種任務。
以下是這些副駕駛可以做什么的幾個示例:
- 自動激活與特定 Web 應用程序相關的 Copilot。例如,當 Mail Web 應用程序加載到瀏覽器選項卡中時,Mail Copilot 可以激活。
- 從當前 Web 應用程序中提取信息。例如,副駕駛可以從郵件 Web 應用程序中提取當前郵件內容,并提供郵件摘要,或者用戶可以詢問有關郵件內容的問題。
- 與 Web 應用程序交互。Copilot 可以根據用戶請求生成郵件正文。它還可以使用適當的測試數據填充 Web 應用程序表單字段。
- 使用任何服務 API 提取其他信息或自動執行 Web 應用程序流程。例如,副駕駛可以從 Web 應用程序后端檢索有效示例以填充前端表單。
- 通過將瀏覽器擴展與 AI 和功能LLM相結合,可以探索許多其他想法和功能。
二、用法
- 通過從發行版下載最新版本,在瀏覽器中安裝擴展。要從 zip 文件安裝擴展,您需要轉到瀏覽器的“管理擴展”屏幕,啟用開發人員模式,然后拖放擴展 zip 文件。
- 通過單擊其圖標打開擴展程序,并通過提供其基本 URL 添加新的 copilot。基 URL 應對應于?
manifest.json
?和?logo.png
?的位置,例如:?http://localhost:8000
?如果您的代理在本地運行。 - 通過單擊配置的 Copilot 開始新聊天,或者,如果 Copilot 具有自動激活功能,只需使用瀏覽器,Copilot 聊天就會在 Copilot 激活時自動出現。
- 直接從聊天中保存您的首選提示。要稍后快速訪問它們,只需在聊天輸入中鍵入“/”即可。
? ? ? 在任何時候,您都可以關閉 Copilot,以便稍后通過擴展圖標或右鍵單擊頁面并選擇?Toggle Browser Copilot
?來恢復對話。
? ? ? 如果您不知道任何 copilot URL,此項目在代理文件夾中包含一個簡單的 copilot 實現。您可以通過將 agent/sample.env 復制到?agent/.env
?,更改其上的環境變量,然后運行?docker-compose up
?(需要 docker) 來啟動它。啟動后,您可以通過添加帶有 URL?http://localhost:8000
?的 copilot 來配置擴展以使用它。
? ? ? 當您激活 copilot (單擊 copilot 列表) 時,它將請求一些憑據。使用?test
?user 和?test
?password 登錄。
? ? ? ?將來,我們計劃添加社區貢獻的 copilots 目錄。因此,如果您創建新的副駕駛,請告訴我們,以便我們可以將它們包含在初始目錄中。
三、代理開發
? ? ? 要開發新的代理,您可以參考 agent-mock、agent-simple 或 agent-extended 文件夾。后者是最完整的,其中包含有關端點和?manifest.json
?.
? ? ? 對于開發環境,此項目使用 devbox 和 direnv。
? ? ? 要安裝所有必需的依賴項(在安裝 devbox 和 direnv 之后),請運行以下命令:
devbox run install
接下來,在 中設置?agent-extended/.env
?適當的環境變量。
為了加快開發速度,您可以注釋掉 Keycloak 部分,這樣您就不需要在每次想在擴展中嘗試 copilot 時都進行身份驗證。如果你沒有注釋掉 Keycloak 部分,那么你需要運行?
devbox run keycloak
?以啟動 Keycloak 進行身份驗證,并使用?test
?test
?憑據進行登錄(當瀏覽器擴展請求時)。
? ? ? ?要在開發模式下運行代理,并在代理源文件中檢測到任何更改時啟用自動熱重載,請執行以下命令:
devbox run agent
如果要調試代理,可以使用首選 IDE 啟動代理,指向 devbox 創建的相關虛擬環境,并使用 IDE 的調試器功能運行主腳本。
? ? ? 有關代理的更多詳細信息,請參閱其 readme。
瀏覽器擴展開發
如果您計劃對瀏覽器擴展進行更改,請參閱 browser-extension 文件夾。
要啟動具有熱重載功能的 Chrome 瀏覽器,請使用以下命令:
devbox run browser
要修改默認瀏覽器設置,請參閱 browser-extension/vite.config.ts。
要構建擴展的最終分發,請執行以下命令:
devbox run build
軟件下載
夸克網盤分享
本文信息來源于GitHub作者地址:https://github.com/abstracta/browser-copilot