BUSINESS AUTOMATION / DOCUMENT AI / 2026.09.28
環境移行、帳票ごとの振り分け、更新時の切り戻しを一つの運用フローにします。
Amazon Textractはスキャンした文書から文字や構造化データを抽出するサービスです。Custom Queriesアダプターは、自社の帳票形式に合わせて抽出を改善する仕組みです。請求書や申込書の試験運用では、まず抽出精度が目標になりがちです。しかし本番では、旧版・新版の帳票が混在し、開発・検証・本番アカウントを分け、モデル更新後にすぐ戻せることも必要になります。[^blog]
AWSの新記事は、Custom Queriesアダプターを例に、CloudFormation/Terraformによる周辺基盤、別アカウントへの昇格、帳票の事前分類、Parameter StoreによるID管理をまとめています。記事の位置付けは設計パターンの公開であり、アダプターの自動クロスアカウントコピー機能が追加されたわけではありません。[blog][copy]
| 方式 | 仕組み | 向いている状況 | 注意点 |
|---|---|---|---|
| アカウント間コピー | 移行先にアダプターのメタデータを作り、同一リージョンのAWS Supportへ版のコピーを依頼 | 環境を強く分離したい、更新が少ない | 依頼のリードタイム。クエリ定義・学習データは別管理 |
| 集約アカウント | 1つのアカウントに学習済みアダプターを置き、各環境からクロスアカウントで呼び出す | 更新が多く、プラットフォームチームが集中管理する | アクセス設計が複雑。APIのTPSなどが1アカウントに集中 |
公式のコピー手順では、移行先アカウントに名前・説明などのメタデータを持つアダプターを先に作成します。その後、リージョン、移行元/先のアカウントID、アダプターID、版を添えてSupportケースを起票します。コピーは同一リージョン内に限られ、Support契約も必要です。[^copy]
AWSの例では、受け取った文書からDetectDocumentTextで軽く文字を取り、帳票名・版番号・ラベルなどで版を判別します。その結果からParameter StoreにあるアダプターIDと版を取得し、AnalyzeDocumentまたはStartDocumentAnalysisへ渡します。[^blog]
1ページに適用できるアダプターは1つです。複数ページの文書では、ページごとに異なるアダプターを指定できます。同期APIは単一ページの扱い、複数ページのPDF/TIFFには非同期APIを使うなど、文書形式とAPIの制限も確認してください。[inference][blog]
アプリにアダプターIDを埋め込まず、例えば/documents/invoice/prod/adapterというParameter Storeのキーに、検証済みのAdapterId:Versionを保存します。更新時は旧値を記録し、新版で精度・処理時間・失敗率を検証してから参照先を変えます。問題が出たら前の値へ戻します。Parameter Storeは更新ごとに版を保持します。[ssm][blog]
# 値は例。実際のID・版・リージョンに置き換える
aws ssm put-parameter --name /documents/invoice/prod/adapter \
--type String --value 'adapter-id:2' --overwrite
aws ssm get-parameter --name /documents/invoice/prod/adapter
これは参照先を外部化する構成例で、AWS CLIを本番環境で実行・検証した結果ではありません。アプリ側が毎回Parameter Storeを読むか、キャッシュを更新する設計でなければ、切り替えは即時には反映されません。パラメータ変更だけでアダプター本体が作成・コピーされるわけでもありません。[^ssm]
最初に1種類の帳票で、旧版・新版の両方を含むテストセットを作るのが現実的です。抽出の正解率だけでなく、分類誤り、手動レビュー率、API制限、切り戻し時間を記録してください。自動化の価値は「抽出できた件数」だけでなく、誤処理を安全に止められるかでも決まります。
最終確認日:2026年9月30日(日本時間)。AWS記事の公開日(9月28日)と本記事の日付は異なります。
[^blog]: AWS Artificial Intelligence Blog: Automating Amazon Textract adapter lifecycle management across accounts(2026年9月28日) [^copy]: AWS Developer Guide: Copying adapters [^inference]: AWS Developer Guide: Using Adapters during Inference [^ssm]: AWS Systems Manager: Working with parameter versions [^quota]: AWS Developer Guide: Modifying Default Quotas in Amazon Textract [^limits]: AWS Developer Guide: Set Quotas in Amazon Textract