טוען…
חיבור סוכני AI ל-Peroot: שדרוג פרומפטים בכל 5 המודים עם המוח המלא של המשתמש (עובדות, סגנון, סקילים פר-פלטפורמה), ספרייה אישית וציבורית, זיכרון ומשוב. אימות: מפתח prk_live_ בכותרת Authorization. מכסה: חינמי 2/יום · PRO 150/חודש (get_quota חינמי). Rate limit: 20/דקה למפתח, 40/דקה למשתמש.
OpenAPI: /api/v1/openapi · Base URL: https://www.peroot.space/api/v1
כל בקשה נושאת את המפתח שלך (נוצר ב-Settings → Peroot Connect) בכותרת Authorization:
Authorization: Bearer prk_live_XXXX
לחלופין, OAuth 2.1 (PKCE) עבור קונקטורים כמו claude.ai ו-ChatGPT: הלקוח נרשם דינמית, המשתמש מאשר בחלון Peroot, והבקשות נושאות access token במקום מפתח. גילוי אוטומטי דרך /.well-known/oauth-authorization-server.
/enhanceשדרוג פרומפט (צורך 1 קרדיט; cache-hit חינם)
אותו צינור כמו הפלטפורמה: סקילים פר-פלטפורמה, עובדות זיכרון, פרופיל סגנון ופרופילי מודלים. תומך Idempotency-Key (retry תוך 15 דק׳ לא מחויב שוב) ו-hard-stop של 55ש׳ עם החזר קרדיט.
/quotaיתרת מכסה ומועד חידוש (חינמי)
/promptsרשימת הפרומפטים השמורים (חינמי)
/promptsשמירת פרומפט לספרייה + Memory Palace (חינמי)
/prompts/searchחיפוש עמום בספרייה האישית (חינמי)
חיפוש היברידי: דירוג טריגרמות (pg_trgm) ועליו, כשקיימים embeddings לפרומפטים של המשתמש, שכבת דמיון סמנטי. הנוסחה דטרמיניסטית: score = 0.7×דמיון קוסינוס + 0.3×ציון מיקום בדירוג הטריגרמות. בלי embeddings (או בכל תקלה בנתיב הסמנטי) ההתנהגות זהה לחיפוש הטריגרמות בלבד.
/prompts/{id}שליפת פרומפט שמור (חינמי)
/prompts/{id}/relatedשכנים ב-Memory Palace, פרומפטים קרובים בגרף (חינמי)
אותו מנוע כמו גרף ה-Memory Palace בפלטפורמה: דמיון מילות מפתח (Jaccard) + שימוש משותף ב-24 שעות, על אותו קורפוס (עד 2000 פרומפטים, החדשים קודם) ואותו חלון אירועים של 90 יום. כשלפרומפט המרכז יש embedding שמור, נוספים גם שכנים לפי דמיון סמנטי (קוסינוס): weight סמנטי = 0.6×clamp((cos-0.5)/0.5), והמשקל הסופי לשכן הוא המקסימום בין שני המנועים. שכן שנמצא רק סמנטית מקבל reason=semantic. בלי embedding התוצאה זהה למנוע הלקסיקלי בלבד. כל שכן כולל reason שמסביר את הקשר.
/context-packחבילת הקשר למשימה, המוח הרלוונטי בקריאה אחת (חינמי)
מרכיב חבילת הקשר למשימה: הפרומפטים הקרובים ביותר לשאילתה (חיפוש סמנטי; בלי embeddings יורד לחיפוש מילות מפתח ו-fallback=true), הרחבה של צעד אחד בגרף (קשרים ידניים ושכני Memory Palace של 3 התוצאות העליונות, עד 8, כל אחד עם why), ועד 5 עובדות זיכרון לפי חפיפת מילים עם השאילתה. גוף הפרומפטים קטום ל-700 תווים.
/prompts/linksקישור ידני בין שני פרומפטים של המשתמש (חינמי)
יוצר קשר ידני בין שני פרומפטים בבעלות המשתמש. הקשר הוא זוג לא-מכוון: קריאה חוזרת על אותו זוג (בכל סדר) מחזירה את הקשר הקיים במקום שגיאה, ו-note חדש מעדכן אותו. הקשר מופיע בגרף ה-Memory Palace ובהרחבת context-pack.
/chainsשרשראות הפרומפטים השמורות של המשתמש (חינמי)
/chains/{id}שרשרת מלאה עם שלביה, להרצה על ידי הסוכן (חינמי)
ההרצה היא באחריות הסוכן: מלא את משתני כל שלב, הרץ כל prompt_text דרך POST /enhance לפי order, והזן פלטים קדימה לפי input_from_step. כל שלב צורך קרדיט אחד.
/library/searchחיפוש בספרייה הציבורית, תבניות מוכחות (חינמי)
/templates/fillמילוי תבנית, {משתנים} + דיווח חסרים (חינמי)
/user/memoryעובדות הזיכרון של המשתמש (חינמי)
/user/memoryשמירת עובדה חדשה לזיכרון (חינמי, עד 100)
/feedbackמשוב 👍/👎 על שדרוג (חינמי)
סכמות מלאות (שדות, גבולות, enums), ב-OpenAPI. סוכני MCP מקבלים את אותן יכולות ככלים דרך https://www.peroot.space/api/mcp.
| קוד | מתי | מה לעשות |
|---|---|---|
401 invalid_key | מפתח חסר/שגוי/מבוטל | צור מפתח חדש ב-Settings → Peroot Connect |
402 no_credits | המכסה נגמרה (חינמי 2/יום · PRO 150/חודש) | המתן ל-quota_resets_at או שדרג ל-PRO |
429 rate_limited | מעל 20/דקה למפתח או 40/דקה למשתמש | כבד את Retry-After |
400 invalid_request | קלט לא תקין (mode לא מוכר, prompt ארוך מדי…) | בדוק מול הסכמה |
504 timeout | השדרוג עבר 55 שניות | הקרדיט הוחזר אוטומטית, נסה שוב |
כל שגיאה חוזרת כ-{ error, error_en, code } , עברית + אנגלית, כדי שהסוכן יסביר למשתמש בשפתו.
context (תמצית קצרה של הפרויקט/השיחה) הופך שדרוג גנרי לשדרוג מקורקע במה שאתם באמת עובדים עליו.GET /quota חינמי, במסלול החינמי (2/יום) שווה לבדוק לפני ששורפים את הקריאה.