1. מבוא
Gemini CLI הוא סוכן מבוסס-AI בקוד פתוח לטרמינל, שמאפשר להשתמש ביכולות של מודלי Gemini ישירות בשורת הפקודה. הוא עוצמתי בפני עצמו, אבל כדי לממש את הפוטנציאל האמיתי שלו צריך להשתמש בתוספים ל-Gemini CLI.
תוספים הם הדרך הרשמית והסטנדרטית להרחבת היכולות של Gemini CLI. לפני שהתוספים הושקו, כדי להתאים אישית את ה-CLI היה צריך לערוך באופן ידני קובצי תצורה כמו settings.json. התהליך הזה היה מסורבל ומועד לשגיאות.
אפשר לחשוב על תוסף כעל 'מכולה' להתאמות אישיות של Gemini CLI. זהו חבילה עצמאית, שאפשר ליצור לה גרסאות שונות ולהפיץ אותה בקלות. היא כוללת את כל הרכיבים שנדרשים כדי ללמד את Gemini מערך חדש של מיומנויות. ה'מכולה' הזו יכולה לכלול :
- הגדרות של שרת MCP: ההגדרות האלה מחברות את Gemini לכלים ולממשקי API חיצוניים, כמו ממשקי ה-API של Google Cloud או שירותים של צד שלישי.
- קבצי הקשר (GEMINI.md): אלה הם 'מדריכים' שמספקים למודל הוראות והנחיות ספציפיות לגבי אופן השימוש היעיל בכלים החדשים.
- פקודות סלאש בהתאמה אישית (קבצי .toml): הפקודות האלה כוללות הנחיות מורכבות שמורכבות מכמה שלבים, והופכות אותן לפקודות פשוטות וקלות לשימוש, כמו /deploy.
- הגבלות על כלים (excludeTools): אפשר להשבית כלים מובנים כדי ליצור סביבה בטוחה או ממוקדת יותר.
הערך המרכזי של התוספים הוא הפיכת Gemini CLI מעוזר אישי לפלטפורמה ניתנת להרחבה שמוכנה לשימוש בארגונים. צוות יכול לארוז את כל מחסנית הענן שלו בתוסף אחד, וכך מפתחים חדשים יכולים להתחיל לעבוד עם פקודה אחת.
ב-codelab הזה תלמדו איך להשתמש במערכת האקולוגית העוצמתית הזו. לא תיצרו תוסף, אבל תתקינו ותשתמשו בארבעה תוספים שונים כדי להוסיף יכולות של פריסת אפליקציות, ניתוח אבטחה, ניתוח נתונים ותשתית כשירות (Infrastructure-as-Code) לטרמינל.
מה עושים
- מתקינים ומגדירים את Gemini CLI ואת הדרישות המוקדמות שלו ב-Google Cloud.
- כדי למצוא תוספים, אפשר לעיין בגלריה הרשמית של תוספים ל-Gemini CLI.
- משתמשים בממשק שורת הפקודה
gemini extensionsכדי להתקין תוספים, לראות רשימה שלהם ולנהל אותם. - היכרות עם כמה תוספים ל-Gemini CLI
מה תלמדו
- מהם תוספים ל-Gemini CLI ולמה הם הדרך המקובלת להתאמה אישית של ה-CLI.
- איך מוצאים ומתקינים תוספים מגלריית התוספים או מכתובת URL ב-GitHub.
- הפונקציה של פקודות לניהול מפתחות:
gemini extensions install,gemini extensions listו-gemini extensions update. - התקנה ושימוש בכמה תוספים ל-Gemini CLI
מה תצטרכו
- דפדפן האינטרנט Chrome
- חשבון Gmail
- פרויקט ב-Cloud עם חיוב מופעל
ה-codelab הזה מיועד למשתמשים ולמפתחים בכל הרמות (כולל מתחילים). מומלץ להכיר את Gemini CLI, אבל נספק גם שלבים להתקנה של Gemini CLI מאפס. כדי להכיר את Gemini CLI, אפשר לנסות את ה-codelab: Hands-on with Gemini CLI (תרגול מעשי עם Gemini CLI).
2. לפני שמתחילים
יצירת פרויקט
- ב-Google Cloud Console, בדף לבחירת הפרויקט, בוחרים או יוצרים פרויקט ב-Google Cloud.
- מוודאים שהחיוב מופעל בפרויקט ב-Cloud. כך בודקים אם החיוב מופעל בפרויקט
- תשתמשו ב-Cloud Shell, סביבת שורת פקודה שפועלת ב-Google Cloud ומגיעה עם bq שנטען מראש. לוחצים על 'הפעלת Cloud Shell' בחלק העליון של מסוף Google Cloud.
- אחרי שמתחברים ל-Cloud Shell, בודקים שכבר בוצע אימות ושהפרויקט מוגדר למזהה הפרויקט באמצעות הפקודה הבאה:
gcloud auth list
- מריצים את הפקודה הבאה ב-Cloud Shell כדי לוודא שפקודת gcloud מכירה את הפרויקט.
gcloud config list project
- אם הפרויקט לא מוגדר, משתמשים בפקודה הבאה כדי להגדיר אותו:
gcloud config set project <YOUR_PROJECT_ID>
- מפעילים את ממשקי ה-API הנדרשים באמצעות הפקודה שמוצגת למטה. זה יימשך כמה דקות, אז כדאי לחכות בסבלנות.
gcloud services enable cloudresourcemanager.googleapis.com \
servicenetworking.googleapis.com \
run.googleapis.com \
cloudbuild.googleapis.com \
אם הפקודה תפעל בהצלחה, תוצג הודעה שדומה לזו שמופיעה בהמשך:
Operation "operations/..." finished successfully.
אם פספסתם API כלשהו, תמיד תוכלו להפעיל אותו במהלך ההטמעה.
אפשר לעיין במאמרי העזרה בנושא פקודות gcloud ושימוש בהן.לפני שמגדירים ומריצים את Gemini CLI, כדאי ליצור תיקייה שתשמש כתיקיית הבית לכל הפרויקטים שייווצרו בתוכה. זו נקודת התחלה לעבודה עם Gemini CLI, אבל הוא גם יפנה לתיקיות אחרות במערכת שלכם, שתגיעו אליהן בהמשך לפי הצורך.
יוצרים תיקיית דוגמה (gemini-cli-projects) ועוברים אליה באמצעות הפקודות שמוצגות למטה. אם אתם מעדיפים להשתמש בשם אחר לתיקייה, אתם יכולים לעשות זאת.
mkdir gemini-cli-projects
כך עוברים לתיקייה הזו:
cd gemini-cli-projects
אפשר להפעיל את Gemini CLI ישירות באמצעות הפקודה gemini בטרמינל חדש של Cloud Shell, או שהוא כבר יופעל בטרמינל נפרד של Cloud Shell.
האינטראקציה הראשונה שלנו עם Gemini CLI
כדי לוודא שהסביבה של Gemini CLI תקינה, אפשר להזין את ההנחיה הראשונה כמו בדוגמה הבאה:
Give me a famous quote on Artificial Intelligence and who said that?
אפשר לראות שהשאילתה שלנו הפעילה את הכלי GoogleSearch (כלי מובנה ב-Gemini CLI). במילים אחרות, כבר השתמשתם באחד מהכלים המובנים והעוצמתיים של Gemini CLI, כלומר GoogleSearch, שמבסס את התשובות שלו על מידע שהוא מקבל מהאינטרנט. אמורה להתקבל תשובה לשאלה.
בשלב הבא נתחיל להשתמש בתוספים.
3. מהו תוסף?
תוסף הוא חבילה עצמאית עם גרסאות שאפשר להפיץ בקלות. אפשר לחשוב על זה כעל 'קונטיינר משלוח' להתאמות האישיות של Gemini CLI, שכולל את כל מה שצריך לתהליך עבודה ספציפי בחבילה אחת מסודרת.
תוסף יכול לכלול כל שילוב של:
- פקודות דרך שורת הפקודות בהתאמה אישית (קבצי .toml).
- הגדרות שרת MCP (שנמצאו בעבר בקובץ settings.json).
- קבצים של הקשר (GEMINI.md) כדי לספק למודל הוראות והנחיות ספציפיות.
- הגבלות על כלים (excludeTools) כדי ליצור סביבה בטוחה וממוקדת יותר.
למה כדאי להשתמש בתוספים? היתרונות העיקריים
שימוש בתוספים להתאמות אישיות מספק כמה יתרונות חשובים:
- התקנה באמצעות פקודה אחת: זהו שלב חשוב. במקום תהליך הגדרה ידני שכולל כמה שלבים, משתמש יכול להתקין חבילת כלים מלאה ומורכבת באמצעות פקודה אחת:
gemini extensions install <URL>אוgemini extensions install --path=some/local/path. ה-<URL> בפקודה שלמעלה יכול להיות כתובת ה-URL של GitHub שבה איחסנתם את התוסף. - הפצה פשוטה יותר: שיתוף העבודה שלכם הופך לפשוט כמו שיתוף כתובת URL של מאגר Git יחיד. לא צריך יותר להעביר קבצים בודדים וקטעי קוד של הגדרות.
- ניהול גרסאות ותלות: מכיוון שתוספים מתארחים בדרך כלל במאגרי Git, אתם מקבלים בקרת גרסאות בחינם. יש
gemini extensions update commandדרכים לעדכן תוסף לגרסה האחרונה. - גילוי וסביבה עסקית: תוספים הם הבסיס לסביבה עסקית עשירה ופתוחה, בדומה לשווקים של VS Code או Chrome. מנגנון התוספים יכול להוות בסיס לשוק עתידי שבו התוספים האלה יהיו זמינים לבדיקה, להורדה ועוד, בסגנון קהילתי אמיתי.
ההשקה של מסגרת התוספים היא אות ברור לכך ש-Gemini CLI מתפתח מכלי עצמאי ועוצמתי לפלטפורמה שניתן להרחיב.
4. הסבר על היסודות של תוספים
בקטע הזה מוסבר על החלקים של סביבת התוספים שמוצגים למשתמשים: חיפוש תוספים וניהול שלהם.
עיון בגלריית התוספים
גלריית התוספים היא המקום המרכזי שבו אפשר למצוא את כל התוספים הרשמיים ש-Google יצרה ואת התוספים של צדדים שלישיים:
- פותחים את כתובת ה-URL הבאה בדפדפן:
https://geminicli.com/extensions/browse/. - הגלריה הזו היא מנוע הגילוי של המערכת האקולוגית. תוכלו לראות תוספים מחברות כמו GitHub, Redis ו-DynaTrace, שממחישים את מגוון הכלים הזמינים.
- גוללים למטה ומחפשים את כרטיס התוסף של Cloud Run.
- שימו לב שהכרטיס כולל תיאור, את המחבר (Google) ולחצן פקודה
Copy installבלחיצה אחת. זו הדרך הכי פשוטה לקבל את פקודת ההתקנה של תוסף.
תוספים ל-Gemini CLI – פקודות ניהול
הפקודה gemini extensions היא נקודת הכניסה לניהול התוספים המקומיים.
מריצים אותה במסוף כדי לראות את רשימת הפקודות הזמינות.
הפקודות הן פשוטות (install/uninstall, list, update, enable/disable וכו'), ונשתמש בחלק מהן ב-codelab הזה.
בדיקת המצב הנוכחי
לפני שמתקינים משהו, בודקים את המצב הנוכחי.
- מריצים את הפקודה
gemini extensions list: - אמור להופיע הפלט הבא, שמאשר שעדיין לא הותקנו תוספים.
No extensions installed.
5. התוסף Cloud Run (פריסת אפליקציה)
התוסף Cloud Run שזמין בגלריית התוספים של Gemini CLI הוא שרת MCP שמאפשר לנו לפרוס את האפליקציות שלנו ב-Cloud Run.
כרטיס התוסף Cloud Run מגלריית התוספים מוצג בהמשך:
קודם כול, נתקין את התוסף Cloud Run. לשם כך, לוחצים על העתקת פקודת ההתקנה כמו שמוצג למעלה. מדביקים את הפקודה במסוף Cloud Shell (היא אמורה להיראות בערך כך):
gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp
כשמריצים את הפקודה שלמעלה, מוצגת בקשה לאישור. אפשר לאשר את זה. התוסף Cloud Run אמור להיות מותקן בהצלחה.
Installing extension "cloud-run".
**Extensions may introduce unexpected behavior. Ensure you have investigated the extension source and trust the author.**
This extension will run the following MCP servers:
* cloud-run (local): npx -y @google-cloud/cloud-run-mcp
This extension will append info to your gemini.md context using gemini-extension/GEMINI.md
Do you want to continue? [Y/n]: Y
Extension "cloud-run" installed successfully and enabled.
אם מריצים עכשיו את הפקודה gemini extensions list, אמור להופיע התוסף Cloud Run שהותקן, כמו בדוגמה הבאה:
✓ cloud-run (1.0.0)
Path: <HOME_FOLDER>/.gemini/extensions/cloud-run
Source: https://github.com/GoogleCloudPlatform/cloud-run-mcp (Type: github-release)
Release tag: v1.5.0
Enabled (User): true
Enabled (Workspace): true
Context files:
<HOME_FOLDER>/.gemini/extensions/cloud-run/gemini-extension/GEMINI.md
MCP servers:
cloud-run
אם מפעילים עכשיו את Gemini CLI ומריצים את הפקודה /mcp, מוצגת התוצאה הבאה:
עכשיו נחזור ל-Cloud Shell וננסה לפרוס אפליקציה. לשם כך, קודם נצטרך אפליקציה פשוטה לפריסה ב-Cloud Run. כך עושים את זה:
מוודאים שאתם נמצאים בתיקייה שיצרנו קודם, כלומר gemini-cli-projects. יוצרים תיקייה נוספת בתוך התיקייה שנקראת gemini-cloud-run ועוברים אליה.
mkdir gemini-cloud-run
cd gemini-cloud-run
עכשיו יוצרים שני קבצים בתיקייה הזו (קובץ app.py וקובץ requirements.txt), שהתוכן שלהם מפורט בהמשך:
app.py
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello_world():
return 'Hello from Gemini and Cloud Run!'
if __name__ == "__main__":
app.run(debug=True, host='0.0.0.0', port=8080)
requirements.txt
Flask
gunicorn
עכשיו מפעילים את Gemini CLI מהתיקייה gemini-cloud-run. כשהטרמינל מוכן, מזינים את ההנחיה הבאה:
/deploy --project="PROJECT_ID" --location="PROJECT_LOCATION" --name="SERVICE_NAME"
תצטרכו לציין את PROJECT_ID (מזהה הפרויקט ב-Google Cloud), את PROJECT_LOCATION ואת SERVICE_NAME. אם לא תציינו את האפשרויות האלה, פקודת Cloud Run תפעיל את הכלים המתאימים שיעזרו לכם לבחור אותן.
כחלק מהתהליך, הכלי הנכון ייבחר מתוך Cloud Run MCP Server Extension שהתקנו. לדוגמה, אמורה להופיע הודעה כזו:
אפשר לתת הרשאה לשימוש בכלי.
זהו! ל-Gemini CLI יש עכשיו את כל המידע שהוא צריך, וגם את ההרשאה שלכם להפעיל את הכלים. הוא יבצע עכשיו את כל תהליך הפריסה: יבנה את קובץ האימג' של Docker, יעביר אותו בדחיפה ל-Artifact Registry, יגדיר ויפרוס שירות חדש של Cloud Run.
אחרי כמה רגעים (למעשה, אחרי 2-3 דקות), תופיע הודעה על הצלחה עם כתובת URL של שירות. דוגמה להרצה:
The Cloud Run service SERVICE_NAME has been deployed from the current folder in project PROJECT_ID.
You can view the service in the Cloud Console: https://console.cloud.google.com/run/detail/PROJECT_LOCATION/SERVICE_NAME?project=PROJECT_ID
The service is accessible at: https://SERVICE_NAME-SOME-ID.a.run.app
אפשר ללחוץ על הקישור הזה. אפליקציית Flask אמורה להציג את דף הבית:
כאן אפשר לראות את העוצמה של תוסף Gemini CLI (במקרה הזה Cloud Run), שבו הוא מסתיר לחלוטין את המורכבות של פקודות gcloud CLI ופשוט מטפל בכל הפרטים בשבילכם.
אתם יכולים לבדוק כלים אחרים בשרת Cloud Run MCP.
6. התוסף BigQuery (ניתוח מערכי נתונים גדולים)
כדי להמשיך, תצטרכו:
- פרויקט Google Cloud שבו מופעל BigQuery API.
- הרשאות IAM:
- משתמש BigQuery (roles/bigquery.user)
- מריצים את הפקודה הזו כדי להגדיר את משתנה הסביבה
BIGQUERY_PROJECT. זהו הפרויקט שבו יופעלו המשימות ב-BigQuery, ולא בהכרח הפרויקט שבו נמצאים הנתונים (אבל יכול להיות שזה אותו פרויקט)
export BIGQUERY_PROJECT=<YOUR_GCP_PROJECT_ID>
- מתקינים את התוסף BigQuery Data Analytics באמצעות הפקודה שבהמשך. חשוב לתת לו הרשאה להתקין. אם ההתקנה תצליח, יהיו לכם 2 תוספים מותקנים בהגדרה :
cloud-runו-bigquery-data-analytics.
gemini extensions install https://github.com/gemini-cli-extensions/bigquery-data-analytics
- נריץ שוב את Gemini CLI באמצעות הפקודה הבאה::
gemini
Gemini CLI אמור להיפתח בטרמינל: 
צריך להזין את הפקודות הבאות בטרמינל של Gemini CLI.
- כדי לוודא שהתוסף BigQuery מותקן ומוכן לשימוש, מזינים את פקודת הלוכסן הבאה:
/extensions list
גם התוסף bigquery-data-analytics אמור להופיע ברשימה.
- מריצים את הפקודה הבאה כדי לראות את הכלים הזמינים
/mcp list
- נשאל שאלה בסיסית בנוגע לניתוח נתונים במערך הנתונים הציבורי של BigQuery: thelook ecommerce. מערך הנתונים הזה כולל נתונים על לקוחות, מוצרים והזמנות באתר מסחר אלקטרוני פיקטיבי למכירת בגדים. מזינים את ההנחיה הבאה ב-Gemini CLI:
Look at BigQuery's the look ecommerce public dataset. Identify the top 5 products that had the most orders.
- ממשק Gemini CLI ישאל אם אתם רוצים לאשר את ההפעלה של כלי BigQuery. כדי להמשיך, בוחרים באפשרות השלישית:
Yes, always allow all tools from server "bigquery_data_analytics".
- מתחת לפני השטח, Gemini ייצור את שאילתת ה-SQL המתאימה, יפעיל את הכלי
execute_sqlויחזיר תשובה בשפה טבעית לצד הנתונים:
- עכשיו נבקש מ-Gemini לחזות מה יהיה שיעור ההחזרות של המוצרים על סמך נתונים היסטוריים. במקרה של הפקודה הזו, Gemini CLI לא אמור לנסות ליצור SQL מפורט כדי ליצור את התחזית הזו, אלא להפעיל את הכלי
forecastמשרת ה-MCP, שישתמש ב-AI.Forecast של BigQuery מאחורי הקלעים:
Forecast what the return rate will be next month.
- אתם אמורים לראות תגובה כזו:
7. העמקה נוספת
במדריך הזה למדנו מהם התוספים ל-Gemini CLI, מהן הפקודות הבסיסיות לעבודה איתם וסקרנו שני תוספים : cloud-run ו-bigquery-data-analytics.
כדי לראות את התוספים שזמינים לשימוש, אפשר לעבור אל גלריית התוספים של Gemini בכתובת https://geminicli.com/extensions/. נכון לכתיבת המאמר הזה, יש יותר מ-100 תוספים. כל כרטיס של תוסף מכיל מידע, את סוג התוסף (MCP, הקשר וכו') וגם קישור למאגר GitHub שלו ופקודה להתקנת התוסף בסביבה שלכם.
8. מזל טוב
כל הכבוד, עכשיו אתם מבינים מהן תוספים ל-Gemini CLI, איך להתקין אותם ואיך להשתמש בהם.