Documents AI интерфејс за фотографирање. Планирано е извлекување на полиња.
Documents AI интерфејс за фотографирање. Планирано е извлекување на полиња.
← Сите водичи за Bubble Native

Xodera Plugins · Bubble Native

Xodera Documents AI Native

Претворете потврда или фотографија од испорака во нацрт форма. Дозволете AI да предложи датум, вкупно и други побарани полиња, потоа некој да ги прегледа пред зачувување.

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/имиња на полиња/согласност/ID на барањето → прикажете ги вратените полиња во вашиот уредлив формулар Expense.

Акцијата ги враќа `status`, `operation_id`, `fields_json` и `review_required`. Корисникот ги поправа/одобрува полињата пред вашиот работен процес да создаде Expense.

При неизвесен резултат, користете Read Analysis со истиот `operation_id`; не започнувајте друга анализа автоматски. Повлекувањето на согласноста ги чисти задржаните снимени/извезени податоци; никогаш не зачувувајте суров base64 во јавен Thing или во дневници.

Планирано. Лице мора да ги прегледа сите предложени вредности пред зачувување.

Прочитајте референца за доставна белешка за формулар за преглед од персонал.

Корисникот во складиште треба да може да прегледа предложена референца/датум наместо да ја внесува од фотографиран хартиен лист.

`fields_json = ["delivery_reference","supplier","delivery_date"]`; снимете ја соодветната страна од примерна доставна белешка за време на тестирање.

По одделната согласност за снимање/обработка, Analyze Captured Document ги предлага избраните полиња. Прикажете ја фотографијата покрај уредливите полиња и побарајте од персоналот да го потврди соодветниот запис Delivery.

Задржете го вратениот `operation_id` за повторно да го проверите резултатот, а `fields_json` како предлог. Вашиот работен процес го прави вистинското пребарување/ажурирање на Delivery само по преглед од персоналот.

Полињата што недостасуваат, се двосмислени или се неточни бараат рачна корекција. Грешка кај провајдерот го остава оригиналниот Delivery непроменет; со Read Analysis проверете го резултатот од операцијата со неизвесен исход.

Планирано. Лице мора да ги прегледа сите предложени вредности пред зачувување.

Предложете серијски број на опрема од фотографија на етикета

Формулар за одржување може да понуди прегледлив предлог за модел/сериски број кога етикетата на имотот е тешка за внесување.

`fields_json = ["manufacturer","model","serial_number"]`; снимете примерна слика на етикета на опрема; изберете го вашиот AI добавувач во поставките на проектот.

Планираната акција Analyze Captured Document враќа предложени текстуални низи. Прикажете ги покрај фотографијата; дозволете му на корисникот да ги поправи пред пребарувањето на Asset или процесот за одржување во вашата апликација.

Користете ги вратените `fields_json`, `review_required` и `operation_id`. Третирајте ги идентификаторите како текст за вашата апликација да ги зачува почетните нули.

Ако сликата е нечитлива или моделот предложи погрешна низа, дозволете рачен внес. Прочитајте ја истата операција после неодреден одговор наместо да се наплаќа нова инференца.

Планирано. Лице мора да ги прегледа сите предложени вредности пред зачувување.

Што работи сега

Приватна бета. Снимањето на фотографија е достапно за тестирање. Извлекувањето на полиња од фотографијата е планирано и сè уште не е спремно за употреба во вашата апликација.

Создајте го работниот процес

Планирано

Планиран работен тек. Сè уште не е достапен во тековната бета верзија.

Овие примери користат записи на апликации како Lesson, Message и Order. Заменете ги со вашите типови податоци и имиња на елементи. Примерните медиумски адреси мора да се заменат со вашите датотеки.

  1. Планирано: изберете полињата што вашата форма ги бара, на пример fields_json=["title","date","total"]. Овозможете enable_analysis_export и поставете analysis_context на избраниот сметка или запис. Овие поставки за анализа не се достапни во тековната верзија на снимање.

  2. Дозволете корисникот да направи фотографија и да се согласи посебно за обработка. На analysis_requested, извршете Analyze Captured Document користејќи ги analysis_image_base64, analysis_mime_type, analysis_fields_json и analysis_consent на овој елемент. Користете analysis_request_id како idempotency_key.

  3. Зачувајте ги вратените operation_id, request_id и status. Ако status има вредност processing, користете Read Analysis со тој operation_id за да го добиете резултатот подоцна.

  4. Прикажете го вратениот fields_json во уредлива форма за преглед. Зачувајте одобрените вредности само откако корисникот ги провери и притисне Потврди. Чувајте го оригиналниот запис до таа потврда.

Дијаграма на работен тек — не е снимка од апликацијата

Конфигурирајте еднаш

Создајте или изберете го вашиот Bubble апликациски проект во BestPlugins → Dashboard → Plugins. Изберете Xodera Documents AI Native, копирајте го неговиот клуч, потоа отворете Bubble → Plugins → Xodera Documents AI Native и вметнете го во project_api_key. Снимете еднаш; потоа користете ги акциите подолу. Секој додаток во секој проект има свој клуч.

Побарајте дозвола за камера и објаснете зошто е потребна фотографијата. За обработката е потребна посебна согласност од корисникот. Изберете го вашиот AI-провајдер во поставките на проектот; тој провајдер го наплаќа користењето.

Конфигурирајте еднаш
  1. Создајте или изберете го вашиот Bubble апликациски проект на BestPlugins → Dashboard → Plugins.
  2. Изберете го овој додаток и копирајте го неговиот клуч за проект.
  3. Отворете Bubble → Plugins → Xodera Documents AI Native; вметнете го клучот во project_api_key и снимете.
  4. Додадете го елементот, изберете ги вашите податоци за апликацијата и изградете го работниот тек подолу.
  5. Приватен бета пристап само засега. Јавната инсталација и платената активација сè уште не се отворени.
Инсталација и претплата

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: owner, operation_id, request_id, status и proposed_fields_json. По прегледот, зачувајте ги одобрениот датум, вкупниот износ и другите полиња, како и reviewed_by и reviewed_at. Поврзете ги само полињата што ги побарал вашиот формулар. Не ставајте ја целосната содржина на сликата во дневници или обични текстуални записи.

Неуспех, откажување и опоравок

Ако резултатот доцни, задржете го истото барање и користете Read Analysis за познатиот operation_id. Не правете нова фотографија и не создавајте ново барање автоматски. Ако корисникот ја повлече согласноста, исчистете ја фотографијата и престанете да го нудите резултатот; тоа не може да повлече копија што веќе е испратена или зачувана.

Можности и ограничувања

Планиран внес на слика: PNG, JPEG или WebP, до 5 MiB; побарајте 1–32 различни имиња на полиња. Секогаш прегледувајте извлечените вредности. Ова не е верификација на идентитет, проверка на автентичност на документ или медицински одлучувачки алат. Трошоците на AI провајдерот се одделни.

Подесувања, акции и резултати

Користете ги овие имиња во 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

Тековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.

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 издание во исчекување

Водичот за форум не е објавен

За помош, кажете ни кој приклучок и уред користите, која акција ја испробавте и што се случи. Користете пример без лични податоци. Никогаш не споделувајте го вашиот клуч или приватни датотеки.