browser copilot

Browser Copilot adalah ekstensi browser yang memungkinkan Anda menggunakan asisten AI yang sudah ada atau yang dibuat khusus untuk membantu Anda dalam tugas aplikasi web sehari-hari.

Motivasi

Tujuannya adalah untuk menyediakan UI serbaguna dan kerangka kerja sederhana untuk mengimplementasikan dan menggunakan kumpulan kopilot (asisten AI) yang terus meningkat. Kopilot ini dapat membantu dalam berbagai tugas dengan memanfaatkan kemampuan ekstensi browser.

Berikut ini beberapa contoh yang dapat dilakukan oleh kopilot:

• ? Secara otomatis mengaktifkan kopilot yang relevan dengan aplikasi web tertentu. Misalnya, Mail Copilot dapat aktif ketika aplikasi web Mail dimuat di tab browser.
• ? Ekstrak informasi dari aplikasi web saat ini. Misalnya, kopilot dapat mengekstrak konten email saat ini, dari aplikasi web Mail, dan memberikan ringkasan email, atau pengguna dapat mengajukan pertanyaan tentang konten email.
• Berinteraksi dengan aplikasi web. Seorang kopilot dapat membuat badan surat berdasarkan permintaan pengguna. Itu juga bisa mengisi kolom formulir aplikasi web dengan data pengujian yang sesuai.
• ? Gunakan API layanan apa pun untuk mengekstrak informasi tambahan atau mengotomatiskan proses aplikasi web. Misalnya, kopilot bisa mengambil contoh yang valid dari backend aplikasi web untuk mengisi formulir frontend.
• Banyak ide dan kemampuan lain yang dapat dieksplorasi dengan menggabungkan ekstensi browser dengan kemampuan AI dan LLM.

Penggunaan

1. Instal ekstensi di browser Anda dengan mengunduh versi terbaru dari rilis. Untuk menginstal ekstensi dari file zip, Anda perlu membuka layar "Kelola Ekstensi" browser Anda, mengaktifkan mode pengembang, dan menarik dan melepas file zip ekstensi.
2. Buka ekstensi dengan mengklik ikonnya dan tambahkan kopilot baru dengan memberikan URL dasarnya. URL dasar harus sesuai dengan lokasi manifest.json dan logo.png , misalnya: http://localhost:8000 jika agen Anda berjalan secara lokal.
3. Mulai obrolan baru dengan mengklik kopilot yang dikonfigurasi, atau, jika kopilot memiliki aktivasi otomatis, cukup gunakan browser Anda dan obrolan kopilot akan otomatis muncul ketika kopilot diaktifkan.
4. Simpan perintah pilihan Anda langsung dari obrolan. Untuk mengaksesnya dengan cepat nanti, cukup ketik '/' di masukan obrolan.

Kapan saja, Anda dapat menutup kopilot untuk melanjutkan percakapan nanti dengan ikon ekstensi atau mengklik kanan halaman dan memilih Toggle Browser Copilot .

Jika Anda tidak mengetahui URL kopilot apa pun, proyek ini menyertakan implementasi kopilot sederhana di folder agen. Anda dapat memulainya dengan menyalin agent/sample.env ke agent/.env , mengubah variabel lingkungan di dalamnya, dan menjalankan docker-compose up (buruh pelabuhan diperlukan untuk ini). Setelah dimulai, Anda dapat mengonfigurasi ekstensi untuk menggunakannya dengan menambahkan kopilot dengan URL http://localhost:8000 .

Saat Anda mengaktifkan kopilot (klik pada daftar kopilot), ia akan meminta beberapa kredensial. Gunakan pengguna test dan kata sandi test untuk masuk.

Kedepannya kami berencana menambah katalog kopilot yang disumbangkan oleh komunitas. Oleh karena itu, jika Anda membuat kopilot baru, harap beri tahu kami agar kami dapat memasukkannya ke dalam katalog awal.

Perkembangan

Pengembangan Agen

Untuk mengembangkan agen baru, Anda dapat merujuk ke folder agent-mock, agent-simple, atau agent-extend. Yang terakhir adalah yang terlengkap dengan dokumentasi yang tepat tentang titik akhir dan manifest.json .

Untuk lingkungan pengembangan, proyek ini menggunakan devbox dan direnv.

Untuk menginstal semua dependensi yang diperlukan (setelah menginstal devbox dan direnv), jalankan perintah berikut:

devbox run install

Selanjutnya, tetapkan variabel lingkungan yang sesuai di agent-extended/.env .

Untuk mempercepat pengembangan, Anda dapat mengomentari bagian Keycloak, sehingga Anda tidak perlu melakukan autentikasi setiap kali ingin mencoba kopilot Anda di ekstensi. test Anda tidak mengomentari bagian Keycloak, maka Anda perlu menjalankan devbox run keycloak untuk menjalankan Keycloak untuk autentikasi dan menggunakan kredensial test untuk login (bila diminta oleh ekstensi browser).

Untuk menjalankan agen dalam mode pengembangan, mengaktifkan hot-reload otomatis setiap kali ada perubahan yang terdeteksi di file sumber agen, jalankan perintah berikut:

devbox run agent

Jika Anda ingin men-debug agen, Anda dapat memulai agen dengan IDE pilihan Anda, menunjuk ke lingkungan virtual relevan yang dibuat oleh devbox, dan menggunakan kemampuan debugger IDE untuk menjalankan skrip utama.

Untuk rincian lebih lanjut tentang agen, silakan merujuk ke readme-nya.

Pengembangan Ekstensi Browser

Jika Anda berencana untuk memberikan kontribusi perubahan pada ekstensi browser, rujuk ke folder ekstensi browser.

Untuk meluncurkan browser Chrome dengan kemampuan hot-reload, gunakan perintah berikut:

devbox run browser

Untuk mengubah pengaturan browser default, lihat browser-extension/vite.config.ts.

Untuk membangun distribusi akhir ekstensi, jalankan perintah berikut:

devbox run build

Berkontribusi

Kami menyambut segala jenis kontribusi!

• Berikan proyek ini bintang agar lebih terlihat oleh seluruh komunitas. Ini memberi tahu kami bahwa Anda tertarik dengan proyek ini, sehingga memotivasi kami untuk menginvestasikan lebih banyak upaya ke dalamnya.
• ? Sebarkan berita tentang proyek ini. Jika Anda membuat publikasi apa pun (tweet, sebutan StackOverflow, postingan LinkedIn, artikel Medium, dll.) tentang hal tersebut, harap beri tahu kami. Kami berencana untuk menambah referensi pada publikasi serupa di masa mendatang.
• ? Ajukan pertanyaan dan minta perbaikan dengan membuat masalah atau membuka diskusi di repositori.
• ?‍ Jika Anda menyukai coding, Anda dapat membuat agen baru, membantu kami mengimplementasikan fitur ekstensi browser atau peningkatan umum.