Documents AI фото түсіру интерфейсі. Өріс шығару жоспарланған.

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.

Жұмыс ағынын құрыңыз ↓Плагин параметрлері ↗Native Lab

Құжаттама қаралды 6 қараша 2026

Практикалық мысалдар

Түбіртек фотосуретінен шығын туралы жазбаның нобайын алдын ала толтыру

Саудагер, күн және жалпы соманы қайта-қайта теру шығын енгізуді баяулатады; алынған өрістерді шолуға болатын нобай ретінде пайдалануға болады.

`fields_json = ["merchant","date","total","currency"]`; пайдаланушы түбіртек суретін түсіріп, өңдеуге бөлек келісім береді. Тестілеу кезінде тек үлгі түбіртектерді пайдаланыңыз.

Жоспарланған: `analysis_requested` → Analyze Captured Document шектеулі экспортталған байттарды/MIME/өріс атауларын/келісім/сұрау ID пайдалана отырып → қайтарылған өрістерді түзетілетін Шығын формасында көрсетіңіз.

Әрекет `status`, `operation_id`, `fields_json` және `review_required` қайтарады. Пайдаланушы өрістерді түзетеді/бекітеді, содан кейін сіздің жұмыс ағыныңыз Шығынды жасайды.

Белгісіз нәтиже болғанда, Read Analysis сол `operation_id`-пен; автоматты түрде тағы бір талдауды шығармаңыз. Келісімнің қайтарылуы сақталған түсірілім/экспортты тазалайды; жалпыға қолжетімді Thing жазбасында немесе журналдарда шикі base64-ты ешқашан сақтамаңыз.

Жоспарланған. Әр ұсынылған мәнді сақтау алдында адам тексеруі керек.

Қызметкерлердің тексеру нысаны үшін жеткізу құжатының сілтемесін оқу

Қойма пайдаланушысы фотосуретке түсірілген қағаз құжаттан терудің орнына ұсынылған сілтеме/күнді шолуға мүмкіндік алуы керек.

`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 сияқты қолданба жазбаларын пайдаланады. Оларды өзіңіздің деректер түрлеріңіз бен элемент атауларыңызбен ауыстырыңыз. Мысал медиа мекенжайлары өз файлдарыңызбен ауыстырылуы керек.

Жоспарланған: форманың қажет ететін өрістерін таңдаңыз, мысалы fields_json=["title","date","total"]. enable_analysis_export іске қосып, analysis_context таңдалған тіркелгіге немесе жазбаға орнатыңыз. Бұл талдау параметрлері ағымдағы түсіру нұсқасында қолжетімді емес.
Пайдаланушыға фотосурет түсіруге және өңдеуге бөлек келісуге мүмкіндік беріңіз. analysis_requested кезінде, осы элементтің analysis_image_base64, analysis_mime_type, analysis_fields_json және analysis_consent пайдаланып Analyze Captured Document іске қосыңыз. analysis_request_id-ны idempotency_key ретінде пайдаланыңыз.
Қайтарылған operation_id, request_id және күйді сақтаңыз. Егер 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 ішіне қойыңыз. Бір рет сақтаңыз; содан кейін төмендегі әрекеттерді пайдаланыңыз. Әр жобадағы әр плагиннің өз кілті бар.

Камера рұқсатын сұраңыз және фотосурет не үшін қажет екенін түсіндіріңіз. Өңдеу үшін бөлек пайдаланушы келісімі қажет. Жоба параметрлерінде AI провайдеріңізді таңдаңыз; сол провайдер өз қызметін пайдалану үшін төлем шотын шығарады.

Бір рет баптаңыз

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 сақтаңыз. Тек нысан сұраған өрістерге мәндерді сәйкестендіріңіз. Толық сурет мазмұнын журналдарға немесе кәдімгі мәтін жазбаларына енгізбеңіз.

Қателік, болдырмау және қалпына келтіру

Нәтиже кешіктірілсе, бірдей сұранысты сақтап, белгілі operation_id үшін Read Analysis пайдаланыңыз. Жаңа фотосурет түсірмеңіз немесе жаңа сұранысты автоматты түрде жасамаңыз. Пайдаланушы келісімін қайтарса, фотосуретті өшіріп, нәтижені ұсынуды тоқтатыңыз; бұл жіберілген немесе сақталған көшірмені қайтаруға мүмкіндік бермейді.

Мүмкіндіктер және шектеулер

Жоспарланған сурет енгізу: 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); Бұл көрініс ашық кезде yes (иә) мәнін орнатыңыз. Шыққанда no (жоқ) мәнін орнатыңыз, сонда ойнатуды немесе ағымдағы жұмысты тоқтатуға болады.

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