קריאת תיעוד Cursor Agent SDK: Deploy מ-Git, רשימות היתר egress, סודות, ושם חבילה שונה מפוסט ההשקה
Cursor אומרת שה-Agent SDK שלה זמין באופן כללי. מה פוסט ההשקה והתיעוד אומרים על סוכנים כקוד, agent-sdk deploy, רשימות היתר egress, סודות hosted, self-hosting, ושם החבילה שעליו שני העמודים לא מסכימים.
פוסט ההשקה של Cursor אומר שה-Agent SDK הוא "generally available today" ושאפשר להגדיר סוכנים בקוד ולהריץ agent-sdk deploy כדי לשים אחד על תשתית Cursor. עמודי תיעוד ה-deployment הם המקום שבו הפרטים התפעוליים יושבים: מה נשלח, איך egress וסודות עובדים, ומה שורד redeploy. הם גם מראים שם חבילה שונה מזה שבפוסט ההשקה.
קראתי את פוסט ההשקה (מתוארך 20 באוקטובר בבלוג של Cursor), את עמוד סקירת ה-Agent SDK, את עמוד ה-deployment ואת עמוד עיון ה-CLI. לא התקנתי או הרצתי שום דבר, ובדקתי מטא-דאטה של חבילות ברישום npm (ראו סעיף שם החבילה). הטענות למטה הן מה שעמודי Cursor אומרים.
מה פוסט ההשקה אומר
לפי הפוסט, ה-Agent SDK הוא ה-framework ש-Cursor משתמשת בו לבנות את הסוכנים המנוהלים שלה כמו Bugbot, Security Reviewer ו-Rollouts. סוכן הוא פרויקט: פרומפטים ב-Markdown, כלי TypeScript, חיבורים לשירותים חיצוניים ו-evals. סוכנים יכולים להגיב לאירועי pull request מ-GitHub, GitLab או Bitbucket, להעביר משימות לסוכנים אחרים, או לפצל עבודה בין סוכני-משנה מקבילים. הפוסט אומר שהוא תומך ב-evals וב-event replay.
שתי דוגמאות בפוסט הן טענות של Cursor עצמה: צוות בנה "kb-reviewer" ב"about a day", ו-PGA Tour מצוטט כמשתמש ב-SDK למפעל פיתוח התוכנה שלו. אף אחת לא מגיעה עם מספרים שאני יכול לבדוק.
מה התיעוד מוסיף
עמוד הסקירה אומר שה-SDK משתמש ב-Cursor SDK harness שמפעיל את Bugbot, Security Review, Approval Bot ו-Rollouts. הוא משווה שלוש אפשרויות:
- Cursor Automations: פרומפט, מודל וטריגר בדשבורד, מנוהל על ידי Cursor.
- Grok Bot: הוראות, מיומנויות וכלים מחוברים באפליקציה, מנוהל על ידי Cursor.
- Agent SDK: פרויקט Markdown ו-TypeScript עם גרסאות, על אירוח מנוהל על ידי Cursor או התשתית שלכם.
ההנחיה של עמוד הסקירה עצמו: בחרו ב-SDK כשאתם רוצים קוד סביב שיפוט מודל שהצוות שלכם יכול לנהל בגרסאות, לעשות review, לבדוק ו-"hillclimb".
Deployment
לפי עמוד ה-deployment, agent-sdk deploy בונה Git ref שנדחף, אז שינויים לא-מחויבים לא נשלחים. הוא מחכה עד שהסוכן רץ ומדפיס URL. אפשר להעביר --repo, --ref, --path ו---slug כשה-checkout הוא לא זה שרציתם. redeploy של אותו slug מחליף את המאגרים הנצפים, אז מעבירים כל ערך --cursor-events-repo שוב, אחרת ה-deployment צופה רק במאגר המקור שלו ב-GitHub.
Privacy Mode. העמוד אומר שאירוח מנוהל שומר את המאגר שלכם ואת נתוני הסוכן. תחת Privacy Mode הוא זמין, עם נתוני deployment שמורים באותה צורה כמו בלי Privacy Mode. תחת "Privacy Mode (Legacy)" הוא לא זמין, ו-deploy, סשן hosted וריצת eval כולם מסרבים. אם הצוות שלכם אוכף הגדרת פרטיות, זה מחליט אם אתם יכולים להשתמש באירוח מנוהל בכלל.
Egress וסודות
זה הסעיף שהייתי קורא פעמיים.
- מכריזים על hosts ושמות סודות בהגדרת הסוכן תחת
hosting.egressDomainsו-hosting.secretNames. Hosts הם שמות hostname באותיות קטנות בלי scheme או path. פורט מתווסף רק ל-TCP גולמי. - מדיניות ה-egress של הצוות שלכם מגבילה אילו hosts אפשר לרשום. העמוד נותן ארבעה מצבים: לא הוגדר מצב, לאפשר כל גישת רשת, ברירות מחדל פלוס רשימת היתר צוות, ורשימת היתר צוות בלבד. בשניים הראשונים, כל host שאתם רושמים מותר. העמוד אומר ששום רשימת צוות לא יכולה להסיר את בסיס הפלטפורמה, שכולל את ה-API של Cursor ואת רישום npm.
- wildcard צוות
*.example.comמכסה את ה-apex ותת-דומיינים. wildcard ברמת סוכן*.example.comמדלג על ה-apex, אז רושמים גםexample.com. - host TCP גולמי כמו מסד נתונים צריך ערך צוות בצורת
CIDR:portשמכסה כל כתובת IPv4 ציבורית שהוא מתרגם אליה. - אם host חסום,
deployנכשל ומזכיר אותו. deployment רץ שומר את המדיניות מה-deploy המוצלח האחרון שלו. - סודות: מחויבים שמות, אף פעם לא ערכים. אחרי deploy מגדירים כל ערך בפרומפט מוסתר עם
agent-sdk secret set, והמשימה הבאה משתמשת בו בלי redeploy. העמוד אומר לא להעבירNAME=VALUE, ולא להשתמש בשם שמתחיל ב-CURSOR_. סודות hosted מגיעים אחרי שהמודולים נטענים, אז קוראים אותם בתוך ה-handler, הכלי או ה-callback. - על אירוח Cursor, העמוד אומר ש-webhook delivery חתום גרוע נדחה לפני שהוא מגיע לסוכן שלכם, כשהערוץ משתמש בסוד בעל שם.
קריאה לסוכן deployed
העמוד מראה route מותאם אישית שנקרא על URL alias יציב עם header מסוג X-Agent-Alias-Token. ה-deploy הראשון מדפיס את alias token פעם אחת. אם הוא דולף או אבד, agent-sdk deployment rotate-token מחליף אותו. העמוד מזהיר שפלט deployment --json יכול לכלול access headers. הוא שומר את publicEndpoint() לספקי webhook שלא יכולים לשלוח את ה-token ושהחתימה שלהם מאומתת על ידי הערוץ.
מצב על פני החלפות
לפי העמוד, סשנים, ctx.host.kv ו-ctx.host.files שורדים הפעלות מחדש ו-redeploys. כל דבר אחר שהסוכן כותב לדיסק יכול להיעלם.
Self-hosting
העמוד אומר להריץ Node 22.13 או חדש יותר, אף פעם לא Bun, ומראה agent-sdk serve עם bearer token ושורש מצב. לפני חשיפה: לשים TLS או proxy מאמת מלפנים, לשמור את ה-bearer token אלא אם proxy מאמת כל קורא, לשמור את שורש המצב על נפח מתמיד מגובה מחוץ למאגר, ולהדליק schedules בתהליך אחד בלבד לכל פרויקט.
אי-התאמה בשם החבילה
דוגמת פוסט ההשקה מייבאת defineAgent מ-@cursor/agent-sdk. עמודי סקירת התיעוד וה-deployment מתקינים @grok/agent-sdk ומייבאים ממנו, והסקירה אומרת "The package was @cursor/bdk before."
בדקתי את מטא-הדאטה של רישום npm הציבורי (בקשת קריאה-בלבד, שום דבר לא הותקן) ב-29 באוקטובר:
@grok/agent-sdkקיים. גרסה אחרונה 0.5.0, נוצר 22 באוקטובר 2026, שונה לאחרונה 28 באוקטובר. התיאור קורא "Build, test, and deploy agents as code on Cursor's agent harness." דף הבית הוא cursor.com ושדה המאגר מצביע ל-github.com/cursor/cursor. ה-maintainers שלו כוללים חשבון בשםeric-anysphere.@cursor/bdkקיים. גרסה אחרונה 0.5.0, נוצר 22 בספטמבר 2026, עם אותו תיאור ומאגר.@cursor/agent-sdk, השם ב-snippet של פוסט ההשקה, החזיר "Not found".
משכתי את עמוד התיעוד ישירות, והעמוד הגולמי וגרסת ה-Markdown שלו שניהם אומרים @grok/agent-sdk, אז אי-ההתאמה אמיתית ולא עותק מטומן. הקריאה שלי: התיעוד עדכני ושם הייבוא של פוסט ההשקה לא תואם חבילה שפורסמה. אני לא יכול לדעת למה Cursor משתמשת ב-scope @grok. התיעוד גם מזכיר מוצר "Grok Bot" ולא קראתי שום דבר שמסביר אותו. מטא-דאטה רישום מראה מי פרסם חבילה ומה היא טוענת, לא שהשם מוזכר, אז לאשרו דרך התיעוד של Cursor עצמה לפני שאתם מתקינים. התייחסו לשורת הייבוא של פוסט ההשקה כמיושנת עד ש-Cursor מתקנת אותה.
מה הייתי בודק
אלה הצעות שלא בדקתי.
1. להתקין מהשם שהתיעוד משתמש בו, @grok/agent-sdk, ולבדוק את אינדקס התיעוד שמגיע עם החבילה. לא להעתיק את שורת הייבוא של פוסט ההשקה.
2. לבדוק את הגדרת Privacy Mode שלכם לפני שאתם מתכננים על אירוח מנוהל.
3. לכתוב את רשימת ה-egress שלכם קודם. להריץ agent-sdk info כפי שהעמוד מתאר כדי לראות את ה-hosts המשולבים, אז להשוות עם מדיניות הצוות שלכם.
4. לבדוק deploy כושל בכוונה עם host חסום, כדי לראות את השגיאה לפני שאתם צריכים אותה.
5. להחליט איפה מצב חי. להשתמש במאגרים השורדים (ctx.host.kv, ctx.host.files) ולהתייחס לדיסק כזמני.
6. לתכנן סיבוב token. ה-alias token מודפס פעם אחת.
7. לשאול על מחיר. לא מצאתי תמחור בעמודים שקראתי.
מה לא הייתי מסיק
- שה-SDK יציב לשימוש שלכם. "Generally available" הוא תווית של Cursor, ושינוי שם החבילה מרמז על שינוי לאחרונה.
- שדוגמאות kb-reviewer או PGA יחזרו עבורכם.
- שאירוח מנוהל חינם או זול. לא קראתי תמחור.
- שה-scope
@grokלא קשור ל-Cursor. מטא-הדאטה הרישום מצביעה ל-cursor.com ומאגר cursor, אבל לא אימתתי בעלות מעבר לזה.
שאלות נפוצות
האם ה-Cursor Agent SDK זמין באופן כללי?
פוסט ההשקה אומר "The Agent SDK is generally available today."
איך אני מפרס סוכן?
Commit ו-push, אז להריץ agent-sdk deploy. הוא בונה את ה-ref שנדחף, אז שינויים לא-מחויבים לא נשלחים.
האם אפשר לעשות self-host?
כן, לפי התיעוד: להריץ agent-sdk serve על Node 22.13 או חדש יותר, מאחורי TLS או proxy מאמת.
איך סודות מטופלים?
מכריזים שמות בקוד ומגדירים ערכים עם agent-sdk secret set בפרומפט מוסתר. לפי התיעוד, המשימה הבאה משתמשת בערך החדש בלי redeploy.
מה שולט בגישת רשת?
hosting.egressDomains פלוס מדיניות ה-egress של הצוות שלכם. host חסום גורם ל-deploy להיכשל.
מה שורד redeploy?
סשנים, ctx.host.kv ו-ctx.host.files. כתיבות דיסק אחרות יכולות להיעלם.
איזו חבילה אני מתקין?
התיעוד אומר @grok/agent-sdk, שקיימת ב-npm. ה-snippet של פוסט ההשקה מייבא @cursor/agent-sdk, שלא מצאתי ב-npm. השתמשו בשם התיעוד.
מקורות
כולם נקראו ב-29 באוקטובר 2026.
- Introducing the Agent SDK (בלוג Cursor, 20 באוקטובר 2026)
- Agent SDK (תיעוד Cursor)
- Deploy an Agent SDK project (תיעוד Cursor)
- Agent SDK CLI (תיעוד Cursor, אינדקס פקודות בלבד)
- @grok/agent-sdk on npm (מטא-דאטה רישום npm, נקרא 29 באוקטובר 2026)
לא נקראו: שאר התיעוד, עיון ה-CLI מעבר לקטלוג הפקודות, עמודי תמחור, תוכן החבילה, ומקור ה-SDK. לרישום קראתי רק מטא-דאטה של חבילות.
קריאה נוספת
- Microsoft Copilot Harness ב-Foundry Agent Service: עובדות ה-public preview, תמחור מ-1 בדצמבר, ומה לא נאמר
מיקרוסופט הכריזה על ה-Copilot harness ב-Foundry Agent Service ב-28 באוקטובר כ-public preview. מה שלושת הפוסטים הראשוניים אומרים על מיומנויות, כלים, סוכני-משנה, התקנת azd, resilience של hosted agents, תמחור sandbox ומגבלות preview.
- Self-hosted Claude Managed Agents: שירות הסוכנים של Anthropic רץ עכשיו על התשתית שלך
Anthropic פתחה את self-hosted Claude Managed Agents בבטא פרטית: אתה מארח את שירות הסוכנים, את מסד הנתונים ואת ארגזי החול, וקריאות המודל הולכות ל-Claude API או לספק שאתה בוחר. מה רץ איפה, אילו הרשאות קיימות, מה עדיין יוצא מהרשת שלך, ומה כדאי לבדוק לפני שמתחייבים.
- המדריך של Anthropic לסוכני always-on: חמישה פרימיטיבים מאחורי סוכנים שלא יושבים בחינם
Anthropic פרסמה מדריך לבניית סוכני always-on: סוכנים שומרי-מצב ופרואקטיביים שמנהלים קונטקסט בין סשנים. הרעיון המרכזי הוא שהסוכן לא באמת רץ כל הזמן - הוא ישן בין ריצות, וחמישה פרימיטיבים ארכיטקטוניים מחליטים מתי הוא מתעורר, מה הוא זוכר, ומה מגיע אליך.
יומן הבנייה
לעקוב אחרי העבודה.
מאמרים ואבטיפוסים חדשים, ישר לקורא ה-RSS שלכם. מנויי המייל בהשהיה זמנית, עד שאחבר שירות משלוח עובד. לא נאסף כאן אימייל.
עקבו ב-RSS