افزودن افزونهٔ خودتان به فضای کاری

کاربرد

سامانهٔ سفارش‌های فروشگاه در فهرست نیست، برای همین کیان خودش آن را اضافه می‌کند. ارائه‌دهندهٔ ابزار خودتان را، از نوع «MCP» یا «OpenAPI»، اضافه کنید تا پس از اتصال، ایجنت‌های فضای کاری بتوانند از آن استفاده کنند.

پیش از شروع

در این فضای کاری باید مجوز مدیریت افزونه‌ها را داشته باشید. نشانی و اطلاعات اتصال ارائه‌دهنده را آماده داشته باشید (نشانی سرور یا مشخصات، و در صورت نیاز کلید دسترسی، توکن یا اطلاعات کلاینت ورود). اطلاعات محرمانه را در گفت‌وگو یا سند مشترک نگذارید. افزونه به فضای کاری انتخاب‌شده اضافه می‌شود.

مراحل

1. «افزونه‌ها» را باز کنید و «افزودن افزونه» را در بالای صفحه بزنید.
2. در «جزئیات افزونه»، «نام»، «توضیحات»، «توسعه‌دهنده»، «دسته» و «وب‌سایت» و «نسخه» (همگی الزامی) را پر کنید. «نماد افزونه» و «رنگ افزونه» را انتخاب کنید. در صورت نیاز «قابلیت‌ها» را با ویرگول یا خط جدید جدا کنید و نشانی «سیاست حفظ حریم خصوصی» و «شرایط استفاده» را بگذارید.
3. در «اتصال»، «ارائه‌دهنده» را انتخاب کنید: «MCP» یا «OpenAPI».
   • برای «MCP»: «نشانی سرور MCP» را وارد کنید و «روش انتقال» را بین «HTTP جریانی» و «SSE» انتخاب کنید.
   • برای «OpenAPI»: متن مشخصات (با قالب جیسون یا یمل) را در «مشخصات OpenAPI» بچسبانید. «نشانی پایه API» را فقط وقتی پر کنید که مشخصات نشانی کامل سرور را نداده باشد.
4. «احراز هویت» را انتخاب کنید: «بدون احراز هویت»، «OAuth 2.1»، «کلید API» یا «توکن حامل».
   • «کلید API»: «سرآیند کلید API» و کلید را وارد کنید.
   • «توکن حامل»: توکن را وارد کنید.
   • «OAuth 2.1»: در صورت نیاز «شناسه کلاینت OAuth»، «رمز کلاینت OAuth» و «دامنه‌های دسترسی OAuth» را بنویسید (اگر ارائه‌دهنده ثبت خودکار دارد، شناسه کلاینت را خالی بگذارید).
5. «افزودن افزونه» را بزنید و صبر کنید. برای افزونه‌هایی که با ورود به حساب کار می‌کنند، پیدا کردن ابزارها پس از اتصال انجام می‌شود. افزونه‌های دیگر هنگام افزودن بررسی می‌شوند: ایجنتوم با ارائه‌دهنده تماس می‌گیرد و ابزارهایش را پیدا می‌کند. با موفقیت، صفحهٔ افزونهٔ تازه باز می‌شود. سپس آن را متصل کنید (راهنمای «اتصال افزونه» را ببینید) و به ایجنت دسترسی بدهید: برای ایجنت پیش‌فرض در تنظیمات، «افزونه‌ها» (راهنمای «ابزارهای افزونه» را ببینید) و برای ایجنت سفارشی در بخش «افزونه‌ها»ی آن.

نتیجهٔ مورد انتظار

افزونه در فهرست افزونه‌ها با نشان «فضای کاری» نمایش داده می‌شود. افزودن آن را متصل نمی‌کند و به ایجنت‌ها دسترسی نمی‌دهد. اطلاعات محرمانه رمزنگاری‌شده نگه داشته می‌شوند.

رفع مشکل