הפעלת קוד

כדי לבצע הרבה משימות, כמו חישובים פיננסיים ותהליכי עבודה של מדעי הנתונים, הנציג צריך ליצור ולהריץ קוד. התכונה "הרצת קוד" מאפשרת לנציג להריץ קוד בסביבת ארגז חול מאובטחת, מבודדת ומנוהלת.

התכונות של הרצת הקוד כוללות:

  • אפשר ליצור ארגזי חול ולהריץ בהם קוד תוך פחות משנייה.

  • ארגזי החול תומכים בקלט ובפלט של קבצים בגודל של עד 100MB לכל הבקשה או התגובה.

  • ארגזי החול שומרים את מצב ההפעלה שלהם (זיכרון) למשך עד 14 ימים. אפשר להגדיר את אורך החיים (TTL) הזה.

לא צריך לפרוס את הנציג ב-Agent Platform כדי להשתמש בהרצת קוד. הסוכן יכול לפעול בכל מקום, אפילו באופן מקומי.

הרצת הקוד פועלת עם כל מסגרת של סוכן וכל מודל גנרטיבי.

אלה הפעולות העיקריות לעבודה עם ארגז חול להרצת קוד:

  • יצירת ארגז חול: יוצרת מרחב מאובטח ומבודד להרצת קוד לא מהימן או שעלול להזיק. הבידוד הזה מפחית את סיכוני האבטחה כי הוא מונע מהקוד לגעת במשאבים, בקבצים או ברשת של המערכת. ארגז חול הוא חיוני כשצריך להריץ קוד בצורה בטוחה, למשל עבור סוכני Data Science, סקריפטים של תזמור או במהלך בדיקות פיתוח. ארגז החול מציע מערכת קבצים מוגבלת וללא גישה לרשת.

  • ‫Get sandbox: הצגת ההגדרות והסטטוס של ארגז חול ספציפי להרצת קוד. אתם יכולים לבדוק פרטים כמו המצב הנוכחי (לדוגמה, פועל או הופסק) וזמן חיים (TTL). כך תוכלו לעקוב אחרי ארגזי החול ולאמת את הסטטוס שלהם לפני או אחרי הרצת הקוד.

  • הצגת רשימה של ארגזי חול: הצגת רשימה של כל ארגזי החול להרצת קוד בפרויקט. אפשר לסנן את התוצאות לפי קריטריונים כמו סטטוס או סוג של ארגז החול. כך תוכלו לבדוק, לעקוב ולנהל הרבה ארגזי חול בפרויקט.

  • הפעלת קוד: שליחת הקוד וכל קובצי הקלט הנדרשים לארגז החול להפעלה בטוחה. התשובה כוללת את התוצאות, כמו פלט סטנדרטי (stdout), שגיאה סטנדרטית (stderr) וכל קובץ שהקוד יוצר. ארגז החול יכול גם לשמור על מצב, וכך לאפשר לקריאות הבאות ל-Execute Code להתבסס על קריאות קודמות. זה חיוני לסשנים אינטראקטיביים או למשימות מורכבות שבהן הסביבה צריכה לשמור על המצב בכמה הרצות של קוד.

ספריות נתמכות

ארגז החול של הרצת הקוד כולל את הספריות הבאות, שמסווגות לפי תרחיש לדוגמה. אי אפשר להתקין ספריות משלכם בסביבת ארגז החול.

מדע הנתונים ולמידת מכונה

הקטע הזה כולל ספריות שחיוניות לניתוח נתונים, למניפולציה, ללמידת מכונה ולחישוב מספרי.

