Giao diện chụp ảnh Documents AI. Việc trích xuất trường đang được lên kế hoạch.

Xodera Plugins · Bubble Native

Xodera Documents AI Native

Chuyển ảnh biên lai hoặc giao hàng thành mẫu nháp. Cho AI đề xuất ngày, tổng và các trường yêu cầu khác, sau đó để người kiểm tra chúng trước khi lưu.

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.

Xây dựng quy trình làm việc ↓Cài đặt plugin ↗Native Lab

Tài liệu được rà soát ngày 6 tháng mười một năm 2026

Ví dụ thực tế

Điền sẵn bản dự thảo chi phí từ ảnh biên lai

Nhập lại nhiều lần merchant, date và total làm chậm việc nhập chi phí; các trường đã trích xuất có thể là bản dự thảo có thể xem lại.

`fields_json = ["merchant","date","total","currency"]`; người dùng chụp ảnh biên lai và đồng ý riêng cho việc xử lý. Chỉ sử dụng biên lai mẫu khi thử nghiệm.

Dự kiến: `analysis_requested` → Analyze Captured Document sử dụng các byte được xuất trong giới hạn cho phép/MIME/tên trường/đồng ý/mã yêu cầu → hiển thị các trường trả về trong biểu mẫu Chi phí có thể chỉnh sửa của bạn.

Hành động trả về `status`, `operation_id`, `fields_json` và `review_required`. Người dùng của bạn chỉnh sửa/đồng ý các trường trước khi quy trình của bạn tạo một Chi phí.

Khi kết quả không chắc chắn, Read Analysis với cùng `operation_id`; không tự động thực hiện phân tích khác. Rút lại đồng ý sẽ xóa dữ liệu chụp/xuất đã lưu; không bao giờ lưu trữ raw base64 trong Thing công cộng hoặc log.

Dự kiến. Người dùng phải xem lại mọi giá trị đề xuất trước khi lưu.

Đọc tham chiếu phiếu giao hàng cho biểu mẫu để nhân viên kiểm tra

Người dùng kho nên có thể xem lại tham chiếu/ngày đề xuất thay vì nhập từ giấy tờ chụp ảnh.

`fields_json = ["delivery_reference","supplier","delivery_date"]`; chụp mặt liên quan của mẫu phiếu giao hàng khi thử nghiệm.

Sau khi có đồng ý riêng cho việc chụp/xử lý, Analyze Captured Document đề xuất các trường đã chọn. Hiển thị ảnh chụp bên cạnh các trường có thể chỉnh sửa và yêu cầu nhân viên xác nhận bản ghi Giao hàng phù hợp.

Giữ `operation_id` trả về để kiểm tra lại kết quả và `fields_json` như một đề xuất. Quy trình của bạn thực hiện việc tra cứu/cập nhật Giao hàng thực tế chỉ sau khi nhân viên xem xét.

Các trường thiếu, mơ hồ hoặc sai cần được chỉnh sửa thủ công. Lỗi nhà cung cấp để nguyên Giao hàng gốc không thay đổi; Read Analysis kiểm tra kết quả của một thao tác không chắc chắn.

Dự kiến. Người dùng phải xem lại mọi giá trị đề xuất trước khi lưu.

Đề xuất số sê-ri thiết bị từ ảnh nhãn

Mẫu bảo trì có thể cung cấp đề xuất mẫu/sê-ri có thể xem lại khi nhãn tài sản khó nhập.

`fields_json = ["manufacturer","model","serial_number"]`; chụp ảnh mẫu nhãn thiết bị; chọn nhà cung cấp AI trong cài đặt dự án.

Hành động Analyze Captured Document dự kiến trả về các chuỗi đề xuất. Hiển thị chúng bên cạnh ảnh; cho phép người dùng chỉnh sửa trước khi tra cứu Tài sản hoặc quy trình bảo trì của bạn.

Sử dụng các giá trị `fields_json`, `review_required` và `operation_id` được trả về. Hãy xử lý mã định danh dưới dạng văn bản để ứng dụng giữ nguyên các chữ số không ở đầu mã.

Nếu ảnh không đọc được hoặc mô hình đề xuất chuỗi sai, cho phép nhập thủ công. Đọc lại cùng một thao tác sau phản hồi không chắc chắn thay vì tính phí suy luận khác.

Dự kiến. Người dùng phải xem lại mọi giá trị đề xuất trước khi lưu.

Những gì hiện đang hoạt động

Beta riêng. Chụp ảnh hiện có sẵn để thử nghiệm. Việc trích xuất các trường từ ảnh đang được lên kế hoạch và chưa sẵn sàng để sử dụng trong ứng dụng của bạn.

Xây dựng quy trình làm việc

Dự kiến

Quy trình dự kiến. Hiện chưa khả dụng trong bản beta hiện tại.

Các ví dụ này sử dụng các bản ghi ứng dụng như Lesson, Message và Order. Hãy thay thế chúng bằng các kiểu dữ liệu và tên phần tử của bạn. Các địa chỉ phương tiện mẫu phải được thay thế bằng các tệp của bạn.

