{"meta":{"title":"GitHub Actions 에이전트형 워크플로 개발","intro":"GitHub Agentic Workflows를 사용하여 Markdown 지침을 타사 코딩 에이전트로 구동되는 자동화로 전환합니다.","product":"GitHub Actions","breadcrumbs":[{"href":"/ko/actions","title":"GitHub Actions"},{"href":"/ko/actions/tutorials","title":"자습서"},{"href":"/ko/actions/tutorials/develop-agentic-workflows-in-github-actions","title":"에이전트형 워크플로 개발"}],"documentType":"article"},"body":"# GitHub Actions 에이전트형 워크플로 개발\n\nGitHub Agentic Workflows를 사용하여 Markdown 지침을 타사 코딩 에이전트로 구동되는 자동화로 전환합니다.\n\n## Introduction\n\nGitHub Agentic Workflows Markdown에서 리포지토리 자동화를 정의하고 이를 실행하는 AI 코딩 에이전트를 선택할 수 있습니다.\n`gh aw` 확장은 각 에이전트 워크플로를 GitHub Actions 워크플로로 컴파일합니다.\n\n전체 워크플로 수명 주기, 즉 작성, 디버깅 및 최적화는 그 자체로 에이전트적입니다. 자연어로 원하는 내용을 설명하고 코딩 에이전트가 워크플로를 만들고, 구체화하고, 문제를 해결해 드립니다.\n\n이 자습서에서는 코딩 에이전트를 사용하여 변경 내용이 적절하게 테스트되었는지 여부를 확인하는 자동화된 풀 리퀘스트 검토기를 만듭니다.\n\n## 사전 요구 사항\n\n시작하기 전에 다음을 확인합니다.\n\n* GitHub Actions이(가) 활성화되어 있고 쓰기 액세스 권한이 있는 리포지토리\n* GitHub CLI 버전 2.0.0 이상 설치 및 인증\n* 지원되는 코딩 에이전트(예: 클로드 코드 또는 OpenAI CodexGoogle Gemini CLI 또는 Copilot CLI) 및 해당 필수 자격 증명에 대한 액세스\n\nGitHub CLI를 인증하려면 다음을 실행하세요:\n\n```shell\ngh auth login --scopes repo,workflow\n```\n\n## `gh aw` 확장 프로그램 설치하기\n\nGitHub CLI용 GitHub Agentic Workflows 확장을 설치합니다:\n\n```shell\ngh extension install github/gh-aw\n```\n\n## 에이전트 선택 및 인증 구성\n\n워크플로에 가장 적합한 에이전트 CLI를 선택합니다.\n클로드 코드 또는 OpenAI CodexGoogle Gemini CLI, and Copilot CLI는 모두 GitHub Agentic Workflows를 실행할 수 있습니다.\n\n이 문서에서는 에이전트의 자격 증명을 리포지토리 비밀로 추가하는 간단한 설정을 안내합니다.\n클로드 코드 또는 OpenAI CodexGoogle Gemini CLI를 사용하는 경우 에이전트의 API 키를 리포지토리 비밀로 저장합니다.\n\n\\| 에이전트 CLI |\n`engine` 값 | 리포지토리 시크릿 |\n\\| --- | --- | --- |\n\\| 클로드 코드 | `claude` |\n`ANTHROPIC_API_KEY`Anthropic API 키 포함 |\n\\| OpenAI Codex | `codex` |\n`OPENAI_API_KEY` OpenAI API 키를 포함하는 |\n\\| Google Gemini CLI | `gemini` |\n`GEMINI_API_KEY` Google AI Studio API 키를 포함하는 |\n\\| Copilot CLI(기본값) | `copilot` | 조직 리포지토리에 비밀이 필요하지 않습니다(아래 참조). 개인 리포지토리의 경우, `COPILOT_GITHUB_TOKEN`에는 **Copilot Requests**가 **Read**로 설정된 세분화된 personal access token가 포함되어 있습니다. |\n\nPi(실험적)와 같은 다른 엔진도 지원됩니다. 전체 목록은 [GitHub Agentic Workflows 인증 참조 문서](https://github.github.com/gh-aw/reference/auth/?utm_source=agentic-workflow-actions-docs-linking-gh-aw-auth-reference\\&utm_medium=docs\\&utm_campaign=universe-2026)를 확인하세요.\n\n### GitHub Copilot에 대한 조직 청구\n\n조직 소유 리포지토리에서 GitHub Copilot를 사용하는 경우 personal access token 대신 GitHub Actions의 기본 제공 `GITHUB_TOKEN`를 사용할 수 있습니다. 워크플로 프런트매터에 `copilot-requests: write` 추가하고 `permissions` 별도의 시크릿은 필요하지 않습니다. 설치 단계는 [GitHub 에이전트 워크플로 만들기](/ko/copilot/how-tos/github-agentic-workflows/creating-github-agentic-workflows#using-the-built-in-github_token)을 참조하세요.\n\n### GitHub UI에 비밀을 저장\n\n클로드 코드 또는 OpenAI CodexGoogle Gemini CLI의 비밀 또는 GitHub Copilot 개인 리포지토리에 대한 비밀을 추가하려면 다음을 수행합니다.\n\n1. GitHub에서 리포지토리로 이동합니다.\n2. 리포지토리 이름 아래에서 설정을 클릭합니다\\*\\*\\*\\*.\n3. 사이드바에서 **Secrets and variables**를 클릭한 다음 **작업**을 클릭합니다.\n4. **새 리포지토리 비밀**을 선택합니다.\n5. **이름** 필드에 위 표의 비밀 이름을 입력하세요.\n6. **비밀** 필드에 값을 입력합니다.\n7. **비밀 추가**를 클릭합니다.\n\n## 워크플로 만들기\n\n코딩 에이전트를 사용하여 자연어 설명을 바탕으로 워크플로를 만듭니다.\n\n1. 리포지토리 루트에서 에이전트형 저작을 위해 리포지토리를 초기화합니다. 그러면 코딩 에이전트가 워크플로를 만들고 편집하는 데 도움이 되는 기술 및 지침이 추가됩니다.\n\n ```shell\n gh aw init\n ```\n\n2. 리포지토리의 컨텍스트에서(예: 클로드 코드 또는 OpenAI CodexGoogle Gemini CLI, Copilot CLI 또는 VS Code 에이전트 모드를 사용하여) 코딩 에이전트 세션을 시작합니다.\n\n3. `agentic-workflows` 스킬을 사용하고 원하는 워크플로를 설명하세요.\n\n ```copilot copy\n /agentic-workflows create a pr reviewer that ensure the changes are tested.\n ```\n\n 에이전트는 `.github/workflows/`에 워크플로 Markdown 파일을 만들고, 해당 `.lock.yml`GitHub Actions 워크플로 파일을 컴파일하고, 두 파일을 모두 검토하고 커밋하도록 요청합니다.\n\n4. 생성된 워크플로를 검토한 다음 에이전트에 파일을 커밋하고 푸시하도록 요청합니다.\n\n> [!TIP]\n> 동일한 에이전트 접근 방식을 사용하여 워크플로가 실행된 후 워크플로를 업데이트하고 개선할 수 있습니다. 에이전트에 자연어로 검토 조건을 구체화하거나, 검사를 더 추가하거나, 실패한 실행을 디버그하도록 요청합니다. 나중에 워크플로 프런트매터를 편집하는 경우 변경 내용을 커밋하기 전에 `gh aw compile`를 실행합니다.\n\n## 워크플로 실행하기\n\n생성된 워크플로는 풀 리퀘스트에서 자동으로 트리거되므로 다음에 리포지토리에서 풀 리퀘스트를 열거나 업데이트할 때 실행됩니다.\n\n1. 리포지토리에서 끌어오기 요청을 엽니다.\n2. GitHub에서 리포지토리로 이동하고 **작업** 탭을 클릭합니다.\n3. 왼쪽 사이드바에서 에이전트가 만든 워크플로를 선택합니다.\n4. 실행이 완료되면 워크플로는 변경 내용에 충분한 테스트가 포함되어 있는지 여부를 나타내는 풀 리퀘스트 검토를 남깁니다.\n\n## 다음 단계\n\n* 주간 이슈 활동 보고서를 생성하는 워크플로를 만들려면 [GitHub 에이전트 워크플로 만들기](/ko/copilot/how-tos/github-agentic-workflows/creating-github-agentic-workflows)을 참조하세요.\n* 고급 엔진 구성, 안전한 출력 및 더 많은 워크플로 예제에 대해서는 [GitHub Agentic Workflows 설명서 사이트](https://github.github.com/gh-aw/?utm_source=linking-agentic-workflows-actions-docs-gh-aw-repo\\&utm_medium=docs\\&utm_campaign=universe-2026)를 참조하세요."}