טיפול בנתוני ליבה וחישובים מספריים

  • ‫numpy ‏(2.1.3): חבילה בסיסית לחישובים מספריים ב-Python, שמספקת תמיכה במערכים ובמטריצות גדולים ורב-ממדיים, יחד עם אוסף גדול של פונקציות מתמטיות ברמה גבוהה לפעולות במערכים האלה.
  • ‫pandas ‏(2.2.3): ספרייה מתקדמת לניתוח נתונים ולמניפולציה של נתונים, שמציעה מבני נתונים כמו DataFrame ו-Series לטיפול בנתונים מובְנים.
  • ‫scipy ‏(1.15.2): סביבה של תוכנות קוד פתוח למתמטיקה, מדע והנדסה. היא מבוססת על NumPy ומספקת מספר רב של שגרות מספריות יעילות וידידותיות למשתמש.
  • pyarrow (18.1.0): פלטפורמת פיתוח חוצת שפות עבור נתונים בזיכרון. הוא שימושי במיוחד לטיפול יעיל בנתונים ולתפעול הדדי בין מערכות.
  • ‫numexpr ‏(2.14.1): כלי מהיר להערכת ביטויים מספריים ב-NumPy, שמבצע אופטימיזציה של פעולות במערכים.
  • ‫narwhals ‏(2.19.0): מאפשרת לכתוב קוד שעובד בכמה ספריות DataFrame (כמו pandas ו-Polars).

מסגרות של למידת מכונה

  • ‫scikit-learn ‏(1.6.1): כלים פשוטים ויעילים לכריית נתונים ולניתוח נתונים, שמבוססים על NumPy,‏ SciPy ו-matplotlib.
  • ‫tensorflow‏ (2.20.0): פלטפורמת קוד פתוח מקצה לקצה ללמידת מכונה.
  • ‫keras ‏(3.14.0): ממשק API של רשתות נוירונים ברמה גבוהה, שכתוב ב-Python ויכול לפעול על גבי TensorFlow,‏ CNTK או Theano.
  • ‫xgboost ‏(3.2.0): ספריית חיזוק גרדיאנט מבוזרת שעברה אופטימיזציה, שנועדה להיות יעילה, גמישה וניידת.
  • ‫thinc ‏(8.3.13): ספריית למידה עמוקה קלת משקל שמציעה API אלגנטי לתכנות פונקציונלי עם בדיקת סוגים, ליצירת מודלים.

עיבוד שפה טבעית (NLP)

  • ‫nltk ‏(3.9.1): פלטפורמה מובילה ליצירת תוכנות ב-Python לעבודה עם נתונים בשפה אנושית.
  • ‫spacy ‏(3.8.14): ספרייה לעיבוד שפה טבעית (NLP) מתקדם ב-Python וב-Cython.
  • ‫spacy-legacy ‏(3.0.12): רכיבים קודמים של spaCy.
  • ‫spacy-loggers ‏(1.0.5): כלי רישום לפרויקטים של spaCy.
  • ‫textblob ‏(0.19.0): ספרייה פשוטה לעיבוד טקסט, שמספקת API פשוט למשימות NLP נפוצות.
  • catalogue ‏(2.0.10): ספרייה קטנה לרישום פונקציות, שמשמשת לעיתים קרובות בצינורות עיבוד נתונים של NLP.
  • ‫confection ‏(1.3.3): מערכת הגדרות אישיות, שמשמשת לעיתים קרובות עם spaCy.
  • ‫cymem ‏(2.0.13): ניהול זיכרון ל-Cython, בשימוש על ידי spaCy.
  • ‫murmurhash ‏(1.0.15): קישורי Cython ל-MurmurHash, בשימוש על ידי spaCy.
  • ‫preshed ‏(3.0.13): טבלאות גיבוב (hash) ומסנני בלום (Bloom) של Cython, שמשמשים את spaCy.
  • ‫srsly ‏(2.5.3): כלי סריאליזציה מודרניים עם ביצועים גבוהים ל-Python.
  • ‫wasabi ‏(1.1.3): כלי עזר קלים להדפסה ולעיצוב של מסוף.
  • ‫weasel‏ (1.0.0): ממשק שורת הפקודה (CLI) לפרויקטים של spaCy.

חישוב מדעי וסימבולי

  • ‫mpmath‏ (1.3.0): ספריית Python לחישובים של נקודה צפה (floating-point) אמיתיים ומורכבים עם דיוק שרירותי.
  • ‫sympy ‏(1.13.3): ספריית Python למתמטיקה סימבולית.
  • ‫networkx ‏(3.6.1): חבילה ליצירה, לשינוי ולמחקר של המבנה, הדינמיקה והפונקציות של רשתות מורכבות.

