דף עזר

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

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

פרמטרי ליבה

modelבחירת מודל

מזהה המודל שיענה. דוגמה: claude-opus-4-5 או claude-sonnet-4-5. שדה חובה - אין ברירת-מחדל.

max_tokensתקרת אורך תשובה

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

messagesמערך הודעות

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

systemפרומפט מערכת

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

פרמטרי דגימה

temperatureטמפרטורה

ערך בין 0 ל-1. נמוך = תשובות צפויות ועקביות. גבוה = יצירתי ומגוון. ברירת-מחדל 1. למשימות סיווג מומלץ 0.

top_pסף הסתברות מצטברת

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

top_kגודל מאגר הדגימה

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

stop_sequencesרצפי עצירה

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

צורת התשובה

streamהזרמת תשובה

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

tool_choiceאכיפת בחירת כלי

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

toolsמערך כלים

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

response_formatפורמט תשובה

מבנה את הפלט - לרוב אובייקט JSON עם schema. שימושי לפלט מובנה צפוי, אבל עולה ב-latency.

מטא ובקרה

metadata.user_idמזהה משתמש

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

anthropic-versionגרסת API

תאריך גרסה בכותרת ה-HTTP. נעולה לגרסה כדי לא להישבר כשה-API מתפתח. מומלץ לנעול ולא לעקוב אחרי 'latest'.

anthropic-betaיכולות בבטא

כותרת HTTP להפעלת יכולות שעדיין לא יציבות - prompt caching, batch API, ועוד. שמות הפיצ'רים מופרדים בפסיק.

cache_controlמטמון פרומפט

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

ערכים מומלצים לפי משימה

סיווג / חילוץטמפרטורה 0

כשרוצים פלט יציב וצפוי - סיווג, חילוץ ישויות, JSON מובנה. אפסו את הטמפרטורה. top_p נשאר 1.

כתיבה יצירתיתטמפרטורה 1

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

צ'אט כלליטמפרטורה 0.7

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

קודטמפרטורה 0.2

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