生成AIの自動化ツールを販売する前に|仕様・検収・保守の準備票

生成AIの自動化ツールを販売する前に|仕様・検収・保守の準備票

生成AIを使った自動化ツールを販売するなら、まず「何を受け取り、何を返し、どこまで責任を持つか」を説明できる形にします。自分の環境で一度動いたことと、購入者へ提供できる状態であることは分けて確かめてください。

最初の検討では外部へ送信したり、本番データを書き換えたりしない小さな用途に絞る方法を提案します。以下は販売準備を考えるためのガイドです。架空のツール仕様と検査例を用いており、実際に開発・販売した製品、受注実績、実測した性能を示すものではありません。

入力と出力を仕様に書く

ツールの入力、出力、対象外を分けて記す図

入力・出力と対象外の定義

「業務を自動化します」だけでは、購入者は必要な環境や残る作業を判断できません。入力するファイル、必要な項目、対象の件数、出力形式を決めます。扱えない入力と、分からないときの表示も同じ仕様に記載します。

架空例として、問い合わせ文のCSVを読み、行ごとに分類候補と理由を返すツールを考えます。ここでは顧客へ回答を送らず、元のCSVも変更しない仕様にします。出力は担当者が確認するための別ファイルです。この段階では実装していないので、対応件数や処理時間を確定した製品仕様として公表しません。

分類候補の扱いと販売説明

分類名を「操作」「契約」「その他」とする場合、境目が曖昧な問い合わせをどう扱うかを決めます。複数の内容があるなら複数候補にするのか、人の確認へ回すのかを、販売説明と検査の両方へ反映します。

すべての問い合わせを自動解決する製品と、この分類補助では、求められる機能が違います。実際に返すものを「分類候補」と決めたなら、販売ページでも「自動対応」「解決済み」と言い換えないようにしてください。

提供する形と費用の担当を決める

提供方法と必要な環境

ソースコードを渡す、実行用のファイルを渡す、提供者が管理する画面を使ってもらうなど、提供する形によって作業が変わります。どの環境を自分が管理し、どの設定を購入者が行うのかを一覧にします。

API費用と保守の範囲

外部のAI APIを使うなら、APIの契約者と利用料を負担する人を決めます。販売代金に利用料を含むのか、購入者が別に支払うのかは、購入前に伝える条件です。現行料金を確認していない状態で、月額費用や一件あたりの費用を固定しないでください。

再実行や失敗した処理で費用がどう扱われるかも、提供元の資料や実装で確認します。「一回の操作」と「外部APIへの一回の送信」が同じとは限りません。未確認なら料金を断定せず、試験で確認する項目に残します。

保守では質問への回答、設定の変更、プログラムの修正、外部APIの変更対応を分けます。売り切りのファイルと継続サービスでは、販売後の責任が違います。「ずっと使えます」「更新にすべて対応」といった約束を、確認せずに付け加えないようにします。

APIキーを商品へ同梱しない

配布物と画面に含めない情報

APIキーは外部サービスを利用するための秘密情報です。販売用ファイル、サンプルコード、操作説明の画面に、自分や顧客のキーを入れないでください。説明用の画像も確認し、設定画面やログにキーが写り込んでいないかを確かめます。

OpenAIの公式ヘルプはAPIキーの共有を認めず、ブラウザやモバイルアプリなど利用者側の環境にキーを配置しないよう案内しています。コードを保存するリポジトリへキーを書き込まないことも示しています[1]。同社APIを使う構成ではこの条件を設計に反映します。

設定する人と保存する場所

購入者が自分の環境で管理する形を検討する場合も、キーを販売者へ送らせる手順を当然のものにしません。誰がどこへ設定し、どの権限で使い、終了時に何を止めるかを確認してください。具体的な安全設計を説明できない状態なら、実データを扱う販売へ進めません。

画面にキーを表示しないだけでは確認が終わりません。配布するファイル、保存するログ、エラー表示、操作説明を対象に含めます。試験用の秘密情報を使った場合も、試験後の無効化と記録の扱いを決めておきます。