Dự kiến: chọn các trường mà biểu mẫu của bạn cần, ví dụ fields_json=["title","date","total"]. Bật enable_analysis_export và đặt analysis_context vào tài khoản hoặc bản ghi đã chọn. Các cài đặt phân tích này không có trong phiên bản chụp hiện tại.
Cho phép người dùng chụp ảnh và đồng ý riêng biệt với việc xử lý. Trên analysis_requested, chạy Analyze Captured Document bằng cách sử dụng analysis_image_base64, analysis_mime_type, analysis_fields_json và analysis_consent của phần tử này. Dùng analysis_request_id làm idempotency_key.
Lưu operation_id, request_id và status đã trả về. Nếu status là processing, dùng Read Analysis cùng với operation_id đó để lấy kết quả sau.
Hiển thị fields_json đã trả về trong biểu mẫu xem xét có thể chỉnh sửa. Chỉ lưu các giá trị đã phê duyệt sau khi người dùng kiểm tra và nhấn Xác nhận. Giữ bản ghi gốc cho đến khi có xác nhận đó.

Sơ đồ quy trình làm việc — không phải ảnh chụp màn hình ứng dụng

Cấu hình một lần

Tạo hoặc chọn dự án ứng dụng Bubble của bạn trong BestPlugins → Dashboard → Plugins. Chọn Xodera Documents AI Native, sao chép khóa của nó, sau đó mở Bubble → Plugins → Xodera Documents AI Native và dán vào project_api_key. Lưu một lần; sau đó sử dụng các hành động bên dưới. Mỗi plugin trong mỗi dự án có khóa riêng của nó.

Yêu cầu quyền truy cập camera và giải thích lý do cần ảnh. Việc xử lý cần có sự đồng ý riêng của người dùng. Chọn nhà cung cấp AI trong cài đặt dự án; việc sử dụng sẽ được nhà cung cấp tính phí.

Cấu hình một lần

Tạo hoặc chọn dự án ứng dụng Bubble của bạn tại BestPlugins → Dashboard → Plugins.
Chọn plugin này và sao chép khóa dự án của nó.
Mở Bubble → Plugins → Xodera Documents AI Native; dán khóa vào project_api_key và lưu.
Thêm phần tử, chọn dữ liệu ứng dụng của bạn và xây dựng quy trình làm việc bên dưới.
Hiện chỉ có quyền truy cập beta riêng. Cài đặt công cộng và kích hoạt trả phí chưa mở.

Cài đặt và đăng ký

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.

Lưu kết quả vào ứng dụng của bạn

Ví dụ ExpenseDraft: chủ sở hữu, operation_id, request_id, trạng thái và proposed_fields_json. Sau khi xem xét, lưu ngày đã phê duyệt, tổng và các trường khác, cộng thêm reviewed_by và reviewed_at. Chỉ ánh xạ các trường mà biểu mẫu của bạn yêu cầu. Không đưa toàn bộ nội dung ảnh vào nhật ký hoặc bản ghi văn bản thông thường.

Lỗi, hủy và khôi phục

Nếu kết quả bị trì hoãn, giữ nguyên yêu cầu và sử dụng Read Analysis cho operation_id đã biết. Không chụp ảnh mới hoặc tạo yêu cầu mới tự động. Nếu người dùng rút lại đồng ý, xóa ảnh và ngừng cung cấp kết quả; điều này không thể thu hồi bản sao đã gửi hoặc lưu.

Khả năng và giới hạn

Đầu vào ảnh dự kiến: PNG, JPEG hoặc WebP, tối đa 5 MiB; yêu cầu các tên trường riêng biệt 1–32. Luôn xem xét các giá trị đã trích xuất. Đây không phải là xác minh danh tính, kiểm tra tính xác thực tài liệu hoặc công cụ quyết định y tế. Phí nhà cung cấp AI là riêng biệt.

Cài đặt, hành động và kết quả

Sử dụng các tên này trong Bubble. Các tính năng dự kiến được đánh dấu riêng.

Cài đặt beta khả dụng

Cài đặt phần tử

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

Trạng thái

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

Sự kiện

capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_error

Hành động và đầu vào của chúng

Cài đặt phần tử · 12

Quy trình dự kiến. Hiện chưa khả dụng trong bản beta hiện tại.

document_sidetext · Mặc định: "front": Giá trị ví dụfront; Ví dụ biểu thức BubbleCapture Side Dropdown's value; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

button_labeltext · Mặc định: "": Giá trị ví dụ""; Ví dụ biểu thức BubbleApp Texts' capture_label; Văn bản hiển thị trong ứng dụng; để trống sẽ dùng văn bản bản địa hóa tích hợp khi được hỗ trợ. Không nhập thông tin xác thực.

consent_texttext · Mặc định: "": Giá trị ví dụI agree to capture this non-sensitive receipt.; Ví dụ biểu thức BubbleApp Texts' capture_consent; Giải thích mục đích và người nhận cụ thể của việc chụp/xử lý. Rút lại đồng ý sẽ xóa các byte đã lưu, không xóa các bản sao ứng dụng trước đó.

