טמפרטורה ופרמטרים

מזהה המודל שיענה. הדור הנוכחי: claude-opus-5, claude-sonnet-5, claude-haiku-4-5, claude-fable-5. שדה חובה - אין ברירת-מחדל. המחרוזת המדויקת קריטית: claude-sonnet-5 זה לא claude-sonnet.

המספר המרבי של טוקנים בתשובה. שדה חובה. במודלים הנוכחיים אפשר עד 128K (ב-Haiku 4.5 עד 64K). זו תקרה ולא יעד - המודל עשוי לסיים מוקדם. מעל 16K בערך הפעילו stream, אחרת הבקשה עלולה ליפול על timeout.

רשימת ההודעות בשיחה, לסירוגין user ו-assistant. ההודעה האחרונה חייבת להיות user. שדה חובה.

הוראות יציבות שמלוות את כל הפנייה - זהות, טון, הקשר קבוע. נמסר כשדה נפרד, לא בתוך messages.

thinking: {type: "adaptive"} מפעיל חשיבה פנימית לפני התשובה, והמודל מחליט לבד כמה להשקיע לפי מורכבות הבקשה. זה מחליף את budget_tokens, שהוסר במודלים החדשים. שווה למשימות רב-שלביות, קוד ומתמטיקה.

חמש רמות: low, medium, high, xhigh, max. קובעות כמה עבודה המודל משקיע לפני שהוא עונה - low לתשובות מהירות וזולות, high ומעלה למשימות שדורשות ניתוח. זו הדרך המרכזית לכוון עומק בדור הנוכחי.

ערך בין 0 ל-1 ששולט בגיוון. שימו לב: הפרמטר הוסר במודלים החדשים - Opus 5 ו-Fable 5 יחזירו 400, ו-Sonnet 5 דוחה כל ערך שאינו ברירת-המחדל. הוא עדיין עובד ב-Haiku 4.5 ובדורות הקודמים. בדור הנוכחי מכוונים סגנון דרך הפרומפט.

שתי דרכים חלופיות לצמצם את הטוקנים שמהם המודל דוגם. אותה מגבלה כמו בטמפרטורה: הוסרו ב-Opus 5 וב-Fable 5, נדחים ב-Sonnet 5, ופעילים רק ב-Haiku 4.5 ובמודלים ישנים - וגם שם לרוב אין סיבה לגעת בהם.

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

true = מקבלים את הפלט טוקן-אחר-טוקן בזמן אמת. false = מקבלים את התשובה בסיום. ברירת-מחדל false.

auto = המודל מחליט. any = חובה להשתמש בכלי כלשהו. tool = חובה להשתמש בכלי הספציפי הזה. none = אסור להשתמש בכלים.

רשימת פונקציות שהמודל יכול לקרוא להן. כל כלי כולל שם, תיאור, ו-schema של הפרמטרים שלו.

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

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

תאריך גרסה בכותרת ה-HTTP. הערך התקף הוא 2023-06-01 והוא לא השתנה מאז. נעילה לגרסה מונעת שבירה כשה-API מתפתח - אל תעקבו אחרי 'latest'.

כותרת HTTP להפעלת יכולות ניסיוניות בלבד, מופרדות בפסיק. שימו לב: prompt caching ו-Batch API כבר יציבים (GA) ולא דורשים אותה. מדריך שמבקש כותרת בטא בשבילן פשוט לא מעודכן.

מסמן חלקים קבועים בפרומפט לשמירה במטמון, ולא דורש שום כותרת בטא. קריאה מהמטמון עולה בערך עשירית ממחיר הקלט הרגיל; הכתיבה עולה פי 1.25 (מטמון של חמש דקות) או פי 2 (שעה).

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

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

ברירת-המחדל הסבירה לרוב היישומים: claude-sonnet-5, מאמץ low או medium, ו-stream: true כדי שהמשתמש יראה תשובה כמעט מיד.

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