GitHub Actions 에이전트 워크플로 개발

참고

GitHub 에이전트형 워크플로 에 공개 미리 보기 있으며 변경될 수 있습니다.

Introduction

GitHub 에이전트형 워크플로 Markdown에서 리포지토리 자동화를 정의하고 이를 실행하는 AI 코딩 에이전트를 선택할 수 있습니다. 확장은 gh aw 각 에이전트 워크플로를 워크플로로 GitHub Actions 컴파일합니다.

작성, 디버깅 및 최적화와 같은 전체 워크플로 수명 주기는 그 자체로 에이전트입니다. 자연어로 원하는 내용을 설명하고 코딩 에이전트가 워크플로를 만들고, 구체화하고, 문제를 해결합니다.

이 자습서에서는 코딩 에이전트를 사용하여 변경 내용이 적절하게 테스트되었는지 여부를 확인하는 자동화된 끌어오기 요청 검토자를 만듭니다.

사전 요구 사항

시작하기 전에 다음을 확인합니다.

사용하도록 설정되고 쓰기 액세스 권한이 있는 GitHub Actions 리포지토리
GitHub CLI 버전 2.0.0 이상 설치 및 인증
지원되는 코딩 에이전트(예: 클로드 코드 또는 OpenAI CodexGoogle Gemini CLI또는 코파일럿 CLI해당 필수 자격 증명)에 대한 액세스

인증 GitHub CLI하려면 다음을 실행합니다.

gh auth login --scopes repo,workflow

`gh aw` 확장 설치

에 GitHub 에이전트형 워크플로 대한 확장을 설치합니다.GitHub CLI

gh extension install github/gh-aw

에이전트 선택 및 인증 구성

워크플로에 가장 적합한 에이전트 CLI를 선택합니다. 클로드 코드 또는 OpenAI CodexGoogle Gemini CLI 코파일럿 CLI 를 선택하고 모두 실행할 GitHub 에이전트형 워크플로수 있습니다.

이 문서에서는 에이전트의 자격 증명을 리포지토리 비밀로 추가하는 간단한 설정을 안내합니다. 사용하는 클로드 코드 또는 OpenAI CodexGoogle Gemini CLI경우 에이전트의 API 키를 리포지토리 비밀로 저장합니다.

| 에이전트 CLI | engine 값 | 리포지토리 비밀 | | --- | --- | --- | | 클로드 코드 | claude | ANTHROPIC_API_KEYAnthropic API 키 포함 | | OpenAI Codex | codex | OPENAI_API_KEY OpenAI API 키 포함 | | Google Gemini CLI | gemini | GEMINI_API_KEY Google AI Studio API 키 포함 | | 코파일럿 CLI(기본값) | copilot | 조직 리포지토리에 비밀이 필요하지 않습니다(아래 참조). 개인 리포지토리 COPILOT_GITHUB_TOKEN 의 경우 Copilot 요청이 읽기로 설정된 세분화된 personal access token 리포지토리를 포함합니다. |

Pi(실험적)와 같은 다른 엔진도 지원됩니다. 전체 목록은 인증 참조를GitHub 에이전트형 워크플로 참조하세요.

조직 청구 GitHub Copilot

조직 소유 리포지토리에서 사용하는 GitHub Copilot 경우 ' 기본 제공 리포지토리 GITHUB_TOKEN 대신 GitHub Actions사용할 personal access token수 있습니다. 워크플로 프런트매터 permissions 에 추가하고 copilot-requests: write 별도의 비밀이 필요하지 않습니다. 설치 단계는 GitHub 에이전트 워크플로 만들기을 참조하세요.

GitHub UI에 비밀 저장

또는 클로드 코드 또는 OpenAI CodexGoogle Gemini CLI 개인 리포지토리에 대한 GitHub Copilot비밀을 추가하려면 다음을 수행합니다.

에서 GitHub리포지토리로 이동합니다.
리포지토리 이름 아래에서 설정을 클릭합니다****.
사이드바에서 비밀 및 변수를 클릭한 다음 작업을 클릭합니다.
새 리포지토리 비밀을 선택합니다.
이름 필드에 위 표의 비밀 이름을 입력합니다.
비밀 필드에 값을 입력합니다.
비밀 추가를 클릭합니다.

워크플로 만들기

코딩 에이전트를 사용하여 자연어 설명에서 워크플로를 만듭니다.

리포지토리 루트에서 에이전트 작성을 위해 리포지토리를 초기화합니다. 그러면 코딩 에이전트가 워크플로를 만들고 편집하는 데 도움이 되는 기술 및 지침이 추가됩니다.
```
gh aw init
```
리포지토리의 컨텍스트(예: VS Code 에이전트 모드 사용클로드 코드 또는 OpenAI CodexGoogle Gemini CLI코파일럿 CLI)에서 코딩 에이전트 세션을 시작합니다.
기술을 agentic-workflows 사용하고 원하는 워크플로를 설명합니다.
Copilot prompt
```
/agentic-workflows create a pr reviewer that ensure the changes are tested.
```
```
/agentic-workflows create a pr reviewer that ensure the changes are tested.
```
에이전트는 워크플로 Markdown 파일을 .github/workflows/만들고, 해당 .lock.ymlGitHub Actions 워크플로 파일을 컴파일하고, 두 파일을 모두 검토하고 커밋하도록 요청합니다.
생성된 워크플로를 검토한 다음 에이전트에 파일을 커밋하고 푸시하도록 요청합니다.

팁

동일한 에이전트 접근 방식을 사용하여 워크플로가 실행된 후 업데이트하고 개선할 수 있습니다. 에이전트에 검토 조건을 구체화하거나, 검사를 더 추가하거나, 실패한 실행을 모두 자연어로 디버그하도록 요청합니다. 나중에 워크플로 프런트매터를 편집하는 경우 변경 내용을 커밋하기 전에 실행 gh aw compile 합니다.

워크플로 실행

생성된 워크플로는 끌어오기 요청에서 자동으로 트리거되므로 다음에 리포지토리에서 끌어오기 요청을 열거나 업데이트할 때 실행됩니다.

리포지토리에서 끌어오기 요청을 엽니다.
에서 GitHub리포지토리로 이동하고 작업 탭을 클릭합니다.
왼쪽 사이드바에서 에이전트가 만든 워크플로를 선택합니다.
실행이 완료되면 워크플로는 변경 내용에 충분한 테스트가 포함되어 있는지 여부를 나타내는 끌어오기 요청 검토를 남깁니다.

다음 단계

주간 이슈 활동 보고서를 생성하는 워크플로를 만들려면 GitHub 에이전트 워크플로 만들기을 참조하세요.
고급 엔진 구성, 안전한 출력 및 더 많은 워크플로 예제는 설명서 사이트를 참조GitHub 에이전트형 워크플로하세요.

GitHub Actions 에이전트 워크플로 개발

이 기사에서