Agents CLI Extensions: לעקוף את פקודת ה-deploy של גוגל בלי Forking, ומה הבלוג אומר לנעול
Agents CLI 1.5.0 של גוגל הוסיף מערכת הרחבות ניסיונית. מה Google Developers Blog אומר על overrides, הפצה מבוססת-git, lockfiles, הרחבת LangChain ומדיניות deploy מותאמת אישית, ומה לבדוק קודם.
ל-Agents CLI של גוגל יש עכשיו מערכת הרחבות. לפי פוסט ב-Google Developers Blog מ-21 באוקטובר, הרחבות הגיעו בגרסה 1.5.0, הרחבת LangChain רשמית נשלחה ב-1.8.0, וכל המערכת "marked experimental" עם סכמת manifest וממשק פקודות ש"may still change in breaking ways". המסר המעשי הוא שצוות פלטפורמה יכול לעטוף פקודה כמו deploy עם מדיניות משלו, למשל סריקת פגיעויות, בלי לעשות fork לכלי.
קראתי את פוסט הבלוג במלואו. לא התקנתי את Agents CLI, לא הרצתי שום פקודה, ולא קראתי את עמודי התיעוד הרשמיים או מאגר המקור שהוא מקשר. כל מה שלמטה הוא מה שהפוסט אומר, והפוסט נכתב על ידי אנשי גוגל שמתארים כלי של גוגל.
הבעיה שהפוסט מתאר
הפוסט אומר ש-Agents CLI הושק ב-Google Cloud Next '26 עם ממשק פקודות אחד לקחת סוכן מרעיון לייצור על Google Cloud. לצוותי ADK, מריצים agents-cli create, כותבים את לוגיקת הסוכן, ושולחים ל-Cloud Run עם observability ו-evals מחוברים, "in about thirty minutes".
אז הוא מזכיר את הפער. צוותים משתמשים ב-LangChain, LangGraph, Deep Agents או frameworks פנימיים. ומנהלי ארגונים אולי רוצים מדיניות על פני כל פרויקט, כמו "a compliance scan, an SSO gate, a Model Risk Management hop". הפוסט מפרט שלוש אפשרויות בלי הרחבות: לעשות fork ל-CLI, לעטוף אותו בסקריפטים מותאמים (ולצפות מפתחים ועוזרי קידוד קוראים לכלי הבסיסי ישירות), או לבנות מאפס.
הוא גם נותן ספירה: שש פקודות מניחות את ה-ADK runtime (playground, run וארבע תת-פקודות eval), וכ-18 אחרות הן framework-agnostic. בלי הרחבות, בחירת framework לא-ADK אמרה לאבד את כל ה-24. הספירה הזו של הפוסט עצמו.
מהי הרחבה
לפי הפוסט, הרחבה היא תיקייה במאגר Git עם קובץ אחד, agents-cli-extension.yaml. היא מכריזה אילו פקודות מובנות היא עוקפת ואילו פקודות חדשות היא מוסיפה. override מקבל את ארגומנטי המשתמש כמו שהם. פקודה חדשה מופיעה כ-agents-cli .
ההפצה היא דרך Git, לא רישום חבילות. הפוסט אומר שיש "no central index to publish to". צורות ייחוס כוללות shorthand רשמי, org/repo, org/repo#name לבחור הרחבה אחת ממאגר, ו-local@path לפיתוח.
שני היקפים:
- היקף פרויקט (ברירת מחדל): ההרחבה וערך ה-lockfile שלה מחויבים למאגר הפרויקט.
- היקף משתמש (
--global): מאוחסן בתיקיית הקונפיגורציה הביתית וחל על כל פרויקט במכונה.
כששניהם מגדירים פקודה, היקף הפרויקט מנצח, ו-agents-cli info מראה את המקור של כל פקודה פעילה. הפוסט אומר שהמערכת "will not silently merge or override extensions".
החלק שהייתי קורא פעמיים: אמון ונעילה
הפוסט משווה את המערכת ל-uv או npm. בזמן התקנה, ייחוס Git מתרגם ל-commit SHA מדויק, מתועד ב-lockfile. agents-cli install משחזר את עותק העבודה ה-vendored מה-SHA הנעול בלי להזיז את הנעילה, כך ש-CI והרצות מקומיות מקבלים אותו קוד. agents-cli extension update מתרגם מחדש את הייחוס ו"re-prompts for third-party trust".
הרחבה מריצה פקודות על המכונה שלכם. שדה ה-run: של ה-manifest הוא וקטור פקודה, והדוגמה בפוסט מריצה bash scripts/sbom_then_deploy.sh. אז הרחבה היא קוד שאתם מריצים, עם ההרשאות של מי שמריץ agents-cli. התשובה של העיצוב של הפוסט לזה היא נעילה ופרומפט אמון, והוא אומר לחייב גם את ה-lockfile וגם את העותק ה-vendored. הוא לא מתאר חתימה או תהליך review מעבר לזה. לא קראתי את התיעוד לראות אם הם כן.
הליווי של LangChain
הפוסט בונה scaffold לסוכן LangChain עם agents-cli create מכוון ל-google/agents-cli/extensions/langchain/template@v1.8.0, ופורס ל-Cloud Run. הוא אומר שלתוצאה אין תלות google-adk, ומראה grep שמחזיר כלום כראיה. תיאור התבנית עצמה, מצוטט בפוסט, מכסה סוכני LangChain, גרפי LangGraph ו-Deep Agents, כי LangChain מודרני מתקמפל ל-LangGraph.
מה שההרחבה משנה, לפי פלט ה-agents-cli info בפוסט, זה שש פקודות:
- ארבע החלפות:
playground(מפעיל את שרת הפיתוח של LangGraph על פורט 8080),run,eval.generateו-publish.gemini-enterprise. - שתי סירובים:
eval.datasetו-eval.optimize, שהפוסט אומר שצריכים אובייקט סוכן ADK, אז פרויקט LangChain "refuses them cleanly". publish.gemini-enterpriseבנוסף מסרב רק על יעד הפריסה Agent Runtime ומאציל לפקודה הטבעית על Cloud Run ו-GKE.
deploy לא מעוקף. הפוסט אומר שפריסת פרויקט LangChain ל-Cloud Run משתמשת באותו נתיב קוד כמו פרויקט ADK, קוראת ל-gcloud run deploy --source . מול Dockerfile שהפקודה שלו זהה. דירוג, השוואה וניתוח הערכות משתמשים בפקודות הטבעיות.
שני פרטים שאהבתי, כמתואר: הטוען מדפיס אזהרה שמפרטת אילו פקודות מעוקפות ועל ידי איזו הרחבה, ופלט העזרה מתייג פקודות מעוקפות עם [↑ extension-name]. override שמשנה התנהגות בשקט הוא הסיכון כאן, ואלה התשובה של הפוסט לו.
הדוגמה המעובדת בפוסט קוראת לכלי מזג אוויר שמחזיר מחרוזות קבועות, ושם המודל בה הוא gemini-3.8-flash. זו דמו, לא benchmark, ולא בדקתי את שם המודל.
דוגמת מדיניות ה-deploy המותאמת
המסע השני בונה sbom-deploy, הרחבה היפותטית שעוקפת את deploy. לפי הפוסט:
- ל-manifest חמישה מפתחות ברמה העליונה ואימות קפדני, כך ששגיאת הקלדה כמו
reqires:מכשילה התקנה עם הצעה במקום להיזרק. requiresמכריז גרסאות Agents CLI נתמכות (הדוגמה משתמשת ב->=1.5,<2) ומדיניותwarnאוerrorעל אי-התאמה.- אפשר לעקוף תת-פקודה כמו
eval.generate, אבל לא קבוצה ברמה העליונה כמוeval. run:הוא וקטור פקודה, לא מחרוזת shell, אז שרשור חייב לחיות בסקריפט עטיפה.- העטיפה מריצה
syftלבנות SBOM, אזgrype ... --fail-on critical, ואז קוראת ל-agents-cli deploy. - כדי להימנע מרקורסיה אינסופית, הטוען מגדיר
AGENTS_CLI_DISABLE_OVERRIDES=1לסקריפטים שמופעלים דרך override, כך שה-agents-cli deployהפנימי פוגע בפקודה המובנית.
הרצת הדמו של הפוסט מחליפה את הסריקה בפקודות echo. היא מאשרת שארגומנטים עוברים ומשתנה הסביבה מוגדר. היא לא מראה סריקה אמיתית חוסמת deploy, אז לא הייתי קורא את זה כהוכחה שהמדיניות עובדת.
מה זה לא נותן לכם
קורא בין השורות של הפוסט, שאני מתייג כפרשנות שלי:
- override של הרחבה הוא מוסכמה בכלי שאתם שולטים בו. הפוסט מציין שאנשים יכולים לעקוף אותו עם
AGENTS_CLI_DISABLE_OVERRIDES=1 agents-cli deploy, כפי שטקסט העזרה מראה. זה בסדר לברירת מחדל צוותית, ולא אכיפה נגד מישהו שרוצה לדלג על הבדיקה. אם אתם צריכים אכיפה, שימו אותה ב-CI או ביעד הפריסה, לא רק ב-CLI. - קריאה ישירה ל-
gcloud run deployמדלגת על Agents CLI לגמרי. בעיית העטיפה של הפוסט ("developers forget about the wrapper and call the underlying tool directly") חלה רמה אחת למטה. - המערכת ניסיונית, אז סכמת ה-manifest יכולה להשתנות.
מה הייתי בודק
אלה הצעות שלא בדקתי, לא תוצאות.
1. לנעול את ה-CLI. הפוסט אומר לנעול את גרסת Agents CLI שלכם בזמן שהמערכת ניסיונית.
2. לקרוא הרחבה לפני שמוסיפים אותה. פתחו את ה-manifest שלה וכל סקריפט שהיא מריצה. שורת ה-run: היא קוד שתריצו.
3. לחייב את ה-lockfile והעותק ה-vendored. אז בדקו ש-checkout נקי עם agents-cli install נותן אותו קוד.
4. בדיקת עקיפה. הריצו את משתנה הסביבה של העקיפה ו-deploy ישיר של gcloud, וראו מה ה-CI שלכם עדיין תופס.
5. נראות override. חפשו את אזהרת ה-override בלוגים של CI, כדי שפקודה ששונתה אף פעם לא תהיה שקטה.
6. סירובים. אם אתם משתמשים בהרחבת LangChain, נסו eval dataset ו-eval optimize ואשרו את הודעת הסירוב לפני שעוזר קידוד מנסה אותן מחדש.
מה לא הייתי מסיק
- שהרחבות בטוחות להתקנה מכל מאגר. הפוסט מתאר נעילה ופרומפט אמון, לא vetting.
- שדוגמת ה-SBOM חוסמת deploys מסוכנים. הדמו של הפוסט רק מדפיס echo.
- שהרחבת LangChain מכסה כל פקודה. שני evals נדחים בכוונה.
- שמספר שלושים הדקות חל עליכם. זה התיאור של הפוסט לנתיב ADK.
שאלות נפוצות
מהי הרחבת Agents CLI?
תיקייה במאגר Git עם agents-cli-extension.yaml שעוקפת פקודות מובנות או מוסיפה חדשות, לפי פוסט ה-Google Developers Blog.
איזו גרסה הוסיפה הרחבות?
הפוסט אומר שגרסה 1.5.0 הוסיפה את המערכת ו-1.8.0 שלחה את הרחבת LangChain הרשמית. הוא מתייג את המערכת כניסיונית ב-1.8.0.
האם אני צריך ADK כדי להשתמש ב-Agents CLI עכשיו?
לפקודות שהרחבת LangChain מכסה, הפוסט אומר לא. הוא מראה פרויקט scaffolded בלי תלות google-adk.
איך הרחבות מופצות?
דרך מאגרי Git. אין רישום. אפשר לייחס org/repo, org/repo#name או נתיב מקומי.
איך אני מונע מהרחבה להשתנות תחתיי?
הפוסט אומר שה-CLI מתעד commit SHA מדויק ב-lockfile, ו-agents-cli install משחזר את הקוד הנעול בלי לקדם אותו.
האם אפשר לעקוף override?
טקסט העזרה בפוסט מראה ש-AGENTS_CLI_DISABLE_OVERRIDES=1 agents-cli deploy מריץ את הפקודה המובנית.
האם זה מוכן לייצור?
הפוסט אומר שמערכת ההרחבות ניסיונית ושסכמת ה-manifest והפקודות עלולות להשתנות בדרכים שוברות. הוא ממליץ לנעול את גרסת ה-CLI.
מקורות
כל העמודים נקראו ב-27 באוקטובר 2026.
- Powering the Agent Development Lifecycle with any framework, from ADK to LangChain and beyond (Google Developers Blog, 21 באוקטובר 2026): מערכת ההרחבות, היקפים, lockfile, תבנית LangChain, דוגמת deploy מותאמת.
לא נקראו: עמודי התיעוד הרשמיים של Extensions, מאגר ומקור google/agents-cli, והערות שחרור כלשהן. לא הרצתי שום פקודה.
קריאה נוספת
- Managed Deep Agents v0.10: Browser Handoff, סוכני-משנה אסינכרוניים, והשינויים השוברים בפוסט השחרור של LangChain
הפוסט של LangChain מ-29 באוקטובר אומר ש-Managed Deep Agents v0.10 מוסיף שימוש בדפדפן עם מסירת התחברות, סוכני-משנה אסינכרוניים ברקע, מקורות threads וכפתור Stop ב-Slack. מה הוא אומר, השינויים השוברים, ומה לבדוק לפני שדרוג.
- Agent Sandbox ב-GKE: מה התיעוד דורש, מה הוא חוסם, ואיפה העמודים לא מסכימים
Agent Sandbox ב-GKE הוא תוסף מנוהל להרצת קוד סוכנים לא-מהימן ב-gVisor. מה התיעוד של גוגל אומר על warm pools, הגדרות pod חובה, ברירות מחדל של רשת ועלות, ועוד שני מקומות שבהם העמודים לא תואמים.
- Self-hosted Claude Managed Agents: שירות הסוכנים של Anthropic רץ עכשיו על התשתית שלך
Anthropic פתחה את self-hosted Claude Managed Agents בבטא פרטית: אתה מארח את שירות הסוכנים, את מסד הנתונים ואת ארגזי החול, וקריאות המודל הולכות ל-Claude API או לספק שאתה בוחר. מה רץ איפה, אילו הרשאות קיימות, מה עדיין יוצא מהרשת שלך, ומה כדאי לבדוק לפני שמתחייבים.
יומן הבנייה
לעקוב אחרי העבודה.
מאמרים ואבטיפוסים חדשים, ישר לקורא ה-RSS שלכם. מנויי המייל בהשהיה זמנית, עד שאחבר שירות משלוח עובד. לא נאסף כאן אימייל.
עקבו ב-RSS