에이전트가 GitHub API 및 워크플로와 상호 작용하는 방법

  • 5분

AI 에이전트는 개발 작업을 수행하는 방법을 변경하고 있습니다. 에이전트는 리포지토리를 수동으로 탐색하고 코드를 작성하고 명령을 실행하는 대신 GitHub 내에서 직접 작동하여 처음부터 끝까지 작업을 완료할 수 있습니다.

GitHub 여러 계층을 통해 에이전트 기반 작업을 지원합니다. 에이전트는 GitHub API를 사용하여 리포지토리 상태를 읽고 작업을 수행할 수 있으며, GitHub Actions 워크플로를 제어된 실행기에서 자동으로 실행할 수 있습니다. 또한, GitHub Agentic Workflows를 통해 Markdown 형식으로 상위 수준의 리포지토리 작업을 설명하고, 강력한 보호 장치 내에서 코딩 에이전트를 사용하여 실행할 수 있습니다. 에이전트는 GitHub 우회하는 대신 분기, 끌어오기 요청, 문제 및 자동화를 포함하여 개발자가 사용하는 것과 동일한 시스템을 통해 작업합니다.

이 단원에서는 다음을 알아봅니다.

  • 에이전트가 API를 통해 GitHub 상호 작용하는 방법
  • 에이전트가 워크플로를 실행 환경으로 사용하는 방법
  • 리포지토리 변경 내용을 만들고 관리하는 방법
  • GitHub 전체 에이전트 실행 흐름의 모양

에이전트가 GitHub 상호 작용하는 방법

Copilot 클라우드 에이전트와 같은 GitHub 에이전트는 정의된 리포지토리 및 분기 컨텍스트 내에서 작동합니다. 예를 들어 문제 또는 프롬프트를 통해 작업을 할당하면 에이전트가 해당 리포지토리 내에서 작업을 시작합니다.

에이전트는 다음과 같은 기능을 수행할 수 있습니다.

  • 리포지토리 연구 및 이해
  • 작업을 완료하는 데 필요한 변경 내용 계획
  • 새 분기에서 코드 변경
  • 검토를 위한 끌어오기 요청 열기

에이전트는 API 및 워크플로와 같은 GitHub 플랫폼 기능을 사용하여 이러한 작업을 수행합니다.

이러한 작업은 리포지토리 이벤트(예: 푸시 또는 끌어오기 요청)에 의해 트리거되거나, 일정에 따라 실행되거나, 시간이 지남에 따라 리포지토리 작업을 지속적으로 자동화하는 에이전트 워크플로를 통해 오케스트레이션될 수 있습니다.

GitHub API를 사용하여 작업 수행

GitHub 시스템이 프로그래밍 방식으로 리포지토리와 상호 작용할 수 있도록 하는 API를 제공합니다.

API를 사용하면 다음과 같은 작업을 수행할 수 있습니다.

  • 분기 및 커밋 만들기
  • 리포지토리 데이터 읽기
  • 끌어오기 요청 열기 및 업데이트
  • 워크플로 트리거

모든 API 요청은 개인 액세스 토큰, GitHub 앱 토큰 또는 워크플로에 제공된 GITHUB_TOKEN 같은 토큰을 사용하여 인증되어야 합니다.

이렇게 하면 에이전트가 수행하는 모든 작업이 권한 제어 및 감사가 가능합니다.

에이전트가 리포지토리에서 변경 내용을 만드는 방법

에이전트가 변경하면 개발자와 동일한 워크플로를 따릅니다. 일반적인 시퀀스는 다음과 같습니다.

  1. 기본 브랜치 선택
  2. 새 작업 분기 만들기
  3. 파일 수정 또는 만들기
  4. 변경 내용 커밋
  5. 끌어오기 요청 열기

Git 참조, 리포지토리 콘텐츠 및 끌어오기 요청 작업을 포함하여 이러한 각 단계에 대해 별도의 API 작업이 있습니다.

즉, 에이전트 작업은 GitHub 표준 개발 모델과 완전히 일치합니다.

GitHub Actions 실행 계층으로 사용

에이전트는 컴퓨터에서 직접 작업을 실행하지 않습니다. 대신 GitHub GitHub Actions 제공하는 워크플로를 통해 실행 환경을 제공합니다.

워크플로는 이벤트에 대한 응답으로 작업을 실행하는 YAML 정의 프로세스입니다.

에이전트는 다음 워크플로를 사용합니다.

  • 테스트 실행
  • 변경 내용 유효성 검사
  • 자동화 작업 실행
  • 애플리케이션 배포

Copilot 클라우드 에이전트는 GitHub Actions 기반 환경에서 작동합니다. 즉, 워크플로가 에이전트 실행의 기초를 형성합니다.

기존 워크플로와 에이전트 워크플로 비교

