AIトークノミクスの記録テンプレート
仕様: 1.0 / 公開日: 2026-09-06
作成: 株式会社麻布技術研究所
説明・計算機: https://azabu.io/ai-tokenomics/
実装: https://github.com/nyasukun/azabu.io

このテンプレートは説明用の記録方式です。業界団体の認定標準ではありません。
個人・企業を問わず、出典URLを残して複製・変更・再配布できます。
数値欄は空欄です。顧客データや実測の成果は含みません。
UTF-8（BOM付き）のCSVです。表計算ソフトでは文字コードをUTF-8として開いてください。

■ 共通条件
金額: JPY、税抜。同じ期間・対象業務・難易度構成・受入基準・費用範囲で比較します。
件数: 非負整数。依頼の再試行を新しい成果として数えません。
金額と時間: 非負の数値。空欄と未計測はゼロとは異なります。
ゼロは費用・時間が発生しなかったと確認できた場合だけ記録します。
同じ費用をモデル、ツール、運用、人作業に二重配賦しません。
他業務と共有する費用は、両方式で同じ配賦規則を決めて記録します。
入力用のCSVに計算式はありません。自分で列を追加する場合は元の列を残してください。

■ ai-tokenomics-cost-template.csv（方式・期間別）
1行 = 1方式、1期間、1対象業務の集計。A/B行の数値欄を埋めます。
schema_version: テンプレート仕様。1.0。
scenario: 比較方式。AまたはB。詳細はcase_mix_noteへ。
period_start / period_end: 対象期間の開始日・終了日。YYYY-MM-DD。
currency: JPY固定。
cost_basis: tax_exclusive（税抜）。
acceptance_criteria_version: 共通の受入基準の識別子と版。
case_mix_note: 業務内容、難易度構成、費用範囲、配賦規則。
total_tasks: 対象に含めた依頼のユニーク件数。
accepted_tasks: 品質条件を満たして受け入れたユニーク件数。total_tasks以下。
model_cost_jpy: 失敗・再試行を含むモデル利用費。キャッシュも請求区分に従う。
tool_cost_jpy: 検索、外部ツール、保存、処理連携の費用。
eval_ops_cost_jpy: 評価・監視基盤と運用の費用。human_work_hours分の作業費を含めない。
human_work_hours: 人の確認・修正・引き継ぎと、その後に人が処理を完了するまでの作業時間の合計（時間）。
hourly_cost_jpy: 人の作業の時間単価。単価が異なる場合は加重平均を使う。
allocated_setup_cost_jpy: 当該期間に配賦した初期開発・教育等の費用。除外時は0とし、case_mix_noteに除外を明記。
unmeasured_costs_note: 未計測の項目と、その影響。未計測を0として総原価を確定しない。

加重平均単価 = 各作業者の「時間×単価」の合計 ÷ 総時間。
総時間が0なら、作業費と時間単価を0として記録します。
総コスト = model_cost_jpy + tool_cost_jpy + eval_ops_cost_jpy
          + human_work_hours × hourly_cost_jpy + allocated_setup_cost_jpy。
成果単価 = 総コスト ÷ accepted_tasks。受入0件は未算出。
受入率 = accepted_tasks ÷ total_tasks × 100。対象0件は未算出。
初期費用の配賦を含めない場合、投資全体の回収を示す計算にはなりません。

■ ai-tokenomics-task-template.csv（業務依頼別）
1行 = 1方式、1ユニーク依頼ID。途中のモデル呼び出しごとに行を増やしません。
schema_version: 1.0。
scenario: 方式A/B。
request_id: 照合用ID。依頼本文・氏名等の個人情報は入れない。
acceptance_criteria_version: 適用した受入基準の識別子と版。
started_at / completed_at: 開始・完了時刻。タイムゾーン付きISO 8601。
accepted: 最終受入判定。受入1、未受入0。未判定は空欄のまま結果を確定しない。
trace_ids: 関連トレースの識別子。複数ならセミコロンで区切る。
model_cost_jpy: この依頼の全モデル呼び出しに要した費用。
tool_cost_jpy: この依頼の検索・外部ツール等の費用。
eval_ops_allocated_jpy: この依頼へ配賦した評価・運用費。
human_review_minutes: 人の確認時間（分）。
human_rework_minutes: 人の修正時間（分）。
human_handoff_minutes: AIで完了できない処理の引き継ぎと、その後に人が処理を完了するまでの作業時間（分）。確認・修正欄に記録した時間は重複計上しない。
hourly_cost_jpy: 作業単価。依頼内で異なる場合も加重平均を使う。
allocated_setup_cost_jpy: この依頼へ配賦した初期費用。
measurement_status: complete（計測完了）またはpartial（欠測あり）。
notes: 欠測、失敗、締め条件、配賦規則、品質上の注意。個人情報は避ける。

■ 依頼別記録から期間集計へ
1. 両方式で対象期間、完了・未完了の扱い、受入基準を固定する。
2. scenarioとrequest_idの組を重複なく数え、total_tasksにする。
3. accepted=1の件数をaccepted_tasksにする。未受入行も費用へ含める。
4. 各費用を集計。子スパンと親の合計額を同時に足さない。
5. 人の時間は確認・修正・引き継ぎの分数を足して60で割る。
6. 各人・各依頼の時間×単価を集計し、加重平均単価を求める。
7. 請求書と照合し、差額・未計測費用を記録してから方式間を比較する。

テンプレートは、データ収集・同意・保存期間の判断を代行しません。
費用の低さだけで方式を選ばず、受入率、重大な誤り、所要時間も確認してください。