Copilot 모델이 안 보일 때, 조직·기업 정책을 확인하는 순서

조직의 허용보다 기업의 잠금부터 확인한다

회사 Copilot에서 원하는 모델이 보이지 않는다면, 조직 소유자가 그 모델을 바꿀 수 있는 상태인지부터 확인해야 한다. GitHub의 조직 모델 관리 안내에 따르면 기업이 강제한 Enabled·Disabled 설정은 조직에서 변경할 수 없다. 기업이 결정을 위임한 모델이어야 조직의 드롭다운으로 허용 여부를 고를 수 있다.

확인 위치는 조직의 Settings → Copilot → Models다. 기업 관리자는 기업의 AI controls → Copilot → Configure models에서 상위 설정을 확인한다. 조직 관리자가 변경할 수 없는 항목이라면 같은 화면에서 재시도하기보다 기업 관리자에게 그 모델의 위임 여부를 확인하는 편이 맞다.

GitHub는 10월 19일 모델 정책 REST API를 일반 제공했다. 기업·조직·기업 팀·에이전트 앱의 정책을 조회하고 갱신할 수 있어, 여러 관리 화면에 나뉜 값을 프로그램으로 대조할 수 있게 됐다.

팀 모드로 전환했다면 조직 설정을 바꿔도 해결되지 않는다

기업 팀 기반 모델 접근은 선택적으로 참여하는 프리뷰다. 이 모드에서는 조직 단위 모델 설정이 비활성화된다. API의 일반 제공과 팀 모드의 프리뷰 상태는 구분해야 한다.

팀의 허용 목록은 기업이 정한 공통 허용 범위에 더해진다. 기업이 막은 모델을 팀이 다시 켤 수는 없다. 사용자가 여러 기업 팀에 속하면 어느 한 팀에서 허용한 모델도 사용할 수 있으므로, 팀 하나의 설정만 보고 접근 가능 여부를 판단하면 빠뜨리는 조건이 생긴다.

전환 전에는 조직에 위임한 모델을 어느 팀에 허용할지 준비해야 한다. 기존 조직 위임 모델은 팀에 허용하기 전까지 사용할 수 없다는 것이 GitHub의 마이그레이션 안내다. 전환 직후 모델이 사라졌다면 이 부분이 확인 대상이다.

조직 응답과 팀 응답은 읽는 법이 다르다

정책 API를 대조할 때는 응답의 범위를 함께 기록해야 한다. 조직 API는 명시 설정과 기본 가용성을 반영한 모델별 유효 정책을 반환한다. 반면 기업 팀 API에는 팀 정책과 기업 정책, 변경 가능 여부가 함께 나온다.

팀의 optional을 ‘사용자에게 허용됨’으로 번역하면 안 된다. 수정 가능한 모델에 팀이 값을 지정하지 않은 상태를 나타낼 수 있다. GitHub도 팀 API의 상태가 사용자 개인의 최종 접근 판정은 아니라고 명시한다.

조회 결과의 모델 ID로 필요한 범위만 바꾼다

조직 모드라면 GET /orgs/ORG/copilot/model-policies로 현재 정책을 읽고, 변경 요청에는 그 응답에 나온 model_name을 사용한다. 기업에서 상속한 잠긴 정책은 조직 PATCH로 수정할 수 없다. 조직 변경 요청은 묶음 전체가 함께 적용되므로 한 항목이 적용 불가능하면 다른 항목도 저장되지 않는다.

조회에도 관리자 권한이 필요하다. 조직 API는 조직 소유자를 대상으로 하며, 세분화된 토큰에는 조직 Administration 쓰기 권한을 요구한다. 단순 GET이라는 이유로 일반 읽기 토큰을 사용하면 정책 내용에 도달하기 전에 권한 문제부터 만나게 된다.

운영 점검 순서는 기업의 강제 설정, 조직·팀 관리 모드, 해당 범위의 정책 응답 순으로 잡을 수 있다. 변경 뒤에는 같은 범위를 다시 조회하고 실제 사용자의 소속과 모델 선택기를 확인한다. 팀 응답 하나를 전체 사용자의 접근 목록으로 저장하지 않는 것이 핵심이다.