اتصال افزونه
باز کردن در ایجنتومکاربرد
تا وقتی کیان افزونهٔ موجودی انبار را وصل نکرده، هیچ‌کس در تیم نمی‌تواند از ایجنت دربارهٔ موجودی چیزی بپرسد. افزونه‌ای را متصل کنید تا ایجنت‌هایتان از ابزارهای آن استفاده کنند، و بعداً که لازمش نداشتید اتصال را قطع یا افزونه را حذف کنید.
پیش از شروع
در فضای کاری باید مجوز استفاده از افزونه‌ها را داشته باشید. قواعد فضای کاری می‌توانند افزونه‌های مجاز را محدود کنند.
مراحل
- «افزونه‌ها» را باز کنید و افزونهٔ موردنظر را باز کنید (راهنمای «مرور افزونه‌ها و دیدن امکانات آن‌ها» را ببینید).
- «اتصال» را بزنید. پنجره‌ای با عنوان «اتصال [نام] به ایجنتوم» اتصال را توضیح می‌دهد: شما تصمیم می‌گیرید وصل کنید یا نه، اطلاعات اتصال رمزنگاری‌شده نگه داشته می‌شود و فقط اطلاعات لازم برای اجرای ابزار مجاز با ارائه‌دهنده به اشتراک گذاشته می‌شود.
- «ادامه با [نام]» را بزنید. برای افزونه‌ای که با ورود به حساب کار می‌کند (روش «OAuth 2.1»)، به ارائه‌دهنده می‌روید، دسترسی را تأیید می‌کنید و به ایجنتوم برمی‌گردید. در روش‌های دیگر («بدون احراز هویت»، «کلید API»، «توکن حامل») اتصال بلافاصله برقرار می‌شود.
- وقتی صفحه «امتحان در گفت‌وگو» را نشان داد و فهرست «ابزارها» پر شد، افزونه متصل است. «امتحان در گفت‌وگو» یک گفت‌وگوی تازه باز می‌کند؛ اگر افزونه قابلیت‌هایی ثبت کرده باشد، اولین قابلیت از قبل در کادر پیام نوشته شده است. آن را بفرستید یا کار دیگری بخواهید که به این افزونه نیاز دارد؛ این دکمه افزونه را خودکار انتخاب نمی‌کند. سپس به ایجنت خود دسترسی بدهید: برای ایجنت پیش‌فرض، دسترسی را در تنظیمات، «افزونه‌ها» مدیریت کنید (راهنمای «ابزارهای افزونه» را ببینید)؛ برای ایجنت سفارشی، افزونه را در بخش «افزونه‌ها»ی آن روشن کنید (راهنمای «انتخاب ابزارهای افزونه برای ایجنت» را ببینید).
- برای قطع اتصال، در صفحهٔ افزونه «گزینه‌های بیشتر برای [نام]» را باز کنید و «قطع اتصال» را بزنید، یا در ردیف افزونه در فهرست «مدیریت [نام]» را بزنید (برای افزونه‌ای که خودتان اضافه کرده‌اید «مدیریت اتصال» در «گزینه‌های [نام]»). در پنجرهٔ «[نام] متصل است»، «قطع اتصال [نام]» را بزنید. این پنجره افزونه، «زمان اتصال»، «نقطه پایانی» و «روش احراز هویت» را هم نشان می‌دهد.
- اگر افزونه را خودتان اضافه کرده‌اید و مجوز مدیریت افزونه‌ها دارید، می‌توانید آن را حذف کنید: در صفحهٔ افزونه، وقتی متصل است «حذف افزونه» در «گزینه‌های بیشتر برای [نام]» است و وقتی متصل نیست در «گزینه‌های افزونه» (سه نقطهٔ کنار «اتصال»)؛ در فهرست هم در منوی ردیف، «گزینه‌های [نام]». «[نام] حذف شود؟» را با «حذف افزونه» تأیید کنید. این کار افزونه و اتصال‌هایش را از فضای کاری حذف می‌کند و قابل بازگشت نیست.
نتیجهٔ مورد انتظار
افزونه متصل نمایش داده می‌شود، در فهرست افزونه‌ها نشان «متصل» می‌گیرد و در فیلتر «متصل» می‌آید. بعد از قطع اتصال، ابزارهایش در اجراهای جدید ایجنت در دسترس نیستند و هر زمان بخواهید می‌توانید دوباره وصلش کنید.
رفع مشکل
| مشکل | راه‌حل |
|---|---|
| اتصال ناموفق است یا رد می‌شود | خطای پنجره را بخوانید و دوباره تلاش کنید. ممکن است ارائه‌دهنده یا قاعده‌ای در فضای کاری آن را نپذیرد. |
| ورود از طریق ارائه‌دهنده تمام نمی‌شود | به صفحهٔ افزونه برگردید و دوباره «اتصال» را بزنید. |
| «حذف افزونه» نمایش داده نمی‌شود | فقط کسی که افزونه را اضافه کرده می‌تواند آن را حذف کند، و حذف مجوز مدیریت افزونه‌ها را هم می‌خواهد. حتی اگر «حذف افزونه» دیده شود، ممکن است مجوزهای فضای کاری آن را رد کنند. |
| افزونه متصل است ولی ایجنت از آن استفاده نمی‌کند | اتصال به همهٔ ایجنت‌ها دسترسی نمی‌دهد. برای ایجنت پیش‌فرض، دسترسی را در تنظیمات، «افزونه‌ها» مدیریت کنید (راهنمای «ابزارهای افزونه» را ببینید). برای ایجنت سفارشی، کلید افزونه را در بخش «افزونه‌ها»ی آن روشن کنید. |