واجهة التقاط الصور Documents AI. استخراج الحقول مخطط له.

Xodera Plugins · Bubble Native

Xodera Documents AI Native

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

Public beta guides · Haptics instructions are in its Bubble listing

Public beta offer: free Bubble install · 7-day card trial, then US$1.50/month per plugin/project.

أنشئ تدفق العمل ↓إعدادات الإضافة ↗Native Lab

تمت مراجعة الوثائق 6 نوفمبر 2026

أمثلة عملية

املأ مسودة المصروف مسبقًا من صورة إيصال

الكتابة المتكررة للتاجر والتاريخ والإجمالي تبطئ إدخال المصروف؛ يمكن أن تكون الحقول المستخرجة مسودة قابلة للمراجعة.

`fields_json = ["merchant","date","total","currency"]`؛ يلتقط المستخدم صورة إيصال ويعطي موافقة منفصلة للمعالجة. استخدم فقط إيصالات عينة أثناء الاختبار.

مخطط: `analysis_requested` → Analyze Captured Document باستخدام البايتات المصدرة المحدودة/MIME/أسماء الحقول/الموافقة/معرّف الطلب → عرض الحقول المسترجعة في نموذج المصروفات القابل للتحرير.

الإجراء يُرجع `status` و`operation_id` و`fields_json` و`review_required`. يقوم المستخدم بتصحيح/اعتماد الحقول قبل أن ينشئ سير العمل الخاص بك مصروفًا.

في حالة نتيجة غير مؤكدة، Read Analysis مع نفس `operation_id`؛ لا تُصدر تحليلًا آخر تلقائيًا. سحب الموافقة يمسح الالتقاط/التصدير المحتفظ به؛ لا تحتفظ أبدًا ببيانات base64 الخام في كائن عام أو سجلات.

مخطط. يجب على الشخص مراجعة كل قيمة مقترحة قبل الحفظ.

قراءة مرجع إشعار التسليم لنموذج مراجعة الموظف

يجب أن يتمكن مستخدم المستودع من مراجعة المرجع/التاريخ المقترح بدلاً من كتابته من قسيمة ورقية مصورة.

`fields_json = ["delivery_reference","supplier","delivery_date"]`؛ التقط الجانب المناسب من عينة إشعار تسليم أثناء الاختبار.

بعد موافقة منفصلة على الالتقاط/المعالجة، يقترح Analyze Captured Document الحقول المحددة. اعرض الصورة بجوار الحقول القابلة للتحرير واطلب من الموظفين تأكيد سجل التسليم المطابق.

احتفظ بـ `operation_id` المسترجعة للتحقق من النتيجة مرة أخرى و`fields_json` كاقتراح. ينفذ سير العمل الخاص بك عملية البحث/التحديث الفعلية للتسليم فقط بعد مراجعة الموظف.

الحقول المفقودة أو الغامضة أو غير الصحيحة تتطلب تصحيحًا يدويًا. خطأ المزود يترك التسليم الأصلي دون تغيير؛ Read Analysis يتحقق من نتيجة عملية غير مؤكدة.

مخطط. يجب على الشخص مراجعة كل قيمة مقترحة قبل الحفظ.

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

يمكن لنموذج الصيانة تقديم اقتراح نموذج/رقم تسلسلي قابل للمراجعة عندما يكون كتابة ملصق الأصل صعبًا.

`fields_json = ["manufacturer","model","serial_number"]`؛ التقط صورة عينة لملصق المعدات؛ اختر مزود الذكاء الاصطناعي في إعدادات المشروع.

الإجراء المخطط Analyze Captured Document يُرجع سلاسل مقترحة. اعرضها بجوار الصورة؛ دع المستخدم يصححها قبل عملية البحث عن الأصل أو سير عمل الصيانة.

استخدم `fields_json` و `review_required` و `operation_id` المسترجعة. عالج المعرفات كنص لضمان احتفاظ تطبيقك بالأصفار الأولية.

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

مخطط. يجب على الشخص مراجعة كل قيمة مقترحة قبل الحفظ.

ما يعمل الآن

نسخة تجريبية خاصة. التقاط الصور متاح للاختبار. استخراج الحقول من الصورة مخطط له ولم يصبح جاهزًا للاستخدام في تطبيقك بعد.

أنشئ تدفق العمل

مخطط

سير عمل مخطط. غير متوفر بعد في النسخة التجريبية الحالية.

تستخدم هذه الأمثلة سجلات التطبيق مثل Lesson، Message و Order. استبدلها بأنواع البيانات وأسماء العناصر الخاصة بك. يجب استبدال عناوين الوسائط المثال بملفاتك الخاصة.

