browser copilot

O Browser Copilot é uma extensão do navegador que permite usar assistentes de IA existentes ou personalizados para ajudá-lo nas tarefas diárias de aplicativos da web.

Motivação

O objetivo é fornecer uma UI versátil e uma estrutura simples para implementar e usar um conjunto cada vez maior de copilotos (assistentes de IA). Esses copilotos podem ajudar em uma ampla variedade de tarefas, aproveitando os recursos de extensão do navegador.

Aqui estão alguns exemplos do que esses copilotos podem fazer:

• ? Ative automaticamente copilotos relevantes para aplicações web específicas. Por exemplo, um Mail Copilot pode ser ativado quando um aplicativo da web Mail é carregado em uma guia do navegador.
• ? Extraia informações do aplicativo web atual. Por exemplo, o copiloto pode extrair o conteúdo atual do correio, de um aplicativo Web Mail, e fornecer um resumo do correio, ou os usuários podem fazer perguntas sobre o conteúdo do correio.
• Interaja com aplicativos da web. Um copiloto poderia gerar corpos de correspondência com base nas solicitações dos usuários. Ele também pode preencher campos de formulário de aplicativos da web com dados de teste apropriados.
• ? Use qualquer API de serviço para extrair informações adicionais ou automatizar processos de aplicativos da web. Por exemplo, o copiloto poderia recuperar exemplos válidos do back-end do aplicativo web para preencher formulários de front-end.
• Muitas outras ideias e capacidades podem ser exploradas combinando a extensão do navegador com capacidades de IA e LLM.

Uso

1. Instale a extensão em seu navegador baixando a versão mais recente dos lançamentos. Para instalar uma extensão a partir de um arquivo zip, você precisa ir até a tela "Gerenciar extensão" do navegador, ativar o modo de desenvolvedor e arrastar e soltar o arquivo zip da extensão.
2. Abra a extensão clicando em seu ícone e adicione um novo copiloto fornecendo seu URL base. A URL base deve corresponder ao local de manifest.json e logo.png , por exemplo: http://localhost:8000 se o seu agente estiver em execução localmente.
3. Inicie um novo chat clicando em um copiloto configurado, ou, caso o copiloto possua ativação automática, basta utilizar seu navegador e o chat do copiloto aparecerá automaticamente quando o copiloto for ativado.
4. Salve suas solicitações preferidas diretamente do chat. Para acessá-los rapidamente mais tarde, basta digitar '/' na entrada do chat.

A qualquer momento, você pode fechar o copiloto para posteriormente retomar a conversa pelo ícone da extensão ou clicando com o botão direito na página e selecionando Toggle Browser Copilot .

Se você não conhece nenhum URL do copiloto, este projeto inclui uma implementação simples do copiloto na pasta do agente. Você pode iniciá-lo copiando agent/sample.env para agent/.env , alterando as variáveis ​​de ambiente nele e executando docker-compose up (o docker é necessário para isso). Depois de iniciado, você pode configurar sua extensão para usá-la adicionando um copiloto com a URL http://localhost:8000 .

Ao ativar o copiloto (clique na lista de copilotos), ele irá solicitar algumas credenciais. Use usuário test e senha test para fazer login.

No futuro, planejamos adicionar um catálogo de copilotos contribuídos pela comunidade. Portanto, caso você crie novos copilotos, avise-nos para que possamos incluí-los no catálogo inicial.

Desenvolvimento

Desenvolvimento de Agente

Para desenvolver um novo agente, você pode consultar as pastas agent-mock, agent-simple ou agent-extended. O último é o mais completo com documentação adequada sobre endpoints e manifest.json .

Para o ambiente de desenvolvimento, este projeto utiliza devbox e direnv.

Para instalar todas as dependências necessárias (após instalar devbox e direnv), execute o seguinte comando:

devbox run install

Em seguida, configure variáveis ​​de ambiente apropriadas em agent-extended/.env .

Para acelerar o desenvolvimento, você pode comentar a seção Keycloak, para não precisar se autenticar toda vez que quiser testar seu copiloto na extensão. Se você não comentar a seção Keycloak, será necessário executar devbox run keycloak para ativar o Keycloak para autenticação e usar credenciais test test para login (quando solicitado pela extensão do navegador).

Para executar o agente no modo dev, habilitando o recarregamento automático sempre que alguma alteração for detectada nos arquivos de origem do agente, execute o seguinte comando:

devbox run agent

Se quiser depurar o agente, você pode iniciá-lo com seu IDE preferido, apontando para o ambiente virtual relevante criado pelo devbox e usando os recursos de depurador do IDE para executar o script principal.

Para obter mais detalhes sobre o agente, consulte seu leia-me.

Desenvolvimento de extensões de navegador

Se você planeja contribuir com alterações na extensão do navegador, consulte a pasta de extensão do navegador.

Para iniciar um navegador Chrome com recursos de recarga a quente, use o seguinte comando:

devbox run browser

Para modificar as configurações padrão do navegador, consulte browser-extension/vite.config.ts.

Para construir a distribuição final da extensão, execute o seguinte comando:

devbox run build

Contribuindo

Aceitamos todos os tipos de contribuições!

• Dê uma estrela a este projeto para torná-lo mais visível para toda a comunidade. Isso nos permite saber que você está interessado neste projeto, motivando-nos a investir mais esforços nele.
• ? Divulgue este projeto. Se você fizer alguma publicação (tweets, menções no StackOverflow, postagens no LinkedIn, artigos no Medium, etc.) sobre isso, informe-nos. Planejamos adicionar referências a tais publicações no futuro.
• ? Tire dúvidas e solicite melhorias criando problemas ou abrindo discussões no repositório.
• ?‍ Se você gosta de codificação, pode criar novos agentes, ajudando-nos a implementar recursos de extensão do navegador ou melhorias gerais.