נכון ל-11 במרץ 2025, השקנו את אבני הבניין של פלטפורמת הסוכנים החדשה שלנו. לפרטים, עיינו בתיעוד ה-API שלנו עבור Responses API, כלים ובהם חיפוש באינטרנט, חיפוש בקבצים ושימוש במחשב, וכן ערכת הפיתוח לסוכנים שלנו עם מעקב אחר ביצוע.
קריאה לפונקציות מאפשרת לחבר מודלים של OpenAI לכלים ולמערכות חיצוניים. היכולת הזו שימושית למטרות רבות, כמו הוספת יכולות לעוזרי בינה מלאכותית או יצירת אינטגרציות עמוקות בין האפליקציות שלכם למודלי שפה גדולים.
למידע נוסף, עיינו במדריך למפתחים בנושא קריאה לפונקציות.
ביוני 2024 השקנו פלט במבנה מוגדר. במודלים ובתצורות בקשה נתמכים, כשהמודל מפיק קריאה לפונקציה, הוספת strict: true להגדרת הפונקציה מבטיחה שהארגומנטים שנוצרים יתאימו לסכמה שסופקה, בתנאי שהסכמה משתמשת בתת-הקבוצה הנתמכת של JSON Schema ועומדת בדרישות המצב הקפדני. בקשות עם סכמות שאינן נתמכות או שאינן עומדות בדרישות נדחות ומוחזרת שגיאה.
באוקטובר 2024 השקנו את התכונה ״ליצור כל דבר״, שמאפשרת למפתחים לתאר פונקציה, להדביק אותה ישירות או להדביק קוד, וליצור סכמה תקינה לפונקציה. למידע נוסף על ״ליצור כל דבר״, עיינו במאמר במרכז העזרה כאן.
איך משתמשים בקריאה לפונקציות?
קריאה לפונקציות שימושית במגוון רחב של תרחישים, כגון:
מתן אפשרות לעוזרים לשלוף נתונים:
מתן אפשרות לעוזרים לבצע פעולות:
מתן אפשרות לעוזרים לבצע חישובים:
בניית תהליכי עבודה עשירים:
תהליך לחילוץ נתונים ששולף טקסט גולמי, ממיר אותו לנתונים מובנים ושומר אותם במסד נתונים.
קריאה לפונקציות נתמכת ב-Responses API, שמאחד יכולות שבעבר היו מפוצלות בין ה-API להשלמת צ'אטים לבין ה-Assistants API.
איך משתמשים במצב JSON?
כשמצב JSON מופעל, מובטח שפלט המודל יהיה JSON תקין, למעט במקרי קצה מסוימים שיש לזהות ולטפל בהם כראוי.
כדי לבקש מצב JSON ב-API להשלמת צ'אטים, יש להגדיר את response_format לערך { "type": "json_object" } במודלים הנתמכים. ב-Responses API, יש להגדיר את text.format לערך { "type": "json_object" }, למשל text: { "format": { "type": "json_object" } }, במקרים שבהם הדבר נתמך. בשני ממשקי ה-API, מצב JSON פועל רק כשמתקיימים התנאים המוקדמים הנוגעים למודל, להודעות ולכלים (למשל, המודל תומך ב-json_object, השיחה כוללת הוראות להפקת JSON, וכל מגבלות הכלים תואמות למצב זה). לפחות הודעת בקשה אחת או הודעת קלט אחת בהקשר הקלט בפועל חייבת להכיל json, ללא תלות ברישיות, למשל JSON, json או Json; אחרת, ה-API מחזיר שגיאה. ב-Responses, השדה instructions ברמה העליונה לבדו אינו מספיק כדי לעבור בדיקת תקינות זו. כשמשתמשים בקריאה לפונקציות במודלים או במסלולים תואמים, מגבלות JSON מוחלות אוטומטית על הארגומנטים של הקריאה לפונקציה; מודלים לא תואמים או שילובים לא תואמים של כלים ופורמט תגובה עשויים להידחות, או שלא ייעשה בהם שימוש בדגימה הכפופה למגבלות JSON.
הערות חשובות:
כשמשתמשים במצב JSON, חובה תמיד להורות למודל להפיק JSON באחת ההודעות בשיחה, למשל בהודעת המערכת. ללא הוראה מפורשת ליצור JSON, המודל עלול ליצור רצף אינסופי של תווי רווח, והבקשה עלולה להמשיך לרוץ עד להגעה למגבלת הטוקנים. כדי לעזור למנוע שכחה של ההוראה, מצב JSON דוחה בקשות אלא אם הודעות הקלט או ההוראות הרלוונטיות מכילות את המילה
jsonברישיות כלשהי.מצב JSON אינו מבטיח שהפלט יתאים לסכמה מסוימת, אלא רק שהוא יהיה תקין וניתן יהיה לפענח אותו ללא שגיאות. מומלץ להשתמש בפלט במבנה מוגדר כדי להבטיח התאמה לסכמה שלכם. אם הדבר אינו אפשרי, מומלץ להשתמש בספריית בדיקת תקינות, ובמידת הצורך גם בניסיונות חוזרים, כדי לוודא שהפלט תואם לסכמה הרצויה.
האפליקציה שלכם חייבת לזהות את מקרי הקצה שבהם פלט המודל עלול לא להיות אובייקט JSON שלם, ולטפל בהם (ראו בהמשך)
