Browser Copilot은 기존 또는 맞춤형 AI 도우미를 사용하여 일상적인 웹 애플리케이션 작업에 도움을 줄 수 있는 브라우저 확장입니다.
목표는 계속 증가하는 부조종사(AI 보조자) 세트를 구현하고 사용할 수 있는 다목적 UI와 간단한 프레임워크를 제공하는 것입니다. 이러한 부조종사는 브라우저 확장 기능을 활용하여 광범위한 작업에 도움을 줄 수 있습니다.
다음은 이러한 부조종사가 수행할 수 있는 작업에 대한 몇 가지 예입니다.
manifest.json
및 logo.png
의 위치와 일치해야 합니다. 예를 들어 에이전트가 로컬에서 실행 중인 경우 http://localhost:8000
입니다. 언제든지 확장 아이콘을 사용하거나 페이지를 마우스 오른쪽 버튼으로 클릭하고 Toggle Browser Copilot
선택하여 부조종사를 닫고 나중에 대화를 재개할 수 있습니다.
부조종사 URL을 모르는 경우 이 프로젝트에는 에이전트 폴더에 간단한 부조종사 구현이 포함되어 있습니다. Agent/sample.env를 agent/.env
에 복사하고 환경 변수를 변경한 후 docker-compose up
실행하여 시작할 수 있습니다(이를 위해서는 docker가 필요함). 일단 시작되면 http://localhost:8000
URL을 사용하여 부조종사를 추가하여 이를 사용하도록 확장을 구성할 수 있습니다.
부조종사를 활성화하면(부조종사 목록 클릭) 일부 자격 증명이 요청됩니다. test
사용자와 test
비밀번호를 사용하여 로그인하세요.
앞으로는 커뮤니티에서 제공하는 부조종사 카탈로그를 추가할 계획입니다. 따라서 새로운 부조종사를 생성하는 경우 초기 카탈로그에 포함할 수 있도록 알려 주시기 바랍니다 .
새 에이전트를 개발하려면 에이전트-모의, 에이전트-단순 또는 에이전트 확장 폴더를 참조할 수 있습니다. 후자는 끝점 및 manifest.json
에 대한 적절한 문서가 포함된 가장 완전한 것입니다.
개발 환경으로는 devbox와 direnv를 사용합니다.
필요한 모든 종속성을 설치하려면(devbox 및 direnv 설치 후) 다음 명령을 실행하십시오.
devbox run install
다음으로, agent-extended/.env
에서 적절한 환경 변수를 설정하십시오.
개발 속도를 높이기 위해 Keycloak 섹션을 주석 처리할 수 있으므로 확장에서 부조종사를 시도할 때마다 인증할 필요가 없습니다. 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
우리는 모든 종류의 기여를 환영합니다!