אוטומציה לסוכני ה-AI שלך עם אינטגרציית VM0 ל-GitHub Actions

הקדמה

היום שיתפנו דוגמה מעשית לשימוש ב-vm0-ai/run-action, GitHub Action שמאפשר להפעיל תהליכי עבודה של VM0 ישירות מתוך צינורות CI/CD שלך. אינטגרציה זו מביאה אוטומציה של סוכני AI למאגרים שלך ב-GitHub, ומאפשרת לתזמן ולהריץ סוכנים אוטומטית בקלות.

מהו VM0

VM0 הוא סביבת הרצה לסוכני AI. הוא מספק תשתית לתזמור מיומנויות סוכן, הרצת סוכנים בסביבות מבודדות, והגדרת תהליכי עבודה של סוכנים בשפה טבעית.

מהו GitHub Action

GitHub Actions היא פלטפורמת האוטומציה המובנית של GitHub, שמאפשרת להריץ תהליכי עבודה על בסיס אירועים או לוח זמנים. באמצעות cron jobs, ניתן להריץ משימות אוטומטית במרווחים קבועים, כמו הרצת צינורות CI, עבודות רקע או סוכני AI.

ממקומי לענן: הרצת תהליכי VM0 עם GitHub Actions

בעבר, הרצת תהליכי VM0 דרשה הפעלת פקודת vm0 run מהמחשב המקומי שלך. למרות שזה עבד היטב לפיתוח ובדיקה (וגם VM0 עדיין בגרסת בטא!), זה יצר אתגרים עבור:

• אוטומציה מתוזמנת – הרצת סוכנים בזמנים מסוימים דרשה התערבות ידנית
• אינטגרציה עם CI/CD – שילוב סוכנים בצינורות פריסה היה מורכב
• שיתוף פעולה צוותי – שיתוף ותיאום הרצות סוכנים בין צוותים
• פריסה לייצור – ניהול סוכנים בסביבות ייצור

עם vm0-ai/run-action החדש, ניתן כעת להפעיל תהליכי VM0 ישירות מ-GitHub Actions באמצעות הגדרת פעולה פשוטה. אין צורך יותר בהרצת פקודות ידנית – פשוט תאר את משימת הסוכן שלך ו-GitHub ידאג לתזמון ולהרצה.

תחילת עבודה: הפעולה הראשונה שלך עם VM0 ב-GitHub

השימוש ב-VM0 ב-GitHub Actions פשוט. הנה דוגמה בסיסית:

- 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 ב-vm0-cookbooks/104-content-farm שאוסף חדשות AI יומיות ומפרסם כתבות. כעת נרצה שהתהליך ירוץ אוטומטית לפי לוח זמנים.

שלב 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: משתמש בתחביר cron להרצה יומית בשעה 2:00 בבוקר 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 כשצריך.

להתחלה, עיין ב-מאגר cookbooks שלנו לדוגמאות עובדות, ונסה את

vm0-ai/run-action בתהליכי העבודה שלך ב-GitHub.

משאבים נוספים

• תיעוד VM0: vm0.ai
• GitHub Action: vm0-ai/run-action
• Cookbooks: vm0-ai/vm0-cookbooks
• מאגר GitHub: vm0-ai/vm0