مخطط: اختر الحقول التي يحتاجها نموذجك، على سبيل المثال fields_json=["title","date","total"]. فعّل enable_analysis_export واضبط analysis_context على الحساب أو السجل المختار. إعدادات التحليل هذه غير متوفرة في نسخة الالتقاط الحالية.
اسمح للمستخدم بالتقاط صورة والموافقة بشكل منفصل على المعالجة. على analysis_requested، نفّذ Analyze Captured Document باستخدام analysis_image_base64 وanalysis_mime_type وanalysis_fields_json وanalysis_consent لهذا العنصر. استخدم analysis_request_id كـ idempotency_key.
احفظ operation_id و request_id والحالة المرتجعة. إذا كانت الحالة معالجة، استخدم Read Analysis مع ذلك operation_id لجلب النتيجة لاحقًا.
اعرض fields_json المسترجعة في نموذج مراجعة قابل للتحرير. احفظ القيم المعتمدة فقط بعد أن يتحقق المستخدم منها ويضغط على تأكيد. احتفظ بالسجل الأصلي حتى ذلك التأكيد.

مخطط سير العمل — ليس لقطة شاشة للتطبيق

قم بالإعداد مرة واحدة

أنشئ أو اختر مشروع تطبيق Bubble الخاص بك في BestPlugins → Dashboard → Plugins. اختر Xodera Documents AI Native، انسخ مفتاحه، ثم افتح Bubble → Plugins → Xodera Documents AI Native والصقه في project_api_key. احفظ مرة واحدة؛ ثم استخدم الإجراءات أدناه. لكل مكوّن إضافي في كل مشروع مفتاحه الخاص.

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

قم بالإعداد مرة واحدة

أنشئ أو اختر مشروع تطبيق Bubble الخاص بك في BestPlugins → Dashboard → Plugins.
اختر هذا المكوّن الإضافي وانسخ مفتاح مشروعه.
افتح Bubble → Plugins → Xodera Documents AI Native؛ الصق المفتاح في project_api_key واحفظ.
أضف العنصر، اختر بيانات تطبيقك وابنِ سير العمل أدناه.
الوصول إلى النسخة التجريبية الخاصة فقط في الوقت الحالي. التثبيت العام والتفعيل المدفوع غير متاحين بعد.

التثبيت والاشتراك

For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.

احفظ النتيجة في تطبيقك

مثال ExpenseDraft: المالك، operation_id، request_id، الحالة و proposed_fields_json. بعد المراجعة، احفظ تاريخ الموافقة، الإجمالي والحقول الأخرى، بالإضافة إلى reviewed_by و reviewed_at. قم بربط الحقول التي طلبها نموذجك فقط. لا تضع محتوى الصورة الكامل في السجلات أو النصوص العادية.

الفشل، الإلغاء والاستعادة

إذا تأخر النتيجة، احتفظ بنفس الطلب واستخدم Read Analysis للـ operation_id المعروف. لا تلتقط صورة جديدة أو تنشئ طلبًا جديدًا تلقائيًا. إذا سحب المستخدم موافقته، امسح الصورة وتوقف عن تقديم النتيجة؛ لا يمكن استرجاع نسخة تم إرسالها أو حفظها بالفعل.

القدرات والحدود

إدخال صورة مخطط: PNG، JPEG أو WebP، حتى 5 MiB؛ طلب 1–32 بأسماء حقول مميزة. راجع القيم المستخرجة دائمًا. هذا ليس تحقق هوية، ولا فحص أصالة المستند، ولا أداة اتخاذ قرار طبي. رسوم مزود الذكاء الاصطناعي منفصلة.

الإعدادات، الإجراءات والنتائج

استخدم هذه الأسماء في Bubble. الميزات المخططة مُعلّمة بشكل منفصل.

إعدادات بيتا المتاحة

إعدادات العنصر

document_side · textbutton_label · textconsent_text · textdisabled · yes/nofields_json · textprocessing_consent_text · textanalyze_button_label · textcheck_button_label · textlanguage · textui_text_json · text

الحالات

capture_status · textlocal_uri · textmime_type · textdocument_side · textimage_width · numberimage_height · numbererror_code · textis_capturing · yes/noanalysis_status · textanalysis_operation_id · textanalysis_fields_json · textanalysis_error_code · textreview_required · yes/nois_analyzing · yes/no

الأحداث

capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_error

الإجراءات ومدخلاتها

إعدادات العنصر · 12

سير عمل مخطط. غير متوفر بعد في النسخة التجريبية الحالية.

document_sidetext · الافتراضي: "front": قيمة مثالfront; مثال Bubble تعبيرCapture Side Dropdown's value; استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.

button_labeltext · الافتراضي: "": قيمة مثال""; مثال Bubble تعبيرApp Texts' capture_label; نص التطبيق المرئي؛ إذا كان فارغًا يستخدم النسخة المترجمة المدمجة حيثما تدعم. لا بيانات اعتماد.

consent_texttext · الافتراضي: "": قيمة مثالI agree to capture this non-sensitive receipt.; مثال Bubble تعبيرApp Texts' capture_consent; اشرح الغرض المحدد من الالتقاط/المعالجة والمتلقي. سحب الموافقة يمسح البيانات المخزنة، وليس النسخ السابقة للتطبيق.