ביצועים ואופטימיזציה

  • ‫numba‏ (0.64.0): קומפיילר Just-In-Time ל-Python שמתרגם קבוצת משנה של קוד Python ו-NumPy לשפת מכונה מהירה.
  • ‫llvmlite ‏(0.46.0): קישורי LLVM Python קלים לשימוש עם Numba.
  • ‫blis ‏(1.3.3): ספריית אלגברה לינארית דמוית BLAS, לעיתים קרובות תלות של חבילות מספריות.
  • ‫opt_einsum ‏(3.4.0): אופטימיזציה של ביטויי einsum ב-NumPy, ב-TensorFlow ובספריות מערכים אחרות.
  • ‫optree ‏(0.19.0): אופטימיזציה של מניפולציית PyTree ב-JAX.
  • ‫nvidia-nccl-cu12 ‏(2.29.7): ספריית NVIDIA Collective Communication, לתקשורת בין כמה מעבדי GPU.

מודלים סטטיסטיים

  • ‫statsmodels ‏(0.14.6): מספקת מחלקות ופונקציות להערכה של מודלים סטטיסטיים רבים ושונים, וגם לביצוע בדיקות סטטיסטיות וניתוח נתונים סטטיסטיים.
  • ‫patsy ‏(1.0.2): ספריית Python לתיאור מודלים סטטיסטיים ולבניית מטריצות עיצוב.

חקר ביצועים

  • <!-- empty -->ortools ‏(9.14.6206): חבילת כלים של Google לאופטימיזציה קומבינטורית.

המחשה

ספריות ליצירת המחשות סטטיות, מונפשות ואינטראקטיביות.

  • ‫matplotlib ‏(3.10.1): ספרייה מקיפה ליצירת תצוגות סטטיות, מונפשות ואינטראקטיביות ב-Python.
  • ‫matplotlib-inline ‏(0.2.1): קצה עורפי להטמעת תרשימי matplotlib ב-Jupyter Notebooks.
  • ‫matplotlib-venn ‏(1.1.2): ספרייה לשרטוט דיאגרמות ון.
  • thought ‫seaborn ‏(0.13.2): ספריית המחשה של נתונים סטטיסטיים שמבוססת על matplotlib. היא מספקת ממשק ברמה גבוהה ליצירת גרפיקה סטטיסטית מושכת ואינפורמטיבית.
  • ‫plotly ‏(6.1.2): ספריית תרשימים אינטראקטיביים שמאפשרת ליצור בקלות תרשימים יפים באיכות פרסום, אונליין ואופליין.
  • ‫bokeh ‏(3.8.2): ספריית ויזואליזציה אינטראקטיבית שמיועדת להצגה בדפדפני אינטרנט מודרניים.
  • ‫mizani ‏(0.13.5): קנה מידה לגרפיקה של Python, בהשראת ggplot2.
  • ‫contourpy ‏(1.3.1): מספקת אלגוריתמים ליצירת קווי גובה.
  • ‫cycler ‏(0.12.1): מחזורי סגנון קומפוזביליים ל-matplotlib.
  • ‫fonttools ‏(4.62.1): ספרייה לשינוי גופנים.
  • ‫kiwisolver ‏(1.5.0): הטמעה יעילה ב-C++‎ של אלגוריתם Cassowary לפתרון אילוצים.

עיבוד תמונות וסרטונים

ספריות לעבודה עם נתוני תמונות וסרטונים.

  • ‫opencv-python ‏(4.11.0.86): קישורי Python ל-OpenCV, ספרייה של פונקציות תכנות שמיועדות בעיקר לראייה ממוחשבת בזמן אמת.
  • ‫pillow ‏(11.1.0): פיצול ידידותי של Python Imaging Library ‏ (PIL), שמוסיף תמיכה בפתיחה, בשינוי ובשמירה של פורמטים רבים ושונים של קובצי תמונות.
  • ‫imageio ‏(2.37.0): ספרייה לקריאה ולכתיבה של מגוון רחב של נתוני תמונות, כולל תמונות מונפשות, סרטונים ונתונים נפחיים.
  • ‫scikit-image‏ (0.25.2): אוסף של אלגוריתמים לעיבוד תמונות.
  • ‫tifffile ‏(2026.4.11): קריאה וכתיבה של קובצי TIFF.

