Integrations

GitHub API

יצירת Gist (דוגמה)

from github import Github
from github.InputFileContent import InputFileContent

g = Github(github_token)
user = g.get_user()
gist = user.create_gist(
    public=False,
    files={"example.py": InputFileContent("print('hello')")},
    description="Code snippet from bot"
)
print(gist.html_url)

Google Drive (OAuth Flow)

לבוט ולוובאפ יש חיבור Drive נפרד, כל אחד ב-OAuth flow אחר, והם לא חולקים טוקנים — ראו חיבור נפרד לכל שירות (owner):

  • הבוט — Device Flow (RFC 8628): start_device_authorization מבקש קוד מ-DEVICE_CODE_URL ומחזיר אותו למשתמש, שמקליד אותו בדף של גוגל, ו-poll_device_token מחליף את ה-device code בטוקנים מול TOKEN_URL (services/google_drive_service.py). אין כאן redirect URI.

  • הוובאפ — הפניה בדפדפן (Authorization Code, RFC 6749 סעיף 4.1): /api/drive/auth מפנה ל-GOOGLE_AUTH_URL עם state שנשמר בשרת, ו-/api/drive/callback מחליף את ה-code בטוקנים מול GOOGLE_TOKEN_URL (webapp/drive_auth.py). ה-redirect URI נבנה ב-_get_redirect_uri — ראו החיבור בוובאפ: קוד ה-state נשמר בשרת.

כל שירות מוגדר במשתני הסביבה שלו: GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET ל-client, ו-GOOGLE_OAUTH_SCOPES להרשאות — ראו משתני סביבה - רפרנס.

Telegram Webhooks vs Polling

# Polling
app.run_polling()
# Webhook
app.run_webhook(listen="0.0.0.0", port=8443, url_path="/webhook", webhook_url="https://your-domain.com/webhook")

קישורים

GitHub – Scopes נדרשים

להפעלת פעולות שונות מול GitHub נדרש להגדיר לטוקן (GITHUB_TOKEN או טוקן משתמש שנשמר במערכת) את מרחבי ההרשאות המינימליים. הקפידו על עיקרון ההרשאות המצומצמות.

Feature → Required Scopes

Feature

Required Scopes

Create Pull Request

repo, workflow

Write files (Trees/Contents API)

repo

Read repository metadata (branches, commits, PRs)

repo

Trigger workflows / read checks status

workflow

למידע נוסף וגרסה מסונכרנת של הטבלה ראו גם: משתני סביבה - רפרנס.

Troubleshooting GitHub – Rate limits

בעת חריגה ממכסת ה‑API של GitHub, ייתכן ותקבלו שגיאות כמו 403 Forbidden עם כותרות X-RateLimit-Remaining: 0 או הודעה על secondary rate limit. המערכת מיישמת Backoff עם ניסיונות חוזרים מדורגים, אך מומלץ:

  • להפחית את קצב הבקשות ולצמצם סריקות

  • לאגד פעולות ולנצל Cache פנימי

  • להשתמש ב‑ChatOps לצפייה במצב מגבלות ובשגיאות

קישורים רלוונטיים:

GitHub CLI (gh) – תקציר קצר

הכלי gh מקל על עבודה מול GitHub משורת הפקודה. דוגמאות נפוצות:

# כניסה
gh auth login

# יצירת PR
gh pr create --title "feat: update docs" --body "Why and test plan"

# סטטוס/מעבר ל‑PR
gh pr status
gh pr checkout <PR_NUMBER>

ל‑Cheatsheet מלא ומקיף ראו: התחלה מהירה - סוכני AI.

Repository Providers

תמיכה בספקי מאגרי קוד מפורטת כאן: Repository Integrations. נכון לעכשיו: נתמך – GitHub; לא נתמך – GitLab/Bitbucket.

Best Practices – מאגרים גדולים/Monorepos

  • הגדירו דילוג על תיקיות כבדות בסריקות (למשל node_modules/, dist/, .venv/)

  • בצעו חיפושים ממוקדים לפי סוג קובץ/ספריות רלוונטיות

  • חלקו תיעוד ותתי‑מודולים לפי תחומים כדי להקל ניווט

  • ודאו ש‑CI ומנגנוני קאש מקומיים מוגדרים נכון למונוריפו (Artifacts, dependency caching)