기존 GitHub Actions 워크플로는 일반적으로 결정적이며 YAML로 정의됩니다. 각 단계, 트리거 및 조건을 명시적으로 지정합니다. GitHub 에이전트 워크플로는 리포지토리 자동화를 위한 다른 모델을 추가합니다. 이를 통해 Markdown에서 원하는 결과를 설명하고, 프런트매터에서 가드레일을 정의하고, GitHub Actions 코딩 에이전트를 사용하여 해당 의도를 실행할 수 있습니다. 심사, 보고, 설명서 유지 관리, CI 오류 분석 및 코드 개선과 같은 개방형이지만 제한된 리포지토리 작업에 가장 적합합니다. CI/CD 파이프라인을 대체하지 않고, GitHub이 'Continuous AI'로 설명하는 것으로 확장합니다.

에이전트 워크플로를 다르게 만드는 이유

GitHub 에이전트 워크플로에는 다음 두 가지 주요 부분이 있습니다.

  • 트리거, 권한, 도구 및 안전한 출력과 같은 구성을 위한 Frontmatter
  • 자연어로 작업을 설명하는 Markdown 지침

Markdown은 의도를 표현하고 프런트매터는 경계를 정의합니다. 그런 다음 워크플로는 GitHub Actions에서 실행할 락 파일로 컴파일됩니다.

on: schedule: daily
permissions: contents: read issues: read pull-requests: read
safe-outputs: create-issue: title-prefix: "[repo-status] " labels: [report]
tools: github:

Daily Repository Status Report
Create a daily report for maintainers.
Include:
Recent activity (issues, PRs, commits)
Key highlights and risks
Recommended next steps
Keep the report concise and link to relevant issues and pull requests.

이 예제에서 프런트매터(--- 사이)는 워크플로가 실행되는 방법과 시기, 액세스할 수 있는 항목 및 허용되는 작업을 정의합니다.

아래 Markdown은 자연어로 워크플로의 의도를 정의합니다. 에이전트는 이 의도를 해석하고 구조화된 출력을 생성합니다. 이 출력은 제어되고 검토 가능한 단계를 통해 적용됩니다.

각 단계를 명시적으로 정의하는 기존의 GitHub Actions 워크플로와 달리 에이전트 워크플로는 결과를 설명하는 데 중점을 줍니다. 에이전트는 프런트매터에 정의된 제약 조건 내에서 목표를 달성하는 방법을 결정합니다.

워크플로 트리거 및 상호 작용 방식

워크플로는 다음과 같은 여러 가지 방법으로 트리거할 수 있습니다.

  • 푸시 또는 끌어오기 요청과 같은 이벤트를 통해 자동으로
  • 수동으로 workflow_dispatch 이벤트 사용
  • GitHub API를 통해 프로그래밍 방식으로

에이전트는 리포지토리를 업데이트한 후 이러한 트리거를 사용하여 작업을 실행하거나 변경 내용의 유효성을 검사할 수 있습니다.

각 워크플로 실행은 격리된 환경에서 작업을 실행하여 일관되고 안전한 실행을 보장합니다.

에이전트 세션 중에 일어나는 일

에이전트 세션은 관찰 가능하고 대화형입니다.

세션 중에 다음을 수행할 수 있습니다.

  • 세션 로그를 통해 진행률 모니터링
  • 에이전트가 수행하는 작업 확인
  • 피드백 제공 또는 작업 조정
  • 최종 끌어오기 요청 검토

에이전트는 피드백에 따라 조정되며 작업이 완료될 때까지 작업을 계속합니다.

엔드 투 엔드 에이전트 실행 흐름

이 모든 것을 종합하면 GitHub 일반적인 에이전트 상호 작용은 다음과 같습니다.

  1. 문제, 채팅 또는 CLI를 통해 작업이 할당됩니다.
  2. 에이전트가 리포지토리 및 기본 분기를 선택합니다.
  3. 에이전트는 코드베이스를 분석하고 변경 내용을 계획합니다.
  4. API 작업은 분기 및 커밋을 만드는 데 사용됩니다.
  5. 끌어오기 요청이 열립니다.
  6. 워크플로를 실행하여 변경 내용의 유효성을 검사하거나 배포합니다.
  7. 사용자가 업데이트를 검토, 승인 또는 요청합니다.

이 흐름은 모든 에이전트 작업이 다음과 같은지 확인합니다.

  • 저장소에 범위 한정
  • 권한으로 제어
  • 워크플로를 통해 실행됨
  • 표시 및 검토 가능

주요 요점

GitHub 에이전트는 플랫폼 외부에서 작동하지 않습니다. 권한을 적용하고, 실행 환경을 제공하고, 끌어오기 요청을 통해 협업을 가능하게 하는 API, 워크플로 및 리포지토리 구조를 통해 상호 작용합니다.

다음으로, MCP(모델 컨텍스트 프로토콜)가 에이전트가 GitHub 이외의 추가 도구 및 서비스에 연결할 수 있도록 하여 이러한 기능을 확장하는 방법을 알아봅니다.