מדריכים
הפעלת ריצה עם האשף
כל שלב באשף ההגשה, מהמשימה ועד בדיקת החוזה.
אשף ההגשה מגדיר ריצה ומתחיל אותה. יש בו ארבעה שלבים: משימה, קלטים, מאפטם ו-מדד והרצה. בכל שלב יש מסך אחד או יותר. המדריך הזה מסביר כל מסך, מהמשימה ועד בדיקת החוזה ותחילת הריצה.
שלב 1: משימה
מה תרצו לייעל?
תאר/י את המשימה לעוזר בצ'אט ראיון משימה. העוזר כותב בשבילך שני שדות:
- מטרה (מודרך: המטרה): במה התוצר המיועל צריך להצטיין.
- רקע (מודרך: הקשר נוסף): הקשר, מגבלות ואיך נראית תוצאה טובה.
אפשר לערוך את שני השדות. העוזר לא דורס את העריכות שלך.
מה נייעל
בחר/י את סוג התוצר:
| סוג התוצר | מה משתנה |
|---|---|
| פרומפט | הוראות שנשלחות למודל שפה |
| קוד | קוד המקור של תוכנית |
| תוכנית DSPy | ההוראות של ה-predictors במודול DSPy |
| טקסט | כל טקסט אחר, כמו מסמך או תבנית |
אחר כך תן/תני את גרסת התחלה (מודרך: מאיפה מתחילים). הדבק/י את הגרסה הנוכחית, או תן/תני לעוזר לכתוב טיוטה.
אופטימיזציה של מאגר קוד
אפשר גם לייעל קוד במאגר קוד. הגדר/י את השדות האלה:
- מאגר: בחר/י מאגר קוד, או כתוב/י אותו בצורה
owner/name. - קומיט: SHA באורך 40 תווים. השאר/י ריק כדי להשתמש בקומיט האחרון בענף.
- נתיבים שהאופטימייזר רשאי לשנות: קובץ או תיקייה בכל שורה. נקודה פירושה המאגר כולו.
- פקודת התקנה: רצה בכל עותק חדש של המאגר לפני הניקוד. אם השדה נשאר ריק, Skynet ימצא את הפקודה בעצמו.
שלב 2: קלטים
נתונים
הוסף/הוסיפי את המקרים לריצה. אפשר:
- להעלות קובץ CSV, JSON או Excel.
- לבחור דאטאסט מהספרייה שלך.
קרא/י את דאטאסטים וחלוקה ואת הכנת דאטאסט.
איך לקרוא את הנתונים
העוזר קורא את הנתונים ומציע איך להשתמש בהם. בדוק/בדקי את הבחירות שלו:
- סמן/י כל עמודה כקלט, כפלט הצפוי, או כעמודה שמדלגים עליה.
- כשאין עמודת פלט, Skynet משתמש בשורה הראשונה כקלט אחד.
- הגדר/י את החלוקה לסט אימון, סט אימות וסט בדיקה. סכום החלוקה חייב להיות 1.
שלב 3: מאפטם
ברמה רגיל יש בשלב הזה מסך אחד. הוא מציג את האופטימייזר, את התקציב, ובמקרה הצורך את המודלים. ברמות מודרך ומומחה יש בשלב שלושה מסכים: אופטימייזר, מודלים ו-תקציב.
אופטימייזר
האשף מציג רק את האופטימייזרים שמתאימים למשימה ולקלטים שלך. Auto נבחר בשבילך. אפשר לבחור אופטימייזר אחר. קרא/י את מנועים ואת איך האופטימיזציה עובדת.
מודלים
- מודל המשימה: המודל שקוד ההרצה שלך קורא לו. השאר/י ריק אם קוד ההרצה לא קורא למודל. לתוכנית DSPy חייב להיות מודל משימה.
- מודל רפלקציה: מודל האופטימיזציה, שקורא את הציונים ואת המשוב וכותב את המועמדים הבאים. באופטימייזר מסוג סוכן קוד, זה המודל של הסוכן.
תקציב
הגדר/י כמה זמן הריצה יכולה להמשיך לנסות, וכמה היא יכולה להוציא:
- מקסימום הרצות ניקוד (מודרך: מקסימום ניסיונות): המספר המרבי של מועמדים ש-Skynet נותן להם ציון. חלק מהאופטימייזרים צריכים מספר מינימלי.
- עצירה בציון (מודרך: לעצור מוקדם כשהציון מגיע ל-): הריצה נעצרת כשגרסה מגיעה לציון הזה.
- מקסימום איטרציות (מודרך: מקסימום סבבים): מופיע באופטימייזרים שתומכים בזה.
- תקרת הוצאה: הסכום המרבי שהריצה יכולה להוציא. ברירת המחדל היא $5, או הסכום נדרש כדי להתחיל אם הוא גבוה יותר. אפשר גם לבחור ללא תקרה.
האשף לא מאפשר להמשיך אם התקרה או היתרה שלך נמוכות מהסכום שנדרש כדי להתחיל. קרא/י את תקציבים וחיוב.
שלב 4: מדד והרצה
קוד ומדד
כתוב/י שני קבצים:
run.py: קוד ההרצה שמריץ את התוצר שלך על מקרה אחד.metric.py: פונקציית המדידה (Metric) שנותנת ציון לפלט וכותב משוב.
סוכן הקוד יכול לכתוב ולשנות כל קובץ בשבילך. הוא בודק את הקוד שלו ומתקן את מה שנכשל. אפשר להוסיף עד 20 קבצים נוספים. קרא/י את פונקציות מדידה ופונקציות ציון.
אם פונקציית המדידה שלך קוראת ל-llm(), הגדר/י את מודל המדד. כברירת מחדל היא משתמשת במודל האופטימיזציה.
בדיקת חוזה
בדיקת חוזה (מודרך: הרצת ניסיון) מריצה את הקוד ואת פונקציית המדידה שלך ב-sandbox על 3 מקרים לדוגמה. היא בודקת:
- את החתימה של קוד ההרצה,
- את החתימה של פונקציית המדידה,
- את המודל של פונקציית המדידה,
- את קוד ההרצה על הדוגמאות,
- את הערך שפונקציית המדידה מחזירה.
בחר/י בדיקה (מודרך: ניסיון). אי אפשר להתחיל את הריצה עד שהבדיקה עוברת. אם משנים את הקוד או את ההגדרות אחרי שהבדיקה עברה, יש להריץ את הבדיקה שוב.
ריצה מתוזמנת
אפשר להריץ את האופטימיזציה שוב לפי לוח זמנים אחרי שהיא מצליחה. ברירת המחדל היא כבויה.
מוכן להרצה
המסך האחרון מציג סיכום בחמש לשוניות: כללי, נתונים, מודלים, תקציב ו-תגמול. בדוק/בדקי את ההגדרות, ואז התחל/י את האופטימיזציה.
הסיכום מציג גם את הנראות של הריצה. ריצות חדשות הן ציבוריות כברירת מחדל. אפשר לשנות את זה אחר כך בחלון שיתוף ופרטיות בעמוד הריצה. קרא/י את שיתוף ופרסום.
אחרי שמתחילים
עמוד הריצה נפתח. קרא/י את ריצות ואת קריאת התוצאות.