Copilot 확장 빌드 정보
Copilot 확장 are integrations that expand the functionality of Copilot Chat, allowing developers to bring external tools, services, and custom behaviors into the Chat experience. You can use Copilot 확장 to extend the capabilities of Copilot Chat in a variety of ways, including:
- Querying documentation: A Copilot 확장 can allow Copilot Chat to query a third-party documentation service to find information about a specific topic.
- AI-assisted coding: A Copilot 확장 can use a third-party AI model to provide code suggestions.
- Data retrieval: A Copilot 확장 can allow Copilot Chat to query a third-party data service to retrieve information about a specific topic.
- Action execution: A Copilot 확장 can allow Copilot Chat to execute a specific action, such as posting to a message board or updating a tracking item in an external system.
GitHub Copilot 확장 are built with GitHub Apps. They are best suited for developers who want cross-platform compatibility and app management and support from GitHub.
기술 세트 및 에이전트 정보
기술 세트와 에이전트는 Copilot 확장성 플랫폼을 통해 Copilot의 기능과 컨텍스트를 확장하는 두 가지 방법입니다. 외부 서비스와 API를 Copilot Chat에 통합할 수 있지만 각각 다른 사용 사례를 제공하고 다양한 수준의 제어와 복잡성을 제공합니다.
- 기술 세트는 Copilot가 최소한의 설정으로 특정 작업(예: 데이터 검색이나 간단한 작업)을 수행해야 하는 개발자를 위해 가볍고 간소화되었습니다. 라우팅, 프롬프트 작성, 함수 평가, 응답 생성을 자동으로 처리하므로 빠르고 간단한 통합에 적합합니다. 기술 세트에 대한 자세한 내용은 GitHub Copilot 확장용 기술 세트 정보을(를) 참조하세요.
- 에이전트는 요청이 처리되고 응답이 생성되는 방식을 완전히 제어해야 하는 복잡한 통합을 위한 것입니다. 사용자 지정 논리를 구현하고, 다른 LLM 및/또는 Copilot API와 통합하고, 대화 컨텍스트를 관리하고, 사용자 상호 작용의 모든 측면을 처리할 수 있습니다. 에이전트는 더 많은 엔지니어링과 유지 관리가 필요하지만, 정교한 워크플로를 위한 최대 유연성을 제공합니다. 에이전트에 대한 자세한 내용은 GitHub Copilot 확장용 에이전트 정보을(를) 참조하세요.
컨텍스트 전달 정보
Copilot 확장는 GitHub App 설정에서 "Copilot Editor Context" 권한에 읽기 전용 액세스 수준을 사용하도록 설정하여 현재 열려 있는 파일과 같은 편집기에서 컨텍스트를 수신하도록 허용할 수 있습니다. GitHub App 구성의 10단계를 참조하세요.
암시적 컨텍스트와 명시적 컨텍스트를 사용할 수 없거나 권한이 없는 경우 GitHub Copilot 확장성 플랫폼은 자동으로 메시지를 처리합니다. 컨텍스트 전달을 사용하도록 설정하려면 사용자의 권한을 요청해야 합니다. 컨텍스트 전달을 사용하도록 설정하려면 다음을 수행해야 합니다.
- 새 참조 형식을 처리하도록 API를 업데이트합니다.
- 사용자에게 사용 권한을 요청합니다. 사용 권한을 요청할 때 다음 모범 사례를 따릅니다.
- 필요한 컨텍스트와 사용 용도를 명확하게 전달합니다.
- 사용자 고유의 애플리케이션 논리와 API가 호출하는 사용할 수 없는 컨텍스트에 대한 적절한 오류 처리를 구현합니다.
- 컨텍스트를 사용할 수 없는 경우 이 데이터 없이 가능한 경우 값을 제공합니다.
- 확장에 필요한 최소 권한만 요청합니다.
컨텍스트 전달은 .
로 시작하는 파일을 포함하여 컨텍스트 제외 설정에 나열된 모든 파일을 참조하는 콘텐츠 제외를 적용합니다.
컨텍스트 전달에 대한 자세한 내용은 에이전트에 대한 컨텍스트 전달을(를) 참조하세요.
GitHub Copilot 확장의 API 사용
GitHub Copilot 확장를 빌드하려면 GitHub API를 사용해야 합니다. 필요에 따라 Copilot API를 추가 기능에 사용할 수 있습니다. 요청 및 응답 형식에 대한 자세한 내용은 OpenAI API 문서를 참조하세요.
참고 항목
Copilot API는 Copilot 확장 작성기에서 사용할 수 있지만, GitHub Apps 및 VS Code 채팅 확장은 이러한 엔드포인트에 액세스하는 데 사용할 수 있습니다.
GitHub Copilot 확장 빌드 리소스
GitHub은(는) 코드 샘플, CLI 디버깅 도구, 빠른 시작 SDK 및 사용자 피드백 리포지토리와 함께 확장 빌더를 위한 종합 도구 키트를 제공합니다. 자세한 내용은 GitHub의 Copilot 확장 조직을 참조하세요.
자체 GitHub Copilot 확장을 처음부터 만들기 전에 기존 Copilot 에이전트를 탐색하고 GitHub App과 통합하여 작동 방식을 확인할 수 있습니다. GitHub는 다음을 포함하여 사용자 고유의 GitHub Copilot 확장을 기준으로 복제하고 사용할 수 있는 몇 가지 예제 Copilot 에이전트를 제공합니다.
-
Blackbeard: Copilot 에이전트의 LLM API 및 특수 시스템 프롬프트를 사용하여 해적과 같은 요청에 응답하는 간단한 입니다. GitHub Copilot 확장을 빌드하는 방법을 배우기 위한 좋은 시작점입니다. 자세한 내용은 Blackbeard Copilot 확장을 참조하세요.
-
GitHub Models: Copilot Chat 내에서 GitHub Marketplace에 나열된 다양한 LLM에 대해 질문하고 상호 작용할 수 있는 더 복잡한 Copilot 에이전트입니다. 자세한 내용은 GitHub Models Copilot 확장을 참조하세요.
참고 항목
GitHub Models은(는) 공개 미리 보기 버전이며 변경될 수 있습니다.
-
함수 호출: 함수 호출 및 확인 대화 상자를 보여 주는 Go로 작성된 예제 에이전트입니다. 자세한 내용은 함수 호출 확장을 참조하세요.
-
RAG 확장: 검색 보강 생성의 간단한 구현을 보여 주는 Go로 작성된 예제 에이전트입니다. 자세한 내용은 RAG 확장을 참조하세요.
-
미리 보기 SDK: 요청 확인, 응답 형식 지정, API 상호 작용을 처리하여 GitHub Copilot 확장를 빌드하는 프로세스를 간소화하는 SDK입니다. 이를 통해 작성자는 도구, API 및 데이터 원본을 Copilot Chat에 통합하여 상용구가 아닌 확장의 핵심 기능에 집중할 수 있습니다. 자세한 내용은 미리보기 SDK을(를) 참조하세요.
Copilot 지원 VS Code 채팅 참가자 빌드 정보
참고 항목
GitHub 설명서는 Copilot 지원 VS Code 채팅 참가자가 아닌 GitHub Copilot 확장를 구축하는 데 중점을 둡니다.
Copilot 지원 VS Code 채팅 참가자라는 이름의 Visual Studio Code 전용 네이티브 Copilot 확장을 구축할 수도 있습니다.
GitHub Copilot 확장 및 Copilot 지원 VS Code 채팅 참가자 채팅 참가자는 동일한 백엔드 플랫폼을 사용하여 요청을 확장으로 라우팅합니다. 두 제품 모두 비슷한 최종 사용자 환경을 제공하고, Copilot Chat와 통합되며, Copilot API나 기타 LLM을 활용할 수 있습니다.
이들은 유사점을 공유하지만 주요 차이점은 다음과 같습니다.
- GitHub Copilot 확장는 확장이 지원되는 모든 편집기에서 사용할 수 있는 반면, Copilot 지원 VS Code 채팅 참가자는 Visual Studio Code에서만 사용할 수 있습니다.
- GitHub Copilot 확장는 서버 측 확장이므로, 서버 인프라를 빌드해야 합니다. 이러한 확장은 조직 관리자가 설정한 대로 GitHub 작업 공간에 대한 기본 연결을 제공합니다.
- Copilot 지원 VS Code 채팅 참가자는 VS Code의 기능과 API에 대해 더 많은 액세스 권한이 있는 클라이언트 쪽 확장으로, 로컬 워크스페이스 데이터 액세스, Visual Studio Code 인터페이스 조작, 로컬 파일에 대한 읽기/쓰기 액세스 등 편집기별 상호 작용이 더 많이 가능합니다. 서버 인프라가 필요하지 않습니다.
- Copilot 지원 VS Code 채팅 참가자는 사용자 컴퓨터에 로컬이므로 GitHub.com에서 조직 또는 엔터프라이즈의 Copilot 정책을 통해 제어할 수 없습니다.
- Copilot 지원 VS Code 채팅 참가자는 GitHub Marketplace가 아닌 VS Code Marketplace에 게시됩니다.
Copilot 지원 VS Code 채팅 참가자는 VS Code 특정 API 및 기능을 사용하는 확장을 구축하거나 기존 VS Code 확장자를 확장하려는 개발자에게 가장 적합합니다.
Copilot 지원 VS Code 채팅 참가자에 대한 자세한 내용은 Visual Studio Code 문서에서 채팅 확장을 참조하세요.
Copilot 확장에 대한 배상
Copilot 확장는 GitHub Copilot의 배상 정책에 포함되지 않습니다. 하지만 이 제외 는 확장 채팅 스레드 내에서 발생하는 문제에만 적용됩니다.
확장을 설치하고 사용해도 코드 완성, 채팅 등 다른 Copilot 기능을 사용하는 동안 발생하는 문제에 대한 배상 범위에는 영향을 미치지 않습니다.