첫 번째 에이전트 워크플로

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

이 기사에서

참고

GitHub 에이전트형 워크플로 are in 공개 미리 보기 and subject to change.

Introduction

GitHub 에이전트형 워크플로 AI 기반 워크플로를 사용하여 리포지토리 작업을 자동화할 수 있습니다. 개요 GitHub 에이전트형 워크플로는 GitHub 에이전트 워크플로 정보을 참조하세요.

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

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

Prerequisites

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

  • AI 계정: GitHub Copilot, Anthropic Claude또는 OpenAI CodexGoogle Gemini

  • GitHub 쓰기 액세스 권한이 있는 리포지토리

  • GitHub Actions 리포지토리에 대해 활성화됨

  • GitHub CLI (gh) v2.0.0 이상 설치 및 인증

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

    gh auth login --scopes repo,workflow

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

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

1단계: 확장 설치 gh aw

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

gh extension install github/gh-aw

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

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

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를 구성하라는 메시지를 표시할 수 있습니다. 설치 지침은 인증 참조 문서를 참조하세요.
  4. 워크플로 마크다운 파일을 생성하고 해당 .lock.yml 파일을 컴파일합니다.
  5. .github/workflows/에서 생성된 두 파일을 모두 추가하는 풀 리퀘스트를 엽니다.
  6. 풀 리퀘스트를 직접 검토하고 병합하거나, 대신 병합해 주는 워크플로를 선택할 수 있습니다.

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

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

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

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

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

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

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

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

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

    gh aw compile

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

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

    gh aw run daily-repo-status

다음 단계