پایگاه دانش
کانکتورها
برنامه‌هایی را که با آن‌ها کار می‌کنید متصل کنید تا دستیار بتواند در آن‌ها جست‌وجو کند و همان‌جا کار انجام دهد.
جزئیات
- اتصال‌دهنده یک برنامهٔ بیرونی را به دستیار وصل می‌کند تا بتواند آنجا جست‌وجو کند و همان‌جا کار انجام دهد. Slack، Notion، Google Drive، HubSpot و حدود هزار برنامهٔ دیگر را می‌توان وصل کرد. «پیشنهادنامه را در Drive پیدا کن و بگو دربارهٔ قیمت‌گذاری چه می‌گوید.» «این خبر تازه را در کانال فروش بگذار.» اتصال‌دهنده‌ها در نوار کناری زیر اتصال‌دهنده‌ها هستند.
- برای وصل کردن یک برنامه، آن را از فهرست انتخاب کنید، تعیین کنید برای چه کسی است و دستیار چه کاری می‌تواند بکند، سپس کار را در صفحهٔ ورود خود برنامه تمام کنید، یا کلیدی از برنامه را آنجا جای‌گذاری کنید. گذرواژه یا کلید هرگز از چت OpenEmail، API آن یا دستیار نمی‌گذرد. اتصال‌دهنده تا وقتی کار را تمام نکرده‌اید در انتظار است، و پس از آن فعال.
- اتصال‌دهنده یا فقط برای شماست یا برای کل فضای کاری، و دستیار یا فقط اجازه دارد از طریق آن جست‌وجو کند یا تغییر هم ایجاد کند. بعداً می‌توانید این را تغییر دهید، و اتصال‌دهنده را متوقف کنید و ادامه دهید. قطع اتصال دسترسی را در برنامهٔ بیرونی هم لغو می‌کند. اگر برنامه دیگر اتصال را نپذیرد، اتصال‌دهنده می‌خواهد که دوباره وصل شود، و یک پیوند تازه آن را به‌عنوان همان اتصال‌دهنده برمی‌گرداند.
- در چت، دستیار می‌بیند چه چیزهایی وصل است، اقدام مناسب را در برنامه پیدا می‌کند و بی‌درنگ می‌خواند. برای هر چیزی که چیزی را در برنامه تغییر دهد، مانند فرستادن پیام، ساختن یا به‌روزرسانی یک رکورد یا حذف، نخست کارتی نشان می‌دهد تا شما تأییدش کنید، حتی وقتی خودتان مستقیماً آن را خواسته باشید. اتصال‌دهنده‌ای که فقط جست‌وجو می‌کند تغییرها را رد می‌کند، و آنچه برنامه برمی‌گرداند به‌عنوان اطلاعات در نظر گرفته می‌شود، هرگز به‌عنوان دستور.
- وظیفه فقط وقتی از اتصال‌دهنده‌ها استفاده می‌کند که اتصال‌دهنده‌ها زیر «ابزارهای اضافه» برایش روشن باشد، و فقط از آن‌هایی که برای فضای کاری وصل شده‌اند، و هرگز از اتصال‌دهنده‌ای که متعلق به یک نفر است. خواندن را خودش انجام می‌دهد. هر تغییر در یک برنامه زیر «منتظر شما» می‌ماند، فارغ از اینکه وظیفه در موارد دیگر اجازهٔ چه کارهایی را به‌تنهایی دارد، و وظیفه‌ای که از اتصال‌دهنده‌ها استفاده می‌کند هرگز خودش به ایمیل پاسخ نمی‌دهد: هر پاسخ منتظر تأیید شما می‌ماند.
- هر فراخوانی‌ای که از طریق یک اتصال‌دهنده انجام شود 90 روز ثبت می‌ماند: چه زمانی، کدام برنامه و کدام اقدام، اینکه چیزی را خواند یا تغییر داد، اینکه موفق بود یا نه، و اینکه از چت، یک وظیفه، API یا یک عامل آمده است. آنچه به برنامه فرستاده شد و آنچه برگشت هرگز نزد OpenEmail نگه‌داری نمی‌شود.
- سه مجوز تعیین می‌کنند چه کسی چه کاری می‌کند: یکی برای دیدن اتصال‌دهنده‌ها و کارهایی که از طریق آن‌ها انجام شده، یکی برای واداشتن دستیار به استفاده از آن‌ها، و یکی برای وصل کردن، متوقف کردن و قطع کردن برنامه‌ها و تعیین کارهایی که دستیار مجاز به انجامشان است. مالکان و مدیران هر سه را دارند، Member دو مجوز اول را دارد و Viewer اولی را. هر کس که اجازهٔ وصل کردن یک برنامه را دارد می‌تواند آن را برای خودش یا برای فضای کاری وصل کند.
- هر طرح برای یک حساب در Free جای 2 اتصال‌دهنده، در Starter 10 و در Business 50 دارد، و همین تعداد را هم برای یک فضای کاری. Enterprise حدی از خودش نمی‌گذارد، و هیچ حساب یا فضای کاری‌ای بیش از 200 جا ندارد. وقتی فضای کاری به طرح کوچک‌تری می‌رود، تازه‌ترین اتصال‌دهنده‌های فراتر از حد متوقف می‌شوند، نه اینکه حذف شوند.
- اتصال‌ها را یک ارائه‌دهندهٔ بیرونی نگه می‌دارد، که سابقهٔ آنچه دستیار به یک برنامه می‌فرستد و آنچه برنامه پاسخ می‌دهد را هم تا یک سال نگه می‌دارد. صفحهٔ سیاست حریم خصوصی از آن نام برده است.
- اتصال‌دهنده‌ها در REST API زیر /connectors، /connector-apps، /connector-categories و /connector-calls، در هر SDK با نام connectors، در خط فرمان با openemail connectors، و روی سرور MCP در دسترس‌اند. روی API یک تغییر بی‌درنگ و بدون پرسیدن از کسی اجرا می‌شود، پس تصمیم با فراخواننده است. سه رویداد وب‌هوک به سیستم‌های شما خبر می‌دهند که یک اتصال‌دهندهٔ فضای کاری وصل شده، اتصالش قطع شده یا به اتصال دوباره نیاز دارد.
اتصال یک برنامه
اتصال یک دقیقه طول می‌کشد، و ورود در صفحهٔ خود برنامه انجام می‌شود.
- اتصال‌دهنده‌ها را در نوار کناری باز کنید و برنامه را در بخش مرور، با نامش یا از روی دسته، پیدا کنید.
- انتخاب کنید اتصال‌دهنده برای چه کسی است: فقط شما، یا کل فضای کاری.
- انتخاب کنید دستیار از طریق آن چه کاری می‌تواند بکند: فقط جست‌وجو، یا ایجاد تغییر هم.
- کار را در صفحهٔ ورود برنامه تمام کنید، یا کلیدی از برنامه را آنجا جای‌گذاری کنید. اتصال‌دهنده تا وقتی کار را تمام نکرده‌اید در انتظار است، و پس از آن فعال.
- گذرواژه یا کلید شما برای برنامه هرگز از چت OpenEmail، API آن یا دستیار نمی‌گذرد.
- وقتی برنامه‌ای دیگر اتصال را نپذیرد، اتصال‌دهنده می‌گوید به اتصال دوباره نیاز دارد. یک پیوند تازه آن را به‌عنوان همان اتصال‌دهنده برمی‌گرداند، پس وظیفه‌هایی که از آن استفاده می‌کنند ادامه می‌دهند.
- اتصال‌دهنده را متوقف کنید تا دستیار نتواند از آن استفاده کند، و هر وقت دوباره خواستیدش آن را ادامه دهید.
- قطع اتصال، اتصال‌دهنده را برمی‌دارد و دسترسی‌ای را که در برنامهٔ بیرونی داشت هم لغو می‌کند.
- اتصال‌دهنده‌ها را می‌توان برای کل سرویس خاموش کرد. آن‌وقت این صفحه پنهان می‌شود.
چه کسی چه کاری می‌تواند بکند
| مجوز | چه اجازه‌ای می‌دهد |
|---|---|
| connectors:read | دیدن اتصال‌دهنده‌ها و کارهایی که از طریق آن‌ها انجام شده است |
| connectors:use | واداشتن دستیار به جست‌وجو و ایجاد تغییر از طریق آن‌ها |
| connectors:write | وصل کردن، متوقف کردن و قطع کردن برنامه‌ها، و تعیین کارهایی که دستیار در آن‌ها مجاز است |
- مالکان و مدیران هر سه را دارند. نقش داخلی Member مجوزهای
connectors:readوconnectors:useرا دارد، و Viewer مجوزconnectors:readرا. - همان مجوز هر دو نوع اتصال‌دهنده را پوشش می‌دهد: هر کس که اجازهٔ وصل کردن یک برنامه را دارد می‌تواند آن را برای خودش یا برای فضای کاری وصل کند.
از کد، ترمینال و عامل‌ها
اتصال‌دهنده‌ها در REST API زیر /connectors، /connector-apps، /connector-categories و /connector-calls، در هر SDK و در CLI زیر connectors، و در ابزارهای MCP هستند، که دستیار هم از آن‌ها استفاده می‌کند.