엔터프라이즈 관리 설정 시작

엔터프라이즈 관리 설정을 사용하면 지원되는 클라이언트에 대한 GitHub Copilot 구성 설정을 중앙에서 정의하고 배포할 수 있습니다. 이렇게 하면 모든 사용자가 정의한 가드레일 내에서 작업할 수 있으며, 다른 팀에 대한 설정을 특수화할 수 있습니다. 예를 들어 에이전트가 중요한 작업을 수행하지 못하도록 차단하거나, 승인된 에이전트 플러그 인을 설치하거나, 세션이 샌드박스에서 실행되는지 확인할 수 있습니다.

이 가이드에서는 managed-settings.json에서 GitHub 파일을 만들고, 설정을 사용자에게 배포하며, 엔터프라이즈 팀의 특정 설정을 재정의하는 방법을 안내합니다. 마찰이 적은 예제에서는 대부분의 사용자에 대한 자동 모델 모드에서 새 대화가 시작되도록 하고 특정 엔터프라이즈 팀에 대해 이 설정을 재정의합니다. 이 예제에서는 사용자에게 중단을 일으키지 않고 관리되는 설정 배포를 테스트할 수 있습니다.

지원되는 클라이언트

모든 클라이언트가 모든 속성을 지원하는 것은 아니지만 다음 클라이언트가 지원됩니다.

• Copilot CLI
• VS Code
• GitHub Copilot app입니다.
• Copilot cloud agent
• JetBrains IDEs

지원되는 키에 대한 전체 참조는 엔터프라이즈 관리 설정을 참조하세요.

1. 리포지토리 만들기 .github-private

엔터프라이즈의 managed-settings.json``.github-private 지정된 조직이 소유한 리포지토리에서 파일을 호스트할 수 있습니다. 이렇게 하면 엔터프라이즈 구성원이 볼 수 있는 위치에 사용자 지정 에이전트 프로필 옆에 관리되는 설정을 유지할 수 있습니다.

리포지토리를 만들고 엔터프라이즈의 클라이언트 거버넌스 원본으로 선택하는 방법에 대한 지침은 .github-private 리포지토리 만들기을 참조하세요.

이 리포지토리의 거버넌스 설정은 사용자가 귀하의 엔터프라이즈 또는 그 산하 조직으로부터 .github-private 라이선스를 받고, 해당 사용자가 Copilot 리포지토리 또는 이를 소유한 조직에 액세스할 수 있는지 여부와 관계없이 모든 사용자에게 적용됩니다. 엔터프라이즈 구성원이 거버넌스 설정을 볼 수 있도록 리포지토리 내부 가시성을 제공하고 파일 편집을 managed-settings.json 관리자 및 AI 관리자로 제한하는 것이 좋습니다.

2. 파일 만들기 managed-settings.json

이 예제에서는 사용자의 대화가 자동 모드에서 시작되도록 하는 매우 간단한 구성을 사용합니다. 즉 Copilot , 엔터프라이즈의 허용 모델에서 사용자 작업에 가장 적합한 모델을 자동으로 선택하여 사용자의 속도 제한 문제를 줄입니다.

1. .github-private 리포지토리에서 copilot/managed-settings.json에 파일을 만듭니다.

2. 파일에 구성을 추가합니다. 다음은 그 예입니다.

   JSON

   {
     "model": "auto"
   }
   

3. 변경 사항을 기본 브랜치에 커밋하세요.

실제 롤아웃의 경우 클라이언트에서 지원되는 키와 해당 범위를 확인합니다. 엔터프라이즈 관리 설정을(를) 참조하세요.

3. 특정 팀에 대한 설정 재정의

엔터프라이즈 팀의 경우 managed-settings.json 파일의 지원되는 속성을 재정의할 수 있습니다. 이 예제에서는 특수 작업을 위해 특정 모델을 고수해야 하는 팀의 자동 모델 기본값을 사용하지 않도록 설정합니다.

이 섹션 .github-private 을 완료하면 리포지토리의 구조는 다음과 같습니다.

• .github-private/
  • copilot/

    ---

managed-settings.json **: { "model": { "overridable": "auto" } } * ** team-mappings.json **: { "no-auto.json": ["special-team"] } * teams/ * ** no-auto.json **: { "model": "unmanaged" }

