Copilot 확장 설정

다음 단계에 따라 Copilot Extensions을(를) 빌드하기 시작합니다.

Tool navigation

이 문서의 내용

이 문서는 완전히 새로운 GitHub Copilot Extension을 구축하는 데 도움을 주기 위해 설계되었습니다. 대신 GitHub에서 만든 데모 Copilot Extension을 빠르게 빌드하고 테스트하는 방법을 알아보려면 에이전트를 사용하는 GitHub Copilot 확장에 대한 빠른 시작을(를) 참조하세요.

기술 세트와 에이전트는 Copilot Extensibility Platform를 통해 Copilot의 기능과 컨텍스트를 확장하는 두 가지 방법입니다. 외부 서비스와 API를 Copilot Chat에 통합할 수 있지만 각각 다른 사용 사례를 제공하고 다양한 수준의 제어와 복잡성을 제공합니다.

  • 기술 세트는 Copilot가 최소한의 설정으로 특정 작업(예: 데이터 검색이나 간단한 작업)을 수행해야 하는 개발자를 위해 가볍고 간소화되었습니다. 라우팅, 프롬프트 작성, 함수 평가, 응답 생성을 자동으로 처리하므로 빠르고 간단한 통합에 적합합니다. 기술 세트에 대한 자세한 내용은 Copilot 기술 세트 정보을(를) 참조하세요.
  • 에이전트는 요청이 처리되고 응답이 생성되는 방식을 완전히 제어해야 하는 복잡한 통합을 위한 것입니다. 사용자 지정 논리를 구현하고, 다른 LLM 및/또는 Copilot API와 통합하고, 대화 컨텍스트를 관리하고, 사용자 상호 작용의 모든 측면을 처리할 수 있습니다. 에이전트는 더 많은 엔지니어링과 유지 관리가 필요하지만, 정교한 워크플로를 위한 최대 유연성을 제공합니다. 에이전트에 대한 자세한 내용은 Copilot 에이전트 정보을(를) 참조하세요.

1. Copilot agents에 대해 알아보기

Copilot agents에는 Copilot Extension에 대한 사용자 지정 코드가 포함되어 있으며 GitHub App와 통합하여 Copilot Extension 자체를 형성합니다. 자세한 내용은 Copilot 에이전트 정보을(를) 참조하세요.

Copilot agent을(를) 성공적으로 빌드하려면 에이전트가 다음과 통신하는 방법을 이해해야 합니다.

2. 예제 Copilot agents and the Copilot Extensions SDK 검토

이전 개념을 실제로 확인하고 에이전트 구현에 대해 알아보려면 copilot-extensions 조직에서 사용할 수 있는 다음 예제 에이전트 및 SDK(소프트웨어 개발 키트)를 검토합니다.

  • Blackbeard (최상의 시작점): Copilot의 LLM(대규모 언어 모델) API 및 특수 시스템 프롬프트를 사용하여 해적과 같은 요청에 응답하는 간단한 에이전트입니다.
  • GitHub Models: Copilot Chat 내에서 GitHub Marketplace에 나열된 다양한 LLM에 대해 질문하고 상호 작용할 수 있는 더 복잡한 에이전트입니다. GitHub Models 에이전트는 함수 호출을 사용합니다.
  • 함수 호출: 함수 호출 및 확인 대화 상자를 보여 주는 Go로 작성된 예제 에이전트입니다.
  • RAG 확장: 검색 보강 생성의 간단한 구현을 보여 주는 Go로 작성된 예제 에이전트입니다.
  • 미리 보기 SDK: 요청 확인, 페이로드 구문 분석 및 응답 형식을 자동으로 처리하여 Copilot Extensions의 개발을 간소화하는 SDK입니다. 이 SDK를 사용하면 확장 빌더가 핵심 기능을 만드는 데 더 집중하고 상용구 코드에 더 집중할 수 있습니다.

3. Copilot agent 빌드

이전 단계의 참조 자료를 사용하여 Copilot agent을(를) 계획하고 빌드합니다. 다음 옵션 중 하나를 선택하여 실행할 수 있습니다.