טיפול בקבצים וקלט/פלט

ספריות לקריאה, לכתיבה ולשינוי של פורמטים שונים של קבצים.

Excel

  • ‫openpyxl ‏(3.1.5): ספרייה לקריאה ולכתיבה של קובצי xlsx/xlsm/xltx/xltm ב-Excel 2010.
  • ‫xlrd ‏(2.0.1): ספרייה למפתחים לחילוץ נתונים מקובצי גיליונות אלקטרוניים של Microsoft Excel (tm).
  • ‫XlsxWriter ‏(3.2.0): מודול ליצירת קובצי Excel בפורמט XSLX.

PDF

  • ‫PyPDF2 ‏(3.0.1): ספריית PDF ב-Python טהור, שמאפשרת לפצל, למזג, לחתוך ולשנות את הדפים של קובצי PDF.
  • ‫fpdf ‏(1.7.2): ספרייה פשוטה ליצירת קובצי PDF.
  • thought ‫reportlab ‏(4.3.1): ספרייה מתקדמת ליצירת קובצי PDF.
  • ‫PyLaTeX ‏(1.4.2): ספרייה ליצירה ולקומפילציה של קובצי LaTeX.

Word

  • ‫python-docx ‏(1.1.2): ספרייה ליצירה ולעדכון של קובצי Microsoft Word ‏(‎.docx).

PowerPoint

  • ‫python-pptx ‏(1.0.2): ספרייה ליצירה ולעדכון של קובצי PowerPoint ‏(‎.pptx).

‫XML/HTML

  • lxml‏ (5.3.1): ספרייה קלה לשימוש עם הרבה תכונות לעיבוד XML ו-HTML.
  • ‫et_xmlfile ‏(2.0.0): ספרייה עם נפח זיכרון קטן ליצירת קובצי XML גדולים.

Markdown

  • ‫Markdown ‏(3.10.2): הטמעת Python של Markdown של John Gruber.
  • markdown-it-py‏ (4.0.0): מנתח Markdown, כמו שצריך. תמיכה מלאה ב-CommonMark.
  • thought ‫mdurl‏ (0.1.2): כלי URL ל-Markdown.

YAML

  • ‫PyYAML ‏(6.0.3): מנתח ופולט YAML ל-Python.

RTF

  • ‫striprtf ‏(0.0.28): ספרייה לחילוץ טקסט פשוט ממסמכי RTF.