disabledyes/no · الافتراضي: false: قيمة مثالno; مثال Bubble تعبيرGuideHost's is_busy (your yes/no custom state); عطّل العنصر بينما يكون تطبيقك مشغولًا أو يكون هذا الإجراء غير متاح.

processing_consent_texttext · الافتراضي: "": قيمة مثالI agree to send this image to the configured AI provider for draft fields.; مثال Bubble تعبيرApp Texts' processing_consent; اشرح الغرض المحدد من الالتقاط/المعالجة والمتلقي. سحب الموافقة يمسح البيانات المخزنة، وليس النسخ السابقة للتطبيق.

analyze_button_labeltext · الافتراضي: "": قيمة مثال""; مثال Bubble تعبيرApp Texts' analyze_label; نص التطبيق المرئي؛ إذا كان فارغًا يستخدم النسخة المترجمة المدمجة حيثما تدعم. لا بيانات اعتماد.

languagetext · الافتراضي: "auto": قيمة مثالuk; مثال Bubble تعبيرCurrent User's preferred_language; اضبط language=auto لتتبع جهاز أو لغة المتصفح المدعومة. أدخل رمز لغة مدعوم لاختيارها صراحة.

ui_text_jsontext · الافتراضي: "": قيمة مثال{}; مثال Bubble تعبيرApp Settings' player_labels_json (supported keys only); JSON اختياري مع تسميات الأزرار المدعومة. اتركه فارغًا لاستخدام النص المدمج.

enable_analysis_exportyes/no · الافتراضي: false: قيمة مثالyes; مثال Bubble تعبيرApp Settings' enable_reviewed_extraction; مخطط: السماح لإجراء التحليل باستخدام الصورة بعد موافقة المستخدمين الاثنين. معطَّل بشكل افتراضي.

analysis_contexttext · الافتراضي: "": قيمة مثال<current-user-id>; مثال Bubble تعبيرCurrent User's unique id; قيمة ثابتة لهذا الحساب أو السجل. تغييرها يمسح الصورة السابقة.

is_activeyes/no · الافتراضي: true: قيمة مثالyes; مثال Bubble تعبيرGuideHost's view_is_active (your yes/no custom state); عيّن نعم بينما هذه الواجهة مفتوحة. عيّن لا عند الخروج، حتى يمكن إيقاف التشغيل أو العمل الحالي.

fields_jsontext · الافتراضي: "[\"title\",\"date\",\"total\"]": قيمة مثال["title","date","total"]; مثال Bubble تعبيرExpense Settings' extraction_fields_json; JSON مصفوفة بأسماء حقول الاستخراج المطلوبة؛ الناتج هو بيانات مقترحة للمراجعة البشرية.

الإجراءات ومدخلاتها · 2

سير عمل مخطط. غير متوفر بعد في النسخة التجريبية الحالية.

Analyze Captured Document

image_base64text · الافتراضي: —: قيمة مثال<canonical bytes from consented export>; مثال Bubble تعبيرDocument Capture's analysis_image_base64; استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.

mime_typetext · الافتراضي: —: قيمة مثالimage/jpeg; مثال Bubble تعبيرDocument Capture's analysis_mime_type; استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.

fields_jsontext · الافتراضي: —: قيمة مثال["title","date","total"]; مثال Bubble تعبيرDocument Capture's analysis_fields_json; JSON مصفوفة بأسماء حقول الاستخراج المطلوبة؛ الناتج هو بيانات مقترحة للمراجعة البشرية.

consentyes/no · الافتراضي: —: قيمة مثالyes — current processing consent; مثال Bubble تعبيرDocument Capture's analysis_consent; استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.

idempotency_keytext · الافتراضي: —: قيمة مثال<unchanged analysis_request_id>; مثال Bubble تعبيرDocument Capture's analysis_request_id; استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.

environmenttext · الافتراضي: —: قيمة مثالdevelopment; مثال Bubble تعبيرApp Settings' selected_environment; استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.

الإرجاع

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no

Read Analysis

operation_idtext · الافتراضي: —: قيمة مثال<returned operation_id>; مثال Bubble تعبيرCurrent ExpenseDraft's operation_id; استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.

environmenttext · الافتراضي: —: قيمة مثالdevelopment; مثال Bubble تعبيرApp Settings' selected_environment; استخدم قيمة سجل الأعمال الحالي؛ تحقق منها مقابل الحدود أدناه.

الإرجاع

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no

الحالات والأحداث

سير عمل مخطط. غير متوفر بعد في النسخة التجريبية الحالية.

الحالات

capture_status · text

النتيجة الحالية لهذا الإجراء. استخدم حدث الإكمال المطابق قبل حفظ النجاح.

local_uri · text

موقع الملف على هذا الجهاز. احفظ أو ارفع الملف بشكل منفصل إذا كان يجب الاحتفاظ به على الإنترنت.

mime_type · text