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"]`; заснемете примерно изображение на етикет на оборудване; изберете вашия AI доставчик в настройките на проекта.

Планираното действие 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 в редактираща форма за преглед. Запазете одобрените стойности само след като потребителят ги провери и натисне Потвърждаване. Запазете оригиналния запис до тази потвърждаваща стъпка.

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

Конфигурирайте еднократно

Създайте или изберете вашия 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