browser copilot

Browser Copilot es una extensión del navegador que le permite utilizar asistentes de IA existentes o personalizados para ayudarle en las tareas diarias de aplicaciones web.

Motivación

El objetivo es proporcionar una interfaz de usuario versátil y un marco simple para implementar y utilizar un conjunto cada vez mayor de copilotos (asistentes de IA). Estos copilotos pueden ayudar en una amplia gama de tareas aprovechando las capacidades de la extensión del navegador.

A continuación se muestran algunos ejemplos de lo que pueden hacer estos copilotos:

• ? Active automáticamente copilotos que sean relevantes para aplicaciones web específicas. Por ejemplo, un Mail Copilot puede activarse cuando se carga una aplicación web de Mail en una pestaña del navegador.
• ? Extraer información de la aplicación web actual. Por ejemplo, el copiloto podría extraer el contenido del correo actual desde una aplicación web de correo y proporcionar un resumen del correo, o los usuarios pueden hacer preguntas sobre el contenido del correo.
• Interactuar con aplicaciones web. Un copiloto podría generar cuerpos de correo según las solicitudes de los usuarios. También podría completar los campos del formulario de la aplicación web con datos de prueba apropiados.
• ? Utilice cualquier API de servicio para extraer información adicional o automatizar procesos de aplicaciones web. Por ejemplo, el copiloto podría recuperar ejemplos válidos del backend de la aplicación web para completar los formularios del frontend.
• Se pueden explorar muchas otras ideas y capacidades combinando la extensión del navegador con capacidades de IA y LLM.

Uso

1. Instale la extensión en su navegador descargando la última versión de los lanzamientos. Para instalar una extensión desde un archivo zip, debe ir a la pantalla "Administrar extensión" de su navegador, habilitar el modo de desarrollador y arrastrar y soltar el archivo zip de extensión.
2. Abra la extensión haciendo clic en su icono y agregue un nuevo copiloto proporcionando su URL base. La URL base debe corresponder a la ubicación de manifest.json y logo.png , por ejemplo: http://localhost:8000 si su agente se ejecuta localmente.
3. Inicie un nuevo chat haciendo clic en un copiloto configurado o, si el copiloto tiene activación automática, simplemente use su navegador y el chat del copiloto aparecerá automáticamente cuando el copiloto se active.
4. Guarde sus mensajes preferidos directamente desde el chat. Para acceder rápidamente a ellos más tarde, simplemente escriba '/' en la entrada del chat.

En cualquier momento, puede cerrar el copiloto para luego reanudar la conversación mediante el ícono de extensión o haciendo clic derecho en la página y seleccionando Toggle Browser Copilot .

Si no conoce ninguna URL de copiloto, este proyecto incluye una implementación de copiloto simple en la carpeta del agente. Puede iniciarlo copiando agent/sample.env en agent/.env , cambiando las variables de entorno y ejecutando docker-compose up (se requiere docker para esto). Una vez iniciado, puede configurar su extensión para usarla agregando un copiloto con la URL http://localhost:8000 .

Cuando actives el copiloto (haz clic en la lista de copilotos), te solicitará algunas credenciales. Utilice el usuario test y la contraseña test para iniciar sesión.

En el futuro, planeamos agregar un catálogo de copilotos aportados por la comunidad. Por lo tanto, si creas nuevos copilotos, háznoslo saber para que podamos incluirlos en el catálogo inicial.

Desarrollo

Desarrollo de agentes

Para desarrollar un nuevo agente, puede consultar las carpetas agente simulado, agente simple o agente extendido. El último es el más completo con documentación adecuada sobre puntos finales y manifest.json .

Para el entorno de desarrollo, este proyecto utiliza devbox y direnv.

Para instalar todas las dependencias requeridas (después de instalar devbox y direnv), ejecute el siguiente comando:

devbox run install

A continuación, establezca las variables de entorno adecuadas en agent-extended/.env .

Para acelerar el desarrollo, puede comentar la sección Keycloak, de modo que no necesite autenticarse cada vez que quiera probar su copiloto en la extensión. Si no comenta la sección Keycloak, entonces necesita ejecutar devbox run keycloak para activar Keycloak para la autenticación y usar las credenciales test test iniciar sesión (cuando lo solicite la extensión del navegador).

Para ejecutar el agente en modo de desarrollo, habilitando la recarga automática en caliente cada vez que se detecte algún cambio en los archivos fuente del agente, ejecute el siguiente comando:

devbox run agent

Si desea depurar el agente, puede iniciarlo con su IDE preferido, apuntando al entorno virtual relevante creado por devbox y utilizando las capacidades de depuración del IDE para ejecutar el script principal.

Para obtener más detalles sobre el agente, consulte su archivo Léame.

Desarrollo de extensiones del navegador

Si planea contribuir con cambios a la extensión del navegador, consulte la carpeta de extensiones del navegador.

Para iniciar un navegador Chrome con capacidades de recarga en caliente, use el siguiente comando:

devbox run browser

Para modificar la configuración predeterminada del navegador, consulte browser-extension/vite.config.ts.

Para construir la distribución final de la extensión, ejecute el siguiente comando:

devbox run build

Contribuyendo

¡Agradecemos todo tipo de contribuciones!

• Dale una estrella a este proyecto para hacerlo más visible para toda la comunidad. Nos hace saber que estás interesado en este proyecto, motivándonos a invertir más esfuerzos en él.
• ? Corre la voz sobre este proyecto. Si realiza alguna publicación (tweets, menciones de StackOverflow, publicaciones de LinkedIn, artículos de Medium, etc.) al respecto, háganoslo saber. Planeamos agregar referencias a dichas publicaciones en el futuro.
• ? Haga preguntas y solicite mejoras creando problemas o abriendo discusiones en el repositorio.
• ?‍ Si le gusta codificar, puede crear nuevos agentes, ayudándonos a implementar funciones de extensión del navegador o mejoras generales.