קלט/פלט של קובץ כללי

  • ‫h5py ‏(3.16.0): ממשק Pythonic לפורמט הנתונים הבינאריים HDF5.
  • ‫smart_open ‏(7.6.0): כלי עזר לסטרימינג של קבצים גדולים (S3,‏ HDFS,‏ Cloud Storage וכו').
  • ‫cloudpathlib ‏(0.23.0): מחלקות בסגנון Pathlib לאחסון בענן.

אינטרנט ורשתות

ספריות לבקשות לאחזור מהרשת, לפיתוח שרתים ולתקשורת ברשת.

  • requests ‏(2.33.1): ספריית HTTP פשוטה ואלגנטית ל-Python, שמיועדת לבני אדם.
  • ‫httpx ‏(0.28.1): צד הלקוח ב-HTTP עם כל התכונות ל-Python, כולל תמיכה ב-HTTP/1.1 וב-HTTP/2 ויכולות אסינכרוניות.
  • ‫httpcore ‏(1.0.9): צד הלקוח ב-HTTP ברמה נמוכה, שמהווה את הליבה של HTTPX.
  • ‫urllib3 ‏(2.6.3): צד לקוח ב-HTTP ל-Python, עוצמתי וידידותי למשתמש.
  • ‫grpcio ‏(1.80.0): ספריית Python gRPC (קריאה לשירות מרוחק של Google).
  • ‫h11 ‏(0.16.0): הטמעה של HTTP/1.1 ב-Pure-Python, עם קלט/פלט משלכם.
  • ‫idna ‏(3.11): תמיכה ב-Internationalized Domain Names in Applications (IDNA) 2008.
  • ‫certifi ‏(2026.2.25): אוסף של אישורי בסיס (Root Certificates) של Mozilla, שמאפשרים לאמת את המהימנות של אישורי SSL.
  • ‫tornado ‏(6.5.5): מסגרת אינטרנט וספריית רשת אסינכרונית.
  • ‫Werkzeug ‏(3.1.8): ספרייה מקיפה של אפליקציות אינטרנט מסוג WSGI.
  • ‫Jinja2 ‏(3.1.6): שפת תבניות מודרנית ונוחה למעצבים ב-Python.
  • ‫MarkupSafe ‏(3.0.3): הוספה בטוחה של מחרוזות לא מהימנות לתגי עיצוב של HTML או XML.

כלי פיתוח וכלי עזר

כלי עזר כלליים, כלים לפיתוח אפליקציות ועזרי פיתוח.

אריזה והפצה

  • ‫pip ‏(24.2): מנהל ההתקנה של חבילות ל-Python.
  • ‫setuptools ‏(82.0.1): ספרייה לאריזת פרויקטים ב-Python.
  • ‫wheel ‏(0.46.3): פורמט של חבילה מובנית ל-Python.
  • ‫packaging ‏(24.0): כלי שירות בסיסיים לחבילות Python.

ממשקי שורת הפקודה (CLI)

  • ‫click ‏(8.3.2): ערכת כלים ליצירת ממשק שורת פקודה (CLI) קומפוזבילי.
  • typer‏ (0.24.1): ספרייה ליצירת אפליקציות CLI עם רמזים לסוגים.
  • ‫rich‏ (15.0.0): ספרייה לטקסט עשיר ועיצוב יפה בטרמינל.
  • ‫termcolor ‏(3.3.0): עיצוב צבע ANSII לפלט בטרמינל.
  • ‫tqdm ‏(4.67.3): סרגל התקדמות מהיר וניתן להרחבה ל-Python ול-CLI.
  • ‫shellingham ‏(1.5.4): כלי לזיהוי המעטפת של המשתמש.

אימות נתונים וסכימות

  • ‫pydantic ‏(2.13.1): אימות נתונים וניהול הגדרות באמצעות הערות מסוג Python.
  • ‫pydantic_core ‏(2.46.1): לוגיקת אימות ליבה ל-Pydantic.
  • ‫annotated-types ‏(0.7.0): סוגי אילוצים לשימוש חוזר לארגומנטים של פונקציות, משתנים ושדות של dataclass.
  • ‫jsonschema ‏(4.23.0): הטמעה של סכימת JSON ל-Python.
  • ‫jsonschema-specifications ‏(2024.10.1): מטא-סכימות ואוצר מילים של סכימת JSON.
  • ‫referencing ‏(0.37.0): רזולוציה של הפניות ב-JSON.

סידור הפרקים

  • ‫protobuf ‏(6.31.1): מאגרי האחסון לפרוטוקולים של Google.
  • flatbuffers (25.12.19): ספריית סריאליזציה יעילה בפלטפורמות שונות.

בו-זמניות ומקביליות

  • ‫anyio ‏(4.13.0): שכבת תאימות אסינכרונית שמאפשרת לכתוב קוד אסינכרוני שפועל בלולאות אירועים אסינכרוניות שונות.
  • ‫joblib ‏(1.4.2): צינור עיבוד נתונים קל: כלים להרצת פונקציות Python כצינור עיבוד נתונים.
  • ‫threadpoolctl ‏(3.6.0): ממשק Python לשליטה במספר ה-threads שמשמשים במאגרי ה-threads של ספריות נפוצות.

ניתוח

  • ‫pyparsing ‏(3.2.1): גישה חלופית ליצירה ולהפעלה של דקדוקים פשוטים, בהשוואה לגישת lex/yacc הרגילה.
  • ‫astunparse ‏(1.6.3): Unparser לעצי תחביר מופשטים של Python.

ממשק פונקציות זרות (FFI) ורמה נמוכה

  • ‫libclang ‏(18.1.1): קישורי Clang Python.

תאריך ושעה

  • ‫python-dateutil ‏(2.9.0.post0): תוספים למודול datetime הרגיל.
  • pytz (2025.2): הגדרות אזורי זמן עולמיים, מודרניים והיסטוריים.
  • ‫tzdata ‏(2025.3): נתונים של אזור זמן.

כלי ניהול כלליים

  • ‫attrs ‏(25.3.0): מחלקות ללא קוד סטנדרטי.
  • ‫toolz ‏(1.0.0): ספרייה סטנדרטית פונקציונלית ל-Python.
  • ‫six ‏(1.17.0): כלי תאימות ל-Python 2 ו-Python 3.
  • ‫wrapt ‏(2.1.2): מודול ל-decorators, ל-wrappers ול-monkey patching.
  • ‫immutabledict ‏(4.3.1): מילון שלא ניתן לשינוי.
  • ordered-set ‏(4.1.0): מבנה נתונים שניתן לשינוי, שהוא שילוב של רשימה וקבוצה.
  • lazy-loader ‏(0.5): ייבוא עצל של מודולים של Python.
  • thought ‫google-pasta ‏(0.2.0): ספרייה לשינוי מבנה הקוד (refactoring) של Python.
  • ‫traitlets ‏(5.14.3): מערכת הגדרות לאפליקציות Python.
  • ‫regex ‏(2026.4.4): מודול חלופי של ביטויים רגולריים, שמחליף את המודול re של Python.
  • ‫chardet ‏(7.4.3): גלאי אוניברסלי של קידוד תווים.
  • ‫charset-normalizer ‏(3.4.7): הגלאי האוניברסלי הראשון של ערכות תווים.
  • ‫typing_extensions ‏(4.15.0): רמזים ניסיוניים לסוגי נתונים והיסב בגרסאות מוקדמות יותר (backporting) ל-Python 3.7 ואילך.
  • ‫typing-inspection ‏(0.4.2): בדיקת סוגים בזמן ריצה ב-Python.
  • ‫Pygments ‏(2.20.0): כלי להדגשת תחביר של Python.
  • ‫ml_dtypes ‏(0.5.4): dtypes ללמידת מכונה.
  • ‫rpds-py ‏(0.30.0): מבני נתונים קבועים של Rust ל-Python.
  • ‫annotated-doc‏ (0.0.4): ספרייה להוספת הערות למסמכים.
  • ‫namex ‏(0.1.0): ספריית שירות.

ניפוי באגים ויצירת פרופילים

  • ‫tensorboard ‏(2.20.0): ערכת הכלים של TensorFlow להמחשה חזותית.
  • ‫tensorboard-data-server ‏(0.7.2): שרת נתונים ל-TensorBoard.

גיאו-מרחבי

ספריות שתוכננו במיוחד לטיפול בנתונים גיאו-מרחביים.

  • ‫geopandas ‏(1.0.1): מרחיבה את סוגי הנתונים שבהם משתמשת pandas כדי לאפשר פעולות מרחביות על סוגים גיאומטריים.
  • pyogrio ‏(0.12.1): קלט/פלט וקטורי לפורמטים של קובצי וקטורים גיאו-מרחביים.
  • ‫pyproj ‏(3.7.2): ממשק Python ל-PROJ (ספרייה של היטלים קרטוגרפיים וטרנספורמציות של קואורדינטות).
  • ‫shapely ‏(2.1.2): חבילה לטיפול באובייקטים גיאומטריים מישוריים ולניתוח שלהם.
  • ‫xyzservices ‏(2026.3.0): מקור של ספקי משבצות XYZ.

שונות

  • ‫chess ‏(1.11.2): ספריית שחמט ב-Python טהור עם יצירה ואימות של מהלכים, ניתוח וכתיבה של PGN ועוד.
  • ‫gast‏ (0.7.0): ממיר AST ל-AST גנרי.

המאמרים הבאים