סקירה כללית

מאמר זה מסביר כיצד להגדיר פעולות ב-GPT, כולל חיבור לממשקי API חיצוניים, הגדרת היכולות של ה-GPT וניהול אימות, סכמות והגבלות workspace.

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

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

מגבלות

אם ה-workspace שלכם אינו מתיר אף דומיין לפעולות, לא ניתן להפעיל פעולות מותאמות אישית של GPT, משום שאף דומיין של פעולה לא יעבור את הבדיקה מול רשימת הדומיינים המורשים. אין פירוש הדבר בהכרח שכל אפשרויות הצפייה בכלי GPT או הגישה אליהם חסומות.

פעולות אינן זמינות במצב Pro. כשיוצרים או עורכים GPT עם פעולות מותאמות אישית, בורר המודלים מציג רק מודלים שתומכים בפעולות ואינם מודלי Pro.

יצירת פעולה

בעורך ה-GPT, עברו לסעיף פעולות ובחרו באפשרות יצירת פעולה חדשה.

לאחר מכן תגדירו כיצד ה-GPT שלכם מתחבר ל-API חיצוני ומשתמש בו.

לאחר הגדרת פעולה, בדקו אותה בתצוגה מקדימה כדי לוודא שהיא פועלת כמצופה.

אימות

הגדרות האימות קובעות כיצד ה-GPT שלכם מתחבר ל-API חיצוני.

האפשרויות הזמינות:

• ללא: לא נדרש אימות

• מפתח API: שימוש במפתח סודי לאישור בקשות

• OAuth: שימוש בכניסת משתמש לצורך גישה מבוססת חשבון

מפתח API

לגישה בין שרתים, יש להשתמש באימות באמצעות מפתח API. ניתן להגדיר אותו באחת מהדרכים הבאות:

• Basic

• Bearer

• כותרת HTTP מותאמת אישית

OAuth

יש להשתמש ב-OAuth כשפעולות דורשות חשבונות משתמש. לשימוש ב-OAuth נדרשים:

• מזהה לקוח וסוד לקוח

• כתובת URL להרשאה וכתובת URL לאסימון

• היקף הרשאות ושיטת החלפת אסימונים

העורך מספק כתובת URL לחזרה (callback) לצורך השלמת תהליך OAuth.

סכמה

הסכמה מגדירה את יכולות ה-API שלכם. היא מגדירה ל-ChatGPT:

• לאיזה שרת לפנות

• אילו נקודות קצה זמינות

• אילו פרמטרים הן מקבלות

• כיצד מזוהה כל פעולה (מזהי פעולות)

יש לספק את הסכמה כמפרט OpenAPI בפורמט JSON או YAML.

הוספת סכמה

אפשר להוסיף סכמה בשלוש דרכים:

• להדביק אותה ישירות בעורך

• לייבא אותה מכתובת URL

• להתחיל מדוגמה מובנית:

  • מזג אוויר (JSON)

  • חנות חיות מחמד (YAML)

  • תבנית ריקה

אם הסכמה תקינה, העורך מציג את הפעולות שזוהו. אם היא אינה תקינה, מוצגות שגיאות אימות.

הגבלות workspace ‏(Enterprise ו-Edu)

אם מופיעה ההודעה:


״הגדרות ה-workspace שלכם אינן מתירות אף דומיין.״

משמעות הדבר היא שהגדרות ה-workspace שלכם מגבילות את השימוש בפעולות.

• מנהלי מערכת יכולים להתיר את כל הדומיינים או להגביל את הפעולות לדומיינים מאושרים.

• אם אף דומיין אינו מורשה, לא ניתן להשתמש בפעולות.

למידע על בקרות לפעולות ועל הגבלות דומיינים ברמת ה-workspace, ראו: ניהול הגישה לכלי GPT בסביבות workspace של Enterprise ו-Edu.

פרטיות ובקרות למשתמשים

• כל פעולה יכולה לכלול כתובת URL של מדיניות פרטיות.

• כלי GPT ציבוריים (הזמינים דרך קישור או בחנות GPT) שמשתמשים בפעולות חייבים לכלול כתובת URL תקינה של מדיניות פרטיות.

• ייתכן שהמשתמשים יתבקשו לאשר פעולות לפני הפעלתן.

• בפעולות שמשתמשות ב-OAuth, המשתמשים יכולים לעיין בחשבונות המחוברים ולנהל אותם.

עזרה נוספת

לקבלת עזרה בכתיבת פעולות או בניפוי שגיאות בהן, אפשר להשתמש בכלי הרשמי ActionsGPT.