에이전트를 사용하는 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를 사용하면 확장 빌더가 핵심 기능을 만드는 데 더 집중하고 상용구 코드에 더 집중할 수 있습니다.