Documents AI vmesnik za zajem fotografij. Načrtovano je izvlečenje polj.
Documents AI vmesnik za zajem fotografij. Načrtovano je izvlečenje polj.
← Vsi izvorni vodiči

Xodera Plugins · Bubble Native

Xodera Documents AI Native

Pretvorite fotografijo računa ali dostave v osnutek obrazca. Naj AI predlaga datum, skupni znesek in druga zahtevana polja, nato naj oseba pregleda podatke pred shranjevanjem.

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 pregledana 6 november 2026

Praktični primeri

Prednapolni osnutek stroška iz fotografije računa

Večkratno tipkanje trgovca, datuma in skupnega zneska upočasni vnos stroškov; izločena polja lahko predstavljajo osnutek za pregled.

`fields_json = ["merchant","date","total","currency"]`; uporabnik zajame sliko računa in ločeno soglaša s procesiranjem. Med testiranjem uporabljajte le vzorčne račune.

Načrtovano: `analysis_requested` → Analyze Captured Document z uporabo omejenih izvoženih bajtov/MIME/imen polj/soglasja/ID zahteve → prikažite vrnjena polja v vašem urejanem obrazcu Strošek.

Dejanje vrne `status`, `operation_id`, `fields_json` in `review_required`. Vaš uporabnik popravi/odobri polja, preden vaš delovni tok ustvari Strošek.

Ob nejasnem rezultatu, Read Analysis z istim `operation_id`; ne sprožite samodejno nove analize. Umik soglasja očisti shranjene zajeme/izvoze; nikoli ne shranjujte surovega base64 v javnem predmetu ali dnevnikih.

Načrtovano. Oseba mora pregledati vsako predlagano vrednost pred shranjevanjem.

Preberite referenco dobavnega lista za obrazec pregleda osebja

Uporabnik skladišča naj bi lahko pregledal predlagano referenco/datume namesto da jih vnaša iz fotografiranega papirnega lista.

`fields_json = ["delivery_reference","supplier","delivery_date"]`; zajemite ustrezno stran vzorčnega dobavnega lista med testiranjem.

Po ločenem soglasju za zajem/procesiranje Analyze Captured Document predlaga izbrana polja. Prikažite fotografijo poleg urejenih polj in prosite osebje, da potrdi ustrezni dobavni zapis.

Obdržite vrnjeni `operation_id` za ponovno preverjanje rezultata in `fields_json` kot predlog. Vaš delovni tok izvede dejansko iskanje/posodobitev dobave šele po pregledu osebja.

Manjkajoča, nejasna ali nepravilna polja zahtevajo ročno popravilo. Napaka ponudnika pusti izvirno dobavo nespremenjeno; Read Analysis preveri rezultat nejasne operacije.

Načrtovano. Oseba mora pregledati vsako predlagano vrednost pred shranjevanjem.

Predlagajte serijsko številko opreme iz fotografije etikete

Obrazec vzdrževanja lahko ponudi pregledno predlogo modela/serijske številke, ko je oznaka sredstva neprijetna za vnos.

`fields_json = ["manufacturer","model","serial_number"]`; zajemite vzorčno sliko etikete opreme; izberite svojega AI ponudnika v nastavitvah projekta.

Načrtovano dejanje Analyze Captured Document vrne predlagane nize. Prikažite jih poleg fotografije; uporabniku dovolite, da jih popravi pred vašim iskanjem sredstva ali delovnim tokom vzdrževanja.

Uporabite vrnjene `fields_json`, `review_required` in `operation_id`. Obravnavajte identifikatorje kot besedilo, da vaša aplikacija ohrani vodilne ničle.

Če je slika neberljiva ali model predlaga napačen niz, dovolite ročni vnos. Preberite isto operacijo po nejasnem odgovoru, namesto da zaračunate dodatno inferenco.

Načrtovano. Oseba mora pregledati vsako predlagano vrednost pred shranjevanjem.

Kaj deluje zdaj

Zasebna beta. Zajem fotografij je na voljo za testiranje. Izločanje polj iz fotografije je načrtovano in še ni pripravljeno za uporabo v vaši aplikaciji.

