יצירת אסימון API עבור סוכן AI
צור אסימון API באשף בן ארבעה שלבים (מטרה, הרשאות, מגבלות, סקור): הגדרות קבועות מראש, הרשאות, תוקף, אתרי תיעוד, תקרות הוצאות ורשימת היתרים לכתובות IP. האסימון מוצג פעם אחת בלבד.
אסימון API מאפשר ל-Claude Code, Codex, Cursor או לסקריפט משלך לפעול בסביבת העבודה שלך בתור אתה, עם הגישה שתבחר בלבד. אתה יוצר אותו באשף בן ארבעה שלבים (מטרה, הרשאות, מגבלות, סקור), ו-Clevera מציגה את האסימון פעם אחת בלבד.
לפני שמתחילים
- AI agents & API זמין בתוכניות Pro, Business ו-Custom. בתוכניות אחרות, תחת אסימון חדש מופיע: "הגישה ל-API ולסוכנים זמינה בתוכנית Pro ומעלה."
- כל חבר בסביבת העבודה יכול ליצור אסימונים עבור עצמו. אסימון יכול לקבל רק הרשאות שהתפקיד שלך מאפשר. ראה הרשאות סוכן.
- סביבת עבודה יכולה להכיל 50 אסימונים פעילים. בהגעה למגבלה, אסימון חדש מושבת: "סביבת העבודה שלך הגיעה למגבלה של 50 אסימונים פעילים. בטל אחד תחילה."
- השתמש באסימון אחד לכל סוכן או סקריפט, כדי שתוכל לראות מה כל אחד עשה ולבטל אחד מבלי לעצור את האחרים.
יצירת אסימון
פתח את כרטיסיית האסימונים
פתח את תפריט סביבת העבודה ובחר ב-AI agents & API. בכרטיסיית אסימונים, לחץ על אסימון חדש.
מטרה: תן לו שם ובחר למה הוא משמש
תן לו שם שתזהה ברשימת האסימונים וביומן הפעילות, עד 100 תווים, כמו "Docs writer (Claude Code)". תחת למה זה משמש?, בחר הגדרה קבועה מראש. היא מסמנת את ההרשאות עבור אותה משימה; תוכל לכוונן אותן בשלב הבא.
בחר את ההגדרה הקרובה ביותר לתפקיד הסוכן. הגדרה קבועה מראש השתמש עבור כותב "סוכנים מנסחים; אדם סוקר ומפרסם." טיוטות לאתרי תיעוד. מפרסם "אוטומציה מהימנה שעשויה לשנות את מה שהקוראים רואים." אתרי תיעוד, כולל פרסום. עוזר תמיכה "תשובות מתוך תיעוד שפורסם. שום דבר אחר." בוט עזרה. לקריאה בלבד "מחקר, ביקורות ובדיקות תרגום." אנליסט "קורא תוכן ואותות מקוראים כדי להציע תיקונים." מפיק "מנסח תוכן ומתחיל עבודה בתשלום במסגרת תקרות הוצאות." בקשת סרטונים, קטעים ומאמרים. סוכן סביבת עבודה "כל מה שסוכן יכול לעשות בסביבת עבודה זו, במסגרת תקרות הוצאות." הגדרה קבועה מראש המופיעה באפור מכילה הרשאה שהתפקיד שלך לא יכול להעניק: "התפקיד שלך לא יכול להעניק את כל היכולות בהגדרה זו."
הרשאות: בדוק כל הרשאה
השלב מפרט כל הרשאה, מקובצת לפי תיעוד, סרטונים ו-סביבת עבודה, כל אחת עם מה שהיא מאפשרת ותג (קריאה, עריכה, פרסם, נהל או מנצל קרדיטים). סמן או בטל סימון של כל אחת. ברגע שתשנה את ההגדרה הקבועה מראש, הכותרת תציג מותאם אישית ו-אפס ל- preset יבטל את השינויים שלך.
כל הרשאה מציינת איזה סוג פעולה היא מאפשרת. מה כל הרשאה מאפשרת: הרשאות סוכן.
מגבלות: הגדר תוקף, אתרים, הוצאות וכתובות
הוצאות מופיעות רק כאשר האסימון עשוי לנצל קרדיטים. ראה אפשרויות מגבלות להלן.
סקור וצור
הסקירה מציינת במילים פשוטות מה האסימון יכול לעשות (יכול לקרוא, יכול ליצור ולערוך, יכול לפרסם, יכול לנהל אתרים, יכול להשתמש בקרדיטים) ואת המגבלות שלו. "הוא פועל בתור אתה, במסגרת מה שהתפקיד שלך מאפשר." לחץ על יצירת אסימון.
בדוק את הסיכום, ואז לחץ על יצירת אסימון. העתק את האסימון
האסימון נוצר מציג את האסימון, המתחיל ב-
clv_agent_: "העתק אותו עכשיו: לא תראה אותו שוב." העתק אותו למאגר סודות או למשתנה סביבה. חיבור סוכן מתחתיו כולל הגדרה מוכנה ל-Claude Code, Codex CLI,.mcp.json,curlו-Claude.ai, ChatGPT. לחץ על שמרתי את זה כשתסיים.
האסימון מוצג פעם אחת בלבד.
חזרה שומרת את כל מה שהזנת. סגירת האשף לאחר שינוי משהו שואלת "לבטל את האסימון הזה?": "ההגדרה שהתחלת אבדה. לא נוצר אסימון."
אפשרויות מגבלות
| אפשרות | מה היא עושה | ברירת מחדל |
|---|---|---|
| פג תוקף לאחר | 7 ימים, 30 ימים, 90 ימים או שנה. התאריך מופיע למטה ("בתאריך date"). אסימונים תמיד פגים. | 90 ימים |
| אתרי תיעוד | מוצג כאשר לאסימון יש הרשאות לאתרי תיעוד. כל האתרים ("כל אתר תיעוד בסביבת עבודה זו, כולל חדשים.") או אתרים נבחרים. | אתרים נבחרים כאשר בסביבת העבודה יש יותר מאתר תיעוד אחד, אחרת כל האתרים |
| הוצאות → למשימה | הסכום המקסימלי להפעלה בודדת, בקרדיטים. ריק: ללא תקרה. | ללא תקרה |
| הוצאות → ליום / לחודש | הסכום המקסימלי שהאסימון רשאי להוציא (ולהחזיק עבור משימות רצות) ביום או חודש קלנדרי. | ללא תקרה |
| הוצאות → אישור אוטומטי למטה | הפעלות שצוטטו מתחת למספר קרדיטים זה ירוצו ללא אדם. "0 אומר שאדם מאשר כל הפעלה בתשלום. התוכנית שלך מאפשרת עד 500." (1,000 ב-Custom.) | 0 |
| מתקדם → רשימת היתרים לכתובות IP | "אופציונלי. כתובת אחת או טווח בשורה; קריאות מכל מקום אחר מסורבות." עד 20 כתובות IPv4/IPv6 או טווחי CIDR, כמו 203.0.113.7 או 198.51.100.0/24. |
ריק: כל כתובת |
הוצאות מופיעות רק כאשר לאסימון יש credits:spend (הגדרות מפיק ו-סוכן סביבת עבודה). כיצד תקרות ואישורים עובדים יחד: בקרת הוצאות ואישורי סוכן.
מה קורה אחר כך
- האסימון עובד מיד דרך MCP (
https://app.clevera.ai/mcp) ו-REST API. - בעל סביבת העבודה ומנהלים מקבלים התראה: "אסימון API חדש, name, נוצר עבור workspace", עם מי הגדיר אותו ומה הגישה שלו.
- האסימון מופיע בכרטיסיית אסימונים עם ארבעת התווים האחרונים שלו, כמו
clv_agent_…k7Qe, וכל שימוש מעדכן את שימוש אחרון. - לאחר יצירתו, לא ניתן לשנות את ההרשאות והמגבלות שלו. כדי לשנות אותן, צור אסימון חדש ובטל את הישן. ראה ניהול אסימוני API.
פתרון בעיות
| הודעה | סיבה | פתרון |
|---|---|---|
| "תן לאסימון שם." | השם ריק. | הקלד שם. |
| "בחר לפחות יכולת אחת." | לא סומנה הרשאה. | סמן לפחות אחת. |
| "בחר לפחות אתר אחד." | אתרים נבחרים ללא בחירה. | בחר אתר, או בחר ב-כל האתרים. |
| "הזן מספר שלם של קרדיטים." | שדה הוצאות מכיל עשרוני או טקסט, או 0 בתקרה. | הזן מספר שלם, או השאר את התקרה ריקה. |
| "התוכנית שלך מאשרת עבודת סוכן אוטומטית מתחת ל-500 קרדיטים לכל היותר." | אישור אוטומטי למטה מעל המקסימום של התוכנית. | הנמך אותו. |
| "value אינו כתובת IP או טווח." | שורה ברשימת היתרים ל-IP אינה תקינה. | תקן או הסר את השורה. |
| "התפקיד שלך לא יכול להעניק חלק מיכולות אלו." | הרשאה מעבר לתפקיד שלך. | בטל את הסימון, או בקש מבעלים או מנהל ליצור את האסימון. |
| "סביבת העבודה שלך הגיעה למגבלה של 50 אסימונים פעילים. בטל אחד תחילה." | 50 אסימונים פעילים. | בטל אחד שאינך משתמש בו. |
| "הגישה ל-API ולסוכנים אינה בתוכנית שלך." | סביבת העבודה אינה ב-Pro, Business או Custom. | שדרג ל-Pro. |
| "לא ניתן היה ליצור את האסימון. נסה שוב." | משהו השתבש. | נסה שוב; צור קשר עם התמיכה אם זה ממשיך. |