חיבור סוכני AI חיצוניים לפולי

חיבור סוכן AI חיצוני לחשבון שלכם בפולי מאפשר לו לעבוד ישירות עם סביבת העבודה שלכם, לקרוא נתונים, לעדכן פריטים ולהפעיל יצירות. תהליך החיבור מתבצע באמצעות אישור מפורש בדפדפן עם קישור וקוד אימות, ללא צורך במסירת סיסמה או בהפקת מפתח API.

מה ניתן לבצע באמצעות החיבור

הסוכן החיצוני פועל מול המשאבים הנתמכים ב-API של פולי בהתאם להרשאות החשבון שלכם:

• קריאת מידע מסביבת העבודה: איתור וקריאה של פרויקטים, שיחות, מסמכים, מאגרי מידע ומקורות קיימים.
• כתיבה ועדכון משאבים: יצירת פרויקטים ושיחות חדשות, עדכון מסמכים נתמכים וניהול מקורות.
• הפעלת הסוכן המובנה של פולי: הרצת בקשות יצירה שונות כגון ניסוח טיוטות, סיכום, מחקר ועריכת תוכן.

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

היקף ההרשאות ואבטחת החשבון

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

שלבי החיבור של סוכן חיצוני

כדי לחבר סוכן חיצוני, העתיקו והדביקו בחלון השיחה של הסוכן את ההנחיה הבאה:

קרא את https://www.polylm.com/api/v1/docs ופעל לפי ההנחיות כדי להתחבר לחשבון פולי שלי. בקש ממני אישור לפני ביצוע פעולות.

לאחר שליחת ההנחיה, פעלו לפי השלבים הבאים:

1. 1
   הסוכן יציג עבורכם קישור אימות וקוד חד-פעמי. פתחו את הקישור בדפדפן (אם הוצגה כתובת כללית בלבד, היכנסו אליה והקלידו את הקוד).
2. 2
   ודאו שאתם מחוברים לחשבון פולי הנכון. בדקו שהקוד המוצג בדף האימות תואם במדויק לקוד שקיבלתם מהסוכן, ועיינו בשם היישום וברשימת ההרשאות המבוקשות.
3. 3
   אם כל הפרטים תואמים ואתם מזהים את היישום, לחצו על אישור החיבור. האישור מעניק ליישום גישה לסביבת העבודה, אך אינו מאשר מראש פעולות ספציפיות שהסוכן יבקש לבצע בהמשך. אם הפרטים אינם מוכרים לכם, לחצו על דחייה.
4. 4
   חזרו אל הסוכן והמתינו להודעה המאשרת שהחיבור הושלם בהצלחה. אין למסור לסוכן בשום שלב סיסמה, מפתח API או אסימון גישה (token) בשיחה.

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

לאחר החיבור, מומלץ להתחיל בבקשת קריאה פשוטה שאינה משנה נתונים, כדי לוודא שהגישה תקינה:

הצג את שמות הפרויקטים שלי ומצא את הפרויקט "[שם הפרויקט]". אל תשנה, תיצור או תשלח דבר. לפני כל פעולה אחרת, בקש ממני אישור מפורש.

כדי לעבוד בצורה מבוקרת ויעילה:

1. 1
   בדקו את תשובת הסוכן וודאו שהוא זיהה את הפרויקט ואת החשבון הנכונים.
2. 2
   לאחר האימות, תוכלו להנחות את הסוכן לקרוא מסמכים, להציע ניסוחים או לבצע פעולות נתמכות.
3. 3
   לפני כל פעולה שמשנה תוכן או מפעילה יצירה חדשה, בקשו מהסוכן לפרט מה בכוונתו לבצע ואשרו זאת רק אם התוצאה תואמת את כוונתכם.
4. 4
   אם שלחתם בקשה והתוצאה אינה ברורה או מתעכבת, בדקו תחילה את השיחה ואת המסמך בפולי לפני שליחה חוזרת, כדי להימנע מכפל עבודה ומצריכה מיותרת של מכסות.

השפעת החיבור על מכסות וחיובים

החיבור החיצוני משתמש במכסות ובתוכנית המנוי הקיימות בחשבון פולי שלכם:

• הודעות, יצירות ופעולות הנספרות במערכת מחושבות כחלק מנפח השימוש הרגיל בחשבון.
• החיבור אינו משנה את מסלול המנוי, אינו מוסיף אמצעי תשלום ואינו פותח מכסה נפרדת.
• מדיניות השימוש ותנאי התוכנית של החשבון ממשיכים לחול.

לצפייה במוני הצריכה ובמצב החשבון, עברו אל מעקב אחרי שימוש ומגבלות.

ניתוק גישת הסוכן מהחשבון

באפשרותכם לנתק את הגישה של הסוכן בכל עת מתוך הגדרות החשבון:

1. 1

   התחברו לחשבון פולי ופתחו את חיבור סוכנים ו־API.

2. 2

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

   לחצו להגדלה

3. 3

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

שימו לב כי הניתוק חוסם בקשות חדשות, אך אינו מבטיח עצירה של משימה או יצירה שכבר התקבלו במערכת לפני הניתוק.

פתרון תקלות

• קישור האימות פג תוקף או שהחיבור נדחה: שלחו לסוכן בקשת חיבור חדשה, פתחו את הקישור כאשר אתם מחוברים לחשבון פולי המתאים ובדקו שוב את התאמת הקוד בדף.
• הסוכן מבקש סיסמה, מפתח API או אסימון גישה (token): עצרו את הפעולה מיד. החיבור התקין נעשה תמיד דרך דף האימות בדפדפן ובהרשאות הקבועות. אין להדביק סיסמאות או אסימוני גישה בשיחה.
• הסוכן מדווח על תוקף הרשאה שפג: התחילו תהליך חיבור מחדש באמצעות הנחיית החיבור, ללא העברת מזהים סודיים בשיחה.
• לא ברור אם פעולה הסתיימה בהצלחה: אל תשלחו מיד את אותה הבקשה שוב. בדקו את היסטוריית השיחה, הפרויקט או הקובץ בממשק פולי כדי לוודא את מצב המשימה ולמנוע כפל פעולות.
• הודעת חריגה ממכסה או ממגבלת תוכנית: עיינו במדריך מעקב אחרי שימוש ומגבלות ובדקו את נתוני הצריכה העדכניים בלשונית הפרופיל בחשבון.

קישורים טכניים

לפרטי השילוב המלאים ולחוזה המכונה של ה-API:

• מדריך ציבורי לסוכנים
• חוזה OpenAPI 3.1