תוכן העניינים
חיבור עם AI
שתי דרכים לתת לסוכן AI לעבוד עם subly: הוראה אחת להדבקה, או Skill שמלמד אותו את החיבור. אם אתם לא בטוחים, התחילו בראשונה.
דרך 1: ההוראה להעתקה
מעתיקים, ומדביקים בצ'אט של ה-AI, בתוך הפרויקט של האפליקציה. ההוראה מפנה את הסוכן ל-llms.txt, כדי שיעבוד לפי התיעוד העדכני ולא לפי מה שהוא זוכר.
אתה מחבר את האפליקציה הזו ל-subly: ניהול מינויים בשקלים. הסביבה: בדיקות · גרסת ההוראה: 21.11.2026 כללים - עבוד רק בסביבת הבדיקות. אל תנסה לעבור לסביבת האמת. - קרא קודם את ההוראות העדכניות: https://sublly.dev/llms.txt אל תסתמך על מה שאתה זוכר על subly. - אל תבקש ממני מפתח או סוד בצ'אט, ואל תדפיס אותם. סודות נשמרים רק בקובץ הסביבה של הפרויקט, או בהגדרות הסודות של הכלי. - אל תמציא מזהים, כתובות או מחירים. אם חסר לך נתון, שאל אותי. - סכומים הם מספר שלם באגורות: 99.00 ₪ הם 9900. - אם פעולה מחזירה "ממתין לאישור": עצור, תן לי את הקישור, ואל תנסה דרך אחרת. - אחרי כל שלב, בדוק שהוא הצליח לפני שאתה ממשיך. השלבים 1. זיהוי. קרא את הפרויקט: באיזו שפה ותשתית הוא כתוב, איפה ההתחברות של המשתמשים, ואיפה נשמרים סודות. 2. התחברות. המפתח שלך נמצא במשתנה הסביבה SUBLY_API_KEY, וכתובת השרת ב-SUBLY_BASE_URL. אם הם חסרים: עצור. בקש ממני לפתוח חשבון ב-https://app.sublly.dev/app/signup (אם עוד אין לי), ליצור מפתח סוכן בלוח הבקרה (מפתחים › מפתחות API) ולשמור אותו בקובץ הסביבה של הפרויקט. לא בצ'אט. 3. תוכנית מחיר. שאל אותי: שם התוכנית, המחיר, חודשי או שנתי, ותקופת ניסיון. צור אותה. 4. חיבור האפליקציה: - יצירת לקוח בכל כניסה של משתמש. - כפתור הרשמה, שמוביל לדף התשלום. - בדיקת גישה לפני כל יכולת בתשלום. - קישור "ניהול המינוי", שמוביל לאזור האישי. 5. אירועים. הוסף נקודת קצה שמאמתת את החתימה על הגוף הגולמי, ורשום את הכתובת שלה. את סוד החתימה אני שומר בעצמי ב-SUBLY_WEBHOOK_SECRET. 6. בדיקה ומסירה. צור קישור למינוי בדיקה, ותן לי אותו. כתוב קובץ SUBLY_SETUP.md: מה הוקם, איפה כל דבר בקוד, ומה נשאר. בסיום אמור לי במפורש מה עשית, מה לא הצלחת, ומה רק אני יכול לעשות: הפעלת החשבון, חיבור פלאקארד ו-BillOS, ויצירת מפתח לאמת.
לא הצלחנו להעתיק אוטומטית. הטקסט מסומן, העתיקו אותו ידנית.
לפני שמדביקים: פותחים חשבון ב-לוח הבקרה, יוצרים ב"מפתחים › מפתחות API" מפתח סוכן (sk_test_agent_...), ושומרים אותו בקובץ הסביבה של הפרויקט:
SUBLY_API_KEY=sk_test_agent_... SUBLY_BASE_URL=https://app.sublly.dev
לא הצלחנו להעתיק אוטומטית. הטקסט מסומן, העתיקו אותו ידנית.
מפתח סוכן נפרד ממפתח האפליקציה, כדי שביומן הפעילות יהיה ברור מה עשה הסוכן ומה עשתה האפליקציה. אל תדביקו מפתחות בצ'אט: הסוכן קורא אותם מקובץ הסביבה.
דרך 2: Skill
ה-Skill הוא קובץ הוראות שמלמד את הסוכן איך לחבר את subly: תוכניות, לקוח, כפתור הרשמה, בדיקת גישה ואירועים. ב-Claude Code, בתיקיית הפרויקט:
mkdir -p .claude/skills/subly-billing curl -fsSL https://sublly.dev/skill/SKILL.md -o .claude/skills/subly-billing/SKILL.md
לא הצלחנו להעתיק אוטומטית. הטקסט מסומן, העתיקו אותו ידנית.
בכלי אחר: מורידים את הקובץ ומוסיפים אותו להוראות של הפרויקט.
מה סוכן יכול לעשות, ומה לא
| בסביבת הבדיקות | בסביבת האמת | |
|---|---|---|
| תוכניות מחיר, לקוחות, מינויים וקישורי תשלום | מותר | מותר, אם אישרתם לסוכן "שינויים, עם אישורים" |
| ביטול מיידי של מינוי | מותר | מחכה לאישור שלכם |
| הוספה, שינוי או מחיקה של כתובת Webhook | מותר | מחכה לאישור שלכם |
| מפתחות API, פרטי העסק, פלאקארד, BillOS והפעלת החשבון | אף פעם | אף פעם |
בסביבת האמת סוכן מקבל גישת קריאה בלבד, אלא אם אישרתם אחרת. בכל רגע אפשר לבטל את המפתח שלו, או להשהות את כל הסוכנים בלחיצה אחת, ב"הגדרות › סוכני AI".
מה קורה כשסוכן צריך אישור
הסוכן מקבל תשובת "ממתין לאישור" עם קישור. הוא אמור לעצור, לתת לכם את הקישור, ולא לנסות דרך אחרת. אתם פותחים את הקישור בלוח הבקרה, רואים מה הוא ביקש ולמה, ומאשרים או דוחים. אישור שנכתב בצ'אט אינו אישור: רק אדם שמחובר ללוח הבקרה מאשר.