חיבור הנתונים שלכם עם Supabase
הדרך הקלה ביותר לגרום לאסטרטגיה לקרוא מדדים מבסיס הנתונים שלכם (למשל מדד הפחד והחמדנות, נתוני on-chain) באמצעות ctx.data(). השכבה החינמית של Supabase מספיקה, ומחרוזת החיבור נשמרת רק במכשיר של הסוכן — השרת של coinsori אינו רואה לא את הנתונים ולא את הסיסמה.
יצירת פרויקט Supabase
יוצרים פרויקט חינמי ב-supabase.com. עדיף לבחור אזור קרוב לסוכן (VPS).
יצירת טבלה והכנסת נתונים
יוצרים טבלת סדרת זמן בעורך ה-SQL או ב-Table Editor. הדרישה המינימלית היא שתי עמודות: עמודת זמן (חותמת זמן) ועמודת ערך. לדוגמה: fear_greed(ts bigint, v numeric) — מומלץ ש-ts יהיה epoch בשניות (מילישניות ו-ISO מזוהים אוטומטית). אם עדיין אין נתונים להכניס, כדאי לקרוא קודם את מה שלמטה — אפשר לדלג על השלב הזה כולו.
הדרך המהירה ביותר היא להתחיל מנתונים ציבוריים חינמיים. אנחנו מספקים אוספים בקוד פתוח שממלאים את ה-DB שלכם במדדים כמו מדד הפחד והחמדנות, קצב ה-hash של ביטקוין, הריבית של ארה"ב ו-VIX — הכול חינם ובלי צורך במפתח API. האוסף **גם יוצר את הטבלה בעצמו** (שתי עמודות ts ו-v). כך לא נשאר מה לעשות בשלב 2 — פקודה אחת טוענת את הנתונים, ופקודה אחת נוספת רושמת את ה-cron. ★ לטעינה משתמשים בחשבון עם הרשאת כתיבה. החשבון לקריאה בלבד שנוצר בשלב 3 הוא חשבון נפרד שהסוכן משתמש בו לקריאה.
למדריך הכנסת נתונים ציבוריים →יצירת חשבון לקריאה בלבד (חשוב)
לאימות אסטרטגיה נדרשת קריאה בלבד. יש להדביק את ה-SQL שלמטה בעורך ה-SQL של Supabase כדי ליצור תפקיד לקריאה בלבד — זה קו ההגנה האמיתי: גם אם מחרוזת החיבור דולפת, אי אפשר לשנות את הנתונים.
create role readonly_bot login password 'יש-להחליף-בסיסמה-חזקה'; grant usage on schema public to readonly_bot; grant select on all tables in schema public to readonly_bot; alter default privileges in schema public grant select on tables to readonly_bot;
העתקת מחרוזת החיבור
בלוח הבקרה של הפרויקט פותחים Project Overview → Get connected, מעתיקים את ה-URL מהפריט Direct, ומחליפים רק את שם המשתמש והסיסמה באלה שנוצרו בשלב 3. באותו מקום מופיעות גם אפשרויות pooler. ★ Supabase עשויה לשנות את נוסח הממשק — ה-URL שהועתק עצמו מראה באיזה מצב מדובר: · המארח הוא db.ref-הפרויקט.supabase.co (ישיר) → שם המשתמש הוא פשוט readonly_bot · אם המארח מכיל pooler.supabase.com → שם המשתמש הוא readonly_bot.ref-הפרויקט (יש להשאיר את ה-ref אחרי הנקודה — בלעדיו החיבור נדחה) ★ בשכבה החינמית החיבור הישיר (5432) הוא IPv6 בלבד — אם לשרת הסוכן אין IPv6, יש להשתמש ב-URL של Session mode (pooler).
לחבר ולהעביר ל-AI
בניהול סוכנים → בחירת סוכן → לשונית הגדרות נתונים מזינים שם חיבור (main) ו-URL, והחיבור מאומת מיד. לאחר מכן, באותו מסך, בשורת הטבלה לוחצים [+ הוספת מערך נתונים מטבלה זו], בוחרים שם, עמודת זמן ועמודת ערך, ואז [בדיקה] → [שמירה] (ה-AI רק קורא מערכי נתונים). לאחר השמירה ה-AI יכול לבנות אסטרטגיה עם השם הזה (למשל ctx.data('fg')) ואף להריץ בקטסט. אם אין נתונים להכניס, אפשר להתחיל מדוגמאות הנתונים הציבוריים ב-/guide/datasets (מדד הפחד והחמדנות ועוד).
- פרויקטים חינמיים מושהים לאחר שבוע ללא שימוש — האימות שהסוכן מריץ כל 10 דקות נספר כפעילות, ולכן בדרך כלל הפרויקט נשאר ער.
- עדכון בזמן אמת (מצב notify) פועל רק עם כתובת URL של Session mode (איגום ב-Transaction mode אינו תומך ב-LISTEN).
- בתוצאות הבקטסט נשמרת טביעת אצבע של הנתונים (מספר שורות · hash) — אם תוכן ה-DB משתנה, טביעת האצבע משתנה, ושתי תוצאות עם טביעות שונות אינן באותם תנאים.
כל התיעוד נמצא כאן — מדריך