Package Information
Available Nodes
Documentation
n8n-nodes-gemini-ai
n8n community node לשימוש ב-Google Gemini AI עם תמיכה בהעלאת קבצים וניתוח תוכן.
תכונות
✅ יצירת טקסט - שליחת שאילתות טקסט ל-Gemini AI
✅ העלאת קבצים - העלאת קבצים באמצעות binary data מנודים קודמים
✅ ניתוח קבצים - ניתוח תמונות, אודיו, PDF ועוד באמצעות AI
✅ תמיכה בפורמטים מרובים - אודיו (MP3, WAV, OGG, OGA), תמונות (JPEG, PNG), PDF, וידאו ועוד
✅ העבודה עם זרימות n8n - קבלת קבצים מנודים קודמים ללא צורך בנתיבים
התקנה
npm install n8n-nodes-gemini-ai
או חיפוש ב-n8n Community Nodes:n8n-nodes-gemini-ai
הגדרה
- צור מפתח API ב-Google AI Studio
- ב-n8n, הוסף את ה-Credentials החדש: "Gemini API"
- הזן את ה-API Key שיצרת
שימוש
🔤 יצירת טקסט
פעולה בסיסית לשליחת שאילתות טקסט ל-Gemini AI.
פרמטרים:
- Prompt - השאילתה הראשית
- System Prompt - הוראות מערכת (אופציונלי)
- Model - בחירת מודל Gemini
- Temperature - רמת היצירתיות (0-2)
- Max Tokens - מספר מקסימלי של מילים בתגובה
- Response Format - פורמט התגובה (Text/JSON)
📁 העלאת קבצים
מעלה קבצים מנודים קודמים ל-Gemini Files API.
שימוש:
- השתמש בנוד שמייצר קובץ בינארי (כמו "Read Binary File", "HTTP Request", "Google Drive" וכו')
- חבר את הנוד הזה אחרי הנוד שיצר את הקובץ
- בחר את שם ה-Binary Property (בדרך כלל "data")
- הזן שם תצוגה לקובץ (אופציונלי)
פרמטרים:
- Binary Property - שם המאפיין הבינארי (בדרך כלל "data")
- Display Name - שם לתצוגה בGemini (אופציונלי, יחזור לשם הקובץ המקורי)
פלט:
- fileUri - URI של הקובץ המועלה (לשימוש בפעולת ניתוח)
- fileName - שם הקובץ
- mimeType - סוג הקובץ
- sizeBytes - גודל הקובץ
🔍 ניתוח קבצים
מנתח קבצים שהועלו עם Gemini AI.
פרמטרים:
- File URI - URI של הקובץ (מפעולת ההעלאה)
- File MIME Type - סוג הקובץ
- Prompt - מה תרצה לדעת על הקובץ
- Model - מודל Gemini לניתוח
סוגי קבצים נתמכים:
- אודיו: MP3, WAV, OGG, OGA
- תמונות: JPEG, PNG
- מסמכים: PDF
- וידאו: MP4, MOV
- אחר: קבצים נוספים
דוגמאות זרימת עבודה
📸 ניתוח תמונה
Read Binary File → Upload File → Analyze File
🎵 תמלול אודיו
HTTP Request (download audio) → Upload File → Analyze File
📄 סיכום PDF
Google Drive (download PDF) → Upload File → Analyze File
🔗 ניתוח קובץ מURL
HTTP Request (binary=true) → Upload File → Analyze File
הערות טכניות
- מגבלות גודל: עד 20MB לקובץ (מגבלת Google)
- זמן תפוגה: קבצים נמחקים אוטומטית אחרי 48 שעות
- עלויות: חיוב לפי גודל הקובץ ומורכבות הניתוח
- זמן עיבוד: קבצים גדולים יכולים לקחת יותר זמן
- Binary Data: הנוד מצפה לקבל קבצים בפורמט binary מנודים קודמים
דוגמאות ספציפיות
תמלול שיחה מקובץ אודיו
Prompt לניתוח: "תמלל את השיחה הזו ותן לי סיכום של הנקודות העיקריות"
ניתוח תמונה רפואית
Prompt לניתוח: "תאר את התמונה הזו ותן התרעות על ממצאים חשובים"
סיכום מסמך PDF ארוך
Prompt לניתוח: "תן לי סיכום של 3 נקודות עיקריות במסמך הזה"
תמיכה וקישורים
רישיון
MIT License
🛠️ פיתוח
הגדרת סביבת פיתוח
git clone <repository-url>
cd n8n-nodes-gemini-ai
npm install
npm run dev # עבור watching mode
בנייה
npm run build
Linting
npm run lint
npm run lintfix # תיקון אוטומטי
פורמט קוד
npm run format
🔍 פתרון בעיות
שגיאות נפוצות
"API Key not found"
- ודא שיצרת credential עם API Key תקין
- בדק שה-credential מחובר לנוד
"Model not found"
- ודא שאתה משתמש במודל תקין
- בדק שה-API Key שלך תומך במודל הנבחר
"Rate limit exceeded"
- המתן מספר דקות לפני ניסיון חוזר
- בדק את ה-quota ב-Google Cloud Console
"Invalid response format"
- ודא שהפרומפט תקין
- בדק שלא חורגים ממגבלות הטוקנים
📋 API Reference
Gemini API Endpoints
- Base URL:
https://generativelanguage.googleapis.com/v1beta - Generate Content:
/models/{model}:generateContent
מודלים נתמכים
gemini-2.5-flash-preview-05-20- המודל החדש והמהיר ביותרgemini-1.5-flash- מודל מהיר ויעילgemini-1.5-pro- המודל המתקדם ביותר
🤝 תרומה
מוזמנים לתרום לפרויקט!
- Fork את הפרויקט
- צרו branch חדש (
git checkout -b feature/amazing-feature) - Commit השינויים (
git commit -m 'Add amazing feature') - Push ל-branch (
git push origin feature/amazing-feature) - פתחו Pull Request
📝 רישיון
MIT License - ראו קובץ LICENSE לפרטים
🔗 קישורים
📞 תמיכה
יש בעיה? פתחו issue ב-GitHub או צרו קשר דרך:
- GitHub Issues: פתח issue
- Email: [email protected]
נוצר עם ❤️ עבור קהילת n8n