Documents AI rozhraní pro zachycení fotografií. Extrakce polí je plánována.

Xodera Plugins · Bubble Native

Xodera Documents AI Native

Převést fotografii účtenky nebo dodávky na návrh formuláře. Nechte AI navrhnout datum, částku a další požadovaná pole a poté nechte osobu, aby je před uložením zkontrolovala.

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.

Vytvořte pracovní postup ↓Nastavení pluginu ↗Native Lab

Dokumentace přezkoumána 6 listopad 2026

Praktické příklady

Předvyplnit návrh výdaje z fotografie účtenky

Opakované zadávání obchodníka, data a částky zpomaluje zadávání výdajů; extrahovaná pole mohou být přezkoumatelný návrh.

`fields_json = ["merchant","date","total","currency"]`; uživatel zachytí obrázek účtenky a samostatně souhlasí se zpracováním. Používejte pouze vzorové účtenky během testování.

Plánováno: `analysis_requested` → Analyze Captured Document pomocí omezených exportovaných bajtů/MIME/názvů polí/souhlasu/ID požadavku → zobrazte vrácená pole ve vašem editovatelném formuláři Výdaje.

Akce vrací `status`, `operation_id`, `fields_json` a `review_required`. Váš uživatel opraví/potvrdí pole před tím, než váš pracovní postup vytvoří Výdaj.

Při nejistém výsledku Read Analysis se stejným `operation_id`; neprovádějte automaticky další analýzu. Odvolání souhlasu vymaže uložené zachycení/export; nikdy neukládejte surový base64 v veřejném objektu nebo protokolech.

Plánováno. Osoba musí před uložením zkontrolovat každou navrženou hodnotu.

Přečtěte referenci dodacího listu pro formulář revize zaměstnance.

Uživatel skladu by měl mít možnost zkontrolovat navrženou referenci/datum místo ručního zadávání z vyfotografovaného papírového lístku.

`fields_json = ["delivery_reference","supplier","delivery_date"]`; zachyťte relevantní stranu vzorového dodacího listu během testování.

Po samostatném souhlasu se zachycením/zpracováním Analyze Captured Document navrhne vybraná pole. Zobrazte fotografii vedle editovatelných polí a požádejte zaměstnance o potvrzení odpovídajícího záznamu Dodávky.

Uchovejte vrácené `operation_id` pro opětovnou kontrolu výsledku a `fields_json` jako návrh. Váš pracovní postup provede skutečné vyhledání/aktualizaci Dodávky až po revizi zaměstnance.

Chybějící, nejednoznačná nebo nesprávná pole vyžadují ruční opravu. Chyba poskytovatele ponechává původní Dodávku beze změny; Read Analysis zkontrolujte výsledek nejisté operace.

Plánováno. Osoba musí před uložením zkontrolovat každou navrženou hodnotu.

Navrhněte sériové číslo zařízení z fotografie štítku.

Formulář údržby může nabídnout přezkoumatelný návrh modelu/sériového čísla, když je štítek majetku obtížně zadatelný.

`fields_json = ["manufacturer","model","serial_number"]`; zachyťte vzorový obrázek štítku zařízení; vyberte svého poskytovatele AI v nastavení projektu.

Plánovaná akce Analyze Captured Document vrací navržené řetězce. Zobrazte je vedle fotografie; nechte uživatele je opravit před vyhledáním majetku nebo údržbovým pracovním postupem.

Použijte vrácené `fields_json`, `review_required` a `operation_id`. Považujte identifikátory za text, aby vaše aplikace zachovala úvodní nuly.

Pokud je obrázek nečitelné nebo model navrhne nesprávný řetězec, povolte ruční zadání. Přečtěte stejnou operaci po nejisté odpovědi místo účtování dalšího odhadu.

Plánováno. Osoba musí před uložením zkontrolovat každou navrženou hodnotu.

Co funguje nyní

Soukromá beta. Zachycení fotografie je k dispozici pro testování. Extrakce polí z fotografie je plánována a zatím není připravena k použití ve vaší aplikaci.

Vytvořte pracovní postup

Plánováno

Plánovaný pracovní postup. V současné beta verzi ještě není k dispozici.

Tyto příklady používají záznamy aplikace, jako jsou Lesson, Message a Order. Nahraďte je vlastními typy dat a názvy prvků. Příkladové adresy médií je třeba nahradit vlastními soubory.

