نظرة عامة

تشرح هذه المقالة كيفية تكوين الإجراءات في GPT، بما في ذلك كيفية الاتصال بواجهات API خارجية، وتحديد ما يمكن لـ GPT فعله، وإدارة المصادقة، والمخططات، وقيود مساحة العمل المشتركة.

لتكوين إجراء، ستحتاج إلى تفاصيل API للخدمة التي تريد الاتصال بها، بما في ذلك معلومات المصادقة ومخطط OpenAPI. يمكن لـ GPT استخدام التطبيقات أو الإجراءات، ولكن ليس كليهما في الوقت نفسه.

يُعرَّف كل إجراء بمكوّنين رئيسيين: كيفية مصادقة GPT مع API، ومخطط يحدد ما يمكن لـ API فعله.

القيود

إذا كانت مساحة العمل المشتركة لديك تسمح بصفر نطاقات إجراءات، فلن تتمكن إجراءات GPT المخصصة من التنفيذ لأنه لا يمكن لأي نطاق إجراء اجتياز فحوصات قائمة السماح. لا يعني هذا بالضرورة أن كل إمكانات رؤية GPT أو الوصول إليه محظورة.

الإجراءات غير متاحة لوضع Pro. عند إنشاء GPT بإجراءات مخصصة أو تحريره، يعرض محدد النماذج فقط النماذج غير Pro التي تدعم الإجراءات.

الانتقال إلى المكوّنات الإضافية

لا تُنقل الإجراءات المخصصة تلقائيًا عند تحويل GPT إلى مكوّن إضافي. أعِدّ تكاملًا بديلًا واختبره قبل الاعتماد على المكوّن الإضافي. تظل التعليمات أدناه سارية على نماذج GPT الحالية التي لم تُحوَّل بعد ولديك إذن بتعديلها. للحصول على إرشادات الانتقال، راجع: الأسئلة الشائعة حول إيقاف نماذج GPT المخصصة والانتقال إلى المكوّنات الإضافية.

إنشاء إجراء

في محرّر GPT، انتقل إلى قسم الإجراءات واختر إنشاء إجراء جديد.

ستضبط بعد ذلك كيفية اتصال GPT الخاص بك بواجهة API خارجية واستخدامه لها.

بعد إعداد الإجراء، اختبره في المعاينة للتأكد من أنه يعمل على النحو المتوقع.

المصادقة

تتحكم المصادقة في كيفية اتصال GPT الخاص بك بواجهة API خارجية.

الخيارات المتاحة:

• بلا: لا يلزم إجراء مصادقة

• مفتاح API: يستخدم مفتاحًا سريًا لتخويل الطلبات

• OAuth: يستخدم تسجيل دخول المستخدم للوصول المستند إلى الحساب

مفتاح API

استخدم مصادقة مفتاح API للوصول من خادم إلى خادم. يمكن تكوينه على النحو التالي:

• أساسي

• Bearer

• ترويسة مخصصة

OAuth

استخدم OAuth عندما تتطلب الإجراءات حسابات مستخدمين. يتطلب OAuth ما يلي:

• معرّف العميل وسر العميل

• عنوان URL للتفويض وعنوان URL للرمز

• النطاق وطريقة تبادل الرموز

يوفر المحرر عنوان URL لمعاودة الاتصال لإكمال تدفق OAuth.

المخطط

يحدد المخطط ما يمكن لواجهة API الخاصة بك فعله. يُخبر ChatGPT بما يلي:

• أي خادم يجب استدعاؤه

• ما نقاط النهاية المتاحة

• ما المعلمات التي تقبلها

• كيفية تحديد كل إجراء (معرّفات العمليات)

يجب تقديم المخطط كمواصفة OpenAPI بتنسيق JSON أو YAML.

إضافة مخطط

يمكنك إضافة مخطط بثلاث طرق:

• الصقه مباشرة في المحرر

• استورده من عنوان URL

• ابدأ من مثال مضمّن:

  • الطقس (JSON)

  • متجر الحيوانات الأليفة (YAML)

  • قالب فارغ

إذا كان المخطط صالحًا، يعرض المحرر الإجراءات التي تم اكتشافها. إذا كان غير صالح، فستُعرض أخطاء التحقق من الصحة.

قيود مساحة العمل المشتركة (Enterprise وEdu)

إذا رأيت الرسالة:


«لا تسمح إعدادات مساحة العمل المشتركة لديك بأي نطاقات.»

فهذا يعني أن الإجراءات مقيدة بإعدادات مساحة العمل المشتركة لديك.

• يمكن للمسؤولين السماح بكل النطاقات أو تقييد الإجراءات بالنطاقات المعتمدة.

• إذا لم يكن مسموحًا بأي نطاقات، فلا يمكنك استخدام الإجراءات.

للاطلاع على عناصر التحكم على مستوى مساحة العمل المشتركة في الإجراءات وقيود النطاقات، راجع: إدارة الوصول إلى GPT في مساحات عمل Enterprise وEdu المشتركة.

الخصوصية وعناصر تحكم المستخدم

• يمكن أن يتضمن كل إجراء عنوان URL لسياسة الخصوصية.

• يجب أن تتضمن GPTs العامة (عبر رابط أو GPT Store) التي تحتوي على إجراءات عنوان URL صالحًا لسياسة الخصوصية.

• قد يُطلب من المستخدمين الموافقة على الإجراءات قبل تشغيلها.

• بالنسبة إلى إجراءات OAuth، يمكن للمستخدمين مراجعة الحسابات المتصلة وإدارتها.

مساعدة إضافية

للحصول على مساعدة في كتابة الإجراءات أو تصحيح أخطائها، استخدم ActionsGPT الرسمي.