disabledyes/no · Mặc định: false: Giá trị ví dụno; Ví dụ biểu thức BubbleGuideHost's is_busy (your yes/no custom state); Vô hiệu hoá phần tử khi ứng dụng của bạn đang bận hoặc hành động này không khả dụng.

processing_consent_texttext · Mặc định: "": Giá trị ví dụI agree to send this image to the configured AI provider for draft fields.; Ví dụ biểu thức BubbleApp Texts' processing_consent; Giải thích mục đích và người nhận cụ thể của việc chụp/xử lý. Rút lại đồng ý sẽ xóa các byte đã lưu, không xóa các bản sao ứng dụng trước đó.

analyze_button_labeltext · Mặc định: "": Giá trị ví dụ""; Ví dụ biểu thức BubbleApp Texts' analyze_label; Văn bản hiển thị trong ứng dụng; để trống sẽ dùng văn bản bản địa hóa tích hợp khi được hỗ trợ. Không nhập thông tin xác thực.

languagetext · Mặc định: "auto": Giá trị ví dụuk; Ví dụ biểu thức BubbleCurrent User's preferred_language; Đặt language=auto để theo dõi ngôn ngữ thiết bị hoặc trình duyệt được hỗ trợ. Nhập mã ngôn ngữ hỗ trợ để chọn một cách rõ ràng.

ui_text_jsontext · Mặc định: "": Giá trị ví dụ{}; Ví dụ biểu thức BubbleApp Settings' player_labels_json (supported keys only); JSON tùy chọn với các nhãn nút được hỗ trợ. Để trống để sử dụng văn bản tích hợp.

enable_analysis_exportyes/no · Mặc định: false: Giá trị ví dụyes; Ví dụ biểu thức BubbleApp Settings' enable_reviewed_extraction; Dự kiến: cho phép hành động phân tích dùng ảnh sau khi người dùng đã đồng ý riêng cho việc chụp và cho việc xử lý. Mặc định là tắt.

analysis_contexttext · Mặc định: "": Giá trị ví dụ<current-user-id>; Ví dụ biểu thức BubbleCurrent User's unique id; Giá trị ổn định cho tài khoản hoặc bản ghi này. Thay đổi sẽ xóa ảnh trước đó.

is_activeyes/no · Mặc định: true: Giá trị ví dụyes; Ví dụ biểu thức BubbleGuideHost's view_is_active (your yes/no custom state); Đặt yes khi chế độ xem này đang mở. Đặt no khi rời khỏi, để có thể dừng việc phát hoặc công việc hiện tại.

fields_jsontext · Mặc định: "[\"title\",\"date\",\"total\"]": Giá trị ví dụ["title","date","total"]; Ví dụ biểu thức BubbleExpense Settings' extraction_fields_json; JSON mảng các tên trường trích xuất được yêu cầu; đầu ra là dữ liệu đề xuất để người dùng xem xét.

Hành động và đầu vào của chúng · 2

Quy trình dự kiến. Hiện chưa khả dụng trong bản beta hiện tại.

Analyze Captured Document

image_base64text · Mặc định: —: Giá trị ví dụ<canonical bytes from consented export>; Ví dụ biểu thức BubbleDocument Capture's analysis_image_base64; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

mime_typetext · Mặc định: —: Giá trị ví dụimage/jpeg; Ví dụ biểu thức BubbleDocument Capture's analysis_mime_type; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

fields_jsontext · Mặc định: —: Giá trị ví dụ["title","date","total"]; Ví dụ biểu thức BubbleDocument Capture's analysis_fields_json; JSON mảng các tên trường trích xuất được yêu cầu; đầu ra là dữ liệu đề xuất để người dùng xem xét.

consentyes/no · Mặc định: —: Giá trị ví dụyes — current processing consent; Ví dụ biểu thức BubbleDocument Capture's analysis_consent; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

idempotency_keytext · Mặc định: —: Giá trị ví dụ<unchanged analysis_request_id>; Ví dụ biểu thức BubbleDocument Capture's analysis_request_id; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

environmenttext · Mặc định: —: Giá trị ví dụdevelopment; Ví dụ biểu thức BubbleApp Settings' selected_environment; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

Trả về

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

Read Analysis

operation_idtext · Mặc định: —: Giá trị ví dụ<returned operation_id>; Ví dụ biểu thức BubbleCurrent ExpenseDraft's operation_id; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

environmenttext · Mặc định: —: Giá trị ví dụdevelopment; Ví dụ biểu thức BubbleApp Settings' selected_environment; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

Trả về

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

Trạng thái và sự kiện

Quy trình dự kiến. Hiện chưa khả dụng trong bản beta hiện tại.

Trạng thái

capture_status · text

Kết quả hiện tại của hành động này. Sử dụng sự kiện hoàn thành tương ứng trước khi lưu thành công.

local_uri · text

Vị trí tệp trên thiết bị này. Lưu hoặc tải lên tệp riêng biệt nếu cần giữ trực tuyến.

mime_type · text