Xodera Plugins · Bubble Native
Xodera Documents AI Native
Premeňte fotografiu účtenky alebo doručenia na návrh formulára. Nechajte AI navrhnúť dátum, sumu a ďalšie požadované polia, potom ich nechajte skontrolovať osobou pred uložením.
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.
Dokumentácia skontrolovaná 6 november 2026
Praktické príklady
Predvyplniť návrh výdavku z fotografie účtenky
Opakované zadávanie obchodníka, dátumu a sumy spomaľuje zadávanie výdavkov; extrahované polia môžu byť návrhom na kontrolu.
`fields_json = ["merchant","date","total","currency"]`; používateľ zachytí obrázok účtenky a samostatne súhlasí so spracovaním. Pri testovaní používajte iba vzorové účtenky.
Plánované: `analysis_requested` → Analyze Captured Document pomocou ohraničených exportovaných bajtov/MIME/názvov polí/súhlasu/ID požiadavky → zobrazte vrátené polia v upraviteľnom formulári Výdavku.
Akcia vráti `status`, `operation_id`, `fields_json` a `review_required`. Váš používateľ opraví/potvrdí polia predtým, než váš pracovný tok vytvorí Výdavok.
Pri neistom výsledku, Read Analysis s rovnakým `operation_id`; nevytvárajte ďalšiu analýzu automaticky. Odvolanie súhlasu vymaže zachytené/exportované údaje; nikdy neukladajte surový base64 v verejnom objekte alebo logoch.
Plánované. Osoba musí skontrolovať každú navrhovanú hodnotu pred uložením.
Prečítajte referenciu dodacieho listu pre formulár revízie zamestnanca
Používateľ skladu by mal mať možnosť skontrolovať navrhovanú referenciu/dátum namiesto ich zadávania z fotografovaného papierového výpisu.
`fields_json = ["delivery_reference","supplier","delivery_date"]`; zachyťte príslušnú stranu vzorového dodacieho listu počas testovania.
Po samostatnom súhlase so zachytením/spracovaním, Analyze Captured Document navrhuje vybrané polia. Zobrazte fotografiu vedľa upraviteľných polí a požiadajte zamestnanca o potvrdenie zodpovedajúceho záznamu Dodávky.
Uchovajte vrátený `operation_id` na opätovnú kontrolu výsledku a `fields_json` ako návrh. Váš pracovný tok vykoná skutočné vyhľadávanie/aktualizáciu Dodávky až po revízii zamestnanca.
Chýbajúce, nejednoznačné alebo nesprávne polia vyžadujú manuálnu opravu. Chyba poskytovateľa ponechá pôvodnú Dodávku nezmenenú; Read Analysis skontrolujte výsledok neistého operácie.
Plánované. Osoba musí skontrolovať každú navrhovanú hodnotu pred uložením.
Navrhnúť sériové číslo zariadenia z fotografie štítku
Formulár údržby môže ponúknuť kontrolovateľný návrh modelu/sériového čísla, keď je štítok majetku ťažko zadávať.
`fields_json = ["manufacturer","model","serial_number"]`; zachyťte vzorový obrázok štítku zariadenia; vyberte svojho AI poskytovateľa v nastaveniach projektu.
Plánovaná akcia Analyze Captured Document vráti navrhované reťazce. Zobrazte ich vedľa fotografie; nechajte používateľa ich opraviť pred vyhľadávaním majetku alebo pracovným tokom údržby.
Použite vrátené `fields_json`, `review_required` a `operation_id`. Považujte identifikátory za text, aby vaša aplikácia zachovala úvodné nuly.
Ak je obrázok nečitateľný alebo model navrhne nesprávny reťazec, umožnite manuálne zadanie. Prečítajte rovnakú operáciu po neistom odpovedi namiesto spustenia ďalšej inferencie.
Plánované. Osoba musí skontrolovať každú navrhovanú hodnotu pred uložením.
Čo funguje teraz
Súkromná beta. Zachytávanie fotografií je k dispozícii na testovanie. Extrakcia polí z fotografie je plánovaná a zatiaľ nie je pripravená na použitie vo vašej aplikácii.
Vytvorte pracovný postup
Plánované
Plánovaný pracovný postup. Nie je zatiaľ dostupný v aktuálnej beta verzii.
Tieto príklady používajú záznamy aplikácie, ako sú Lesson, Message a Order. Nahraďte ich vlastnými typmi údajov a názvami prvkov. Príkladové mediálne adresy musia byť nahradené vašimi vlastnými súbormi.
Plánované: vyberte polia, ktoré váš formulár potrebuje, napríklad fields_json=["title","date","total"]. Aktivujte enable_analysis_export a nastavte analysis_context na vybraný účet alebo záznam. Tieto nastavenia analýzy nie sú dostupné v aktuálnej verzii zachytávania.
Nechajte používateľa odfotiť a samostatne súhlasiť so spracovaním. Na analysis_requested spustite Analyze Captured Document pomocou analysis_image_base64, analysis_mime_type, analysis_fields_json a analysis_consent tohto prvku. Použite analysis_request_id ako idempotency_key.
Uložte vrátené operation_id, request_id a status. Ak má status hodnotu processing, použite Read Analysis s tým operation_id na neskoršie načítanie výsledku.
Zobrazte vrátené fields_json v editovateľnom revíznom formulári. Uložte schválené hodnoty až po tom, čo ich používateľ skontroluje a stlačí Potvrdiť. Ponechajte pôvodný záznam až do tejto potvrdenia.
Nastavte raz
Vytvorte alebo vyberte svoj Bubble projekt v BestPlugins → Dashboard → Plugins. Vyberte Xodera Documents AI Native, skopírujte jeho kľúč a potom otvorte Bubble → Plugins → Xodera Documents AI Native a vložte ho do project_api_key. Uložte raz; potom použite akcie nižšie. Každý plugin v každom projekte má svoj vlastný kľúč.
Požiadajte o povolenie kamery a vysvetlite, prečo je fotografia potrebná. Spracovanie vyžaduje samostatný súhlas používateľa. Vyberte svojho poskytovateľa AI v nastaveniach projektu; jeho používanie je fakturované týmto poskytovateľom.
Nastavte raz
- Vytvorte alebo vyberte svoj Bubble projekt na BestPlugins → Dashboard → Plugins.
- Vyberte tento plugin a skopírujte jeho projektový kľúč.
- Otvorte Bubble → Plugins → Xodera Documents AI Native; vložte kľúč do project_api_key a uložte.
- Pridajte element, vyberte svoje údaje aplikácie a zostavte pracovný postup nižšie.
- Privátny beta prístup len zatiaľ. Verejná inštalácia a platená aktivácia nie sú ešte otvorené.
Inštalácia a predplatné
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.
Uložte výsledok do svojej aplikácie
Príklad ExpenseDraft: vlastník, operation_id, request_id, stav a proposed_fields_json. Po kontrole uložte schválený dátum, sumu a ďalšie polia, plus reviewed_by a reviewed_at. Mapujte iba polia požadované vaším formulárom. Neprepisujte celý obsah obrázka do logov alebo bežných textových záznamov.
Zlyhanie, zrušenie a obnovenie
Ak je výsledok oneskorený, zachovajte rovnakú požiadavku a použite Read Analysis pre známy operation_id. Nevytvárajte novú fotografiu ani automaticky novú požiadavku. Ak používateľ odvolá súhlas, vymažte fotografiu a prestaňte ponúkať výsledok; nie je možné zrušiť kópiu, ktorá už bola odoslaná alebo uložená.
Možnosti a limity
Plánovaný vstup obrázku: PNG, JPEG alebo WebP, až do 5 MiB; požadujte 1–32 odlišné názvy polí. Vždy kontrolujte extrahované hodnoty. Toto nie je overovanie identity, kontrola pravosti dokumentu ani nástroj pre medicínske rozhodnutia. Poplatky poskytovateľa AI sú samostatné.
Nastavenia, akcie a výsledky
Použite tieto názvy v Bubble. Plánované funkcie sú označené samostatne.
Dostupné beta nastavenia
Nastavenia prvku
document_side · textbutton_label · textconsent_text · textdisabled · yes/nofields_json · textprocessing_consent_text · textanalyze_button_label · textcheck_button_label · textlanguage · textui_text_json · textStavy
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/noUdalosti
capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_errorAkcie a ich vstupy
Nastavenia prvku · 12
Plánovaný pracovný postup. Nie je zatiaľ dostupný v aktuálnej beta verzii.
document_sidetext · Predvolené: "front"- Ukážková hodnota
front - Príklad Bubble výraz
Capture Side Dropdown's value - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
button_labeltext · Predvolené: ""- Ukážková hodnota
"" - Príklad Bubble výraz
App Texts' capture_label - Viditeľný text aplikácie; prázdne použije vstavanú lokalizovanú verziu, ak je podporovaná. Žiadne poverenia.
consent_texttext · Predvolené: ""- Ukážková hodnota
I agree to capture this non-sensitive receipt. - Príklad Bubble výraz
App Texts' capture_consent - Vysvetlite konkrétny účel zachytenia/spracovania a príjemcu. Odvolanie súhlasu vymaže zachytené bajty, nie predchádzajúce kópie aplikácie.
disabledyes/no · Predvolené: false- Ukážková hodnota
no - Príklad Bubble výraz
GuideHost's is_busy (your yes/no custom state) - Zakážte prvok, keď je vaša aplikácia zaneprázdnená alebo je táto akcia nedostupná.
processing_consent_texttext · Predvolené: ""- Ukážková hodnota
I agree to send this image to the configured AI provider for draft fields. - Príklad Bubble výraz
App Texts' processing_consent - Vysvetlite konkrétny účel zachytenia/spracovania a príjemcu. Odvolanie súhlasu vymaže zachytené bajty, nie predchádzajúce kópie aplikácie.
analyze_button_labeltext · Predvolené: ""- Ukážková hodnota
"" - Príklad Bubble výraz
App Texts' analyze_label - Viditeľný text aplikácie; prázdne použije vstavanú lokalizovanú verziu, ak je podporovaná. Žiadne poverenia.
languagetext · Predvolené: "auto"- Ukážková hodnota
uk - Príklad Bubble výraz
Current User's preferred_language - Nastavte language=auto, aby sledoval podporované zariadenie alebo jazyk prehliadača. Zadajte podporovaný kód jazyka pre jeho explicitný výber.
ui_text_jsontext · Predvolené: ""- Ukážková hodnota
{} - Príklad Bubble výraz
App Settings' player_labels_json (supported keys only) - Voliteľný JSON s podporovanými popiskami tlačidiel. Ponechajte prázdne pre použitie vstavaného textu.
enable_analysis_exportyes/no · Predvolené: false- Ukážková hodnota
yes - Príklad Bubble výraz
App Settings' enable_reviewed_extraction - Plánované: povoliť akcii analýzy použiť fotografiu po oboch používateľských súhlasoch. Vypnuté v predvolenom nastavení.
analysis_contexttext · Predvolené: ""- Ukážková hodnota
<current-user-id> - Príklad Bubble výraz
Current User's unique id - Stála hodnota pre tento účet alebo záznam. Zmena vymaže predchádzajúcu fotografiu.
is_activeyes/no · Predvolené: true- Ukážková hodnota
yes - Príklad Bubble výraz
GuideHost's view_is_active (your yes/no custom state) - Nastavte áno, kým je tento pohľad otvorený. Nastavte nie pri odchode, aby sa prehrávanie alebo aktuálna práca mohla zastaviť.
fields_jsontext · Predvolené: "[\"title\",\"date\",\"total\"]"- Ukážková hodnota
["title","date","total"] - Príklad Bubble výraz
Expense Settings' extraction_fields_json - JSON pole požadovaných názvov extrakčných polí; výstup je navrhované údaje na ľudskú kontrolu.
Akcie a ich vstupy · 2
Plánovaný pracovný postup. Nie je zatiaľ dostupný v aktuálnej beta verzii.
Analyze Captured Document
image_base64text · Predvolené: —- Ukážková hodnota
<canonical bytes from consented export> - Príklad Bubble výraz
Document Capture's analysis_image_base64 - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
mime_typetext · Predvolené: —- Ukážková hodnota
image/jpeg - Príklad Bubble výraz
Document Capture's analysis_mime_type - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
fields_jsontext · Predvolené: —- Ukážková hodnota
["title","date","total"] - Príklad Bubble výraz
Document Capture's analysis_fields_json - JSON pole požadovaných názvov extrakčných polí; výstup je navrhované údaje na ľudskú kontrolu.
consentyes/no · Predvolené: —- Ukážková hodnota
yes — current processing consent - Príklad Bubble výraz
Document Capture's analysis_consent - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
idempotency_keytext · Predvolené: —- Ukážková hodnota
<unchanged analysis_request_id> - Príklad Bubble výraz
Document Capture's analysis_request_id - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
environmenttext · Predvolené: —- Ukážková hodnota
development - Príklad Bubble výraz
App Settings' selected_environment - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Návraty
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noRead Analysis
operation_idtext · Predvolené: —- Ukážková hodnota
<returned operation_id> - Príklad Bubble výraz
Current ExpenseDraft's operation_id - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
environmenttext · Predvolené: —- Ukážková hodnota
development - Príklad Bubble výraz
App Settings' selected_environment - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Návraty
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noStavy a udalosti
Plánovaný pracovný postup. Nie je zatiaľ dostupný v aktuálnej beta verzii.
Stavy
capture_status · textAktuálny výsledok tejto akcie. Použite zodpovedajúcu udalosť dokončenia pred uložením úspechu.
local_uri · textUmiestnenie súboru na tomto zariadení. Uložte alebo nahrajte súbor samostatne, ak musí zostať online.
mime_type · textAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
document_side · textAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
image_width · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
image_height · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
error_code · textInformácie o chybe poslednej akcie. Zobrazte užitočnú správu a ponúknite príslušný opätovný pokus.
is_capturing · yes/noAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
analysis_image_base64 · textAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
analysis_mime_type · textAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
analysis_fields_json · textNávrhové hodnoty pre požadované polia. Zobraziť ich na kontrolu pred uložením.
analysis_request_id · textIdentifikátor pre túto položku alebo akciu. Uchovajte ho s príslušným záznamom aplikácie. Použite rovnaký identifikátor požiadavky pri opakovaní neistého výsledku.
analysis_consent · yes/noAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
analysis_export_status · textAktuálny výsledok tejto akcie. Použite zodpovedajúcu udalosť dokončenia pred uložením úspechu.
analysis_export_error · textInformácie o chybe poslednej akcie. Zobrazte užitočnú správu a ponúknite príslušný opätovný pokus.
analysis_image_bytes · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
Udalosti
capture_startedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
capture_succeededKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
capture_cancelledKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
permission_deniedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
capture_errorKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
analysis_requestedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
analysis_export_errorKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
analysis_clearedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
Otázky, ktoré kladú vývojári
Overuje to identitu alebo dokumenty?
Nie. Navrhuje textové polia na kontrolu. Zachytený obrázok dokumentu nepreukazuje identitu, pravosť ani medicínsky/finančný záver.
Ako funguje predplatné?
Plánované ceny: inštalácia pluginu v Bubble je zadarmo. Prístup k BestPlugins je samostatné predplatné pre každý plugin v každom projekte aplikácie Bubble: 7 dní zadarmo, potom US$1.50 mesačne. Development a Live sú zahrnuté. Neexistuje pevný limit počtu operácií; obmedzenia veľkosti súborov a funkcií stále platia. Pokladňa ešte nie je otvorená. Aktivácia zobrazí dátum prvého fakturačného obdobia a podmienky zrušenia.
Súvisiace návody
Marketplace vydanie čaká
Sprievodca fóra nebol zverejnený
Pre pomoc nám povedzte, ktorý plugin a zariadenie používate, akú akciu ste skúšali a čo sa stalo. Použite príklad bez osobných údajov. Nikdy nezdieľajte svoj kľúč ani súkromné súbory.