{"meta":{"title":"GitHub Copilot 클라우드 에이전트용 가드레일 빌드","intro":"안전하고 규정을 준수하는 환경에서 작동할 수 있도록 Copilot cloud agent 엔터프라이즈를 구성합니다.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ko/copilot","title":"GitHub Copilot"},{"href":"/ko/copilot/tutorials","title":"자습서"},{"href":"/ko/copilot/tutorials/cloud-agent","title":"클라우드 에이전트"},{"href":"/ko/copilot/tutorials/cloud-agent/build-guardrails","title":"가이드라인 구축"}],"documentType":"article"},"body":"# GitHub Copilot 클라우드 에이전트용 가드레일 빌드\n\n안전하고 규정을 준수하는 환경에서 작동할 수 있도록 Copilot cloud agent 엔터프라이즈를 구성합니다.\n\nCopilot cloud agent를 사용하기 전에, Copilot가 안전하고 예측 가능한 가드레일 내에서 작동할 수 있도록 엔터프라이즈를 미리 설정하는 것이 좋습니다.\n\n## 기본 제공 보호에 대해 알아보기\n\nCopilot cloud agent 에는 AI 에이전트의 일반적인 위험 지점으로부터 보호하도록 설계된 강력한 기본 제공 보안 보호 기반이 있습니다.\n[GitHub Copilot 클라우드 에이전트에 대한 위험 및 완화](/ko/copilot/concepts/agents/cloud-agent/risks-and-mitigations)을(를) 참조하세요.\n\n## 정책 설정 계획\n\nCopilot cloud agent의 정책을 미리 계획하세요. 정책을 사용하면 엔터프라이즈 수준에서 제한에 대한 기준을 설정할 수 있으며, 조직 소유자는 필요한 경우 추가로 제한할 수 있습니다.\n\n몇 가지 질문은 다음과 같습니다.\n\n* 어떤 조직 및 리포지토리가 사용하도록 설정되나요 Copilot cloud agent ?\n  [GitHub Copilot 클라우드 에이전트에 대한 액세스 관리](/ko/copilot/concepts/agents/cloud-agent/access-management)을(를) 참조하세요.\n* 외부 도구에 대한 액세스 권한을 부여 Copilot cloud agent 하도록 구성할 MCP 서버는 무엇입니까?\n  [리포지토리에 대한 MCP 서버 구성](/ko/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers)을(를) 참조하세요.\n\n### 적용되지 않는 정책은 무엇입니까?\n\n다음 Copilot 정책은 적용되지 않습니다.Copilot cloud agent\n\n* 사용자 지정 모델(사용자 고유의 LLM API 키 제공)\n* 프라이빗 MCP 레지스트리\n\n## 규칙 집합 조정\n\nCopilot cloud agent 는 기본 분기로 푸시하거나 끌어오기 요청 병합과 같은 작업에서 이미 제한됩니다. 분기 규칙 집합에서 이러한 기본 보호를 빌드할 수 있습니다.\nCopilot cloud agent 는 인간 개발자와 마찬가지로 규칙 집합의 적용을 받습니다.\n\nCopilot cloud agent을 위해 규칙 집합을 조정하려면:\n\n* 에이전트가 작동하는 리포지토리에 추가 규칙이 필요한지 여부를 고려하십시오. 예를 들어, 결과 \\*\\*\\*\\* 또는 code scanning가 필요한 경우입니다. 조직 또는 리포지토리 Copilot cloud agent가 사용하도록 설정될 위치를 확인한 경우, 규칙 집합에서 쉽게 지정할 수 있도록 사용자 지정 속성을 적용할 수 있습니다.\n* 기존 규칙 세트에 의해 Copilot cloud agent가 차단될지 여부를 고려하십시오.\n  Copilot\n  *는* 커밋에 서명할 수 있지만 커밋 메타데이터를 제한하는 다른 규칙을 따르지 못할 수 있습니다.\n* 파일을 사용하여 Copilot\\*\\*\\*\\* \"코드 소유자로부터 검토 필요\" 규칙을 사용하도록 설정하여 특정 팀에서 이러한 파일에 대한 편집을 승인해야 합니다. 대상으로 지정할 파일 경로는 [Copilot 사용자 지정 참고 자료](/ko/copilot/reference/customization-cheat-sheet)을 참조하세요.\n\n## GitHub Actions 환경 설정하기\n\nCopilot cloud agent 는 GitHub Actions 실행기에서 작동합니다.\nCopilot이(가) 안전하게 운영되도록 실행기와 정책을 설정하세요.\n\n### 데이터 및 비밀 저장\n\n\\_\n\\_ 액세스CopilotGitHub Actions 데이터 및 토큰을 계속 저장합니다.\nCopilot은 세션이나 환경 설정 시 액세스할 수 없습니다.\n\nCopilot cloud agent와 비밀을 \\_\\_ 제공해야 하는 경우 조직 또는 리포지토리 수준에서 에이전트 비밀 및 변수를 구성하여 이 작업을 수행할 수 있습니다. 자세한 내용은 [Copilot 클라우드 에이전트에 대한 비밀 및 변수 구성](/ko/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/configure-secrets-and-variables)을(를) 참조하세요.\n\n### 실행기 구성\n\nCopilot cloud agent에 사용할 실행기를 결정하십시오.\n\\*\\*\nGitHub-호스팅 실행기\\*\\*를 사용하여 각 Copilot cloud agent 가 새 가상 컴퓨터에서 실행되도록 하는 것을 추천합니다. 자체 호스팅 실행기를 사용하는 경우 임시 실행기 사용을 추천합니다.\n\n조직 소유자는 Copilot cloud agent의 실행기를 특정 실행기 레이블로 제한하여 모든 리포지토리에서 자동으로 사용되도록 설정할 수 있습니다.\n[조직 내 GitHub Copilot 클라우드 에이전트를 위한 실행기 구성하기](/ko/copilot/how-tos/administer-copilot/manage-for-organization/configure-runner-for-coding-agent)을(를) 참조하세요.\n\n### 워크플로 정책 구성\n\n끌어오기 요청GitHub Actions으로 생성된 워크플로가 실행되지 않도록 차단할지를\\*\\*\\*\\*.\n[GitHub Copilot 클라우드 에이전트에 대한 설정 구성](/ko/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings#allowing-github-actions-workflows-to-run-automatically-when-copilot-pushes)을(를) 참조하세요.\n\n기본적으로 워크플로는 쓰기 액세스 권한이 있는 사용자가 승인할 때까지 실행이 차단됩니다. 리포지토리 관리자는 이 기능을 사용하지 않도록 설정할 수 있으므로 원하는 설정에 대해 미리 통신할 수 있습니다.\n\n### 기본 사용 권한 검토\n\n엔터프라이즈에서 `GITHUB_TOKEN`의 기본 사용 권한을 검토합니다.\n[엔터프라이즈에서 GitHub Actions 대한 정책 적용](/ko/enterprise-cloud@latest/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#workflow-permissions)을(를) 참조하세요.\n\n이 정책은 해당 세션에 대해 수신할 토큰 \\*\\*\\*\\* 에 영향을 Copilot 않지만 `GITHUB_TOKEN` 워크플로 파일에 정의된 \\_\\_ 환경 설정 `copilot-setup-steps.yml`\n\n개발자는 이러한 워크플로 파일에서 직접 `permissions` 설정할 수 있으며 모든 워크플로에서 필요한 최소 사용 권한을 사용하도록 권장해야 합니다."}