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.
مستندات بررسی‌شده 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 و status بازگشتی را ذخیره کنید. اگر مقدار status برابر processing باشد، از Read Analysis همراه با آن operation_id برای دریافت نتیجه بعداً استفاده کنید.
fields_json را در فرم بازبینی قابل ویرایش نشان دهید. پس از بررسی توسط کاربر و فشار دادن Confirm، فقط مقادیر تأییدشده را ذخیره کنید. تا زمان تأیید، رکورد اصلی را نگه دارید.
یک‌بار پیکربندی کنید
پروژه برنامه 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/noRead 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مقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
document_side · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
image_width · numberمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
image_height · numberمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
error_code · textاطلاعات خطا برای آخرین عمل. پیام مفید نشان دهید و گزینهٔ تلاش مجدد مرتبط را ارائه دهید.
is_capturing · yes/noمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
analysis_image_base64 · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
analysis_mime_type · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
analysis_fields_json · textمقادیر پیشنهادی برای فیلدهای درخواست‌شده. قبل از ذخیره‌سازی برای بازبینی نمایش دهید.
analysis_request_id · textشناسه برای این مورد یا عمل. آن را همراه با رکورد برنامهٔ مرتبط نگه دارید. هنگام تلاش مجدد برای نتیجهٔ نامشخص، از همان شناسهٔ درخواست استفاده کنید.
analysis_consent · yes/noمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
analysis_export_status · textنتیجه فعلی این عمل. قبل از ذخیره موفقیت، از رویداد تکمیل مطابقت‌دار استفاده کنید.
analysis_export_error · textاطلاعات خطا برای آخرین عمل. پیام مفید نشان دهید و گزینهٔ تلاش مجدد مرتبط را ارائه دهید.
analysis_image_bytes · numberمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
رویدادها
capture_startedهنگامی که این رویداد رخ میدهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
capture_succeededهنگامی که این رویداد رخ میدهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
capture_cancelledهنگامی که این رویداد رخ میدهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
permission_deniedهنگامی که این رویداد رخ میدهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
capture_errorهنگامی که این رویداد رخ میدهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
analysis_requestedهنگامی که این رویداد رخ میدهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
analysis_export_errorهنگامی که این رویداد رخ میدهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
analysis_clearedهنگامی که این رویداد رخ میدهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
سؤالاتی که توسعه‌دهندگان می‌پرسند
آیا این هویت یا اسناد را تأیید میکند؟
نه. این فیلدهای متنی را برای بازبینی پیشنهاد میدهد. یک تصویر سند ضبطشده هویت، اصالت یا نتیجهگیری پزشکی/مالی را تأیید نمیکند.
اشتراک چگونه کار میکند؟
قیمتگذاری برنامهریزیشده: نصب افزونه در Bubble رایگان است. دسترسی به BestPlugins یک اشتراک جداگانه برای هر افزونه در هر پروژه برنامهای Bubble است: 7 روز رایگان، سپس US$1.50 در ماه. Development و Live گنجانده شدهاند. محدودیت ثابت برای تعداد عملیات وجود ندارد؛ محدودیتهای حجم فایل و ویژگیها همچنان اعمال میشوند. پرداخت هنوز باز نیست. صفحه فعالسازی تاریخ اولین صورتحساب و شرایط لغو را نشان خواهد داد.
راهنماهای مرتبط
Marketplace انتشار در انتظار
راهنمای انجمن منتشر نشده است
برای دریافت کمک، به ما بگویید از کدام افزونه و دستگاه استفاده می‌کنید، عملی که امتحان کردید و چه اتفاقی افتاد. از مثالی بدون داده‌های شخصی استفاده کنید. هرگز کلید یا فایل‌های خصوصی خود را به اشتراک نگذارید.