단계

1. 자동 모드 기본값을 받지 않아야 하는 사용자를 포함하는 엔터프라이즈 팀을 만듭니다. 이 예제에서는 호출합니다 special-team. 엔터프라이즈 팀 만들기을(를) 참조하세요.

2. copilot/managed-settings.json 파일에서 { "overridable": VALUE } 구문을 사용하여 키를 재정의 가능으로 표시합니다. 팀 VALUE 파일이 지정된 키에 대해 다른 값을 선언하지 않는 경우 기본값입니다.

   예를 들어, 엔터프라이즈 팀의 경우 auto을(를) 재정의할 수 있도록 하고, 다른 모든 사용자에게는 model이(가) 기본값으로 유지되도록 할 것입니다:

   JSON

   {
     "model": { "overridable": "auto" }
   }
   

3. .github-private 리포지토리에서 copilot/teams/ 아래에 엔터프라이즈 팀용 전용 설정 파일을 만드세요. 예: copilot/teams/no-auto.json.

   이 파일에서 재정의 가능한 속성에 대한 값을 제공하는 구성을 추가합니다.

   다음 예제에서는 자동 모델 모드에서 컨트롤을 제거합니다. 그 외의 모든 항목은 사용자의 managed-settings.json 파일에 의해 관리됩니다.

   JSON

   {
     "model": "unmanaged"
   }
   

4. .github-private 리포지토리에서 copilot/team-mappings.json을 만드세요. 이 파일에서 엔터프라이즈 팀의 이름을 특수 구성 파일에 매핑합니다. 키는 설정 파일 이름이며 값은 팀 슬러그 배열이므로 여러 팀에 하나의 파일을 적용할 수 있습니다.

   JSON

   {
     "no-auto.json": ["special-team"]
   }
   

5. 변경 내용을 커밋하고 기본 분기로 푸시합니다.

나중에 다른 키 및 다른 팀에 대해 다른 재정의를 추가할 수 있습니다. 자세한 예제는팀에 대한 엔터프라이즈 관리 설정 재정의을 참조하세요.

4. 설정이 활성 상태인지 확인

정의한 설정이 사용자에 대해 활성 상태이고 특정 팀에 대해 재정의되는지 확인합니다. 이 예제에서는 대부분의 엔터프라이즈 사용자가 클라이언트의 Copilot 새 대화가 자동 모드에서 시작된다는 것을 알아야 합니다. 엔터프라이즈 팀에는 special-team 이러한 경험이 없어야 합니다.

서버 관리형 배포의 경우 지원되는 클라이언트의 사용자는 약 1시간 이내에 지정된 설정을 볼 수 있습니다. 여기에는 copilot/managed-settings.json, copilot/team-mappings.json, 및 copilot/teams/의 파일이 포함됩니다. 클라이언트를 다시 시작하거나 다시 로그인하면 즉시 새로 고침이 트리거됩니다.

사용자에게 이러한 설정이 표시되지 않는 경우, 해당 사용자가 귀하의 엔터프라이즈 또는 그 조직 중 하나를 통해 Copilot에 대한 액세스 권한을 받도록 확인하세요. 사용자가 여러 청구 엔터티로부터 라이선스를 받는 경우 개인 Copilot 설정의 "청구된 사용량" 드롭다운에서 엔터프라이즈를 선택했는지 확인합니다.

MDM 관리형 배포의 경우 클라이언트는 매시간 업데이트된 정책을 확인합니다. 파일 기반 배포의 경우 클라이언트를 다시 시작하여 업데이트된 파일을 로드합니다. 이러한 배포 방법은 라이선스의 원본 위치에 관계없이 컴퓨터에 설치된 설정이 있는 Copilot 모든 사용자에게 적용됩니다.

다음 단계:

이제 간단한 관리 설정 설정을 만들었으므로 다음을 수행할 수 있습니다.

• 파일에 거버넌스 속성을 추가합니다. 엔터프라이즈 관리 설정을(를) 참조하세요.
• 다른 방법을 통해 사용자에게 설정을 배포할지 여부를 결정합니다. 사용자에게 엔터프라이즈 관리 설정을 배포하는 방법 선택을(를) 참조하세요.