הפעלת קוד

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

התכונות של Code Execution כוללות:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • ‫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): ספרייה לעיבוד מתקדם של שפה טבעית ב-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 ומסנני בלום של Cython, בשימוש ב-spaCy.
  • ‫srsly (2.5.3): כלי עזר מודרניים לביצוע סדרות (serialization) בביצועים גבוהים עבור Python.
  • ‫wasabi (1.1.3): כלי עזר קלים להדפסה ולעיצוב של מסוף.
  • ‫weasel (1.0.0): ממשק שורת פקודה לפרויקטים של spaCy.

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

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

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

  • ‫numba (0.64.0): מהדר בזמן ריצה (JIT) ל-Python שמתרגם קבוצת משנה של קוד Python ו-NumPy לשפת מכונה מהירה.
  • ‫llvmlite (0.46.0): קשירות Python קלות משקל ל-LLVM לשימוש עם 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, לתקשורת בין כמה מעבדים גרפיים.

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

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

חקר ביצועים

  • ‫ortools (9.14.6206): Google Optimization Tools, חבילת כלים לאופטימיזציה קומבינטורית.

תצוגה חזותית

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

  • ‫matplotlib (3.10.1): ספרייה מקיפה ליצירת ויזואליזציות סטטיות, מונפשות ואינטראקטיביות ב-Python.
  • ‫matplotlib-inline (0.2.1): Backend להטמעת תרשימים של matplotlib ב-Jupyter notebooks.
  • ‫matplotlib-venn (1.1.2): ספרייה לשרטוט דיאגרמות ון.
  • ‫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): ספרייה לקריאה/כתיבה של קובצי Excel 2010‏: xlsx/xlsm/xltx/xltm
  • ‫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.
  • ‫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.
  • ‫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,‏ GCS וכו').
  • ‫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 ב-Python טהור, עם קלט/פלט משלכם.
  • ‫idna (3.11): תמיכה בשמות דומיין בינלאומיים באפליקציות (IDNA) משנת 2008.
  • ‫certifi (25.2.2026): מספק אוסף שנאסף בקפידה של 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): סוגי אילוצים לשימוש חוזר לארגומנטים של פונקציות, למשתנים ולשדות של מחלקות נתונים.
  • ‫jsonschema (4.23.0): הטמעה של סכימת JSON ל-Python.
  • ‫jsonschema-specifications (2024.10.1): מטא-סכימות ומילונים של JSON Schema.
  • הפניה (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 לשליטה במספר השרשורים שמשמשים במאגרי שרשורים של ספריות נפוצות.

ניתוח

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

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

  • ‫libclang (18.1.1): Clang Python bindings.

תאריך ושעה

  • ‫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 ו-3.
  • ‫wrapt ‏ (2.1.2): מודול לקישוטים, לעטיפות ולתיקוני באגים.
  • ‫immutabledict (4.3.1): מילון קבוע.
  • ‫ordered-set (4.1.0): מבנה נתונים ניתן לשינוי שהוא שילוב של רשימה וקבוצה.
  • ‫lazy-loader (0.5): ייבוא עצל של מודולים של Python.
  • ‫google-pasta‏ (0.2.0): ספרייה לשינוי מבנה של קוד 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): Backported and Experimental Type Hints for Python 3.7+‎
  • ‫typing-inspection (0.4.2): בדיקת סוגים בזמן ריצה ב-Python.
  • ‫Pygments (2.20.0): כלי להדגשת תחביר של Python.
  • ‫ml_dtypes (0.5.4): סוגי נתונים ללמידת מכונה.
  • ‫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.

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