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-ის გამოყენებით → აჩვენეთ დაბრუნებული ველები თქვენს რედაქტირებად Expense ფორმაში.

ქმედება აბრუნებს `status`, `operation_id`, `fields_json` და `review_required`. თქვენი მომხმარებელი სწორებს/დადასტურებს ველებს, სანამ თქვენი სამუშაო ნაკადი ქმნის ხარჯს.

გაურკვეველი შედეგისას გამოიყენეთ Read Analysis იმავე `operation_id`-ით; ავტომატურად არ გაუშვათ სხვა ანალიზი. თანხმობის გაუქმება ასუფთავებს შენახულ გადაღებულ მონაცემებსა და ექსპორტს; არასოდეს შეინახოთ ნედლი base64 საჯარო Thing-ში ან ლოგებში.

დაგეგმილია. პირმა უნდა გადახედოს ყველა შემოთავაზებული მნიშვნელობა შენახვამდე.

წაიკითხეთ ზედნადების ნომერი პერსონალის მიერ შესამოწმებელი ფორმისთვის

საწყობის მომხმარებელს უნდა შეეძლოს შემოთავაზებული ნომრისა და თარიღის შემოწმება, ფოტოზე გადაღებული ქაღალდის დოკუმენტიდან მათი აკრეფის ნაცვლად.

`fields_json = ["delivery_reference","supplier","delivery_date"]`; ტესტირებისას გადაღეთ ზედნადების ნიმუშის შესაბამისი მხარე.

ცალკე გადაღების/დამუშავების თანხმობის შემდეგ, Analyze Captured Document სთავაზობს არჩეულ ველებს. აჩვენეთ ფოტო რედაქტირებად ველებთან გვერდით და მოითხოვეთ პერსონალს დადასტურება შესაბამისი მიწოდების ჩანაწერისთვის.

შეინახეთ დაბრუნებული `operation_id`, რათა თავიდან გადაამოწმოთ შედეგი, და `fields_json` როგორც შეთავაზება. თქვენი სამუშაო ნაკადი აკეთებს რეალურ მიწოდების ძებნას/განახლებას მხოლოდ პერსონალის გადახედვის შემდეგ.

აკლებული, გაურკვეველი ან არასწორი ველები საჭიროებს ხელით შესწორებას. პროვაიდერის შეცდომა დატოვებს ორიგინალურ მიწოდებას შეუცვლელად; Read Analysis გადაამოწმეთ შედეგი გაურკვეველი შედეგის მქონე ოპერაციის.

შემოთავაზეთ აღჭურვილობის სერიული ნომერი ლეიბლის ფოტოდან

ტექნიკური მომსახურების ფორმა შეიძლება შემოთავაზოთ გადახედვადი მოდელი/სერიული ნომერი, როდესაც აქტივის ლეიბლი აკრიფვისთვის რთულია.

`fields_json = ["manufacturer","model","serial_number"]`; გადაღეთ ნიმუშის აღჭურვილობის-ლეიბლის სურათი; აირჩიეთ თქვენი AI პროვაიდერი პროექტის პარამეტრებში.

დაგეგმილი Analyze Captured Document მოქმედება აბრუნებს შემოთავაზებულ სტრიქონებს. აჩვენეთ ისინი ფოტოს გვერდით; მომხმარებელს მიეცით მათი გასწორების საშუალება, სანამ თქვენს აპში Asset ჩანაწერს მოძებნით ან ტექნიკური მომსახურების სამუშაო ნაკადს გაუშვებთ.

გამოიყენეთ დაბრუნებული `fields_json`, `review_required` და `operation_id`. განიხილეთ იდენტიფიკატორები როგორც ტექსტი, რათა თქვენმა აპლიკაციამ საწყისი ნულები შეინარჩუნოს.

თუ სურათი არ იკითხება ან მოდელი არასწორ სტრიქონს გთავაზობთ, დაუშვით ხელით შეყვანა. გაურკვეველი პასუხის შემდეგ წაიკითხეთ იმავე ოპერაციის შედეგი, ნაცვლად იმისა, რომ კიდევ ერთი AI-ანალიზის საფასური გადაიხადოთ.

რას მუშაობს ახლა

პირადი ბეტა. ფოტოს გადაღება ხელმისაწვდომია ტესტირებისთვის. ფოტოდან ველების გამოღება დაგეგმილია და ჯერ არ არის მზად თქვენი აპლიკაციაში გამოყენებისთვის.

შექმენით სამუშაო ნაკადი

დაგეგმილი

გეგმული სამუშაო ნაკადი. ჯერ არ არის ხელმისაწვდომი მიმდინარე ბეტაში.

ამ მაგალითებში გამოიყენება აპის ჩანაწერები, როგორიცაა Lesson, Message და Order. შეცვალეთ ისინი თქვენი მონაცემის ტიპებით და ელემენტის სახელებით. მაგალითი მედია მისამართები უნდა შეცვალოთ თქვენი ფაილებისით.

