メインコンテンツへスキップ
見出し画像

API連携まで自動化する前に、推進役が決める『止める条件』

    連携の相談を受けるたび、私が最初に聞くのはこれです。

    「これ、止める時はどうするんですか」

    いま業務自動化の話題は、「どこまでつなげるか」に寄っています。スプレッドシートとAIをつなぐ、会計ソフトとAIをつなぐ。つなげば確かに楽になります。でも、止め方の話はあまり出てきません。部署別連載の合間の番外編として、今回はAPI連携の「止め方」を取り上げます。

    手作業には、当たり前の安全装置があります。やっている本人が「おかしい」と気づけば、手が止まる。ところが自動化された処理は、誰も見ていない時間に、決まった手順で動き続けます。間違った手順でも、疲れず、迷わず、同じ間違いを積み上げていく。だから連携は、作る前に「止める条件」を決めておく必要があります。これはブレーキの話であると同時に、現場に安心
    して任せてもらうための約束の話です。

    画像

    止める条件は、動かす前にしか決められない

    止める条件は、連携が動き始めてからでは決めにくくなります。理由は単純で、動いているものを止めるには理由が要るからです。「先月は問題なかった」「止めたら今日の処理が遅れる」。止める側が説明を求められる空気が生まれると、異常を見ても誰も手を出せません。

    始める前に決めておけば、話は逆になります。異常が出たら止めるのは、「決めたとおりにやった」だけのことです。止めた人を責める材料にはなりません。安全装置は、必要になってから付けるのでは遅い。推進役の仕事は、連携を作ることと同じくらい、この「先に決めておく」部分にあります。

    連携を始める前に決める5つのこと

    連携の相談を受けたときに、最低限そろっていなければ開始を認めない項目が5つあります。

    1つ目は、対象データの区分です。その連携で、どのデータが外のサービスに渡るのか。個人名や取引先名、未公開の金額が含まれていないか。区分の詳しい線引きは別の機会に譲りますが、少なくとも「何が渡るか」を一覧にできていない連携は始めません。

    2つ目は、読み取り専用か、書き込みを伴うかです。最初の連携は、読み取りと集計の下準備までに留めるのが私の基準です。書き込みは一段上の扱いにして、書き込む先と項目、タイミングを個別に決めます。読み取りの失敗は「情報が古い」で済みますが、書き込みの失敗は相手先のデータを壊します。

    3つ目は、実行頻度と実行者です。毎時なのか、日次なのか。誰のアカウントで動くのか。作った本人の個人アカウントで回っている連携は、本人の異動や休暇で止まるだけではありません。止め方を知っているのが本人だけ、ということにもなりがちです。実行の主体は、業務側の共用のものに寄せます。

    4つ目は、ログの残し方です。凝ったものは要りません。「いつ実行したか」「何件処理したか」「異常が何件あったか」の3点が残れば十分です。ログのない連携は、異常が起きても「いつからおかしかったか」が分からず、後述する巻き戻しの範囲も決められません。

    5つ目は、停止の操作を先に試すことです。止める手順は、文書に書くだけでは足りません。開始前に一度、実際に止めてみる。スケジュールを無効化したら本当に止まるのか、実行中の処理はどうなるのか。止められない連携は、始めない。この5つ目が、いちばん譲れない項目です。

    連携で完結させてよい仕事、させない仕事

    次に、業務の側の線引きです。私の分け方は、2つの問いで決まります。「間違えたら取り戻せるか」「間違いが顧客や取引先に届くか」。

    連携で完結させてよいのは、取り戻せる仕事です。読み取り、集計の下準備、転記のドラフト、社内向け通知の下書き。間違えても、直して出し直せば済む範囲です。

    逆に、連携で完結させない仕事もあります。外部への送信、金額の確定、対外文書の発行、元データの削除や上書きです。これらは「下準備までは連携、最後の一押しは人」という形にします。自動で送るのではなく、人が画面で確認して送信ボタンを押す。その一手間が、事故の大きさを決めます。

    区分と例と理由:

    • 連携で完結させてよい: 読み取り、集計の下準備、転記のドラフト — 間違えても直して出し直せる

    • 人が最後に入る: 外部への送信、金額の確定、対外文書の発行 — 相手に届く。確定すると戻せない

    • 連携させない: 元データの削除・上書き、認証情報の受け渡し — 巻き戻しが効かない

    止める条件は、数字で決める

    いざ止める場面で「異常だと思う」という感覚だけに頼ると、判断が人によってぶれます。止める条件は、できるだけ数字で先に決めます。私が目安にしているのは、この3つです。

    1つ目。照合の不一致が1件でも出たら、その回の処理は全体を止める。100件中99件合っていれば流してよい、とはしません。不一致は「前提が崩れている」というサインです。部分的に流してしまうと、後でどこまでが正しいデータなのか分からなくなります。

    2つ目。保留の割合が5%を超えたら、自動実行を止めて原因を見る。保留とは、形式が合わずに処理できなかったデータの置き場のことです。普段1〜2%のものが6%になっていたら、データの出し側で何かが変わっています。連携そのものを疑う前に、入力側の変化を疑うのが順序です。ただし、件数の少ない連携では割合が荒れます。10件中1件の保留で、もう10%です。対象が50件未満の回は割合を使わず、「保留が3件出たら止める」という件数ルールを併用します。

    3つ目。異常が3回続いたら、連携そのものを切り、手作業に戻す。ここでいう異常とは、照合の不一致、保留の発生、実行そのもののエラーのいずれかが出た回のことです。数え方は実行回単位で、毎時で回る連携なら3回は3時間分、日次なら3日分を意味します。1回は偶然、2回は様子見でも、3回続けば構造の問題です。そして、戻す先の手作業の手順が残っていることも、条件のうちです。手作業の手順を捨ててしまった自動化は、止めた途端に業務そのものが止まります。

    API連携には、もう1つ固有の事情があります。止める操作の最終手段が、APIキーの無効化になることです。キーを止めれば連携は確実に止まりますが、そのキーを使っている別の処理まで止まることがあります。「どのキーを止めると、何が一緒に止まるか」も、開始前に控えておく項目です。

    もう1つ、止める権限の置き場所が大事です。止める判断は、現場の実行担当がその場でできます。推進役の承認を待つ設計にすると、夜間や休日の異常は朝まで走り続けます。「止めてよかった」が先で、報告は後でいい。この順序を先に宣言しておくことが、現場に止める勇気を渡します。

    止めた後、どう巻き戻すか

    止めるだけでは半分です。止まるまでの間に流れたデータを、どう戻すかまで決めておきます。

    巻き戻しを可能にするのは、2つの仕掛けです。1つは、連携が作ったデータに「連携で作った」と分かる印を付けること。登録日時や作成経路が残っていれば、巻き戻しの範囲は「何時から何時までの連携分」と特定できます。印のないデータは、正常分と異常分が混ざり合って、結局すべてを人の目で見ることになります。

    もう1つは、書き込み先に「下書きの置き場」を用意することです。連携はいきなり本番の台帳に書かず、下書きや仮登録の状態までで止める。確定は人が行う。この形なら、巻き戻しは「下書きを捨てる」だけで済みます。連携側に自動の再送(リトライ)設定があると、失敗した書き込みが二重に走ることがありますが、下書き方式なら二重になっても破棄で済みます。月次の集計連携をこの下書き方式に変えてからは、異常時の後処理が「全部見直し」から「下書きの破棄と再実行」に変わりました。

    照合を入れなかった連携で、二重計上しかけた話

    失敗の話を1つ書きます。月次の売上集計を連携で自動化したときのことです。ファイルの取り込みから集計までを一気に流す設計にして、途中に照合の工程を入れませんでした。理由は「ファイルは決まった場所に置かれるだけだから大丈夫だろう」という油断です。

    月末の確認で、合計金額がいつもより大きいことに経理が気づきました。調べると、同じファイルが置き直しのタイミングで2回取り込まれていました。対象は月あたり約200件の請求データで、そのうち19件が二重計上、金額にして約46万円分の差になっていました。確定前だったので実害はなかったものの、気づくのが遅れていたら、報告に使う数字そのものが間違っていたところです。

    回避策は地味です。連携の途中に「件数と合計金額の照合」を1工程入れる。取り込む前に前回分と件数を比べ、同じファイルの二重取り込みはファイル名と更新日時で弾く。派手な仕組みではありません。ただ、連携の事故はだいたい、こういう地味な欠けから起きます。

    連携開始前チェックリスト

    最後に、連携を始める前に推進役が確認する5項目を置きます。そのまま使ってください。

    • 渡るデータの一覧があり、個人情報・未公開の金額・認証情報が含まれていない

    • 読み取り専用か書き込みかが決まっていて、書き込み先と項目が特定されている

    • 実行頻度と実行主体が決まっていて、特定の個人に依存していない

    • ログに「実行日時・処理件数・異常件数」の3点が残る

    • 止める条件(不一致1件で停止/保留率5%超で停止・50件未満の回は保留3件で停止/異常3回で手作業へ)と停止手順が書かれていて、実際に一度止めてみた

    確認日:____ 確認者:____(記入して業務フォルダに置く)

    止められるから、任せられる

    止める条件の話をすると、「推進役なのにブレーキの話ばかり」と言われることがあります。でも現場の受け止めは逆です。止め方が決まっている連携は、現場が安心して任せてくれます。決まっていない連携は、便利でもどこかで人の目が離れず、結局、確認の仕事が残り続けます。

    人を切るためではなく、人の仕事を取り戻すためにAIを使う。この連載の出発点に、止める条件はそのままつながっています。判断と責任は人に残す。その約束を、連携という仕組みの中に先に埋め込んでおく。それが推進役の仕事だと考えています。

    次回からは現場篇に入ります。

    ――
    本連載は、拙著『人を切らないAI改革 ― 中小企業のための「社内AI推進役」のつくり方』の続篇企画です。第1弾(総論篇)はKindleとペーパーバックで発売中です。
    https://www.amazon.co.jp/dp/B0HPX76PLZ

     
     

    edge

     
     
    中小企業で社内AI推進役を務める実務家です。Kindle書籍15冊(日本語・英語)を出版し、『人を切らないAI改革』シリーズなどを連載中。Udemy講座「社内AI推進役のはじめ方」も開講しています。現場でそのまま使えるAI活用の手順・数字・失敗談を書きます。

    あなたへのおすすめ