VM0 GitHub Actions 통합으로 AI 에이전트 자동화하기

들어가며

오늘 우리는 vm0-ai/run-action을 사용하는 실용적인 예시를 공유했습니다. 이는 CI/CD 파이프라인에서 VM0 워크플로를 직접 트리거할 수 있게 해 주는 GitHub Action입니다. 이 통합은 에이전트 자동화를 여러분의 GitHub 저장소로 가져와, AI 에이전트를 자동으로 예약하고 실행하기 쉽게 만들어 줍니다.

VM0란

VM0는 AI 에이전트를 만들기 위한 에이전트 런타임입니다. 에이전트 스킬을 조율하고, 샌드박스에서 에이전트를 실행하며, 자연어로 에이전트 워크플로를 정의할 수 있는 인프라를 제공합니다.

GitHub Actions란

GitHub Actions는 이벤트 또는 일정에 따라 워크플로를 실행할 수 있게 해 주는 GitHub의 내장 자동화 플랫폼입니다. 크론 작업을 사용하면 CI 파이프라인, 백그라운드 작업, 또는 AI 에이전트 실행처럼 정해진 간격으로 작업을 자동으로 수행할 수 있습니다.

로컬에서 클라우드로: GitHub Actions로 VM0 워크플로 실행하기

이전에는 VM0 워크플로를 실행하려면 로컬 머신에서 vm0 run 명령을 실행해야 했습니다. 이는 개발과 테스트에는 잘 맞았지만(게다가 VM0는 베타입니다!) 다음과 같은 부분에서 어려움이 있었습니다.

• 예약된 자동화 - 특정 시간에 에이전트를 실행하려면 수동 개입이 필요했습니다
• CI/CD 통합 - 에이전트를 배포 파이프라인에 통합하는 것이 복잡했습니다
• 팀 협업 - 팀 전반에 걸쳐 에이전트 실행을 공유하고 조율하는 것이 어려웠습니다
• 프로덕션 배포 - 프로덕션 환경에서 에이전트를 관리하는 것이 까다로웠습니다

새로운 vm0-ai/run-action을 사용하면, 이제 간단한 action 설정만으로 GitHub Actions에서 VM0 워크플로를 직접 트리거할 수 있습니다. 더 이상 수동으로 명령을 실행할 필요가 없습니다. 그저 에이전트 작업을 설명하기만 하면, 예약과 실행은 GitHub가 처리합니다.

시작하기: 첫 번째 VM0 GitHub Action

GitHub Actions에서 VM0를 사용하는 것은 간단합니다. 다음은 기본 예시입니다.

- name: Run VM0 Agent
  uses: vm0-ai/run-action@v1
  with:
    agent: my-agent
    prompt: "Build and test the project"
    artifact-name: my-artifact
    vm0-token: ${{ secrets.VM0_TOKEN }}

인증 설정하기

GitHub Actions를 VM0로 인증하려면, 저장소에 VM0_TOKEN 시크릿을 설정해야 합니다. 이는 한 번만 하면 되는 설정 과정입니다.

# Generate a VM0 authentication token and store it in GitHub Secrets
vm0 auth setup-token | gh secret set VM0_TOKEN

이 명령은 로컬 VM0 인증에서 토큰을 생성하여 GitHub 저장소의 시크릿에 안전하게 저장하고, 이를 워크플로에서 사용할 수 있게 합니다.

실전 예시: 자동화된 콘텐츠 발행

VM0 GitHub Actions 통합의 위력을 보여 주는 완전한 예시를 함께 살펴보겠습니다. 매일 AI 뉴스 기사를 dev.to에 발행하는 자동화된 콘텐츠 팜을 만들어 보겠습니다.

시나리오

우리에게는 vm0-cookbooks/104-content-farm에 매일 AI 뉴스를 수집하고 기사를 발행하는 기존 VM0 워크플로가 있습니다. 이제 이 워크플로가 일정에 따라 자동으로 실행되도록 하려고 합니다.

1단계: GitHub 저장소 만들기

먼저, 자동화된 워크플로를 담을 새 저장소를 만듭니다.

# Create and set up your repository
git clone <https://github.com/yourusername/vm0-content-farm>
cd vm0-content-farm

2단계: 워크플로 구성하기

저장소에 .github/workflows/daily.yaml을 생성합니다.

name: Content Farm

on:
  schedule:
    # Run at 10:00 AM UTC+8 (2:00 AM UTC) every day
    - cron: '0 2 * * *'
  workflow_dispatch:

jobs:
  run-content-farm:
    runs-on: ubuntu-latest
    steps:
      - name: Run Content Farm Agent
        uses: vm0-ai/run-action@v1
        with:
          agent: content-farm
          prompt: "Write an article about recent AI developments, providing brief summaries of each story to help readers quickly browse the news over their morning coffee"
          artifact-name: content-farm-output
          vm0-token: ${{ secrets.VM0_TOKEN }}
          secrets: |
            CLAUDE_CODE_OAUTH_TOKEN=${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
            FAL_KEY=${{ secrets.FAL_KEY }}
            DEVTO_API_KEY=${{ secrets.DEVTO_API_KEY }}

핵심 구성 요소를 하나씩 살펴보겠습니다.

• schedule: 크론 문법을 사용하여 매일 오전 2시 PST, UTC-8에 실행합니다
• workflow_dispatch: 테스트를 위한 수동 트리거를 허용합니다
• agent: 실행할 VM0 에이전트를 지정합니다
• prompt: 에이전트가 무엇을 해야 하는지에 대한 지시를 제공합니다
• secrets: 필요한 API 키와 토큰을 에이전트에 전달합니다

3단계: 시크릿 설정하기

저장소에 필요한 인증 토큰을 구성합니다.

# Set up Claude Code authentication
claude setup-token
gh secret set CLAUDE_CODE_OAUTH_TOKEN --body "your-claude-token"

# Set up other required API keys
gh secret set FAL_KEY --body "your-fal-key"
gh secret set DEVTO_API_KEY --body "your-devto-api-key"

보안 참고: 이 시크릿들은 GitHub에 안전하게 저장되며 여러분의 워크플로만 접근할 수 있습니다. 로그나 워크플로 출력에는 결코 노출되지 않습니다.

4단계: 자동 배포 워크플로 추가하기

.github/workflows/publish.yml을 생성합니다.

  name: Publish Agent

  on:
    push:
      branches:
        - main

  jobs:
    publish:
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v4
        - uses: vm0-ai/compose-action@v1
          with:
            vm0-token: ${{ secrets.VM0_TOKEN }}

이렇게 하면 main에 푸시할 때마다 에이전트 구성이 자동으로 배포됩니다. 수동으로 vm0 compose를 실행할 필요가 없습니다.

5단계: 배포 및 테스트

  Deploy:
  # Get the content-farm agent configuration
  git clone https://github.com/vm0-ai/vm0-cookbooks
  cp -r vm0-cookbooks/104-content-farm/* ./

  # Push to trigger auto-deployment
  git add .
  git commit -m "feat: add content farm agent"
  git push origin main

  Test:
  # Manually trigger the workflow
  gh workflow run scheduled-run.yml

이것으로 끝입니다! 이제 여러분의 에이전트는 푸시할 때마다 자동으로 배포되고 일정에 따라 실행됩니다.

마치며

VM0 GitHub Actions 통합은 AI 에이전트를 여러분의 기존 개발 워크플로로 가져오는 데 도움을 줍니다.

에이전트를 수동으로 실행하거나 일회성 스크립트로 취급하는 대신, CI/CD 파이프라인 안에서 그리고 일정에 따라 직접 실행할 수 있습니다. 이로써 다음이 더 쉬워집니다.

• 작업을 곁에서 지켜보지 않고도 반복 작업을 자동으로 실행하기
• 에이전트를 일반적인 개발 및 릴리스 프로세스에 연결하기
• 팀과 함께 에이전트 워크플로를 공유하고 개선하기
• 더 적은 예기치 못한 상황으로 에이전트 기반 자동화를 출시하기

콘텐츠를 발행하든, 보고서를 생성하든, 코드를 리뷰하든, 내부 워크플로를 자동화하든, VM0 GitHub Actions는 필요할 때 AI 에이전트를 실행할 수 있는 간단하고 신뢰할 수 있는 방법을 제공합니다.

시작하려면, 동작하는 예시가 담긴 우리의 쿡북 저장소를 둘러보고,

여러분만의 GitHub 워크플로에서 vm0-ai/run-action을 사용해 보세요.

추가 자료

• VM0 문서: vm0.ai
• GitHub Action: vm0-ai/run-action
• 쿡북: vm0-ai/vm0-cookbooks
• 커뮤니티 Discord: discord.gg/WMpAmHFfp6
• GitHub 저장소: vm0-ai/vm0