架空の入力で検収条件を作る

正常な入力、曖昧な入力、接続失敗を検収に含める図

検収の目的と正常な入力

検収は決めた納品条件を満たしたか確かめる作業です。購入者と合意する前に、正常な入力だけでなく、不足や失敗がある入力も用意します。次は編集者が作った検査設計で、ツールを実行した結果ではありません。

一つ目は、必須の問い合わせ本文がある架空のCSVです。出力の行数と入力の行数が対応し、どの行を分類したか追えることを確認する案です。分類の正しさとは別に、入力の取りこぼしや重複がないかを見る項目です。

空欄・曖昧な入力・接続失敗

二つ目は、本文が空欄の行です。内容を推測して分類せず、入力不足として確認対象へ回す仕様を考えます。空欄のまま外部へ送るか、送る前に止めるかも決めます。

三つ目は、分類の判断が難しい内容です。正解を一つに決められない場合は、「確認が必要」と残すことを期待する条件にします。曖昧な例を無理に正解へ寄せ、成功率をよく見せる検査にはしません。

四つ目は外部APIに接続できない場合です。処理済みと未処理の範囲を区別し、再実行で同じ行を二重に処理しないかを確認します。実装による動作を試したうえで、再開方法を説明書へ記載します。

これらの条件は仮の設計です。製品の安全性や正確性を証明する試験一式ではありません。提供する用途に合わせて、検査入力、期待する扱い、実際の結果、未解決事項を残してください。

販売準備票のテンプレート

準備票の記入項目

ツールの用途と想定利用者:
受け取る入力と必須項目:
返す出力と人が確認する点:
対応しない入力や作業:
外部送信する情報と送信先:
書き換えるデータ:なし/具体的な対象
提供する形と必要な動作環境:
外部APIの契約者と費用負担:
APIキーを管理する人と場所:
試験入力、期待する扱い、実際の結果:
未処理や失敗時の表示と再開方法:
納品物と検収条件:
説明書と問い合わせ方法:
保守の期間、対象、対象外:
販売前に未確認の項目:

説明書・販売ページと試験

準備票は販売ページと説明書の確認にも使います。販売ページで「すべて自動」、説明書で「担当者の確認が必要」と書くような食い違いを残さないためです。検査していない件数や環境も、対応済みとして記載しません。

別の人が使う試験では、説明書だけで入力を用意し、結果を確認できるかを見ます。開発者が横で毎回設定する状態なら、その支援を納品や保守に含めるのかを検討します。想定外の作業を購入者の責任として後から追加しないようにしてください。

問い合わせ対応でログを受け取る場合は、必要な項目と受け取り方も説明します。失敗した画面を丸ごと送ってもらう方法では、問い合わせ本文や秘密情報まで含まれるおそれがあります。架空の入力で問題を再現できるかを先に確かめ、実データが必要なら取り扱う範囲を合意してください。説明書には、送ってよい情報と伏せる情報を分けて記載します。

配布するコードと利用条件を確認する

他人のコードやライブラリを含める場合は、利用するバージョンとライセンスを確認します。GitHubの公式資料は、ライセンスがソースコードに対して可能な利用を示すと説明しています。公開されているコードでも、ライセンスがない場合に自由に複製・配布できるとは案内していません[2]。

販売できるかどうかはコード、AIサービス、素材、販売先それぞれの条件を照合して判断します。自分が付ける利用条件だけで、他者の条件を消すことはできません。権利や契約の判断が必要な場合は、条件を整理して専門家など適切な確認先へ相談してください。

仕事の見本を提示する段階では、生成AI副業を初心者が始める手順も参考になります。ただし、文章の見本と動作するツールでは、検収や保守で確認すべき項目が違います。

販売を急ぐ前に、架空入力を使って「説明どおりに扱えた範囲」と「まだ未確認の範囲」を分けましょう。最初に準備票を埋めると、機能を追加する前に、提供条件として不足している項目を確認できます。

参照資料

著者について

松本大輔

Re-BIRTH株式会社 代表取締役社長。

著書