动机

目标是提供一个多功能的 UI 和简单的框架来实现和使用不断增加的副驾驶（AI 助手）。这些副驾驶可以利用浏览器扩展功能来帮助完成各种任务。

以下是这些副驾驶可以执行的操作的一些示例：

？自动激活与特定 Web 应用程序相关的副驾驶。例如，当浏览器选项卡中加载邮件 Web 应用程序时，邮件副驾驶可以激活。
？从当前 Web 应用程序中提取信息。例如，副驾驶可以从邮件网络应用程序中提取当前邮件内容，并提供邮件摘要，或者用户可以询问有关邮件内容的问题。
与网络应用程序交互。副驾驶可以根据用户请求生成邮件正文。它还可以使用适当的测试数据填充 Web 应用程序表单字段。
？使用任何服务 API 来提取附加信息或自动化 Web 应用程序流程。例如，副驾驶可以从 Web 应用程序后端检索有效示例以填充前端表单。
通过将浏览器扩展与 AI 和 LLM 功能相结合，可以探索许多其他想法和功能。

用法

通过从发行版下载最新版本来在浏览器中安装扩展。要从 zip 文件安装扩展，您需要转到浏览器的“管理扩展”屏幕，启用开发人员模式，然后拖放扩展 zip 文件。
单击扩展程序的图标即可打开该扩展程序，并通过提供其基本 URL 来添加新的副驾驶。基本 URL 应对应于manifest.json和logo.png的位置，例如： http://localhost:8000 （如果您的代理在本地运行）。
通过单击已配置的副驾驶开始新的聊天，或者，如果副驾驶具有自动激活功能，则只需使用浏览器，副驾驶聊天将在副驾驶激活时自动出现。
直接从聊天中保存您喜欢的提示。要稍后快速访问它们，只需在聊天输入中键入“/”即可。

您可以随时关闭 Copilot，然后通过扩展程序图标或右键单击页面并选择Toggle Browser Copilot来恢复对话。

如果您不知道任何 copilot URL，该项目在代理文件夹中包含一个简单的 copilot 实现。您可以通过将agent/sample.env复制到agent/.env ，更改其环境变量，然后运行docker-compose up来启动它（这需要docker）。启动后，您可以通过添加具有 URL http://localhost:8000副驾驶员来配置您的扩展以使用它。

当您激活副驾驶时（单击副驾驶列表），它将请求一些凭据。使用test用户和test密码登录。

未来，我们计划添加社区贡献的副驾驶目录。因此，如果您创建新的副驾驶，请告知我们，以便我们将其包含在初始目录中。

发展

代理开发

要开发新的代理，您可以参考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 的调试器功能来运行主脚本。

有关代理的更多详细信息，请参阅其自述文件。

浏览器扩展开发

如果您计划对浏览器扩展进行更改，请参阅浏览器扩展文件夹。

要启动具有热重载功能的 Chrome 浏览器，请使用以下命令：

devbox run browser

要修改默认浏览器设置，请参阅 browser-extension/vite.config.ts。

要构建扩展的最终发行版，请执行以下命令：

devbox run build

贡献

我们欢迎各种贡献！

给这个项目一颗星，让整个社区更容易看到它。它让我们知道您对这个项目感兴趣，从而激励我们投入更多的努力。
？宣传这个项目。如果您发布任何相关出版物（推文、StackOverflow 提及、LinkedIn 帖子、Medium 文章等），请告知我们。我们计划将来添加对此类出版物的引用。
？通过在存储库中创建问题或打开讨论来提出问题并请求改进。
?‍ 如果您喜欢编码，您可以构建新的代理，帮助我们实现浏览器扩展功能或一般改进。

展开

附加信息