Xodera Plugins · Bubble Native
Xodera Documents AI Native
Paverkite kvito arba pristatymo nuotrauką į juodraščio formą. Leiskite DI pasiūlyti datą, sumą ir kitus prašomus laukus, tada leiskite asmeniui juos peržiūrėti prieš išsaugant.
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.
Dokumentacija peržiūrėta 6 lapkričio 2026
Praktiniai pavyzdžiai
Iš anksto užpildyti išlaidų juodraštį iš kvito nuotraukos
Kartojamas pardavėjo, datos ir sumos įvedimas sulėtina išlaidų įrašymą; išgauti laukai gali būti peržiūrimas juodraštis.
`fields_json = ["merchant","date","total","currency"]`; naudotojas fiksuoja kvito vaizdą ir atskirai sutinka su apdorojimu. Testuojant naudokite tik pavyzdinius kvitus.
Planuojama: `analysis_requested` → Analyze Captured Document naudojant ribotus eksportuotus baitus/MIME/laukų pavadinimus/sutikimą/užklausos ID → rodyti grąžintus laukus redaguojamoje išlaidų formoje.
Veiksmas grąžina `status`, `operation_id`, `fields_json` ir `review_required`. Jūsų naudotojas taiso / patvirtina laukus prieš jūsų darbo eiga sukuria Išlaidų įrašą.
Esant neaiškiam rezultatui, Read Analysis su tuo pačiu `operation_id`; automatiškai neskirkite kitos analizės. Sutikimo atšaukimas išvalo išsaugotą fiksavimą/eksportą; niekada neišsaugokite neapdoroto base64 viešame objekte ar žurnaluose.
Planuojama. Asmuo turi peržiūrėti kiekvieną siūlomą reikšmę prieš išsaugant.
Perskaityti pristatymo lapo nuorodą personalo peržiūros formai
Sandėlio naudotojas turėtų galėti peržiūrėti siūlomą nuorodą/datą, o ne įvesti ją iš nuotraukos nuimto popierinio lapelio.
`fields_json = ["delivery_reference","supplier","delivery_date"]`; fiksuokite atitinkamą pavyzdinio pristatymo lapo pusę testuojant.
Po atskiro fiksavimo/apdorojimo sutikimo, Analyze Captured Document siūlo pasirinktus laukus. Rodykite nuotrauką šalia redaguojamų laukų ir paprašykite personalo patvirtinti atitinkamą pristatymo įrašą.
Išsaugokite grąžintą `operation_id`, kad vėl patikrintumėte rezultatą, ir `fields_json` kaip pasiūlymą. Jūsų darbo eiga atlieka faktinę pristatymo paiešką/atnaujinimą tik po personalo peržiūros.
Trūkstami, dviprasmiški arba neteisingi laukai reikalauja rankinio koregavimo. Tiekėjo klaida palieka originalų pristatymą nepakeistą; Read Analysis patikrinkite neaiškios operacijos rezultatą.
Planuojama. Asmuo turi peržiūrėti kiekvieną siūlomą reikšmę prieš išsaugant.
Siūlyti įrangos serijos numerį iš etiketės nuotraukos
Techninės priežiūros forma gali pasiūlyti peržiūrimą modelio/serijos pasiūlymą, kai turto etiketė sunkiai įvedama.
`fields_json = ["manufacturer","model","serial_number"]`; fiksuokite pavyzdinį įrangos etiketės vaizdą; projekto nustatymuose pasirinkite savo AI tiekėją.
Planuojamas Analyze Captured Document veiksmas grąžina siūlomus tekstus. Rodykite juos šalia nuotraukos; leiskite naudotojui juos pataisyti prieš jūsų turto paiešką ar priežiūros darbo eigą.
Naudokite grąžintus `fields_json`, `review_required` ir `operation_id`. Traktuokite identifikatorius kaip tekstą, kad jūsų programa išsaugotų priekinius nulius.
Jei vaizdas neperskaitomas arba modelis siūlo neteisingą tekstą, leiskite rankinį įvedimą. Perskaitykite tą pačią operaciją po neaiškaus atsakymo, o ne atlikite papildomą inferenciją.
Planuojama. Asmuo turi peržiūrėti kiekvieną siūlomą reikšmę prieš išsaugant.
Kas veikia dabar
Privati beta. Nuotraukų fiksavimas prieinamas testavimui. Laukų išskyrimas iš nuotraukos yra planuojamas ir dar nėra paruoštas naudojimui jūsų programoje.
Sukurkite darbo srautą
Planuojama
Planuojamas darbo srautas. Šiuo metu beta versijoje dar neprieinama.
Šie pavyzdžiai naudoja programos įrašus, tokius kaip Lesson, Message ir Order. Pakeiskite juos savo duomenų tipais ir elementų pavadinimais. Pavyzdiniai medijos adresai turi būti pakeisti jūsų failais.
Planuojama: pasirinkite laukus, kurių reikia jūsų forma, pavyzdžiui fields_json=["title","date","total"]. Įjunkite enable_analysis_export ir nustatykite analysis_context į pasirinktą paskyrą arba įrašą. Šie analizės nustatymai nėra prieinami dabartinėje fiksavimo versijoje.
Leiskite vartotojui padaryti nuotrauką ir atskirai sutikti su apdorojimu. analysis_requested metu vykdykite Analyze Captured Document, naudodami šio elemento analysis_image_base64, analysis_mime_type, analysis_fields_json ir analysis_consent. Naudokite analysis_request_id kaip idempotency_key.
Išsaugokite grąžintą operation_id, request_id ir būseną. Jei status=processing, naudokite Read Analysis kartu su operation_id, kad vėliau gautumėte rezultatą.
Rodykite grąžintą fields_json redaguojamoje peržiūros formoje. Išsaugokite patvirtintas reikšmes tik po to, kai vartotojas jas patikrina ir paspaudžia Patvirtinti. Laikykite originalų įrašą iki patvirtinimo.
Konfigūruokite vieną kartą
Sukurkite arba pasirinkite savo Bubble programos projektą BestPlugins → Dashboard → Plugins. Pasirinkite Xodera Documents AI Native, nukopijuokite jo raktą, tada atidarykite Bubble → Plugins → Xodera Documents AI Native ir įklijuokite jį į project_api_key. Išsaugokite vieną kartą; tada naudokite žemiau esančius veiksmus. Kiekvienas įskiepis kiekviename projekte turi savo raktą.
Paprašykite kameros leidimo ir paaiškinkite, kodėl reikia nuotraukos. Apdorojimui reikalingas atskiras vartotojo sutikimas. Pasirinkite savo DI tiekėją projekto nustatymuose; jo naudojimas apmokestinamas tiekėjo.
Konfigūruokite vieną kartą
- Sukurkite arba pasirinkite savo Bubble programos projektą BestPlugins → Dashboard → Plugins.
- Pasirinkite šį įskiepį ir nukopijuokite jo projekto raktą.
- Atidarykite Bubble → Plugins → Xodera Documents AI Native; įklijuokite raktą į project_api_key ir išsaugokite.
- Pridėkite elementą, pasirinkite savo programos duomenis ir sukurkite žemiau esantį darbo srautą.
- Privati beta prieiga tik dabar. Vieša įdiegimas ir mokama aktyvacija dar neprieinama.
Įdiegimas ir prenumerata
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.
Išsaugokite rezultatą savo programoje
Pavyzdys ExpenseDraft: savininkas, operation_id, request_id, būsena ir proposed_fields_json. Po peržiūros išsaugokite patvirtintą datą, sumą ir kitus laukus, taip pat reviewed_by ir reviewed_at. Susiekite tik laukus, kurių prašo jūsų forma. Nelaikykite viso vaizdo turinio žurnaluose ar įprastuose teksto įrašuose.
Gedimas, atšaukimas ir atkūrimas
Jei rezultatas vėluoja, išlaikykite tą patį užklausą ir naudokite Read Analysis žinomam operation_id. Neimkite naujos nuotraukos ir automatiškai nesukurkite naujos užklausos. Jei vartotojas atšaukia sutikimą, išvalykite nuotrauką ir nutraukite rezultatų siūlymą; tai negali atšaukti jau išsiųstos ar išsaugotos kopijos.
Galimybės ir apribojimai
Planuojamas vaizdo įvestis: PNG, JPEG arba WebP, iki 5 MiB; prašykite 1–32 atskirų laukų pavadinimų. Visada peržiūrėkite išgautas reikšmes. Tai nėra tapatybės patikrinimas, dokumento autentiškumo tikrinimas ar medicinos sprendimų priemonė. DI tiekėjo mokesčiai yra atskiri.
Nustatymai, veiksmai ir rezultatai
Naudokite šiuos pavadinimus Bubble. Planuojamos funkcijos pažymėtos atskirai.
Prieinami beta nustatymai
Elemento nustatymai
document_side · textbutton_label · textconsent_text · textdisabled · yes/nofields_json · textprocessing_consent_text · textanalyze_button_label · textcheck_button_label · textlanguage · textui_text_json · textBūsenos
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Įvykiai
capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_errorVeiksmai ir jų įvestys
Elemento nustatymai · 12
Planuojamas darbo srautas. Šiuo metu beta versijoje dar neprieinama.
document_sidetext · Numatytasis: "front"- Pavyzdinė reikšmė
front - Pavyzdinis Bubble išraiška
Capture Side Dropdown's value - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
button_labeltext · Numatytasis: ""- Pavyzdinė reikšmė
"" - Pavyzdinis Bubble išraiška
App Texts' capture_label - Matomas programos tekstas; jei tuščias, naudojama įdiegta lokalizuota kopija, kur palaikoma. Nėra kredencialų.
consent_texttext · Numatytasis: ""- Pavyzdinė reikšmė
I agree to capture this non-sensitive receipt. - Pavyzdinis Bubble išraiška
App Texts' capture_consent - Paaiškinkite konkretų fiksavimo/apdorojimo tikslą ir gavėją. Sutikimo atšaukimas išvalo išsaugotus baitus, bet ne ankstesnes programos kopijas.
disabledyes/no · Numatytasis: false- Pavyzdinė reikšmė
no - Pavyzdinis Bubble išraiška
GuideHost's is_busy (your yes/no custom state) - Išjunkite elementą, kai programa užimta arba šis veiksmas neprieinamas.
processing_consent_texttext · Numatytasis: ""- Pavyzdinė reikšmė
I agree to send this image to the configured AI provider for draft fields. - Pavyzdinis Bubble išraiška
App Texts' processing_consent - Paaiškinkite konkretų fiksavimo/apdorojimo tikslą ir gavėją. Sutikimo atšaukimas išvalo išsaugotus baitus, bet ne ankstesnes programos kopijas.
analyze_button_labeltext · Numatytasis: ""- Pavyzdinė reikšmė
"" - Pavyzdinis Bubble išraiška
App Texts' analyze_label - Matomas programos tekstas; jei tuščias, naudojama įdiegta lokalizuota kopija, kur palaikoma. Nėra kredencialų.
languagetext · Numatytasis: "auto"- Pavyzdinė reikšmė
uk - Pavyzdinis Bubble išraiška
Current User's preferred_language - Nustatykite language=auto sekti palaikomą įrenginį arba naršyklės kalbą. Įveskite palaikomą kalbos kodą, kad pasirinktumėte ją tiesiogiai.
ui_text_jsontext · Numatytasis: ""- Pavyzdinė reikšmė
{} - Pavyzdinis Bubble išraiška
App Settings' player_labels_json (supported keys only) - Pasirenkamas JSON su palaikomais mygtukų etiketėmis. Palikite tuščią, kad naudotumėte įdiegtą tekstą.
enable_analysis_exportyes/no · Numatytasis: false- Pavyzdinė reikšmė
yes - Pavyzdinis Bubble išraiška
App Settings' enable_reviewed_extraction - Planuojama: leisti analizės veiksmui naudoti nuotrauką po abiejų naudotojų sutikimų. Išjungta pagal numatymą.
analysis_contexttext · Numatytasis: ""- Pavyzdinė reikšmė
<current-user-id> - Pavyzdinis Bubble išraiška
Current User's unique id - Stabili vertė šiai paskyrai arba įrašui. Keisdami ją išvalote ankstesnę nuotrauką.
is_activeyes/no · Numatytasis: true- Pavyzdinė reikšmė
yes - Pavyzdinis Bubble išraiška
GuideHost's view_is_active (your yes/no custom state) - Nustatykite taip, kai šis vaizdas atvertas. Nustatykite ne, kai išeinate, kad atkūrimas arba dabartinis darbas galėtų sustoti.
fields_jsontext · Numatytasis: "[\"title\",\"date\",\"total\"]"- Pavyzdinė reikšmė
["title","date","total"] - Pavyzdinis Bubble išraiška
Expense Settings' extraction_fields_json - JSON – masyvas prašomų išskyrimo laukų pavadinimų; išvestis yra siūlomi duomenys žmogaus peržiūrai.
Veiksmai ir jų įvestys · 2
Planuojamas darbo srautas. Šiuo metu beta versijoje dar neprieinama.
Analyze Captured Document
image_base64text · Numatytasis: —- Pavyzdinė reikšmė
<canonical bytes from consented export> - Pavyzdinis Bubble išraiška
Document Capture's analysis_image_base64 - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
mime_typetext · Numatytasis: —- Pavyzdinė reikšmė
image/jpeg - Pavyzdinis Bubble išraiška
Document Capture's analysis_mime_type - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
fields_jsontext · Numatytasis: —- Pavyzdinė reikšmė
["title","date","total"] - Pavyzdinis Bubble išraiška
Document Capture's analysis_fields_json - JSON – masyvas prašomų išskyrimo laukų pavadinimų; išvestis yra siūlomi duomenys žmogaus peržiūrai.
consentyes/no · Numatytasis: —- Pavyzdinė reikšmė
yes — current processing consent - Pavyzdinis Bubble išraiška
Document Capture's analysis_consent - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
idempotency_keytext · Numatytasis: —- Pavyzdinė reikšmė
<unchanged analysis_request_id> - Pavyzdinis Bubble išraiška
Document Capture's analysis_request_id - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
environmenttext · Numatytasis: —- Pavyzdinė reikšmė
development - Pavyzdinis Bubble išraiška
App Settings' selected_environment - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Grąžinamos reikšmės
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noRead Analysis
operation_idtext · Numatytasis: —- Pavyzdinė reikšmė
<returned operation_id> - Pavyzdinis Bubble išraiška
Current ExpenseDraft's operation_id - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
environmenttext · Numatytasis: —- Pavyzdinė reikšmė
development - Pavyzdinis Bubble išraiška
App Settings' selected_environment - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Grąžinamos reikšmės
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noBūsenos ir įvykiai
Planuojamas darbo srautas. Šiuo metu beta versijoje dar neprieinama.
Būsenos
capture_status · textDabartinis šio veiksmo rezultatas. Naudokite atitinkamą užbaigimo įvykį prieš išsaugant sėkmę.
local_uri · textFailo vieta šiame įrenginyje. Išsaugokite arba įkelkite failą atskirai, jei jis turi būti laikomas internete.
mime_type · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
document_side · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
image_width · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
image_height · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
error_code · textPaskutinio veiksmo klaidos informacija. Rodykite naudingą pranešimą ir pasiūlykite atitinkamą pakartojimą.
is_capturing · yes/noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
analysis_image_base64 · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
analysis_mime_type · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
analysis_fields_json · textSiūlomos reikšmės prašomiems laukams. Rodyti jas peržiūrai prieš išsaugant.
analysis_request_id · textIdentifikatorius šiam elementui arba veiksmui. Laikykite jį kartu su atitinkamu programos įrašu. Naudokite tą patį užklausos identifikatorių, kai kartojate neaiškų rezultatą.
analysis_consent · yes/noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
analysis_export_status · textDabartinis šio veiksmo rezultatas. Naudokite atitinkamą užbaigimo įvykį prieš išsaugant sėkmę.
analysis_export_error · textPaskutinio veiksmo klaidos informacija. Rodykite naudingą pranešimą ir pasiūlykite atitinkamą pakartojimą.
analysis_image_bytes · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
Įvykiai
capture_startedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
capture_succeededKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
capture_cancelledKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
permission_deniedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
capture_errorKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
analysis_requestedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
analysis_export_errorKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
analysis_clearedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
Klausimai, kuriuos užduoda kūrėjai
Ar tai patikrina tapatybę arba dokumentus?
Ne. Tai siūlo tekstinius laukus peržiūrai. Užfiksuotas dokumento vaizdas nepatvirtina tapatybės, autentiškumo ar medicininio/finansinio sprendimo.
Kaip veikia prenumerata?
Planuojama kaina: įdiegti papildinį Bubble yra nemokama. BestPlugins prieiga yra atskira prenumerata kiekvienam papildiniui kiekviename Bubble programos projekte: 7 dienų nemokamai, po to US$1.50 per mėnesį. Development ir Live yra įtraukti. Nėra fiksuoto operacijų skaičiaus limito; vis tiek galioja failų dydžio ir funkcijų apribojimai. Apmokėjimas dar neatsidaro. Aktyvavimo ekrane bus rodomi pirmasis apmokėjimo data ir atšaukimo sąlygos.
Susijusios gairės
Marketplace laida laukia
Forumo vadovas nepublikuotas
Pagalbos prašym, nurodykite, kurį papildinį ir įrenginį naudojate, kokį veiksmą bandėte ir kas įvyko. Naudokite pavyzdį be asmeninių duomenų. Niekada nesidalinkite savo raktu ar privačiais failais.