Plánováno: vyberte pole, která váš formulář potřebuje, například fields_json=["title","date","total"]. Aktivujte enable_analysis_export a nastavte analysis_context na vybraný účet nebo záznam. Tato nastavení analýzy nejsou v aktuální verzi zachycení k dispozici.
Nechte uživatele pořídit fotografii a samostatně souhlasit se zpracováním. Na analysis_requested spusťte Analyze Captured Document pomocí analysis_image_base64, analysis_mime_type, analysis_fields_json a analysis_consent tohoto prvku. Použijte analysis_request_id jako idempotency_key.
Uložte vrácené operation_id, request_id a status. Pokud má status hodnotu processing, použijte Read Analysis s tím operation_id k pozdějšímu načtení výsledku.
Zobrazte vrácené fields_json v editovatelném revizním formuláři. Uložte schválené hodnoty až po kontrole uživatelem a stisknutí Potvrdit. Ponechte původní záznam až do této potvrzení.

Diagram pracovního postupu — ne snímek obrazovky aplikace

Nastavte jednou

Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins. Vyberte Xodera Documents AI Native, zkopírujte jeho klíč, poté otevřete Bubble → Plugins → Xodera Documents AI Native a vložte jej do project_api_key. Uložte jednou; poté použijte akce níže. Každý plugin v každém projektu má svůj vlastní klíč.

Požádejte o oprávnění k fotoaparátu a vysvětlete, proč je fotografie potřebná. Zpracování vyžaduje samostatný souhlas uživatele. Vyberte poskytovatele AI v nastavení projektu; jeho využití fakturuje daný poskytovatel.

Nastavte jednou

Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins.
Vyberte tento plugin a zkopírujte jeho projektový klíč.
Otevřete Bubble → Plugins → Xodera Documents AI Native; vložte klíč do project_api_key a uložte.
Přidejte prvek, vyberte svá data aplikace a vytvořte níže uvedený pracovní postup.
Soukromý beta přístup pouze zatím. Veřejná instalace a placená aktivace ještě nejsou otevřeny.

Instalace a předplatné

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ýsledek ve své aplikaci

Příklad ExpenseDraft: owner, operation_id, request_id, status a proposed_fields_json. Po revizi uložte schválené datum, částku a další pole, plus reviewed_by a reviewed_at. Mapujte pouze pole, která váš formulář požaduje. Nepřidávejte celý obsah obrázku do logů ani běžných textových záznamů.

Selhání, zrušení a obnovení

Pokud je výsledek zpožděn, zachovejte stejný požadavek a použijte Read Analysis pro známý operation_id. Nevytvářejte automaticky novou fotografii ani nový požadavek. Pokud uživatel odvolá souhlas, vymažte fotografii a přestaňte výsledek nabízet; nelze odvolat již odeslanou nebo uloženou kopii.

Možnosti a limity

Plánovaný vstup obrázku: PNG, JPEG nebo WebP, až do 5 MiB; požadujte odlišné názvy polí 1–32. Vždy kontrolujte extrahované hodnoty. Nejedná se o ověření identity, kontrolu pravosti dokumentu ani o nástroj pro lékařské rozhodování. Poplatky poskytovatele AI jsou samostatné.

Nastavení, akce a výsledky

Použijte tyto názvy v Bubble. Plánované funkce jsou označeny zvlášť.

Dostupná beta nastavení

Nastavení prvku

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

Stavy

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

Události

capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_error

Akce a jejich vstupy

Nastavení prvku · 12

Plánovaný pracovní postup. V současné beta verzi ještě není k dispozici.

document_sidetext · Výchozí: "front": Ukázková hodnotafront; Příklad Bubble výrazuCapture Side Dropdown's value; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

button_labeltext · Výchozí: "": Ukázková hodnota""; Příklad Bubble výrazuApp Texts' capture_label; Viditelný text aplikace; prázdné použije vestavěnou lokalizovanou verzi, kde je podporována. Žádné přihlašovací údaje.

consent_texttext · Výchozí: "": Ukázková hodnotaI agree to capture this non-sensitive receipt.; Příklad Bubble výrazuApp Texts' capture_consent; Vysvětlete konkrétní účel zachycení/zpracování a příjemce. Odvolání souhlasu vymaže uložené bajty, nikoli předchozí kopie aplikace.

disabledyes/no · Výchozí: false: Ukázková hodnotano; Příklad Bubble výrazuGuideHost's is_busy (your yes/no custom state); Deaktivujte prvek, když je aplikace zaneprázdněná nebo je tato akce nedostupná.

