Skip to main content

에이전트를 사용하는 GitHub Copilot 확장에 대한 빠른 시작

GitHub Copilot Extensions의 개발 프로세스에 대해 알아보려면 GitHub의 Blackbeard 확장을 빌드하고 사용해 보세요.

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 에이전트를 웹앱으로 배포하는 대신 훨씬 더 빠른 빌드 프로세스를 위해 에이전트를 로컬로 호스트할 수 있습니다.

  1. VS Code에 기본 제공된 터미널을 사용하여 copilot-extensions/blackbeard-extension 리포지토리를 복제합니다.
  2. 동일한 터미널에서 npm install을 실행하여 필요한 종속성을 설치한 다음, npm start를 실행하여 포트 3000에서 Blackbeard 에이전트를 시작합니다.
  3. VS Code 패널의 "Ports" 탭에서 Forward a port 또는 Add port를 클릭한 다음, 포트 3000을 추가합니다.
  4. 포트를 마우스 오른쪽 단추로 클릭하고 표시 여부를 "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 앱 구성을(를) 참조하세요.

2. codespace에서 Blackbeard 에이전트 복제 및 호스트

Blackbeard 에이전트를 웹앱으로 배포하는 대신 훨씬 더 빠른 빌드 프로세스를 위해 에이전트를 codespace에서 호스트할 수 있습니다.

  1. copilot-extensions/blackbeard-extension 리포지토리로 이동합니다. Code 드롭다운 메뉴를 선택한 다음, Create codespace on main을 클릭합니다.
  2. 새 codespace을 찾으려면 Code 드롭다운 메뉴를 선택합니다. 새 codespace 옆에 있는 를 선택하고 Open in Browser를 클릭합니다.
  3. 통합 터미널에서 npm start를 실행하여 포트 3000에서 Blackbeard 에이전트를 시작합니다.
  4. VS Code 패널의 "Ports" 탭에서 Forward a port를 클릭한 다음, 포트 3000을 추가합니다.
  5. 포트를 마우스 오른쪽 단추로 클릭하고 표시 여부를 "Public"으로 설정한 다음, 로컬 주소를 복사합니다.

3. Blackbeard 확장 통합 및 테스트

GitHub App 및 Blackbeard 에이전트를 설정한 후 에이전트를 앱과 통합하고 Blackbeard 확장을 테스트할 수 있습니다. GitHub App 설정을 다음과 같이 변경해야 합니다.

  • "General" 설정의 "Callback URL" 필드에 에이전트에 전달된 주소를 붙여넣습니다.
  • "Permissions & events" 설정에서 Copilot Chat에 읽기 전용 권한을 부여합니다.
  • "Copilot" 설정에서 앱 유형을 "Agent"로 설정한 다음, 나머지 필드를 채웁니다.

GitHub App 설정을 업데이트한 후 지원되는 클라이언트 또는 IDE의 Copilot Chat 창에 @YOUR-EXTENSION-NAME을 입력한 다음, 정상적으로 프롬프트를 전송하여 확장과 채팅을 시작할 수 있습니다. 지원되는 클라이언트 및 IDE 목록은 Copilot 확장 빌드 정보을(를) 참조하세요.

Note

GitHub Codespaces에서 GitHub Copilot Extensions와의 채팅은 지원되지 않습니다.

자세한 지침은 Copilot 확장에 대한 GitHub 앱 구성을(를) 참조하세요.

2. Blackbeard 에이전트를 로컬로 복제 및 시작

Blackbeard 에이전트를 웹앱으로 배포하는 대신 훨씬 더 빠른 빌드 프로세스를 위해 에이전트를 로컬로 호스트할 수 있습니다.

  1. 명령줄 애플리케이션을 사용하여 copilot-extensions/blackbeard-extension 리포지토리를 복제합니다.
  2. npm install을 실행하여 필요한 종속성을 설치한 다음, npm start를 실행하여 포트 3000에서 Blackbeard 에이전트를 시작합니다.

3. 로컬 서버 노출

Blackbeard 에이전트를 Copilot 플랫폼 및 GitHub에 액세스할 수 있도록 하려면 HTTP 요청으로 연결할 수 있도록 로컬 서버를 노출해야 합니다. 이를 달성하기 위해 모든 포트 전달 또는 터널링 서비스를 사용할 수 있습니다. 다음 단계에서는 ngrok를 사용합니다.

  1. ngrok의 다운로드 페이지로 이동한 다음 운영 체제에 적합한 ngrok 버전을 설치합니다.

  2. ngrok 설정 및 설치 페이지로 이동한 다음, ngrok 계정에 로그인하거나 등록합니다.

  3. 로컬 서버를 노출하려면 명령줄 애플리케이션의 새 창에서 다음 명령을 실행합니다.

    Shell
    ngrok http http://localhost:3000
    
  4. 명령줄 애플리케이션에서 "전달" 옆에 ngrok가 서버에 할당한 URL을 복사합니다.

4. Blackbeard 확장 통합 및 테스트

GitHub App을 Blackbeard 에이전트와 통합하려면 앱 설정을 다음과 같이 변경해야 합니다.

  • "General" 설정의 "Callback URL" 필드에 노출된 서버의 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를 사용하면 확장 빌더가 핵심 기능을 만드는 데 더 집중하고 상용구 코드에 더 집중할 수 있습니다.