Ustvarite delovni tok

Načrtovano

Načrtovan potek dela. Še ni na voljo v trenutni beta različici.

Ti primeri uporabljajo zapise aplikacije, kot so Lesson, Message in Order. Zamenjajte jih s svojimi vrstami podatkov in imeni elementov. Primeri naslovov medijev je treba zamenjati s svojimi datotekami.

  1. Načrtovano: izberite polja, ki jih vaš obrazec potrebuje, na primer fields_json=["title","date","total"]. Omogočite enable_analysis_export in nastavite analysis_context na izbrani račun ali zapis. Te nastavitve analize niso na voljo v trenutni različici zajema.

  2. Dovolite uporabniku, da posname fotografijo in ločeno soglasi z obdelavo. Na analysis_requested zaženite Analyze Captured Document z uporabo analysis_image_base64, analysis_mime_type, analysis_fields_json in analysis_consent tega elementa. Uporabite analysis_request_id kot idempotency_key.

  3. Shrani vrnjeni operation_id, request_id in status. Če ima status vrednost processing, uporabite Read Analysis s tem operation_id za kasnejše pridobivanje rezultata.

  4. Prikažite vrnjeni fields_json v urejevalnem preglednem obrazcu. Shranite potrjene vrednosti šele, ko jih uporabnik pregleda in pritisne Potrdi. Ohranite izvirni zapis do potrditve.

Diagram delovnega toka — ne posnetek zaslona aplikacije

Nastavite enkrat

Ustvarite ali izberite svoj projekt aplikacije Bubble v BestPlugins → Dashboard → Plugins. Izberite Xodera Documents AI Native, kopirajte njegov ključ, nato odprite Bubble → Plugins → Xodera Documents AI Native in ga prilepite v project_api_key. Shranite enkrat; nato uporabite spodnje akcije. Vsak vtičnik v vsakem projektu ima svoj ključ.

Zahtevajte dovoljenje za kamero in pojasnite, zakaj je fotografija potrebna. Obdelava zahteva ločeno soglasje uporabnika. Izberite svojega AI ponudnika v nastavitvah projekta; njegova uporaba se zaračunava s strani tega ponudnika.

Nastavite enkrat
  1. Ustvarite ali izberite svoj projekt aplikacije Bubble pri BestPlugins → Dashboard → Plugins.
  2. Izberite ta vtičnik in kopirajte njegov ključ projekta.
  3. Odprite Bubble → Plugins → Xodera Documents AI Native; prilepite ključ v project_api_key in shranite.
  4. Dodajte element, izberite svoje podatke aplikacije in sestavite spodnji potek dela.
  5. Zasebni beta dostop je zaenkrat edini. Javno nameščanje in plačana aktivacija še nista na voljo.
Namestitev in naročnina

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.

Shrani rezultat v vašo aplikacijo

Primer ExpenseDraft: lastnik, operation_id, request_id, status in proposed_fields_json. Po pregledu shranite potrjeni datum, skupni znesek in druga polja, ter reviewed_by in reviewed_at. Preslikajte le polja, ki jih zahteva vaš obrazec. Ne vnašajte celotne vsebine slike v dnevnike ali običajne besedilne zapise.

Napaka, preklic in obnovitev

Če je rezultat zakasnjen, obdržite isto zahtevo in uporabite Read Analysis za znani operation_id. Ne zajemajte nove fotografije niti samodejno ustvarite nove zahteve. Če uporabnik prekliče soglasje, izbrišite fotografijo in prenehajte ponujati rezultat; s tem ni mogoče umakniti že poslane ali shranjene kopije.

Zmožnosti in omejitve

Načrtovan vnos slik: PNG, JPEG ali WebP, do 5 MiB; zahtevajte 1–32 različna imena polj. Vedno preglejte izločene vrednosti. To ni preverjanje identitete, preverjanje pristnosti dokumenta ali orodje za medicinske odločitve. Stroški AI ponudnika so ločeni.

Nastavitve, dejanja in rezultati

