مشاركة عبر

واجهة برمجة تطبيقات مساعدي Azure OpenAI (معاينة)

  • مقالة

المساعدون، وهي ميزة جديدة لخدمة Azure OpenAI، متاحة الآن في المعاينة العامة. تسهل واجهة برمجة تطبيقات المساعدين على المطورين إنشاء تطبيقات بتجارب متطورة تشبه copilot يمكنها التدقيق في البيانات واقتراح الحلول وأتمتة المهام.

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

نظرة عامة

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

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

تلميح

لا توجد أسعار إضافية أو حصة نسبية لاستخدام المساعدين ما لم تستخدم مترجم التعليمات البرمجية أو أدوات البحث في الملفات.

تم بناء واجهة برمجة تطبيقات المساعدين على نفس القدرات التي تدعم منتج GPT الخاص ب OpenAI. تتراوح بعض حالات الاستخدام المحتملة من الذكاء الاصطناعي موصي المنتج، تطبيق محلل المبيعات، مساعد الترميز، روبوت دردشة Q&A الموظف، والمزيد. ابدأ البناء على ملعب المساعدين بدون تعليمات برمجية على Azure OpenAI Studio أو الذكاء الاصطناعي Studio أو ابدأ البناء باستخدام واجهة برمجة التطبيقات.

هام

قد يؤدي استرداد البيانات غير الموثوق بها باستخدام استدعاء الدالة أو مترجم التعليمات البرمجية أو البحث في الملفات مع إدخال الملف ووظائف مساعد مؤشرات الترابط إلى اختراق أمان مساعدك أو التطبيق الذي يستخدم المساعد. تعرف على نهج التخفيف من المخاطر هنا.

ملعب المساعدين

نحن نقدم معاينة لملعب المساعدين في دليل التشغيل السريع. يوفر هذا بيئة بدون تعليمات برمجية لاختبار قدرات المساعدين.

مكونات المساعدين

رسم تخطيطي يوضح مكونات المساعد.

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

وصول المساعدين إلى البيانات

حاليا، يتم تحديد نطاق المساعدين ومؤشرات الترابط والرسائل والملفات التي تم إنشاؤها للمساعدين على مستوى مورد Azure OpenAI. لذلك، يمكن لأي شخص لديه حق الوصول إلى مورد Azure OpenAI أو الوصول إلى مفتاح API قراءة/كتابة المساعدين ومؤشرات الترابط والرسائل والملفات.

نوصي بشدة بعناصر التحكم في الوصول إلى البيانات التالية:

  • تنفيذ التخويل. قبل إجراء عمليات القراءة أو الكتابة على المساعدين ومؤشرات الترابط والرسائل والملفات، تأكد من أن المستخدم النهائي مخول للقيام بذلك.
  • تقييد مورد Azure OpenAI والوصول إلى مفتاح API. فكر بعناية في من لديه حق الوصول إلى موارد Azure OpenAI حيث يتم استخدام المساعدين ومفاتيح واجهة برمجة التطبيقات المقترنة.
  • تدقيق الحسابات/الأفراد الذين لديهم حق الوصول إلى مورد Azure OpenAI بشكل روتيني. تتيح مفاتيح واجهة برمجة التطبيقات والوصول إلى مستوى الموارد مجموعة واسعة من العمليات بما في ذلك قراءة الرسائل والملفات وتعديلها.
  • تمكين إعدادات التشخيص للسماح بالتتبع طويل الأجل لجوانب معينة من سجل نشاط مورد Azure OpenAI.

المعلمات

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

إدارة نافذة السياق

يقوم المساعدون تلقائيا باقتطاع النص للتأكد من بقائه ضمن الحد الأقصى لطول السياق للنموذج. يمكنك تخصيص هذا السلوك عن طريق تحديد الحد الأقصى للرمز المميزة التي ترغب في أن يستخدمها التشغيل و/أو الحد الأقصى لعدد الرسائل الأخيرة التي ترغب في تضمينها في التشغيل.

الحد الأقصى للإكمال والرموز المميزة للمطالبة القصوى

للتحكم في استخدام الرمز المميز في تشغيل واحد، قم بتعيين max_prompt_tokens وعند max_completion_tokens إنشاء Run. تنطبق هذه الحدود على إجمالي عدد الرموز المميزة المستخدمة في جميع عمليات الإكمال طوال دورة حياة التشغيل.

على سبيل المثال، يعني بدء تشغيل مع max_prompt_tokens تعيين إلى 500 وتعيينه max_completion_tokens إلى 1000 أن الإكمال الأول سيقتطاع مؤشر الترابط إلى 500 رمز مميز ويحدد الحد الأقصى للإخراج عند 1000 رمز مميز. إذا تم استخدام 200 رمز مميز موجه و300 رمز مميز للإكمال في الاكتمال الأول، فسيكون للإكمال الثاني حدود متاحة من 300 رمز مميز للمطالبة و700 رمز مميز للإكمال.

إذا وصل الإكمال إلى max_completion_tokens الحد الأقصى، فسينتهي التشغيل بحالة غير مكتملة، وسيتم توفير التفاصيل في incomplete_details حقل كائن Run.

عند استخدام أداة "البحث في الملفات"، نوصي بتعيين max_prompt_tokens إلى ما لا يقل عن 20,000. لإجراء محادثات أطول أو تفاعلات متعددة مع "البحث في الملفات"، ضع في اعتبارك زيادة هذا الحد إلى 50,000، أو بشكل مثالي، إزالة max_prompt_tokens الحدود تماما للحصول على أعلى نتائج ذات جودة.

استراتيجية الاقتطاع

يمكنك أيضا تحديد استراتيجية اقتطاع للتحكم في كيفية عرض مؤشر الترابط الخاص بك في نافذة سياق النموذج. سيستخدم استخدام استراتيجية اقتطاع من النوع auto استراتيجية اقتطاع OpenAI الافتراضية. سيسمح لك استخدام استراتيجية اقتطاع من النوع last_messages بتحديد عدد أحدث الرسائل لتضمينها في نافذة السياق.

(راجع أيضًا )