# 첫 번째 에이전트 워크플로

미리 빌드된 워크플로 및 GitHub CLI를 사용하여 첫 번째 AI 기반 자동화를 실행합니다.

> \[!NOTE]
> GitHub 에이전트형 워크플로 are in 공개 미리 보기 and subject to change.

## Introduction

GitHub 에이전트형 워크플로 AI 기반 워크플로를 사용하여 리포지토리 작업을 자동화할 수 있습니다. 개요 GitHub 에이전트형 워크플로는 [GitHub 에이전트 워크플로 정보](/ko/enterprise-cloud@latest/copilot/concepts/agents/about-github-agentic-workflows)을 참조하세요.

이 가이드에서는 미리 빌드된 에이전트 워크플로(일일 리포지토리 상태 보고서)를 기존 리포지토리에 추가합니다. 이 작업은 약 10분이 소요되며, 에서 실행되는 GitHub Actions자동화된 에이전트의 작업 예제를 제공합니다.

이 빠른 시작에서는 첫 번째 워크플로를 실행하는 데 중점을 둡니다. 자세한 설정 및 문제 해결 지침은 [설명서 사이트를 참조GitHub 에이전트형 워크플로](https://github.github.com/gh-aw/)하세요.

## Prerequisites

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

* AI 계정: GitHub Copilot, Anthropic Claude또는 OpenAI CodexGoogle Gemini
* GitHub 쓰기 액세스 권한이 있는 리포지토리
* GitHub Actions 리포지토리에 대해 활성화됨
* GitHub CLI (`gh`) v2.0.0 이상 설치 및 인증

  버전을 확인하려면 `gh --version`을(를) 실행합니다. 인증하려면 다음을 실행합니다.

  ```shell
  gh auth login --scopes repo,workflow
  ```

지원되는 모든 엔진으로 이 빠른 시작을 완료할 수 있습니다.
GitHub Copilot는 기본 엔진이며, GitHub Copilot 플랜은 해당 엔진을 선택한 경우에만 필요합니다.

지원되는 운영 체제는 WSL을 사용하는 Linux, macOS 및 Windows.

## 1단계: 확장 설치 `gh aw`

GitHub 에이전트형 워크플로용 GitHub CLI 확장을 설치합니다:

```shell
gh extension install github/gh-aw
```

## 2단계: 워크플로 추가 및 실행 트리거

리포지토리 루트에서 다음을 실행합니다.

```shell
gh aw add-wizard githubnext/agentics/daily-repo-status
```

`add-wizard` 명령은 `OWNER/REPO/WORKFLOW-NAME` 형식의 워크플로 참조를 허용합니다. 이 대화형 프로세스는 다음과 같습니다.

1. 리포지토리 필수 구성 요소를 확인합니다.
2. AI 엔진을 선택하라는 메시지를 표시합니다(Copilot 기본값이거나 다른 엔진에서 선택).
3. 선택한 엔진에 대한 비밀 및 인증 설정을 안내합니다. 선택한 엔진에 따라 마법사가 `COPILOT_GITHUB_TOKEN`, `ANTHROPIC_API_KEY`, `OPENAI_API_KEY` 또는 `GEMINI_API_KEY`를 구성하라는 메시지를 표시할 수 있습니다. 설치 지침은 [인증 참조](https://github.github.com/gh-aw/reference/auth/) 문서를 참조하세요.
4. 워크플로 마크다운 파일을 생성하고 해당 `.lock.yml` 파일을 컴파일합니다.
5. `.github/workflows/`에서 생성된 두 파일을 모두 추가하는 풀 리퀘스트를 엽니다.
6. 풀 리퀘스트를 직접 검토하고 병합하거나, 대신 병합해 주는 워크플로를 선택할 수 있습니다.

워크플로가 만들어지면 즉시 실행할지 묻는 메시지가 표시됩니다.
**예를** 선택하여 워크플로를 트리거합니다.

## 3단계: 워크플로가 완료되기를 기다립니다.

자동화된 워크플로 실행은 일반적으로 2\~3분이 걸립니다. 완료되면 분석하는 일별 상태 보고서가 포함된 새 문제가 리포지토리에 나타납니다.

* 최근 리포지토리 활동(문제, 끌어오기 요청, 토론, 릴리스)
* 진행률 추적 및 강조 표시
* 유지 관리자를 위한 실행 가능한 다음 단계

## 4단계: 워크플로 사용자 지정(선택 사항)

우선 순위와 일치하도록 워크플로를 편집할 수 있습니다.

1. 리포지토리에서 `.github/workflows/daily-repo-status.md`을(를) 여세요.

2. markdown 본문을 편집하여 보고서에서 다룰 문제 백로그, CI 설정, 테스트, 성능 또는 로드맵을 설명합니다.

3. 프런트매터 구성을 변경한 경우 워크플로를 다시 컴파일합니다.

   ```shell
   gh aw compile
   ```

4. 변경 내용을 커밋하고 푸시합니다.

5. 필요에 따라 다른 실행을 트리거합니다.

   ```shell
   gh aw run daily-repo-status
   ```

## 다음 단계

* 사용자 고유의 사용자 지정 에이전트 워크플로을 만들려면 [GitHub 에이전트 워크플로 만들기](/ko/enterprise-cloud@latest/copilot/how-tos/github-agentic-workflows/creating-github-agentic-workflows)을 참조하세요.
* 고급 패턴 및 전체 참조는 [설명서 사이트를 참조GitHub 에이전트형 워크플로](https://github.github.com/gh-aw/)하세요.