Uporabite ta imena v Bubble. Načrtovane funkcije so označene ločeno.

Razpoložljive beta nastavitve

Nastavitve elementa

document_side · textbutton_label · textconsent_text · textdisabled · yes/nofields_json · textprocessing_consent_text · textanalyze_button_label · textcheck_button_label · textlanguage · textui_text_json · text

Stanja

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

Dogodki

capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_error

Dejanja in njihovi vnosi

Nastavitve elementa · 12

Načrtovan potek dela. Še ni na voljo v trenutni beta različici.

document_sidetext · Privzeto: "front"
Primer vrednostifront
Primer Bubble izrazaCapture Side Dropdown's value
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
button_labeltext · Privzeto: ""
Primer vrednosti""
Primer Bubble izrazaApp Texts' capture_label
Vidno besedilo aplikacije; prazno uporablja vgrajeno lokalizirano kopijo, kjer je podprto. Brez poverilnic.
consent_texttext · Privzeto: ""
Primer vrednostiI agree to capture this non-sensitive receipt.
Primer Bubble izrazaApp Texts' capture_consent
Razložite namen specifičnega zajema/procesiranja in prejemnika. Umik soglasja očisti shranjene bajte, ne pa predhodne kopije aplikacije.
disabledyes/no · Privzeto: false
Primer vrednostino
Primer Bubble izrazaGuideHost's is_busy (your yes/no custom state)
Onemogoči element, ko je vaša aplikacija zasedena ali ko je to dejanje nedostopno.
processing_consent_texttext · Privzeto: ""
Primer vrednostiI agree to send this image to the configured AI provider for draft fields.
Primer Bubble izrazaApp Texts' processing_consent
Razložite namen specifičnega zajema/procesiranja in prejemnika. Umik soglasja očisti shranjene bajte, ne pa predhodne kopije aplikacije.
analyze_button_labeltext · Privzeto: ""
Primer vrednosti""
Primer Bubble izrazaApp Texts' analyze_label
Vidno besedilo aplikacije; prazno uporablja vgrajeno lokalizirano kopijo, kjer je podprto. Brez poverilnic.
languagetext · Privzeto: "auto"
Primer vrednostiuk
Primer Bubble izrazaCurrent User's preferred_language
Nastavite language=auto, da sledi podprti napravi ali jeziku brskalnika. Vnesite podprto kodo jezika, da ga izberete izrecno.
ui_text_jsontext · Privzeto: ""
Primer vrednosti{}
Primer Bubble izrazaApp Settings' player_labels_json (supported keys only)
Izbirni JSON s podprtimi oznakami gumbov. Pustite prazno za uporabo vgrajenega besedila.
enable_analysis_exportyes/no · Privzeto: false
Primer vrednostiyes
Primer Bubble izrazaApp Settings' enable_reviewed_extraction
Načrtovano: omogočiti dejanje analize, da uporabi fotografijo po obeh uporabniških soglasjih. Privzeto izklopljeno.
analysis_contexttext · Privzeto: ""
Primer vrednosti<current-user-id>
Primer Bubble izrazaCurrent User's unique id
Stabilna vrednost za ta račun ali zapis. Spreminjanje izbriše prejšnjo fotografijo.
is_activeyes/no · Privzeto: true
Primer vrednostiyes
Primer Bubble izrazaGuideHost's view_is_active (your yes/no custom state)
Nastavi da, ko je ta pogled odprt. Nastavi ne, ko zapuščate, da se predvajanje ali trenutno delo lahko ustavi.
fields_jsontext · Privzeto: "[\"title\",\"date\",\"total\"]"
Primer vrednosti["title","date","total"]
Primer Bubble izrazaExpense Settings' extraction_fields_json
JSON polje zahtevanih imen izločnih polj; izhod so predlagani podatki za človeški pregled.
Dejanja in njihovi vnosi · 2

Načrtovan potek dela. Še ni na voljo v trenutni beta različici.

