التكاملات
ربط أي API
استخدم خدمات غير موجودة في كتالوج الموصّلات، من واجهات API العامة إلى الخدمات التي تحتاج إلى مفتاح، أو أضف موصّلك الخاص ليتمكن الذكاء الاصطناعي من الإنشاء به.
يضم كتالوج الموصّلات أكثر من 100 خدمة، لكن تطبيقك يستطيع العمل مع أي خدمة تقريبًا لديها API (وهي طريقة تتيح للبرامج الأخرى التواصل معها). توضح لك هذه الصفحة ثلاث طرق لذلك، من الأسرع إلى الأكثر قابلية لإعادة الاستخدام.
| وضعك | ما عليك فعله |
|---|---|
| الـ API عامة ولا تحتاج إلى مفتاح | اطلبها في المحادثة |
| الـ API تحتاج إلى مفتاح، وتحتاج إليه في تطبيق واحد فقط | دع الذكاء الاصطناعي يطلب المفتاح، ويُحفظ كمفتاح سري لذلك التطبيق |
| ستستخدم الخدمة في عدة تطبيقات، أو تريد أن يفهمها الذكاء الاصطناعي جيدًا | أنشئ موصّلك الخاص من صفحة الموصّلات |
أيًّا كانت الطريقة التي تختارها، تُستخدم المفاتيح في الكود الذي يعمل على خادم تطبيقك فقط، فلا تصل إلى متصفحات زوّارك.
استخدام API عامة
كثير من الخدمات، مثل الطقس والعطلات الرسمية والبيانات المفتوحة، لا تحتاج إلى مفتاح إطلاقًا. اذكر اسم الخدمة وقل ما تريده منها.
اعرض توقعات الطقس لخمسة أيام لمدينة الزائر في الصفحة الرئيسية، باستخدام Open-Meteo API.
إذا احتاج الذكاء الاصطناعي إلى تفاصيل عن API لا يعرفها جيدًا، فالصق في المحادثة الجزء المناسب من توثيقها، مثل طلب واحد كمثال والإجابة التي يرجعها، أو أرفق التوثيق كملف. راجع إضافة الصور والملفات.
استخدام API تحتاج إلى مفتاح
عندما تحتاج ميزة ما إلى مفتاح لخدمة غير موجودة في الكتالوج، يعرض الذكاء الاصطناعي في المحادثة بطاقة مفتاح فيها الاسم الذي سيستخدمه، مثل ACME_API_KEY. الصق المفتاح وانقر حفظ، أو انقر تخطي لتتابع من دونه.
تقول البطاقة ذلك بوضوح: يُحفظ المفتاح بأمان وبشكل مشفّر، ولا يظهر أبدًا في المحادثة ولا في كود تطبيقك، ويمكنك تغييره لاحقًا من إدارة ← المفاتيح السرية (يُخبَر أعضاء الفريق بأن مالك المشروع هو من يستطيع تغييره).
أضف نموذج تواصل ينشئ عميلًا محتملًا جديدًا في نظام CRM لدينا عبر API الخاصة به. اطلب مني مفتاح API.
يمكنك أيضًا إضافة المفاتيح بنفسك قبل أن تطلب: افتح تبويب إدارة، واختر المفاتيح السرية، وأضف مفتاحًا من إضافة مفتاح سري جديد. تلتقط المعاينة التغييرات تلقائيًا، أما تطبيقك المنشور فيحصل عليها في المرة التالية التي تنشر فيها. راجع المفاتيح السرية ومفاتيح API.
لا تكتب المفاتيح داخل رسالة في المحادثة. رسائل المحادثة تُحفظ مع مشروعك. استخدم بطاقة المفتاح أو إدارة ← المفاتيح السرية بدلًا من ذلك.
إنشاء موصّلك الخاص
إذا كنت ستستخدم خدمة في أكثر من تطبيق، أو تريد أن يفهم الذكاء الاصطناعي API الخاصة بها فهمًا جيدًا، فأضفها كموصّل خاص بك. تصف الـ API مرة واحدة، وبعدها يعمل مثل أي موصّل في الكتالوج: تربطه بمفتاحك، وتشغّله أو توقفه لكل تطبيق، ويستطيع الذكاء الاصطناعي الإنشاء به والقراءة منه أثناء الإنشاء.
في صفحة الموصّلات، انتقل إلى موصّلاتك الخاصة وانقر إنشاء موصّل. أبقِ توثيق API الخاص بالخدمة مفتوحًا أمامك، لأنك ستحتاج إلى عنوان API وإلى معرفة كيف تستقبل الخدمة المفتاح. لا تضع أي مفاتيح في الوصف نفسه؛ ستربط مفتاحك أنت في النهاية.
التفاصيل
حدّد له الاسم. يمكنك اختياريًا إضافة وصف قصير للبطاقة وما وظيفته (يساعد هذا الذكاء الاصطناعي على معرفة متى يستخدمه). ثم اختر الفئة، وأضف رابط توثيق API إن شئت، واختر اللون. أما الاسم البرمجي فيحدد أسماء الإعدادات التي تقرؤها تطبيقاتك، مثل
ACME_CRM_API_KEY. ولا يمكن تغييره لاحقًا.طريقة تسجيل الدخول
أدخل عنوان API الذي يبدأ منه كل طلب (يجب أن يبدأ بـ
https://). ثم أجب عن كيف تتحقق الخدمة من هويتك؟: رمز Bearer، أو مفتاح API في ترويسة، أو مفتاح API في العنوان، أو اسم المستخدم وكلمة المرور. إذا كانت الخدمة تحتاج إلى أكثر من قيمة، مثل رقم تعريف الحساب، فأضفها ضمن هل يحتاج إلى أكثر من قيمة؟. وتعرض لك المعاينة شكل الطلب.طلب الاختبار
اختر طلبًا يقرأ فقط ويحتاج إلى المفتاح، مثل "من أنا" أو "اعرض عناصري". يشغّل Buildliy هذا الطلب للتحقق من كل مفتاح قبل حفظه، لذلك يجب ألا يغيّر أي شيء. ضمن جرّبه (اختياري) يمكنك لصق مفتاح والنقر على تشغيل طلب الاختبار لترى الإجابة؛ هذا المفتاح يُستخدم للاختبار فقط، ولا يُحفظ إلا إذا ربطت به لاحقًا.
من يرى البيانات
اختر أنا فقط — بيانات شخصية للبيانات الخاصة بحسابك (بريدك أو ملاحظاتك أو بنكك)، أو أي شخص يستخدم تطبيقي — بيانات مشتركة للبيانات المخصصة للجميع، مثل قائمة منتجات أو إعلانات عامة.
ملاحظات للذكاء الاصطناعي
يمكنك اختياريًا لصق أجزاء من توثيق الـ API التي تريد أن يعرفها الذكاء الاصطناعي: نقاط النهاية، وأمثلة الطلبات والإجابات. أعطِ كل ملاحظة اسم الملف، وإن أردت فحدد متى يقرأه الذكاء الاصطناعي؟ يمكنك إضافة ما يصل إلى 10 ملاحظات، بحد أقصى 20,000 حرف لكل ملاحظة. يرى الذكاء الاصطناعي بداية كل ملاحظة ويقرأ الباقي عندما يحتاج إليه. لا تلصق مفاتيح هنا أبدًا.
انقر إنشاء موصّل. تفتح بعد ذلك نافذة الربط، وفيها المفتاح الذي كتبته ضمن جرّبه (اختياري) معبّأً مسبقًا: أدخل مفتاحك إذا لزم الأمر وانقر ربط. يشغّل Buildliy طلب الاختبار بالمفتاح قبل حفظه، ثم يحتفظ به مشفّرًا. ولا يُستخدم إلا في الكود الذي يعمل على خادم تطبيقاتك.
استخدم موصّل Acme CRM الخاص بي لعرض أحدث 20 جهة اتصال لدي في صفحة لوحة معلومات، مع مربع بحث.
لكل موصّل من موصّلاتك الخاصة بطاقة فيها ربط (أو إدارة بعد الربط، أو إعادة الربط إذا توقف المفتاح عن العمل)، وتعديل، وزر حذف. يؤدي الحذف إلى إزالة الموصّل ومفتاحك المحفوظ له، ولن تتمكن التطبيقات التي تستخدمه من الوصول إلى الخدمة حتى تضيفه من جديد. ويمكن أن يكون لديك ما يصل إلى 25 موصّلًا خاصًا بك.
إذا اخترت أنا فقط — بيانات شخصية، فسيُبقي الذكاء الاصطناعي أي شيء قادم من تلك الخدمة خلف تسجيل الدخول في تطبيقك. وبعد الربط، تمنع قائمة التحقق قبل الإطلاق النشر إذا كان كود تطبيقك يستخدمه ولا يوجد في التطبيق تسجيل دخول. أما إذا كان في التطبيق تسجيل دخول، فتذكّرك القائمة بالتأكد من أنك وحدك (أو الأشخاص الذين تختارهم) من يستطيع تسجيل الدخول، لأن ترك إنشاء الحسابات مفتوحًا للجميع يتيح لأي شخص رؤية البيانات.
استقبال الأحداث من خدمة
بعض الخدمات تستطيع أن ترسل إلى تطبيقك رسالة عندما يحدث شيء ما، مثل طلب جديد أو دفعة مكتملة. تُسمّى هذه الرسائل غالبًا ويب هوك (webhooks). اطلب من الذكاء الاصطناعي أن يضيف في تطبيقك مكانًا لاستقبالها. وإذا أعطتك الخدمة مفتاح توقيع سريًا للتحقق من أن الرسائل أصلية، فسيطلبه الذكاء الاصطناعي منك عبر بطاقة مفتاح.
أضف نقطة استقبال webhook تستقبل أحداث الطلبات الجديدة من نظام المخازن لدينا وتحفظ كل طلب في قاعدة البيانات.
أعطِ الخدمة عنوان تطبيقك المنشور، وليس عنوان المعاينة، لأن المعاينة لا تكون قيد التشغيل دائمًا. راجع نشر تطبيقك.
مواضيع ذات صلة
ما زلت عالقًا؟ اقرأ الأسئلة الشائعة أو تواصل معنا.