نمای کلی

این مقاله توضیح می‌دهد چگونه اقدام‌ها را در یک GPT پیکربندی کنید، از جمله نحوه اتصال به APIهای خارجی، تعریف کارهایی که GPT می‌تواند انجام دهد، و مدیریت احراز هویت، الگوها و محدودیت‌های فضای کاری.

برای پیکربندی یک اقدام، به جزئیات API سرویسی که می‌خواهید متصل کنید نیاز دارید، از جمله اطلاعات احراز هویت و یک الگوی OpenAPI. یک GPT می‌تواند از برنامه‌ها یا اقدام‌ها استفاده کند، اما نه هر دو به‌طور هم‌زمان.

هر اقدام با دو مؤلفه اصلی تعریف می‌شود: نحوه احراز هویت GPT با API، و الگویی که تعریف می‌کند API چه کارهایی می‌تواند انجام دهد.

محدودیت‌ها

اگر فضای کاری شما هیچ دامنه اقدامی را مجاز نداند، اقدام‌های سفارشی GPT نمی‌توانند اجرا شوند، چون هیچ دامنه اقدامی نمی‌تواند بررسی‌های فهرست مجاز را بگذراند. این لزوماً به این معنا نیست که همه قابلیت‌های مشاهده یا دسترسی GPT مسدود شده‌اند.

اقدام‌ها برای حالت Pro در دسترس نیستند. وقتی یک GPT با اقدام‌های سفارشی ایجاد یا ویرایش می‌کنید، انتخابگر مدل فقط مدل‌های غیر Pro را نشان می‌دهد که از اقدام‌ها پشتیبانی می‌کنند.

ایجاد اقدام

در ویرایشگر GPT، به بخش اقدام‌ها بروید و ایجاد اقدام جدید را انتخاب کنید.

سپس پیکربندی می‌کنید که GPT شما چگونه به یک API خارجی متصل شود و از آن استفاده کند.

پس از پیکربندی یک اقدام، آن را در پیش‌نمایش آزمایش کنید تا مطمئن شوید مطابق انتظار عمل می‌کند.

احراز هویت

احراز هویت کنترل می‌کند GPT شما چگونه به یک API خارجی متصل می‌شود.

گزینه‌های موجود:

• هیچ‌کدام: احراز هویت لازم نیست

• کلید API: از یک کلید محرمانه برای مجاز کردن درخواست‌ها استفاده می‌کند

• OAuth: برای دسترسی مبتنی بر حساب از ورود کاربر استفاده می‌کند

کلید API

برای دسترسی سرور به سرور از احراز هویت با کلید API استفاده کنید. می‌توان آن را به این صورت پیکربندی کرد:

• Basic

• Bearer

• سربرگ سفارشی

OAuth

وقتی اقدام‌ها به حساب‌های کاربری نیاز دارند، از OAuth استفاده کنید. OAuth نیازمند موارد زیر است:

• شناسه کلاینت و راز کلاینت

• URL مجوزدهی و URL توکن

• دامنه دسترسی و روش تبادل توکن

ویرایشگر برای تکمیل جریان OAuth یک URL بازگشت ارائه می‌کند.

الگو

الگو تعریف می‌کند API شما چه کارهایی می‌تواند انجام دهد. این به ChatGPT می‌گوید:

• با کدام سرور تماس بگیرد

• چه نقاط پایانی در دسترس هستند

• چه پارامترهایی را می‌پذیرند

• هر اقدام چگونه شناسایی می‌شود (شناسه‌های عملیات)

الگو باید به‌صورت یک مشخصات OpenAPI در قالب JSON یا YAML ارائه شود.

افزودن الگو

می‌توانید یک الگو را به سه روش اضافه کنید:

• آن را مستقیماً در ویرایشگر جای‌گذاری کنید

• آن را از یک URL وارد کنید

• از یک نمونه داخلی شروع کنید:

  • آب‌وهوا (JSON)

  • فروشگاه حیوانات خانگی (YAML)

  • قالب خالی

اگر الگو معتبر باشد، ویرایشگر اقدام‌های شناسایی‌شده را نشان می‌دهد. اگر نامعتبر باشد، خطاهای اعتبارسنجی نمایش داده می‌شوند.

محدودیت‌های فضای کاری (Enterprise و Edu)

اگر این پیام را می‌بینید:


«هیچ دامنه‌ای توسط تنظیمات فضای کاری شما مجاز نشده است.»

یعنی اقدام‌ها توسط تنظیمات فضای کاری شما محدود شده‌اند.

• مدیران می‌توانند همه دامنه‌ها را مجاز کنند یا اقدام‌ها را به دامنه‌های تأییدشده محدود کنند.

• اگر هیچ دامنه‌ای مجاز نباشد، نمی‌توانید از اقدام‌ها استفاده کنید.

برای کنترل‌های سطح فضای کاری روی اقدام‌ها و محدودیت‌های دامنه، ببینید: مدیریت دسترسی GPT در فضاهای کاری Enterprise و Edu.

حریم خصوصی و کنترل‌های کاربر

• هر اقدام می‌تواند شامل یک URL سیاست حفظ حریم خصوصی باشد.

• GPTهای عمومی (پیوند یا GPT Store) که اقدام دارند باید یک URL معتبر برای سیاست حفظ حریم خصوصی داشته باشند.

• ممکن است از کاربران خواسته شود پیش از اجرای اقدام‌ها آن‌ها را تأیید کنند.

• برای اقدام‌های OAuth، کاربران می‌توانند حساب‌های متصل را بازبینی و مدیریت کنند.

راهنمایی بیشتر

برای دریافت کمک در نوشتن یا اشکال‌زدایی اقدام‌ها، از ActionsGPT رسمی استفاده کنید.