Automatize seus agentes de IA com a integração GitHub Actions da VM0

Introdução

Hoje, compartilhamos um exemplo prático usando o vm0-ai/run-action, um GitHub Action que permite acionar workflows da VM0 diretamente dos seus pipelines de CI/CD. Essa integração traz a automação de agentes para dentro dos seus repositórios no GitHub, facilitando agendar e executar agentes de IA automaticamente.

O que é a VM0

A VM0 é um runtime de agentes para construir agentes de IA. Ela fornece a infraestrutura para orquestrar habilidades de agentes, rodar agentes em sandboxes e definir workflows de agentes usando linguagem natural.

O que é o GitHub Actions

O GitHub Actions é a plataforma de automação integrada do GitHub que permite executar workflows com base em eventos ou em um agendamento. Usando cron jobs, você pode executar tarefas automaticamente em intervalos fixos, como rodar pipelines de CI, jobs em segundo plano ou agentes de IA.

Do local para a nuvem: executando workflows da VM0 com o GitHub Actions

Antes, executar workflows da VM0 exigia rodar o comando vm0 run a partir da sua máquina local. Embora isso funcionasse bem para desenvolvimento e testes (além disso, a VM0 está em beta!), apresentava desafios para:

• Automação agendada - Rodar agentes em horários específicos exigia intervenção manual
• Integração com CI/CD - Incorporar agentes nos pipelines de deploy era complexo
• Colaboração em equipe - Compartilhar e coordenar execuções de agentes entre equipes
• Deploy em produção - Gerenciar agentes em ambientes de produção

Com o novo vm0-ai/run-action, agora você pode acionar workflows da VM0 diretamente do GitHub Actions usando uma configuração de action simples. Chega de executar comandos manualmente: basta descrever a tarefa do seu agente e deixar o GitHub cuidar do agendamento e da execução.

Primeiros passos: seu primeiro GitHub Action da VM0

Usar a VM0 no GitHub Actions é simples. Aqui está um exemplo básico:

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

Configurando a autenticação

Para autenticar seu GitHub Actions com a VM0, você precisará configurar um secret VM0_TOKEN no seu repositório. Esse é um processo de configuração único:

# Gere um token de autenticação da VM0 e armazene-o no GitHub Secrets
vm0 auth setup-token | gh secret set VM0_TOKEN

Esse comando gera um token a partir da sua autenticação local da VM0 e o armazena com segurança nos secrets do seu repositório no GitHub, deixando-o disponível para seus workflows.

Exemplo do mundo real: publicação automatizada de conteúdo

Vamos percorrer um exemplo completo que demonstra o poder da integração da VM0 com o GitHub Actions. Vamos criar um content farm automatizado que publica diariamente artigos de notícias sobre IA no dev.to.

O cenário

Temos um workflow existente da VM0 em vm0-cookbooks/104-content-farm que coleta notícias diárias sobre IA e publica artigos. Agora, queremos que esse workflow rode automaticamente em um agendamento.

Passo 1: Crie um repositório no GitHub

Primeiro, crie um novo repositório para abrigar seu workflow automatizado:

# Crie e configure seu repositório
git clone <https://github.com/yourusername/vm0-content-farm>
cd vm0-content-farm

Passo 2: Configure o workflow

Crie .github/workflows/daily.yaml no seu repositório:

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

Vamos detalhar os componentes principais:

• schedule: Usa a sintaxe cron para rodar diariamente às 2h da manhã PST, UTC-8
• workflow_dispatch: Permite o acionamento manual para testes
• agent: Especifica qual agente da VM0 rodar
• prompt: Fornece instruções sobre o que o agente deve fazer
• secrets: Passa as chaves de API e os tokens necessários ao agente

Passo 3: Configure seus secrets

Configure os tokens de autenticação necessários no seu repositório:

# Configure a autenticação do Claude Code
claude setup-token
gh secret set CLAUDE_CODE_OAUTH_TOKEN --body "your-claude-token"

# Configure as outras chaves de API necessárias
gh secret set FAL_KEY --body "your-fal-key"
gh secret set DEVTO_API_KEY --body "your-devto-api-key"

Nota de segurança: Esses secrets são armazenados com segurança no GitHub e só ficam acessíveis aos seus workflows. Eles nunca são expostos em logs ou nas saídas de workflow.

Passo 4: Adicione o workflow de deploy automático

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

Isso faz o deploy automático da configuração do seu agente a cada push para a main. Sem necessidade de um vm0 compose manual.

Passo 5: Faça o deploy e teste

  Deploy:
  # Obtenha a configuração do agente content-farm
  git clone https://github.com/vm0-ai/vm0-cookbooks
  cp -r vm0-cookbooks/104-content-farm/* ./

  # Faça o push para acionar o deploy automático
  git add .
  git commit -m "feat: add content farm agent"
  git push origin main

  Test:
  # Acione o workflow manualmente
  gh workflow run scheduled-run.yml

É isso! Seu agente agora fará deploy automático a cada push e rodará no agendamento.

Conclusão

A integração da VM0 com o GitHub Actions ajuda você a trazer agentes de IA para o seu fluxo de desenvolvimento já existente.

Em vez de rodar agentes manualmente ou tratá-los como scripts pontuais, você pode executá-los diretamente dentro dos seus pipelines de CI/CD e em um agendamento. Isso facilita:

• Rodar tarefas recorrentes automaticamente, sem precisar ficar de babá dos jobs
• Encaixar agentes no seu processo normal de desenvolvimento e release
• Compartilhar e iterar workflows de agentes com sua equipe
• Entregar automação orientada por agentes com menos surpresas

Seja para publicar conteúdo, gerar relatórios, revisar código ou automatizar workflows internos, o GitHub Actions da VM0 oferece uma forma simples e confiável de rodar agentes de IA quando eles são necessários.

Para começar, explore nosso repositório de cookbooks para exemplos funcionais e experimente o

vm0-ai/run-action nos seus próprios workflows do GitHub.

Recursos adicionais

• Documentação da VM0: vm0.ai
• GitHub Action: vm0-ai/run-action
• Cookbooks: vm0-ai/vm0-cookbooks
• Discord da comunidade: discord.gg/WMpAmHFfp6
• Repositório no GitHub: vm0-ai/vm0