Automatisoi AI-agenttisi VM0 GitHub Actions -integraatiolla

Johdanto

Tänään jaoimme käytännön esimerkin käyttäen vm0-ai/run-action, GitHub Actionia, jonka avulla voit käynnistää VM0-työnkulkuja suoraan CI/CD-putkistasi. Tämä integraatio tuo agenttiautomaation GitHub-repositorioihisi, jolloin AI-agenttien ajoittaminen ja suorittaminen onnistuu helposti automaattisesti.

Mikä on VM0

VM0 on agenttien ajoympäristö AI-agenttien rakentamiseen. Se tarjoaa infrastruktuurin agenttitaitojen orkestrointiin, agenttien suorittamiseen hiekkalaatikoissa ja agenttityönkulkujen määrittelyyn luonnollisella kielellä.

Mikä on GitHub Action

GitHub Actions on GitHubin sisäänrakennettu automaatioalusta, jonka avulla voit suorittaa työnkulkuja tapahtumien tai aikataulun perusteella. Cron-tehtävien avulla voit suorittaa tehtäviä automaattisesti tietyin väliajoin, kuten CI-putkien, taustatehtävien tai AI-agenttien ajon.

Paikallisesta pilveen: VM0-työnkulkujen suorittaminen GitHub Actionsilla

Aiemmin VM0-työnkulkujen suorittaminen vaati vm0 run-komennon ajamista paikalliselta koneeltasi. Vaikka tämä toimi hyvin kehityksessä ja testauksessa (myös VM0 on beta!), se aiheutti haasteita:

• Ajoitettu automaatio – Agenttien ajaminen tiettyinä aikoina vaati manuaalista työtä
• CI/CD-integraatio – Agenttien liittäminen julkaisuprosesseihin oli monimutkaista
• Tiimityöskentely – Agenttien suoritusten jakaminen ja koordinointi tiimien kesken
• Tuotantoon vienti – Agenttien hallinta tuotantoympäristöissä

Uuden vm0-ai/run-action-toiminnon avulla voit nyt käynnistää VM0-työnkulkuja suoraan GitHub Actionsista yksinkertaisella action-määrityksellä. Ei enää manuaalista komentojen suorittamista – kuvaile vain agenttitehtäväsi ja anna GitHubin hoitaa ajoitus ja suoritus.

Aloitus: ensimmäinen VM0 GitHub Action

VM0:n käyttö GitHub Actionsissa on suoraviivaista. Tässä perusesimerkki:

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

Autentikoinnin määrittäminen

Jotta GitHub Actions voi tunnistautua VM0:lle, sinun tulee luoda VM0_TOKEN-salaisuus repositoriossasi. Tämä tehdään vain kerran:

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

Tämä komento luo tunnisteen paikallisesta VM0-autentikoinnistasi ja tallentaa sen turvallisesti GitHub-repositoriosi salaisuuksiin, jolloin se on työnkulkujesi käytettävissä.

Käytännön esimerkki: Sisällön automaattinen julkaisu

Käydään läpi kokonainen esimerkki, joka havainnollistaa VM0 GitHub Actions -integraation voimaa. Luomme automatisoidun sisällöntuotantofarmarin, joka julkaisee päivittäin AI-uutisartikkeleita dev.to.

Tilannekuvaus

Meillä on olemassa oleva VM0-työnkulku osoitteessa vm0-cookbooks/104-content-farm, joka kerää päivittäiset AI-uutiset ja julkaisee artikkeleita. Nyt haluamme tämän työnkulun toimivan automaattisesti aikataulun mukaan.

Vaihe 1: Luo GitHub-repositorio

Luo ensin uusi repositorio automatisoidulle työnkulullesi:

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

Vaihe 2: Määritä työnkulku

Luo tiedosto .github/workflows/daily.yaml repositoriossasi:

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

Käydään läpi tärkeimmät osat:

• schedule: Käyttää cron-syntaksia suorittaakseen päivittäin klo 2:00 aamulla PST, UTC-8
• workflow_dispatch: Mahdollistaa manuaalisen käynnistyksen testausta varten
• agent: Määrittää, mikä VM0-agentti suoritetaan
• prompt: Antaa ohjeet agentille tehtävästä
• secrets: Välittää tarvittavat API-avaimet ja tunnisteet agentille

Vaihe 3: Määritä salaisuudet

Määritä tarvittavat autentikointitunnisteet repositoriossasi:

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

Turvallisuusvinkki: Nämä salaisuudet tallennetaan turvallisesti GitHubiin ja ovat vain työnkulkujesi käytettävissä. Niitä ei koskaan näytetä lokeissa tai työnkulun tulosteissa.

Vaihe 4: Lisää automaattinen käyttöönotto

Luo tiedosto .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 }}

Tämä ottaa agenttikonfiguraatiosi automaattisesti käyttöön jokaisella päähaaran päivityksellä. Manuaalista vm0 compose -komentoa ei tarvita.

Vaihe 5: Ota käyttöön ja testaa

  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

Siinä kaikki! Agenttisi otetaan nyt automaattisesti käyttöön pushin yhteydessä ja suoritetaan aikataulun mukaan.

Yhteenveto

VM0 GitHub Actions -integraatio auttaa tuomaan AI-agentit osaksi olemassa olevaa kehitysprosessiasi.

Sen sijaan, että suorittaisit agentteja manuaalisesti tai pitäisit niitä yksittäisinä skripteinä, voit ajaa ne suoraan CI/CD-putkissa ja aikataulun mukaan. Tämä helpottaa:

• Toistuvien tehtävien automaattista suorittamista ilman jatkuvaa valvontaa
• Agenttien liittämistä normaaliin kehitys- ja julkaisuprosessiisi
• Agenttityönkulkujen jakamista ja kehittämistä tiimisi kanssa
• Agenttipohjaisen automaation julkaisemista ennakoitavammin

Olitpa sitten julkaisemassa sisältöä, luomassa raportteja, tarkistamassa koodia tai automatisoimassa sisäisiä työnkulkuja, VM0 GitHub Actions tarjoaa yksinkertaisen ja luotettavan tavan ajaa AI-agentteja silloin kun niitä tarvitaan.

Aloita tutustumalla cookbooks-repositorioomme, jossa on toimivia esimerkkejä, ja kokeile

vm0-ai/run-action omissa GitHub-työnkuluissasi.

Lisäresurssit

• VM0 Dokumentaatio: vm0.ai
• GitHub Action: vm0-ai/run-action
• Cookbooks: vm0-ai/vm0-cookbooks
• GitHub-repositorio: vm0-ai/vm0