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.
ドキュメント確認日：2026年11月6日
実用的な例
領収書の写真から経費ドラフトを事前入力する
加盟店、日付、合計を何度も入力すると経費入力が遅くなります。抽出されたフィールドはレビュー可能なドラフトにできます。
`fields_json = ["merchant","date","total","currency"]`; ユーザーは領収書画像をキャプチャし、別途処理への同意を行います。テスト時はサンプル領収書のみを使用してください。
予定: `analysis_requested` → Analyze Captured Document を、制限されたエクスポートバイト/MIME/フィールド名/同意/リクエストID と共に使用し、返されたフィールドを編集可能な Expense フォームに表示します。
このアクションは `status`、`operation_id`、`fields_json`、`review_required` を返します。ユーザーがフィールドを修正/承認した後に、ワークフローが Expense を作成します。
結果が不確かな場合、Read Analysis を同じ `operation_id` と共に使用します；自動的に別の分析を実行しないでください。同意の取り消しは保持されたキャプチャ/エクスポートを削除します；生の base64 を公開された Thing やログに永続保存しないでください。
予定。保存する前にすべての提案値を人がレビューする必要があります。
スタッフレビュー用フォームの配送伝票参照を読み取る
倉庫ユーザーは、写真撮影された紙の伝票から入力する代わりに、提案された参照/日付をレビューできる必要があります。
`fields_json = ["delivery_reference","supplier","delivery_date"]`; テスト時にサンプル配送伝票の該当面をキャプチャしてください。
別途キャプチャ/処理の同意を得た後、Analyze Captured Document が選択されたフィールドを提案します。写真を編集可能なフィールドの横に表示し、スタッフに対応する Delivery レコードを確認させてください。
返された `operation_id` を保持して結果を再確認し、`fields_json` を提案として使用してください。スタッフレビューの後に、ワークフローが実際の Delivery 検索/更新を実行します。
欠落、曖昧、または不正確なフィールドは手動で修正が必要です。プロバイダーエラーが発生した場合、元の Delivery は変更されません；不確かな操作の結果を Read Analysis で確認してください。
予定。保存する前にすべての提案値を人がレビューする必要があります。
ラベル写真から機器のシリアル番号を提案する
資産ラベルの入力が困難な場合、保守フォームはレビュー可能なモデル/シリアルの提案を提供できます。
`fields_json = ["manufacturer","model","serial_number"]`; サンプルの機器ラベル画像をキャプチャし、プロジェクト設定で AI プロバイダーを選択してください。
予定された Analyze Captured Document アクションは提案文字列を返します。写真の横に表示し、ユーザーがAsset 検索または保守ワークフローの前に修正できるようにしてください。
返された `fields_json`、`review_required`、`operation_id` を使用してください。識別子はテキストとして扱い、アプリが先頭のゼロを保持できるようにします。
画像が読めない、またはモデルが誤った文字列を提案した場合は手動入力を許可してください。不確かな応答の後は、別の推論で追加料金を発生させるのではなく、同じ操作を再度読み取ります。
予定。保存する前にすべての提案値を人がレビューする必要があります。
現在機能しているもの
プライベートベータです。写真撮影はテスト用に利用可能です。写真からの項目抽出は計画中で、まだアプリで使用できる状態ではありません。
ワークフローを構築する
計画中
計画中のワークフローです。現在のベータ版ではまだ利用できません。
これらの例は Lesson、Message、Order などのアプリレコードを使用しています。ご自身のデータ型や要素名に置き換えてください。メディアアドレスの例はご自身のファイルに置き換える必要があります。
計画中: フォームが必要とするフィールドを選択してください（例: fields_json=["title","date","total"]）。enable_analysis_export を有効にし、analysis_context を選択したアカウントまたはレコードに設定します。これらの分析設定は現在のキャプチャバージョンでは利用できません。
ユーザーに写真を撮らせ、処理への同意を別途取得してください。analysis_requested 上で、この要素の analysis_image_base64、analysis_mime_type、analysis_fields_json、analysis_consent を使用して Analyze Captured Document を実行します。analysis_request_id を idempotency_key として使用してください。
返された operation_id、request_id と status を保存してください。status が processing の場合、その operation_id と共に Read Analysis を使用して後で結果を取得します。
返された fields_json を編集可能なレビュー形式で表示します。ユーザーが確認しConfirm ボタンを押した後にのみ、承認された値を保存してください。確認が行われるまで元のレコードは保持してください。
一度だけ設定する
Bubble アプリプロジェクトを BestPlugins → Dashboard → Plugins で作成または選択します。Xodera Documents AI Native を選び、キーをコピーし、次に Bubble → Plugins → Xodera Documents AI Native を開いて project_api_key に貼り付けます。一度保存し、以下のアクションを使用してください。各プロジェクトの各プラグインはそれぞれ固有のキーを持ちます。
カメラの許可を求め、写真が必要な理由を説明してください。処理には別途ユーザー同意が必要です。プロジェクト設定でAIプロバイダーを選択してください。その使用料はプロバイダーから請求されます。
一度だけ設定する
- BestPlugins → Dashboard → Plugins で Bubble アプリプロジェクトを作成または選択してください。
- このプラグインを選択し、プロジェクトキーをコピーしてください。
- 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: owner、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/noRead 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 は含まれています。操作回数に固定上限はありませんが、ファイルサイズと機能制限は引き続き適用されます。チェックアウトはまだ開いていません。アクティベーション画面に最初の請求日とキャンセル条件が表示されます。
関連ガイド
Marketplaceリリース保留中
フォーラムガイドは未掲載
サポートが必要な場合は、使用しているプラグインとデバイス、試したアクションと結果をお知らせください。個人データを含まない例を使用してください。キーやプライベートファイルを決して共有しないでください。