تشغيل التعليمات البرمجية داخل وكيل الذكاء الاصطناعي الخاص بك باستخدام بطاقة تنفيذ التعليمات البرمجية

وكلاء الذكاء الاصطناعي لا يتمتعون بالقوة إلا بقدر قوة البيانات التي يمكنهم الوصول إليها. في حين أن النماذج اللغوية الكبيرةLLMs تولد استجابات من بيانات التدريب، إلا أنها لا تستطيع استرداد أسعار الأسهم في الوقت الحقيقي، أو معالجة المدفوعات، أو الوصول إلى تفاصيل إدارة علاقات العملاء - ما لم يتم دمجها مع واجهات برمجة التطبيقات.

تُمكِّن واجهات برمجة التطبيقات وكلاء الذكاء الاصطناعي من الوصول إلى البيانات في الوقت الفعلي، وتنفيذ المنطق، وتشغيل الإجراءات. وللاستفادة منها بشكل كامل، يحتاج الوكلاء إلى كود مخصص.

تتيح لك بطاقة "تنفيذ التعليمات البرمجية" في Botpress Studio كتابة وتنفيذ JavaScript داخل سير عمل الروبوت - التعامل بسلاسة مع مكالمات واجهة برمجة التطبيقات، ومعالجة البيانات، وتخصيص سلوك الروبوت.

ما هي بطاقة تنفيذ الكود؟

تُمكِّن بطاقة تنفيذ التعليمات البرمجية في Botpress المطورين من تشغيل جافا سكريبت مخصص داخل تدفق الروبوت. وهي تمكّن الوظائف التالية:

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

‍

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

لماذا يحتاج وكلاء الذكاء الاصطناعي إلى واجهات برمجة تطبيقات خارجية؟

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

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

‍

5 طرق لاستخدام بطاقة تنفيذ التعليمات البرمجية

تعمل بطاقة تنفيذ الكود في Botpress Studio على تبسيط عمليات وكيل الذكاء الاصطناعي. وإضافتها إلى سير عملك أمر بسيط - اتبع هذا البرنامج التعليمي السريع:

‍

‍بمجردإضافته، إليك بعض الطرق الرئيسية للاستفادة منه في سير العمل العميل الخاص بك.

1. مكالمات واجهة برمجة التطبيقات الديناميكية

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

مثال: جلب بيانات مخصصة بناءً على تفضيلات المستخدم.

موجه: يحتاج chatbot الخاص بالسفر إلى استرداد أسعار الفنادق بناءً على وجهة المستخدم وتواريخ السفر والميزانية.

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

2. المعالجة اللاحقة على استجابات LLM

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

‍مثال: إعادة كتابة استجابات LLM غير المنظمة في جدول/تنسيق محدد.

‍مقترح: يقوم الذكاء الاصطناعي بجلب توصيات المطاعم من واجهة برمجة التطبيقات، وأريد منك تنسيقها في جدول نظيف قبل عرضها.

3. الحد من المعدل والتنفيذ المشروط

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

‍مثال: التحقق من استخدام واجهة برمجة التطبيقات قبل استدعائها

‍Prompt: Check API quota from https://api.monitoring.com/usage?apikey=${workflow.userApiKey} before making a request. If fewer than 5 requests remain, return an error; otherwise, proceed. Ensure proper error handling in case of failures.

4. التعامل مع الأذونات

إذا كان الروبوت الخاص بك يحتاج إلى التحقق من المستخدمين قبل منحهم حق الوصول إلى ميزات معينة، فإن البطاقة تسمح بتدفقات مصادقة مخصصة تتجاوز الخيارات الافتراضية لـ Botpress.

‍مثال: التحقق من حالة اشتراك المستخدم قبل توفير استجابات الذكاء الاصطناعي

‍Prompt: Check a user's subscription via https://billing.example.com/user/{userId}. If on a free plan, prompt an upgrade; otherwise, allow access. Handle errors.

5. تسلسل واجهة برمجة التطبيقات متعددة الخطوات

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

‍مثال: جلب الطقس + حجز المطعم للتوصية بأفضل وقت للمغادرة

‍مقترح: قم بجلب بيانات الطقس وحركة المرور لسير العمل.city باستخدام workflow.userApiKey. بناءً على الظروف، قم بإرجاع أفضل وقت للسفر. تعامل مع حالات الفشل.

تكامل سلس لواجهة برمجة التطبيقات (API) لوكلاء الذكاء الاصطناعي

يعمل وكلاء الذكاء الاصطناعي بشكل أفضل عندما يتمكنون من الاستفادة من البيانات في الوقت الفعلي، وأتمتة سير العمل، والاتصال بالخدمات الخارجية.

يجعل Botpress Hub هذا الأمر سلسًا بفضل عمليات تكامل واجهة برمجة التطبيقات المبنية مسبقًا وأدوات الأتمتة والموصلات الجاهزة للاستخدام - حتى تتمكن من التركيز على البناء وليس التهيئة.

‍ابدأ فيدمج واجهات برمجة التطبيقات الفعّالة في سير عمل الروبوت الخاص بك اليوم - إنه مجاني.

الأسئلة الأكثر تداولًا

1. هل أحتاج إلى معرفة JavaScript لاستخدام بطاقة تنفيذ التعليمات البرمجية بفعالية؟

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

2. هل هناك قوالب أو مقتطفات من التعليمات البرمجية لعمليات تكامل واجهة برمجة التطبيقات الشائعة؟

نعم، يقدم Botpress أمثلة مدمجة ومقتطفات من التعليمات البرمجية لعمليات تكامل واجهة برمجة التطبيقات الشائعة مثل CRMs وبوابات الدفع. يمكنك أيضًا تصفح منتديات المجتمع للحصول على أنماط التعليمات البرمجية الجاهزة للاستخدام.

3. هل يمكنني استخدام بطاقة تنفيذ التعليمات البرمجية بدون خبرة سابقة في تكامل واجهة برمجة التطبيقات؟

نعم، يمكنك استخدام بطاقة تنفيذ التعليمات البرمجية بدون خبرة سابقة في تكامل واجهة برمجة التطبيقات. الواجهة صديقة للمبتدئين، ويمكن لمساعد الذكاء الاصطناعي في Botpress إنشاء التعليمات البرمجية وشرحها، مما يجعل منحنى التعلم قابلاً للإدارة حتى لغير المطورين.

4. كيف تتعامل البطاقة مع طلبات واجهة برمجة التطبيقات الطويلة الأمد أو المهلات؟

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

5. ما هي أفضل الممارسات لتنفيذ المصادقة والتفويض باستخدام البطاقة؟

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