Інтэрфейс захопу фота 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

Практычныя прыклады

Папоўніце чарнавік выдаткаў з фота чэка

Паўторнае ўводжанне назвы прадаўца, даты і сумы запавольвае ўвод выдаткаў; вынятыя палі могуць быць чарнавiком для праверкі.

`fields_json = ["merchant","date","total","currency"]`; карыстальнік захоплівае выяву чэка і асобна дае згоду на апрацоўку. Падчас тэставання выкарыстоўвайце толькі прыкладныя чэкі.

Плануецца: `analysis_requested` → Analyze Captured Document з выкарыстаннем абмежаваных экспартаванаў байтаў/MIME/назваў палёў/ідэнтыфікатара згоды/запыту → паказаць вернутыя палі ў вашай рэдагуемай форме Выдаткаў.

Дзеянне вяртае `status`, `operation_id`, `fields_json` і `review_required`. Ваш карыстальнік выпраўляе/зацвярджае палі, перш чым ваш працэс стварае Выдатак.

Пры няпэўным выніку Read Analysis з тым жа `operation_id`; не запускаць іншы аналіз аўтаматычна. Адмова ад згоды ачыстіць захаваныя захопы/экспарты; ніколі не захоўвайце сыры base64 у публічным аб'екце або журналах.

Плануецца. Кожнае прапанаванае значэнне павінна быць праверана чалавекам перад захаваннем.

Прачытайце спасылку на накладную для формы праверкі супрацоўнікамі

Карыстальнік складa павінен мець магчымасць праверыць прапанаваную спасылку/дату, а не ўводзіць яе з фота папяровай квітанцыі.

`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