Note
GitHub Copilot Extensions은(는) 공개 미리 보기 버전이며 변경될 수 있습니다.
Blackbeard 확장은 Copilot의 LLM(대규모 언어 모델) API 및 특수 시스템 프롬프트를 사용하여 해적과 같은 요청에 응답하는 간단한 에이전트로 빌드된 GitHub Copilot Extension입니다. 이 가이드에서는 간단한 에이전트 구현을 사용하지만, 프로세스는 기술 세트와 비슷합니다.
이 빠른 시작은 Blackbeard 확장을 최대한 빨리 빌드하고 채팅할 수 있도록 설계되어 인프라를 배포하지 않고도 확장을 개발하고 테스트할 수 있습니다. 프로덕션의 경우 퍼블릭으로 액세스할 수 있는 서버에서 에이전트 또는 기술 세트의 엔드포인트에 대한 애플리케이션을 호스트해야 합니다. 새 GitHub Copilot Extension을 만드는 방법을 알아보려면 Copilot 확장 설정을(를) 참조하세요.
1. GitHub App을 만들고 설치하기
GitHub 계정의 개발자 설정에서 GitHub App을 만듭니다. GitHub App에는 반드시 다음이 있어야 합니다.
- 이름
- 홈페이지 URL
- 선택 취소된 웹후크
앱을 만든 후 사이드바에서 Install App을 클릭한 다음, 계정에 앱을 설치합니다.
자세한 지침은 Copilot 확장용 GitHub 앱 만들기을(를) 참조하세요.
2. Blackbeard 에이전트를 로컬로 복제 및 호스트
Blackbeard 에이전트를 웹앱으로 배포하는 대신 훨씬 더 빠른 빌드 프로세스를 위해 에이전트를 로컬로 호스트할 수 있습니다.
- VS Code에 기본 제공된 터미널을 사용하여
copilot-extensions/blackbeard-extension
리포지토리를 복제합니다. - 동일한 터미널에서
npm install
을 실행하여 필요한 종속성을 설치한 다음,npm start
를 실행하여 포트 3000에서 Blackbeard 에이전트를 시작합니다. - VS Code 패널의 "Ports" 탭에서 Forward a port 또는 Add port를 클릭한 다음, 포트 3000을 추가합니다.
- 포트를 마우스 오른쪽 단추로 클릭하고 표시 여부를 "Public"으로 설정한 다음, 로컬 주소를 복사합니다.
3. Blackbeard 확장 통합 및 테스트
GitHub App 및 Blackbeard 에이전트를 설정한 후 에이전트를 앱과 통합하고 Blackbeard 확장을 테스트할 수 있습니다. GitHub App 설정을 다음과 같이 변경해야 합니다.
- "General" 설정의 "Callback URL" 필드에 에이전트의 로컬 주소를 붙여넣습니다.
- "Permissions & events" 설정에서 Copilot Chat에 읽기 전용 권한을 부여합니다.
- "Copilot" 설정에서 앱 유형을 "Agent"로 설정한 다음, 나머지 필드를 채웁니다.
GitHub App 설정을 업데이트한 후 Copilot Chat 창에 @YOUR-EXTENSION-NAME
을 입력한 다음, 정상적으로 프롬프트를 전송하여 확장과 채팅을 시작할 수 있습니다.
자세한 지침은 Copilot 확장에 대한 GitHub 앱 구성을(를) 참조하세요.
다음 단계
이제 작동 중인 GitHub Copilot Extension이 있으므로 Blackbeard 에이전트를 기반으로 빌드하여 에이전트 개발을 실험해 볼 수 있습니다.
더 복잡한 에이전트 구현에 대해 알아보려면 copilot-extensions
조직에서 모두 사용할 수 있는 다음 예제 에이전트 및 SDK(소프트웨어 개발 키트)를 검토할 수도 있습니다.
- GitHub Models: Copilot Chat 내에서 GitHub Marketplace에 나열된 다양한 LLM에 대해 질문하고 상호 작용할 수 있는 더 복잡한 에이전트입니다. GitHub Models 에이전트는 함수 호출을 사용합니다.
- 함수 호출: 함수 호출 및 확인 대화 상자를 보여 주는 Go로 작성된 예제 에이전트입니다.
- RAG 확장: 검색 보강 생성의 간단한 구현을 보여 주는 Go로 작성된 예제 에이전트입니다.
- 미리 보기 SDK: 요청 확인, 페이로드 구문 분석 및 응답 형식을 자동으로 처리하여 Copilot Extensions의 개발을 간소화하는 SDK입니다. 이 SDK를 사용하면 확장 빌더가 핵심 기능을 만드는 데 더 집중하고 상용구 코드에 더 집중할 수 있습니다.