חבר ונהל אינטגרציות
אינטגרציות מחברות את Atoms לכלים ולשירותים שבהם אתם כבר משתמשים. בהתאם למחבר, Atoms יכול להשתמש במידע חיצוני בזמן שהוא מסייע לכם לבנות, להוסיף יכולות לאפליקציה שפרסמתם, או לתמוך בשני תהליכי העבודה.
כל מחבר תומך בפעולות ובהרשאות משלו. בדקו את היכולות ואת היקף ההרשאות שמוצגים עבור המחבר המחובר; לוח פרטים של מחבר שאינו מחובר עשוי להציג רק את התיאור שלו ואת בקרת החיבור.
השתמשו בחשבון ובהיקף ההרשאות בעלי ההרשאות המינימליות שיכולים להשלים את המשימה. אל תדביקו סיסמאות, אסימוני גישה, מפתחות פרטיים או נתונים רגישים לא קשורים בתוך פרומפט. כאשר שירות מכיל נתוני ייצור או נתוני לקוחות, בדקו עם דוגמה לא רגישה ואמתו את היעד המדויק לפני שאתם מאפשרים כתיבה.
המחברים והפעולות שאתם רואים עשויים להשתנות לפי החשבון והגרסה. פתחו את קטלוג המחברים ב-Atoms כדי לראות מה זמין לכם כעת.
החליטו מה החיבור אמור לעשות
לפני חיבור שירות, החליטו היכן אתם צריכים אותו.
| מטרה | דוגמאות |
|---|---|
| תנו ל-Agent הקשר בזמן שאתם בונים | מצאו קבצים, סכמו משימות, בדקו issues, או השתמשו בנתוני פרויקט בתוך פרומפט |
| אפשרו ל-Agent לבצע פעולה בשירות אחר | צרו משימה, עדכנו רשומה, הוסיפו נתונים לגיליון אלקטרוני או צרו אירוע ביומן |
| הוסיפו שירות לאפליקציה שפורסמה | אחסנו נתוני אפליקציה, טפלו באימות, עבדו תשלומים או הפעילו תהליך עבודה של אפליקציה |
חלק מהמחברים תומכים ביותר ממטרה אחת. בדקו את תיאור המחבר ואת ההרשאות המבוקשות לפני שאתם מחברים אותו.
חברו אינטגרציה
פתחו הגדרות → מחברים כדי להשתמש בנקודת הכניסה הראשית. אפשר גם לבחור חברו את הכלים שלכם ל-Atoms מלוח הבקרה.
חיבור או ניתוק של אינטגרציה עשויים לדרוש גישת owner של סביבת העבודה או גישת admin מורשה. אם אינכם owner או admin ובקרה מסוימת אינה זמינה, פנו ל-owner של סביבת העבודה או ל-admin מורשה.
מלוח הבקרה
- פתחו את לוח הבקרה של Atoms.
- בחרו חברו את הכלים שלכם ל-Atoms.
- בחרו את המחבר שבו אתם רוצים להשתמש. פעלו לפי בקרת החיבור שמוצגת בכרטיס המחבר הזה.
- השתמשו בבקרה שמוצגת עבור אותו מחבר. אם היא פותחת לוח פרטים כללי, בחרו Connect; אינטגרציות ייעודיות לספק עשויות לפתוח תהליך הגדרה או הרשאה משלהן.
- התחברו לשירות החיצוני אם תתבקשו.
- בדקו את החשבון ואת ההרשאות, ואז אשרו את החיבור.
- חזרו ל-Atoms ואשרו שהמחבר מוצג כמחובר. ב-Chat שבו אתם רוצים להשתמש בו, פתחו את בוחר המחברים והפעילו את המחבר עבור אותו Chat.
השתמשו באינטגרציה מחוברת
אמרו ל-Agent באיזה שירות להשתמש וכללו מספיק פרטים כדי לזהות את הפריט הנכון. פרטים שימושיים כוללים:
- שם הפרויקט, סביבת העבודה, המאגר, התיקייה, היומן או הגיליון האלקטרוני
- שם משימה, מזהה issue, שם קובץ או מזהה רשומה
- טווח תאריכים, תאריך יעד, בעלים, סטטוס או עדיפות
- מה אתם רוצים ש-Atoms יקרא, יסכם, ייצור או יעדכן
לדוגמה:
- “סכם issues בעדיפות גבוהה ב-Linear שמוקצים לי.”
- “מצא את תקציר ההשקה ב-Drive ורשום את ההחלטות הפתוחות.”
- “הוסף את הלידים המאושרים האלה לגיליון האלקטרוני של הקמפיין.”
- “צור אירוע ביומן לביקורת העיצוב ביום שלישי הבא בשעה 15:00.”
Atoms יכול להשתמש רק בפעולות שנתמכות על ידי המחבר ובנתונים שזמינים לחשבון המחובר. אם היכולת או הפעולה שאתם צריכים אינן מוצגות עבור אותו מחבר, עצרו ואל תניחו שהן נתמכות.
בדקו שינויים חיצוניים לפני שהם מופעלים
כאשר מחבר ופעולה תומכים ביצירה או בעדכון של נתונים חיצוניים, Atoms עשוי להציג אישור לפני ההפעלה.
בדקו:
- השירות והחשבון המחובר
- קובץ היעד, הגיליון האלקטרוני, היומן, הפרויקט או הרשומה
- המידע שייוצר או ישתנה
- כל תאריך, שעה, נמען או ערך חשוב אחר
אם Atoms מציג אישור, בדקו אותו ובחרו Confirm כדי להמשיך או cancel כדי להשאיר את השירות החיצוני ללא שינוי. זמינות הכתיבה תלויה במחבר ובפעולה; מחברים לקריאה בלבד אינם מציעים פעולות כתיבה.
לאחר כתיבה, אמתו את התוצאה בשירות החיצוני לפני ניסיון חוזר. אם היעד או הערכים שגויים, עצרו את תהליך העבודה והשתמשו בכלי ההיסטוריה, הביטול או השחזור של הספק עצמו כאשר הם זמינים. ניתוק מחבר עוצר שימוש עתידי; הוא אינו מבטל שינויים שכבר בוצעו.
נהלו חיבור
פתחו את קטלוג המחברים ובחרו שירות מחובר כדי לבדוק את הסטטוס הנוכחי שלו.
מלוח פרטי המחבר, ייתכן שתוכלו:
- לבדוק איזה חשבון מחובר
- לבדוק את הפעולות הנתמכות של המחבר ואת היקף ההרשאות
- להתחבר מחדש כאשר ההרשאה פגה
- לרענן או לשנות גישה כאשר השירות תומך בכך
- לנתק את החשבון מ-Atoms
ניתוק ב-Atoms עוצר שימוש עתידי בחיבור. חלק מהשירותים עשויים גם לדרוש מכם לבטל את ההרשאה של Atoms דרך הגדרות החשבון או האבטחה של השירות עצמו.
דוגמאות לפי מקרה שימוש
הטבלה שלהלן היא קיבוץ מערכתי לפי מקרה שימוש, ולא קבוצה של קטגוריות קטלוג. השתמשו בקטלוג הניתן לחיפוש כדי לראות את הרשימה הנוכחית של המחברים הזמינים.
| קטגוריה | שימושים נפוצים | דוגמאות |
|---|---|---|
| פיתוח | בקרת מקור, מאגרים, issues ותהליכי מסירה | GitHub, Linear |
| Backend ונתונים | מסדי נתונים, אימות, אחסון ונתונים מובנים | Supabase |
| תשלומים | תהליכי checkout, חיוב ותשלום | Stripe |
| ניהול עבודה | משימות, פרויקטים, בעלים ותאריכי יעד | Asana, Todoist |
| קבצים ותוכן | חיפוש, קריאה וארגון של קבצים חיצוניים | Box, Dropbox |
| אנליטיקה ושיווק | תנועה, ביצועי חיפוש, קמפיינים ודיווח | Google Analytics 4, Google Search Console, Google Ads |
זמינות המחברים משתנה עם הזמן. השתמשו בקטלוג ב-Atoms כדי לראות את הרשימה הנוכחית ופתחו מחבר כדי לבדוק את היכולות המדויקות שלו.
מדריכי הגדרה
בחרו את המדריך עבור השירות שלכם:
לבעיות חיבור, ראו פתרון בעיות באינטגרציה.