סקירה כללית

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

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

מה סוכן יכול לעשות?

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

למידע על היכולות הנתמכות ולדוגמאות, עיינו בסקירה הכללית של Agents API.

איך מתחילים?

1. צרו מפתח API לאפליקציה בפרויקט שלכם בפלטפורמת OpenAI. העניקו את ההרשאות api.agents.read ו-api.agents.write לסשנים, וכן את ההרשאה api.responses.write לבקשות למודל.

2. פעלו לפי מדריך ההתחלה המהירה כדי להגדיר סוכן, ליצור סשן ולשלוח משימה.

3. עקבו אחר אירועי הסשן כדי לבדוק את ההתקדמות ואת התוצאות. שמרו את מזהה הסשן אם ברצונכם להמשיך בעבודה.

שמרו את מפתח ה-API שלכם מחוץ לסביבה המבודדת של הסוכן. הבקשות מחייבות את הכותרת OpenAI-Beta: agents=v1. ערכות ה-SDK של OpenAI מוסיפות את הכותרת הזו אוטומטית.

האם הסוכן שלי צריך סביבה מבודדת?

בחרו את הסביבה המתאימה למשימה:

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

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

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

לפרטי התצורה, עיינו בארכיטקטורה של Agents API.

איפה אפשר לבדוק סשן?

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

מדריך הניטור מסביר גם איך לבדוק את נתוני השימוש בטוקנים שנרשמו.

מה עושים אם זרם האירועים מתנתק?

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

השלמת סבב שיחה אינה מעידה שכל הכלים פעלו בהצלחה. בדקו את התוצאה שדווחה. עצם היותו של סשן במצב המתנה אינו מעיד שהמשימה הושלמה בהצלחה.

איך מחויב השימוש?

בקשות למודל מחויבות לפי תעריפי ה-API של המודל שנבחר. כלים של OpenAI וסביבות מבודדות המתארחות אצל OpenAI מחויבים לפי תעריפי הכלים והקונטיינרים הרלוונטיים.

לתעריפים העדכניים, עיינו במחירון ה-API.

איך מטופלים הנתונים והקבצים של הסשן?

Agents API שומר את מצב הסשן כדי לאפשר המשכיות בעבודה בין סבבי שיחה. אפשר למחוק סשנים ותוצרים שפורסמו כשאין בהם עוד צורך. שמרו את כל הקבצים הדרושים לכם לפני מחיקת סשן.

Agents API תומך כרגע בתושבות נתונים בארצות הברית בלבד. הוא אינו תומך באפס שמירת נתונים (ZDR), גם בעת שימוש בסביבה מבודדת באירוח עצמי. לפרטים על בקרות הנתונים, עיינו בתיעוד של Agents API.