დაგეგმილია: აირჩიეთ ველები, რომლებიც თქვენი ფორმა საჭიროებს, მაგალითად fields_json=["title","date","total"]. ჩართეთ enable_analysis_export და დააყენეთ analysis_context არჩეულ ანგარიშზე ან ჩანაწერზე. ეს ანალიზის პარამეტრები არ არის ხელმისაწვდომი მიმდინარე გადაღების ვერსიაში.
დაეხმარეთ მომხმარებელს ფოტოს გადაღებაში და ცალკე დაეთანხმოს დამუშავებას. analysis_requested-ზე გაუშვით Analyze Captured Document, იყენებთ ამ ელემენტის analysis_image_base64, analysis_mime_type, analysis_fields_json და analysis_consent-ს. გამოიყენეთ analysis_request_id როგორც idempotency_key.
შეინახეთ დაბრუნებული operation_id, request_id და status. თუ status არის processing, შედეგის მოგვიანებით მისაღებად გამოიყენეთ Read Analysis იმავე operation_id-ით.
აჩვენეთ დაბრუნებული fields_json რედაქტირებად მიმოხილვის ფორმაში. დამტკიცებული მნიშვნელობები შეინახეთ მხოლოდ მომხმარებლის შემოწმების შემდეგ და ღილაკზე „დადასტურება“ დაჭერის შემდეგ. დატოვეთ ორიგინალი ჩანაწერი მანამ, სანამ არ მოხდება ეს დადასტურება.

სამუშაო ნაკადის დიაგრამა — არა აპის ეკრანის სურათი

კონფიგურაცია ერთხელ

შექმენით ან აირჩიეთ თქვენი 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, status და 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

არჩეული ელემენტის მიმდინარე მნიშვნელობა. წაიკითხეთ იგი დაკავშირებული მოვლენის შემდეგ.

document_side · text

image_width · number

image_height · number

error_code · text

შეცდომის ინფორმაცია ბოლო ქმედებისთვის. აჩვენეთ სასარგებლო შეტყობინება და შემოთავაზეთ შესაბამისი ცდა.

is_capturing · yes/no

analysis_image_base64 · text

analysis_mime_type · text

analysis_fields_json · text

შემოთავაზებული მნიშვნელობები მოთხოვნილი ველებისთვის. აჩვენეთ ისინი მიმოხილვისთვის შენახვამდე.

analysis_request_id · text

იდენტიფიკატორი ამ ელემენტის ან ქმედებისათვის. შეინახეთ იგი შესაბამისი აპის ჩანაწერში. გამოიყენეთ იგივე მოთხოვნის იდენტიფიკატორი, როდესაც თავიდან ცდილობთ გაურკვეველი შედეგის.

analysis_consent · yes/no

analysis_export_status · text

analysis_export_error · text

analysis_image_bytes · number

მოვლენები

capture_started

როდესაც ეს მოვლენა მოხდება, წაიკითხეთ დაკავშირებული მდგომარეობები იგივე ელემენტიდან.

capture_succeeded

capture_cancelled

permission_denied

capture_error

analysis_requested

analysis_export_error

analysis_cleared

დეველოპერების კითხვები

აქვს თუ არა იგი იდენტობის ან დოკუმენტების გადამოწმება?

არა. იგი შესამოწმებლად ტექსტურ ველებს გთავაზობთ. გადაღებული დოკუმენტის სურათი არ ადასტურებს პიროვნების იდენტობას, დოკუმენტის ნამდვილობას ან სამედიცინო თუ ფინანსურ დასკვნას.

როგორ მუშაობს გამოწერა?

დაგეგმილი ფასები: პლაგინის დაყენება Bubble-ში უფასოა. BestPlugins წვდომა არის ცალკეული გამოწერა თითოეული პლაგინისთვის თითოეულ Bubble აპის პროექტში: 7 დღე უფასოა, შემდეგ US$1.50 ყოველთვიურად. Development და Live შედის. ოპერაციების რაოდენობაზე ფიქსირებული ლიმიტი არ არსებობს; ფაილის ზომის და ფუნქციების ლიმიტები მაინც მოქმედებს. გადახდა ჯერ არ არის ღია. აქტივაციის ეკრანი აჩვენებს პირველ ბილინგის თარიღს და გაუქმების პირობებს.

დაკავშირებული გზამკვლევები

audio-player video-player photo-editor audio-recorder offline-files qr-passes b2-files

Marketplace გამოშვება ელოდება

ფორუმის გზამკვლევი არ არის გამოქვეყნებული

დახმარებისთვის, გვაცნობეთ, რომელი პლაგინი და მოწყობილობა იყენებთ, რა მოქმედება სცადეთ და რა მოხდა. გამოიყენეთ მაგალითი პირად მონაცემებს გარეშე. არასოდეს გაუზიაროთ თქვენი გასაღები ან კერძო ფაილები.