make-integration

make-integration

使用するタイミング

ユーザーが Make Platform の統合機能を必要としている場合、特に請求書や伝票の OCR 認識が必要な場合にこのスキルを使用します。

現在の機能：

• makecli integration ocr による伝票・請求書の OCR
• 請求書の真偽確認（オプション）
• PDF/OFD/PNG/JPG/JPEG ファイルの構造化抽出
• 返される請求書のフィールド、印影、QR コード、座標、オプションの切り抜き画像

依存関係

make-integration は makecli スキルとインストール済みの makecli バイナリに依存します。

手順

実行前の確認

OCR を実行する前に：

0. makecli がインストールされていることを確認します。

   • インストールされていない場合：brew tap qfeius/makecli && brew install makecli を実行します。

1. OCR コマンドが存在することを確認します。

   • makecli integration ocr --help を実行します。
   • コマンドが存在しない場合は、makecli update を実行するか、makecli をアップグレードします。

2. 選択したプロファイルを確認します。

   • makecli configure verify --profile <profile> --output=json を実行します。
   • 設定されていない場合は、対話型セットアップを実行するようユーザーに伝えます。 ! makecli configure token --profile <profile>
   • トークンが無効または未設定の場合は処理を中止し、makecli の認証情報を設定するようユーザーに依頼します。makecli を使わずに請求書の内容を認識、抽出、推測、修正、補完してはいけません。

3. makecli からリクエストのベース URL を確認します。

   • makecli configure get server-url --profile <profile> を実行します。
   • 環境 URL をハードコードするのではなく、プロファイルで設定されたサーバー URL を優先して使用します。
   • プロファイルにサーバー URL が設定されていない場合、makecli は独自のデフォルトのベース URL を使用します。

4. 入力ファイルを確認します。

   • 対応する拡張子：.pdf、.ofd、.png、.jpg、.jpeg
   • ユーザーが提供または承認したファイルのみをアップロードします。

認識ワークフロー

ユーザーが読みやすい回答だけを必要としている場合は、表形式の出力を使用します。

makecli integration ocr -f <file> --profile <profile>

フィールドの解析や、結果を別の Make 操作に渡す必要がある場合は、JSON 出力を使用します。

makecli integration ocr -f <file> --output=json --profile <profile>

一般的なオプション：

# Recognize selected pages
makecli integration ocr -f invoice.pdf --pages "1,3,2"
makecli integration ocr -f invoice.pdf --pages "2-4"

# Bind a business document id
makecli integration ocr -f invoice.pdf --business-id <business-id>

# Explicitly disable invoice authenticity verification
makecli integration ocr -f invoice.pdf --verify-vat=false

# Optional response controls
makecli integration ocr -f invoice.pdf --coord-restore-original
makecli integration ocr -f invoice.pdf --crop-complete
makecli integration ocr -f invoice.pdf --crop-value
makecli integration ocr -f invoice.pdf --merge-elec
makecli integration ocr -f invoice.pdf --return-ppi

出力の処理

--output=json の場合、次の内容を基に要約します。

data.file_name
data.bill_count
data.processing_duration_ms
data.result.pages[].bills[].items[]
data.result.pages[].bills[].stamps[]
data.result.pages[].bills[].qr_codes[]

ユーザーに結果を報告する際：

• 入手可能な場合は、ファイル名、伝票の件数、ページ数、処理時間を含めます。
• 空でない items[].value フィールドを抽出します。
• 印影や QR コードがあり、役立つ場合は含めます。
• 通常の要約には、base64 形式の切り抜きデータを含めないでください。
• 認識された OCR 値は、成功した makecli integration ocr の出力からのみ報告します。
• 認識結果として扱うのは makecli integration ocr の出力のみです。請求書データを認識または補完するために、目視確認、モデルの知識、ファイルの解析、別の OCR ツール、直接の HTTP 呼び出し、ユーザーに表示される画像の内容を使用してはいけません。
• 特別な情報や個人情報のマスキングまたは置き換えは、スキルのドキュメント例、コミット済みサンプル、ログ、デバッグ用スニペットでのみ行います。
• OCR 結果を Make のレコードに書き込む場合は、認識後のレコード操作に makecli スキルを呼び出します。

エラーへの対処

• API 错误 [990300403]: token验证失败
  • トークンが選択した環境では無効です。その環境で有効なトークンを設定するようユーザーに依頼してから、makecli を通じて OCR を再試行します。
• API 错误 [990300404]: 服务不存在
  • 選択した makecli のサーバー URL では、OCR エンドポイントがまだデプロイされていない可能性があります。プロファイルのサーバー URL を確認するか、デプロイ状況を確認します。
• unsupported file extension
  • 対応する PDF/OFD/PNG/JPG/JPEG ファイルを依頼します。
• 打开文件失败
  • ローカルパスとアクセス権限を確認します。
• makecli の OCR で発生したその他のエラー
  • makecli のエラーと、次に必要な makecli の設定または環境に関する手順を報告します。自分で請求書の内容を認識して処理を続けてはいけません。

厳守事項

• ユーザーから提供されたトークンをリポジトリ内のファイルに書き込まないでください。
• ユーザーから一時的に使用するトークンが提供された場合は、一時的な設定ディレクトリを優先してください。
• 実行後は、ユーザーから保持するよう求められない限り、一時的な認証情報と OCR 結果ファイルを削除してください。
• トークンを表示、コミット、複製しないでください。
• ユーザーから提供または承認されていないローカルファイルをアップロードしないでください。
• スキルの例に、実際の請求書番号、納税者 ID、注文番号、電話番号、住所、トークン、QR ペイロード、その他の機密情報を含めてコミットしないでください。
• このスキルでは、makecli 以外のパスをフォールバックとして使用しないでください。makecli を実行できない場合や OCR に失敗した場合は、まず makecli の設定と環境を修正し、その後 makecli 経由で再試行してください。