VM0 GitHub Actions entegrasyonu ile AI ajanlarınızı otomatikleştirin

Giriş

Bugün, vm0-ai/run-action kullanarak pratik bir örnek paylaştık. Bu GitHub Action, VM0 iş akışlarını doğrudan CI/CD boru hatlarınızdan tetiklemenizi sağlar. Bu entegrasyon, ajan otomasyonunu GitHub depolarınıza getirir ve AI ajanlarını otomatik olarak zamanlamak ve çalıştırmak için kolaylık sunar.

VM0 Nedir

VM0, AI ajanları oluşturmak için bir ajan çalışma zamanıdır. Ajan yeteneklerini düzenlemek, ajanları izole ortamlarda çalıştırmak ve doğal dil kullanarak ajan iş akışları tanımlamak için altyapı sağlar.

Github Action Nedir

GitHub Actions, GitHub’ın yerleşik otomasyon platformudur ve olaylara veya zamanlamaya dayalı iş akışları çalıştırmanıza olanak tanır. Cron işleriyle, CI boru hatlarını, arka plan görevlerini veya AI ajanlarını belirli aralıklarla otomatik olarak çalıştırabilirsiniz.

Lokalden buluta: VM0 iş akışlarını GitHub Actions ile çalıştırmak

Daha önce, VM0 iş akışlarını çalıştırmak için vm0 run komutunu yerel makinenizden çalıştırmanız gerekiyordu. Bu yöntem geliştirme ve test için uygundu (ayrıca VM0 hâlâ beta aşamasında!) ancak şu konularda zorluklar yaratıyordu:

• Zamanlanmış otomasyon - Ajanları belirli saatlerde çalıştırmak manuel müdahale gerektiriyordu
• CI/CD entegrasyonu - Ajanları dağıtım boru hatlarına dahil etmek karmaşıktı
• Ekip iş birliği - Ajan çalıştırmalarını ekipler arasında paylaşmak ve koordine etmek zordu
• Üretim dağıtımı - Ajanları üretim ortamlarında yönetmek karmaşıktı

Yeni vm0-ai/run-action ile artık VM0 iş akışlarını GitHub Actions üzerinden basit bir action yapılandırmasıyla doğrudan tetikleyebilirsiniz. Artık manuel komut çalıştırmaya gerek yok; ajan görevinizi tanımlayın ve zamanlama ile çalıştırmayı GitHub’a bırakın.

Başlarken: İlk VM0 GitHub Action’ınız

VM0’ı GitHub Actions’ta kullanmak oldukça basittir. İşte temel bir örnek:

- 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 }}

Kimlik doğrulama kurulumu

GitHub Actions’ınızı VM0 ile kimlik doğrulamak için, deponuzda bir VM0_TOKEN gizlisi oluşturmanız gerekir. Bu tek seferlik bir kurulumdur:

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

Bu komut, yerel VM0 kimlik doğrulamanızdan bir token üretir ve bunu GitHub deponuzun gizlilerine güvenli şekilde kaydeder; böylece iş akışlarınızda kullanılabilir olur.

Gerçek dünya örneği: Otomatik içerik yayını

VM0 GitHub Actions entegrasyonunun gücünü gösteren eksiksiz bir örnek üzerinden ilerleyelim. Günlük AI haber makalelerini dev.to sitesine yayımlayan otomatik bir içerik çiftliği oluşturacağız.

Senaryo

vm0-cookbooks/104-content-farm adresinde günlük AI haberlerini toplayıp makale olarak yayımlayan mevcut bir VM0 iş akışımız var. Şimdi, bu iş akışının otomatik olarak zamanlanmış şekilde çalışmasını istiyoruz.

Adım 1: Bir GitHub deposu oluşturun

Öncelikle, otomatik iş akışınızı barındıracak yeni bir depo oluşturun:

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

Adım 2: İş akışını yapılandırın

Depoda .github/workflows/daily.yaml dosyasını oluşturun:

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 }}

Temel bileşenleri inceleyelim:

• schedule: Cron söz dizimiyle her gün saat 2:00'de PST, UTC-8 çalışır
• workflow_dispatch: Test için manuel tetiklemeye izin verir
• agent: Hangi VM0 ajanının çalıştırılacağını belirtir
• prompt: Ajanın ne yapması gerektiğine dair talimatları sağlar
• secrets: Gerekli API anahtarlarını ve tokenları ajana iletir

Adım 3: Gizlilerinizi ayarlayın

Gerekli kimlik doğrulama tokenlarını deponuzda yapılandırın:

# 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"

Güvenlik notu: Bu gizliler GitHub’da güvenli şekilde saklanır ve yalnızca iş akışlarınız tarafından erişilebilir. Kayıtlarda veya çıktı dosyalarında asla gösterilmezler.

Adım 4: Otomatik dağıtım iş akışı ekleyin

.github/workflows/publish.yml dosyasını oluşturun

  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 }}

Bu işlem, ana dalınıza yapılan her push’ta ajan yapılandırmanızı otomatik olarak dağıtır. Manuel vm0 compose gerekmez.

Adım 5: Dağıtın ve test edin

  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

Hepsi bu kadar! Artık ajanınız push ile otomatik dağıtılacak ve zamanında çalışacaktır.

Sonuç

VM0 GitHub Actions entegrasyonu, AI ajanlarını mevcut geliştirme iş akışınıza dahil etmenizi sağlar.

Ajanları manuel çalıştırmak veya tek seferlik betikler olarak görmek yerine, onları doğrudan CI/CD boru hatlarınızda ve zamanlanmış olarak çalıştırabilirsiniz. Bu sayede:

• Tekrarlayan görevleri otomatik olarak, sürekli takip etmeden çalıştırabilirsiniz
• Ajanları normal geliştirme ve sürüm süreçlerinize entegre edebilirsiniz
• Ekip olarak ajan iş akışlarını paylaşabilir ve geliştirebilirsiniz
• Daha az sürprizle ajan tabanlı otomasyonlar sunabilirsiniz

İster içerik yayımlayın, ister rapor oluşturun, kod inceleyin ya da dahili iş akışlarını otomatikleştirin; VM0 GitHub Actions, AI ajanlarını ihtiyaç duyduğunuzda çalıştırmak için basit ve güvenilir bir yol sunar.

Başlamak için cookbooks deposunu inceleyin ve kendi GitHub iş akışlarınızda

vm0-ai/run-action kullanmayı deneyin.

Ek kaynaklar

• VM0 Dokümantasyonu: vm0.ai
• GitHub Action: vm0-ai/run-action
• Cookbooks: vm0-ai/vm0-cookbooks
• GitHub Deposu: vm0-ai/vm0