4. Copilot agent 배포

Copilot agent을(를) Copilot 플랫폼 및 GitHub에 액세스할 수 있도록 하려면 HTTP 요청으로 연결할 수 있는 서버에 배포해야 합니다. Copilot 확장을 호스트하도록 서버 구성을(를) 참조하세요.

5. GitHub App을(를) 만들고 Copilot agent과(와) 통합합니다.

Copilot Extension을(를) 만들려면 GitHub App을(를) 만들고 구성한 다음 Copilot agent와 통합해야 합니다. Copilot 확장용 GitHub 앱 만들기 및 Copilot 확장에 대한 GitHub 앱 구성을(를) 참조하세요.

6. Copilot Extension의 가용성 선택

Copilot Extension에 대한 두 가지 표시 여부 수준 중 하나를 선택합니다.

  • 공개: 확장에 대한 설치 페이지 링크가 있는 모든 사용자 또는 조직 계정을 설치할 수 있습니다.
  • 비공개: 확장을 만든 사용자 또는 조직 계정만 설치할 수 있습니다.

Copilot Extension을(를) 공개로 설정하는 경우 GitHub Marketplace의 목록에 올리도록 선택할 수 있습니다.

Copilot Extension의 표시 여부를 변경하고 GitHub Marketplace에 나열하는 방법을 알아보려면 Copilot 확장의 가용성 관리을(를) 참조하세요.

다음 단계

Copilot Extension를 사용하는 방법을 알아보려면 확장을 사용하여 외부 도구를 Copilot 채팅과 통합을(를) 참조하세요.

1. Github Copilot skillsets에 대해 알아보기

Github Copilot skillsets에는 Copilot Extension에 대한 사용자 지정 코드가 포함되어 있으며 GitHub App과 통합하여 Copilot Extension 자체를 형성합니다.

Copilot agents과 달리 Copilot skillsets는 프롬프트 작성, 함수 평가, 응답 생성의 논리를 처리하므로 최소한의 노력으로 빠르고 효과적인 통합을 추구하는 개발자에게 이상적인 선택입니다. 자세한 내용은 Copilot 기술 세트 정보을(를) 참조하세요.

2. Copilot skillset 빌드

기술 세트 구현의 예를 살펴보려면 copilot-extensions 조직의 skillset-example 리포지토리를 참조하세요.

기술 세트를 빌드하려면 Copilot 기술 세트 빌드을(를) 참조하세요.

3. Copilot skillset 배포

Copilot skillset를 Copilot 플랫폼 및 GitHub에 액세스할 수 있도록 하려면 HTTP 요청으로 연결할 수 있는 서버에 배포해야 합니다. Copilot 확장을 호스트하도록 서버 구성을(를) 참조하세요.

4. GitHub App 만들기 및 Copilot skillset와 통합

Copilot Extension을 만들려면 GitHub App을 만들고 구성한 다음, Copilot skillset와 통합해야 합니다. Copilot 확장용 GitHub 앱 만들기 및 Copilot 확장에 대한 GitHub 앱 구성을(를) 참조하세요.

5. Copilot skillset의 가용성 선택

Copilot Extension에 대한 두 가지 표시 여부 수준 중 하나를 선택합니다.

  • 공개: 확장에 대한 설치 페이지 링크가 있는 모든 사용자 또는 조직 계정을 설치할 수 있습니다.
  • 비공개: 확장을 만든 사용자 또는 조직 계정만 설치할 수 있습니다.

Copilot Extension을(를) 공개로 설정하는 경우 GitHub Marketplace의 목록에 올리도록 선택할 수 있습니다.

Copilot Extension의 표시 여부를 변경하고 GitHub Marketplace에 나열하는 방법을 알아보려면 Copilot 확장의 가용성 관리을(를) 참조하세요.

다음 단계

Copilot Extension를 사용하는 방법을 알아보려면 확장을 사용하여 외부 도구를 Copilot 채팅과 통합을(를) 참조하세요.