processing_consent_texttext · Výchozí: "": Ukázková hodnotaI agree to send this image to the configured AI provider for draft fields.; Příklad Bubble výrazuApp Texts' processing_consent; Vysvětlete konkrétní účel zachycení/zpracování a příjemce. Odvolání souhlasu vymaže uložené bajty, nikoli předchozí kopie aplikace.

analyze_button_labeltext · Výchozí: "": Ukázková hodnota""; Příklad Bubble výrazuApp Texts' analyze_label; Viditelný text aplikace; prázdné použije vestavěnou lokalizovanou verzi, kde je podporována. Žádné přihlašovací údaje.

languagetext · Výchozí: "auto": Ukázková hodnotauk; Příklad Bubble výrazuCurrent User's preferred_language; Nastavte language=auto tak, aby sledoval podporované zařízení nebo jazyk prohlížeče. Zadejte podporovaný kód jazyka pro jeho explicitní výběr.

ui_text_jsontext · Výchozí: "": Ukázková hodnota{}; Příklad Bubble výrazuApp Settings' player_labels_json (supported keys only); Volitelný JSON s podporovanými popisky tlačítek. Nechte prázdné pro použití vestavěného textu.

enable_analysis_exportyes/no · Výchozí: false: Ukázková hodnotayes; Příklad Bubble výrazuApp Settings' enable_reviewed_extraction; Plánováno: umožnit akci analýzy použít fotografii po obou uživatelských souhlasech. Ve výchozím nastavení vypnuto.

analysis_contexttext · Výchozí: "": Ukázková hodnota<current-user-id>; Příklad Bubble výrazuCurrent User's unique id; Stabilní hodnota pro tento účet nebo záznam. Změna vymaže předchozí fotografii.

is_activeyes/no · Výchozí: true: Ukázková hodnotayes; Příklad Bubble výrazuGuideHost's view_is_active (your yes/no custom state); Nastavte ano, dokud je tento pohled otevřený. Nastavte ne při odchodu, aby se přehrávání nebo aktuální práce mohly zastavit.

fields_jsontext · Výchozí: "[\"title\",\"date\",\"total\"]": Ukázková hodnota["title","date","total"]; Příklad Bubble výrazuExpense Settings' extraction_fields_json; JSON pole požadovaných názvů extrahovaných polí; výstup jsou navrhovaná data ke kontrole člověkem.

Akce a jejich vstupy · 2

Plánovaný pracovní postup. V současné beta verzi ještě není k dispozici.

Analyze Captured Document

image_base64text · Výchozí: —: Ukázková hodnota<canonical bytes from consented export>; Příklad Bubble výrazuDocument Capture's analysis_image_base64; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

mime_typetext · Výchozí: —: Ukázková hodnotaimage/jpeg; Příklad Bubble výrazuDocument Capture's analysis_mime_type; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

fields_jsontext · Výchozí: —: Ukázková hodnota["title","date","total"]; Příklad Bubble výrazuDocument Capture's analysis_fields_json; JSON pole požadovaných názvů extrahovaných polí; výstup jsou navrhovaná data ke kontrole člověkem.

consentyes/no · Výchozí: —: Ukázková hodnotayes — current processing consent; Příklad Bubble výrazuDocument Capture's analysis_consent; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

idempotency_keytext · Výchozí: —: Ukázková hodnota<unchanged analysis_request_id>; Příklad Bubble výrazuDocument Capture's analysis_request_id; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

environmenttext · Výchozí: —: Ukázková hodnotadevelopment; Příklad Bubble výrazuApp Settings' selected_environment; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

Vrácení

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no

Read Analysis

operation_idtext · Výchozí: —: Ukázková hodnota<returned operation_id>; Příklad Bubble výrazuCurrent ExpenseDraft's operation_id; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

environmenttext · Výchozí: —: Ukázková hodnotadevelopment; Příklad Bubble výrazuApp Settings' selected_environment; Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.

Vrácení

ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no

Stavy a události

Plánovaný pracovní postup. V současné beta verzi ještě není k dispozici.

Stavy

capture_status · text

Aktuální výsledek této akce. Použijte odpovídající událost dokončení před uložením úspěchu.

local_uri · text

Umístění souboru na tomto zařízení. Uložte nebo nahrajte soubor samostatně, pokud má být uchován online.

mime_type · text