اتصال و مدیریت یکپارچه‌سازی‌ها
یکپارچه‌سازی‌ها Atoms را به ابزارها و سرویس‌هایی که از قبل استفاده می‌کنید متصل می‌کنند. بسته به کانکتور، Atoms می‌تواند هنگام کمک به شما برای ساخت، افزودن قابلیت‌ها به برنامه منتشرشده‌تان، یا پشتیبانی از هر دو جریان کاری، از اطلاعات خارجی استفاده کند.
هر کانکتور از اقدامات و مجوزهای مخصوص به خود پشتیبانی می‌کند. قابلیت‌ها و دامنه مجوزی را که برای کانکتور متصل نمایش داده شده است بررسی کنید؛ یک پنل جزئیاتِ متصل‌نشده ممکن است فقط توضیحات و کنترل اتصال آن را نشان دهد.
از حساب و دامنه مجوز با کمترین سطح دسترسی که بتواند کار را انجام دهد استفاده کنید. گذرواژه‌ها، توکن‌های دسترسی، کلیدهای خصوصی یا داده‌های حساس نامرتبط را در یک پرامپت جای‌گذاری نکنید. وقتی یک سرویس شامل داده‌های تولیدی یا داده‌های مشتری است، با یک نمونه غیرحساس آزمایش کنید و پیش از اجازه دادن به نوشتن، هدف دقیق را تأیید کنید.
کانکتورها و اقداماتی که می‌بینید ممکن است بسته به حساب و نسخه متفاوت باشند. کاتالوگ Connector را در Atoms باز کنید تا ببینید در حال حاضر چه مواردی برای شما در دسترس است.
تصمیم بگیرید اتصال باید چه کاری انجام دهد
پیش از اتصال یک سرویس، تصمیم بگیرید به آن در کجا نیاز دارید.
| هدف | نمونه‌ها |
|---|---|
| هنگام ساخت، به Agent زمینه بدهید | فایل‌ها را پیدا کنید، وظایف را خلاصه کنید، مسائل را بررسی کنید یا از داده‌های پروژه در یک پرامپت استفاده کنید |
| به Agent اجازه دهید در سرویس دیگری اقدام انجام دهد | یک وظیفه ایجاد کنید، یک رکورد را به‌روزرسانی کنید، داده‌های صفحه‌گسترده را اضافه کنید یا یک رویداد تقویم ایجاد کنید |
| یک سرویس به برنامه منتشرشده اضافه کنید | داده‌های برنامه را ذخیره کنید، احراز هویت را مدیریت کنید، پرداخت‌ها را پردازش کنید یا یک جریان کاری برنامه را اجرا کنید |
برخی کانکتورها از بیش از یک هدف پشتیبانی می‌کنند. پیش از اتصال، توضیحات کانکتور و مجوزهای درخواستی را بررسی کنید.
یک یکپارچه‌سازی را متصل کنید
باز کنید Settings → Connectors را برای استفاده از نقطه ورود اصلی به‌کار ببرید. همچنین می‌توانید ابزارهای خود را به Atoms متصل کنید را از داشبورد انتخاب کنید.
اتصال یا قطع اتصال یک یکپارچه‌سازی ممکن است به دسترسی مالک فضای کاری یا مدیر مجاز نیاز داشته باشد. اگر مالک یا مدیر نیستید و کنترلی در دسترس نیست، از مالک فضای کاری یا یک مدیر مجاز درخواست کنید.
از داشبورد
- داشبورد Atoms را باز کنید.
- انتخاب کنید ابزارهای خود را به Atoms متصل کنید.
- کانکتوری را که می‌خواهید استفاده کنید انتخاب کنید. کنترل اتصال نمایش‌داده‌شده روی کارت آن کانکتور را دنبال کنید.
- از کنترلی که برای آن کانکتور نمایش داده شده استفاده کنید. اگر یک پنل جزئیات عمومی باز شد، Connect را انتخاب کنید؛ یکپارچه‌سازی‌های مخصوص ارائه‌دهنده ممکن است جریان راه‌اندازی یا مجوزدهی خود را باز کنند.
- اگر از شما خواسته شد، به سرویس خارجی وارد شوید.
- حساب و مجوزها را بررسی کنید، سپس اتصال را تأیید کنید.
- به Atoms برگردید و تأیید کنید که کانکتور به‌صورت متصل نمایش داده می‌شود. در Chatی که می‌خواهید از آن استفاده کنید، انتخاب‌گر کانکتور را باز کنید و کانکتور را برای آن Chat فعال کنید.
از یک یکپارچه‌سازی متصل استفاده کنید
به Agent بگویید از کدام سرویس استفاده کند و جزئیات کافی را برای شناسایی مورد درست وارد کنید. جزئیات مفید شامل این موارد است:
- نام پروژه، فضای کاری، مخزن، پوشه، تقویم یا صفحه‌گسترده
- نام وظیفه، شناسه مسئله، نام فایل یا شناسه رکورد
- بازه زمانی، موعد، مالک، وضعیت یا اولویت
- این‌که می‌خواهید Atoms چه چیزی را بخواند، خلاصه کند، ایجاد کند یا به‌روزرسانی کند
برای مثال:
- «مسائل Linear با اولویت بالا که به من واگذار شده‌اند را خلاصه کن.»
- «خلاصه راه‌اندازی را در Drive پیدا کن و تصمیم‌های باز را فهرست کن.»
- «این سرنخ‌های تأییدشده را به صفحه‌گسترده کمپین اضافه کن.»
- «برای بازبینی طراحی در سه‌شنبه آینده ساعت 3 بعدازظهر یک رویداد تقویم ایجاد کن.»
Atoms فقط می‌تواند از اقداماتی استفاده کند که توسط کانکتور پشتیبانی می‌شوند و از داده‌هایی که برای حساب متصل در دسترس هستند. اگر قابلیت یا اقدامی که نیاز دارید برای آن کانکتور نشان داده نشده است، متوقف شوید و فرض نکنید که پشتیبانی می‌شود.
تغییرات خارجی را پیش از اجرا بررسی کنید
وقتی یک کانکتور و اقدام از ایجاد یا به‌روزرسانی داده‌های خارجی پشتیبانی می‌کنند، Atoms ممکن است پیش از اجرا یک تأیید نمایش دهد.
بررسی کنید:
- سرویس و حساب متصل
- فایل، صفحه‌گسترده، تقویم، پروژه یا رکورد هدف
- اطلاعاتی که ایجاد یا تغییر داده خواهند شد
- هر تاریخ، زمان، گیرنده یا مقدار مهم دیگر
اگر Atoms یک تأیید نمایش می‌دهد، آن را بررسی کنید و برای ادامه Confirm را انتخاب کنید یا برای بدون تغییر گذاشتن سرویس خارجی، لغو کنید. در دسترس بودن نوشتن به کانکتور و اقدام بستگی دارد؛ کانکتورهای فقط‌خواندنی اقدام نوشتن ارائه نمی‌کنند.
پس از یک نوشتن، پیش از تلاش دوباره نتیجه را در سرویس خارجی بررسی کنید. اگر هدف یا مقادیر اشتباه هستند، جریان کاری را متوقف کنید و در صورت وجود از ابزارهای تاریخچه، واگردانی یا بازیابی خود ارائه‌دهنده استفاده کنید. قطع اتصال یک کانکتور استفاده‌های آینده را متوقف می‌کند؛ تغییراتی را که قبلاً انجام شده‌اند برنمی‌گرداند.
یک اتصال را مدیریت کنید
کاتالوگ Connector را باز کنید و یک سرویس متصل را انتخاب کنید تا وضعیت فعلی آن را بررسی کنید.
از پنل جزئیات کانکتور، ممکن است بتوانید:
- بررسی کنید کدام حساب متصل است
- اقدامات پشتیبانی‌شده و دامنه مجوز کانکتور را بررسی کنید
- وقتی مجوز منقضی شده است دوباره متصل شوید
- وقتی سرویس از آن پشتیبانی می‌کند، دسترسی را تازه‌سازی یا تغییر دهید
- حساب را از Atoms قطع کنید
قطع اتصال در Atoms استفاده‌های آینده از اتصال را متوقف می‌کند. برخی سرویس‌ها ممکن است همچنین از شما بخواهند Atoms را از حساب خود سرویس یا تنظیمات امنیتی آن لغو دسترسی کنید.
نمونه‌ها بر اساس مورد استفاده
جدول زیر یک گروه‌بندی تحریریه‌ای بر اساس مورد استفاده است، نه مجموعه‌ای از دسته‌بندی‌های کاتالوگ. برای فهرست فعلی کانکتورهای موجود از کاتالوگ قابل جستجو استفاده کنید.
| دسته‌بندی | کاربردهای رایج | نمونه‌ها |
|---|---|---|
| توسعه | کنترل منبع، مخازن، مسائل و جریان‌های کاری تحویل | GitHub, Linear |
| بک‌اند و داده | پایگاه‌های داده، احراز هویت، ذخیره‌سازی و داده‌های ساخت‌یافته | Supabase |
| پرداخت‌ها | تسویه‌حساب، صورتحساب و جریان‌های کاری پرداخت | Stripe |
| مدیریت کار | وظایف، پروژه‌ها، مالکان و موعدها | Asana, Todoist |
| فایل‌ها و محتوا | جستجو، خواندن و سازمان‌دهی فایل‌های خارجی | Box, Dropbox |
| تحلیل و بازاریابی | ترافیک، عملکرد جستجو، کمپین‌ها و گزارش‌دهی | Google Analytics 4, Google Search Console, Google Ads |
در دسترس بودن کانکتورها در طول زمان تغییر می‌کند. برای فهرست فعلی از کاتالوگ در Atoms استفاده کنید و یک کانکتور را باز کنید تا قابلیت‌های دقیق آن را بررسی کنید.
راهنماهای راه‌اندازی
راهنمای سرویس خود را انتخاب کنید:
برای مشکلات اتصال، ببینید عیب‌یابی یکپارچه‌سازی.