Analyze Captured Document
image_base64text · Privzeto: —
Primer vrednosti<canonical bytes from consented export>
Primer Bubble izrazaDocument Capture's analysis_image_base64
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
mime_typetext · Privzeto: —
Primer vrednostiimage/jpeg
Primer Bubble izrazaDocument Capture's analysis_mime_type
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
fields_jsontext · Privzeto: —
Primer vrednosti["title","date","total"]
Primer Bubble izrazaDocument Capture's analysis_fields_json
JSON polje zahtevanih imen izločnih polj; izhod so predlagani podatki za človeški pregled.
consentyes/no · Privzeto: —
Primer vrednostiyes — current processing consent
Primer Bubble izrazaDocument Capture's analysis_consent
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
idempotency_keytext · Privzeto: —
Primer vrednosti<unchanged analysis_request_id>
Primer Bubble izrazaDocument Capture's analysis_request_id
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
environmenttext · Privzeto: —
Primer vrednostidevelopment
Primer Bubble izrazaApp Settings' selected_environment
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.

Vrnjeno

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no
Read Analysis
operation_idtext · Privzeto: —
Primer vrednosti<returned operation_id>
Primer Bubble izrazaCurrent ExpenseDraft's operation_id
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
environmenttext · Privzeto: —
Primer vrednostidevelopment
Primer Bubble izrazaApp Settings' selected_environment
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.

Vrnjeno

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no
Stanja in dogodki

Načrtovan potek dela. Še ni na voljo v trenutni beta različici.

Stanja

capture_status · text

Trenutni rezultat tega dejanja. Uporabite ustrezen dogodek dokončanja pred shranjevanjem uspeha.

local_uri · text

Lokacija datoteke na tej napravi. Shranite ali naložite datoteko ločeno, če jo je treba obdržati na spletu.

mime_type · text

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

document_side · text

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

image_width · number

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

image_height · number

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

error_code · text

Podatki o napaki za zadnje dejanje. Prikažite koristno sporočilo in ponudite ustrezen ponovni poskus.

is_capturing · yes/no

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

analysis_image_base64 · text

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

analysis_mime_type · text

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

analysis_fields_json · text

Predlagane vrednosti za zahtevana polja. Prikažite jih za pregled pred shranjevanjem.

analysis_request_id · text

Identifikator za ta element ali dejanje. Obdržite ga z ustreznim zapisom aplikacije. Uporabite isti identifikator zahteve pri ponovnem poskusu nejasnega rezultata.

analysis_consent · yes/no

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

analysis_export_status · text

Trenutni rezultat tega dejanja. Uporabite ustrezen dogodek dokončanja pred shranjevanjem uspeha.

analysis_export_error · text

Podatki o napaki za zadnje dejanje. Prikažite koristno sporočilo in ponudite ustrezen ponovni poskus.

analysis_image_bytes · number

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

Dogodki

capture_started

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

capture_succeeded

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

capture_cancelled

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

permission_denied

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

capture_error

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

analysis_requested

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

analysis_export_error

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

analysis_cleared

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

Vprašanja, ki jih postavljajo razvijalci

Ali preverja identiteto ali dokumente?

Ne. Predlaga besedilna polja za pregled. Zajeta slika dokumenta ne potrjuje identitete, pristnosti ali medicinskega/finančnega zaključka.

Kako deluje naročnina?

Načrtovana cena: namestitev vtičnika v Bubble je brezplačna. Dostop do BestPlugins je ločena naročnina za vsak vtičnik v vsakem Bubble projektu aplikacije: 7 dni brezplačno, nato US$1.50 na mesec. Development in Live sta vključena. Ni fiksne omejitve števila operacij; omejitve velikosti datotek in funkcij še vedno veljajo. Blagajna še ni odprta. Aktivacijski zaslon bo prikazal prvi datum obračuna in pogoje preklica.

Povezani vodniki

Marketplace izdaja v teku

Vodič foruma ni objavljen

Za pomoč nam povejte, kateri vtičnik in napravo uporabljate, kakšno dejanje ste poskusili in kaj se je zgodilo. Uporabite primer brez osebnih podatkov. Nikoli ne delite svojega ključa ali zasebnih datotek.