# AIコスト工学／ROI編

CURRENT_STATUS: UNKNOWN
OBSERVATION: SPEC_ONLY
FRESHNESS: UNKNOWN
PAGE_TYPE: guide
CANONICAL_URL: /tools/ea-017-ai-roi
CLAIM_IDS: none
EVIDENCE_IDS: EA-017-R11-RESEARCH, EA-017-R11-WEB-READBACK
UNKNOWN_IDS: EA-017-UNKNOWN-01, EA-017-UNKNOWN-CURRENTNESS
OPS_IDS: none

## Summary
token/list priceはEnterprise AIの総原価の一部にすぎない。比較単位は、固定したquality gateを通過した「accepted outcome 1件あたりのend-to-end cost」とし、model usageだけでなくtool/retrieval、storage/runtime、人間確認、失敗・再実行、observability/governance、固定費配賦を分離記録する。

## Current judgment
token/list priceはEnterprise AIの総原価の一部にすぎない。比較単位は、固定したquality gateを通過した「accepted outcome 1件あたりのend-to-end cost」とし、model usageだけでなくtool/retrieval、storage/runtime、人間確認、失敗・再実行、observability/governance、固定費配賦を分離記録する。

## Scope
AIコスト工学／ROI編

## Confirmed

## UNKNOWN
- EA-017-UNKNOWN-01: - 低token価格でも、低品質→再試行→tool churn→human escalationが増えればaccepted-task単価は高くなり得る。
- 公開price pageはlist priceであり、個別enterprise contract、volume discount、commitment、tax、currency、support、minimum spendを証明しない。
- agent runはstep数とtool callが確率的で、平均値だけではloopやtail costを隠す。
- fixed license/admin/security/observabilityの配賦は組織会計方針に依存する。
- self-hostはGPU時間だけでなくcapex/depreciation、energy、utilization、ops、downtime、network等を含めないとcloud API比較と釣り合わない。
- `OPEN_UNKNOWN`: 個別enterprise discount/commit/tax/currency、実workload trace、acceptance/human correction、tenant billing export semantics、実security/governance/admin cost、benefit realization mechanism。
- provider price、billing unit、free allowance、tool billingは`PRODUCT_VOLATILE`であり、公開直前に再採集する。
- EA-017-UNKNOWN-CURRENTNESS: 外部根拠の再確認日がcanonical body/control-planeで確定していないため、currentnessはUNKNOWNとして保持する。日付を推測補完しない。

## Evidence
- EA-017-R11-RESEARCH (RESEARCH): EA-017 監査済みresearch / canonical revision binding
- EA-017-R11-WEB-READBACK (IMPL): EA-017 Web body identity / canonical readback

## Failure / limits
低token価格でも、低品質→再試行→tool churn→human escalationが増えればaccepted-task単価は高くなり得る。
## Failure / limits
公開price pageはlist priceであり、個別enterprise contract、volume discount、commitment、tax、currency、support、minimum spendを証明しない。
## Failure / limits
agent runはstep数とtool callが確率的で、平均値だけではloopやtail costを隠す。
## Failure / limits
fixed license/admin/security/observabilityの配賦は組織会計方針に依存する。
## Failure / limits
self-hostはGPU時間だけでなくcapex/depreciation、energy、utilization、ops、downtime、network等を含めないとcloud API比較と釣り合わない。
## Failure / limits
`OPEN_UNKNOWN`: 個別enterprise discount/commit/tax/currency、実workload trace、acceptance/human correction、tenant billing export semantics、実security/governance/admin cost、benefit realization mechanism。
## Failure / limits
provider price、billing unit、free allowance、tool billingは`PRODUCT_VOLATILE`であり、公開直前に再採集する。
## Practice
低価格経路がretention、residency、tool routing、provider boundaryを変える場合、cost optimizationをgovernance回避に使用しない。

cost traceにはprompt本文や機微データを不必要に保存せず、request/workflow/tenant/model/version/pricing snapshotの識別子を分離する。price snapshot/as-of、run/trace ID、meter quantity、currency、cost-center、attribution ruleを監査可能にする。

budget/alert/quota、cost anomaly、retry cap、agent step cap、loop breaker、price drift detectionを運用controlに含める。non-idempotent actionのretryはAPI料金を超える業務損失を生み得るため、duplicate side effectを別failureとして扱う。
## Practice
plan/tier/region/org/billing account、negotiated contract、currency/tax、model/tool support、batch/cache/flex support、rate limit/quota、storage/retention、minimum spend/commitment、billing export権限、data residency、self-host infrastructure。
## Practice
以下はすべて`UNEXECUTED`。
## Practice
TEST_PROFILE-017-A REAL_WORKLOAD_COST_LEDGER — representative task setでprovider usage meter、tool/retrieval、trace、human correctionを同一run IDへ紐付ける。認証/paid tenantが必要なため設計のみ。
## Practice
TEST_PROFILE-017-B RETRY_AMPLIFICATION — safe local/mock timeoutでretry、tool重複、cost amplificationを測る。実外部side effectは発生させない。
## Practice
TEST_PROFILE-017-C QUALITY_COST_FRONTIER — cheap/premium modelを同一golden task・同一acceptance thresholdで比較し、total cost、accept rate、latency、human correctionを測る。
## Practice
TEST_PROFILE-017-D ROI_BASELINE_SENSITIVITY — adoption、utilization、error/rework、time-to-cash conversion、benefit horizonを振り、ROIの仮定依存性を可視化する。
## Practice
TEST_PROFILE-017-E PRICE_DRIFT — 公式pricingを日付付きsnapshot化し、model/tool/billing mode変更時に同一workload costを再計算する。
## Practice
TEST_PROFILE-017-F AGENT_TAIL_COST — synthetic tool loop＋最大step capでp95/p99 costとloop breaker効果を測る。paid toolは呼ばない。
## Public claim
token/list priceはEnterprise AIの総原価の一部にすぎない。比較単位は、固定したquality gateを通過した「accepted outcome 1件あたりのend-to-end cost」とし、model usageだけでなくtool/retrieval、storage/runtime、人間確認、失敗・再実行、observability/governance、固定費配賦を分離記録する。

公開料金は`PRODUCT_VOLATILE`かつas-of付きで扱い、個別契約・請求・組織固有TCOへ外挿しない。外部研究のproductivity gainやtime savingを組織固有のrealized ROIへ直接移植しない。estimated benefitとrealized benefitを分離する。

## Evidence and provenance
- OpenAI API model/pricing documentation — provider-authored current pricing surface。input/cached input/output等のmeterを分離する根拠。`PRODUCT_VOLATILE`。2026-09-11 as-ofの調査証拠であり、公開時に再確認する。
- OpenAI GPT-4.1 API announcement — cached input割引とBatch API discountの条件付きcost surfaceを示すprovider evidence。`PRODUCT_VOLATILE`。
- Google Gemini Developer API pricing — Standard/Batch/Flex、input/output、context cache/storage、grounding等を別課金軸として扱うprovider evidence。`PRODUCT_VOLATILE`。
- Google Context caching — cache hit、cached-token usage、explicit caching条件を分離するprovider evidence。`PRODUCT_VOLATILE`。
- Google Flex inference — lower-price service modeとavailability/service constraintsを分離するprovider evidence。`PRODUCT_VOLATILE`。
- FinOps Foundation, Token Economics: The Atomic Unit of AI Value — AI spendをbusiness outcomeへattributionする実務context。provider billing仕様ではない。
- Brynjolfsson, Li, Raymond, Generative AI at Work — 5,179 customer-support agentsのfield study。平均productivity gainとskill別heterogeneityを示すcounterevidenceとして使用し、組織固有ROI保証へ外挿しない。

## Cost stack
最低限、以下を別surfaceとして記録する。

- model input / output / reasoning等のusage meter
- cached input、cache write/read/storage
- batch / flex / priority等のservice mode
- web/search/file/vector/retrieval/tool call
- storage / ingestion / indexing
- image/audio/video/computer/tool execution
- seat/license/commit/minimum-spend等のfixed charge
- compute/runtime/network/egress/self-host infrastructure
- observability/security/governance/admin
- human review/verification/escalation/correction/training/change management
- retry/failure/duplicate side effect
- procurement/support/tax/currency/contract allocation

provider間でmeter semanticsが異なるため、単一の「$/1M tokens」表だけをTCO比較としない。

## Cost model
以下は`PROPOSAL`であり、providerの請求式そのものではない。

`TOTAL_WORKLOAD_COST = model + tool/retrieval + storage + runtime/network + human + retry/failure + observability/governance + allocated fixed fees`

`COST_PER_ACCEPTED_TASK = total incremental workload cost / accepted successful tasks`

model selectionはtoken単価だけでなく、同一task set・同一acceptance thresholdで`COST_PER_ACCEPTED_TASK`、quality、latency、retry、human correctionを同時比較する。

Batch/cache/flex等は適用条件下でprovider usage costを下げ得るが、latency、model/tool availability、cache hit、storage、quality、人間補正を含む総原価まで一律に下げる保証ではない。

Agent workloadではloop length、branch count、tool calls、context growth、retry rate、escalation rate、human approval timeを観測する。低いmodel単価が低いaccepted-outcome costを保証するとは扱わない。

## ROI boundary
ROIは費用削減だけに限定しない。revenue uplift、capacity release、loss/risk avoidance等をbenefit categoryとして分離する。

以下は`PROPOSAL`であり、finance/accounting policyに依存するため普遍式として固定しない。

`REALIZED_ROI = (realized incremental benefit - incremental AI operating/workload cost) / incremental AI operating/workload cost`

baseline/counterfactual、benefit realization、配賦仮定、期間、uncertaintyを明示する。time savedは自動的にcash savedではない。人員、処理件数、売上等へ実際に転換されるまではcapacity benefitとして分離する。

## COST_EVENT_RECORD
`PROPOSAL`:
timestamp、workload/run/trace_id、provider/product/model/version、meter_type、quantity、unit_price、currency、price_source_as_of、cache/batch/tool class、retry_parent、cost_center、attribution_key。

## WORKLOAD_COST_PROFILE
`PROPOSAL`:
task family、fixed/variable/human/failure cost、accepted-task denominator、p50/p95/p99 run cost、latency、acceptance/error、human correction、provider version。

## ROI_CASE_RECORD
`PROPOSAL`:
baseline process/period、intervention、benefit category、gross benefit、incremental cost、realized_vs_estimated、horizon、attribution/confounder、uncertainty/sensitivity。

## PRICE_SNAPSHOT
`PROPOSAL`:
provider surface、model/tool/mode、captured_at、source URL、unit、list price、gate、superseded_by。

価格値は本文の普遍原則へ焼き込まず、as-of/source付きsnapshotとして別層に保持する。

## Evaluation
cost benchmarkは同じtask setとquality/acceptance thresholdを固定し、token数だけでなくsuccess/acceptance、human correction、latency、tool/retrieval、retryを同時記録する。run costはmeanだけでなくp50/p95/p99を保持する。

price-performance frontierは「安いモデルが勝つ」ではなく、要求品質を満たす最小end-to-end costを探す。外部生産性benchmark/field studyを自社ROI保証へ外挿しない。

## Security / privacy / audit / operability
低価格経路がretention、residency、tool routing、provider boundaryを変える場合、cost optimizationをgovernance回避に使用しない。

cost traceにはprompt本文や機微データを不必要に保存せず、request/workflow/tenant/model/version/pricing snapshotの識別子を分離する。price snapshot/as-of、run/trace ID、meter quantity、currency、cost-center、attribution ruleを監査可能にする。

budget/alert/quota、cost anomaly、retry cap、agent step cap、loop breaker、price drift detectionを運用controlに含める。non-idempotent actionのretryはAPI料金を超える業務損失を生み得るため、duplicate side effectを別failureとして扱う。

## Availability gates
plan/tier/region/org/billing account、negotiated contract、currency/tax、model/tool support、batch/cache/flex support、rate limit/quota、storage/retention、minimum spend/commitment、billing export権限、data residency、self-host infrastructure。

## Safe wording
- トークン単価は総原価の一部であり、企業運用では受入可能な成果単位のend-to-end costを併記する。
- 公開料金表はas-of時点のlist priceであり、個別契約の請求額やTCOを保証しない。
- Batch、cache、flex等は適用条件下でprovider usage costを下げ得るが、遅延・品質・人間確認・tool費用を含む総原価まで一律に下げるとは限らない。
- 特定研究の生産性改善率を自社ROIへ直接外挿しない。
- ROIはbaseline/counterfactual、benefit realization、配賦仮定、期間、uncertaintyを明示する。

## Test profiles
以下はすべて`UNEXECUTED`。

- TEST_PROFILE-017-A REAL_WORKLOAD_COST_LEDGER — representative task setでprovider usage meter、tool/retrieval、trace、human correctionを同一run IDへ紐付ける。認証/paid tenantが必要なため設計のみ。
- TEST_PROFILE-017-B RETRY_AMPLIFICATION — safe local/mock timeoutでretry、tool重複、cost amplificationを測る。実外部side effectは発生させない。
- TEST_PROFILE-017-C QUALITY_COST_FRONTIER — cheap/premium modelを同一golden task・同一acceptance thresholdで比較し、total cost、accept rate、latency、human correctionを測る。
- TEST_PROFILE-017-D ROI_BASELINE_SENSITIVITY — adoption、utilization、error/rework、time-to-cash conversion、benefit horizonを振り、ROIの仮定依存性を可視化する。
- TEST_PROFILE-017-E PRICE_DRIFT — 公式pricingを日付付きsnapshot化し、model/tool/billing mode変更時に同一workload costを再計算する。
- TEST_PROFILE-017-F AGENT_TAIL_COST — synthetic tool loop＋最大step capでp95/p99 costとloop breaker効果を測る。paid toolは呼ばない。

## Failure envelope / OPEN_UNKNOWN
- 低token価格でも、低品質→再試行→tool churn→human escalationが増えればaccepted-task単価は高くなり得る。
- 公開price pageはlist priceであり、個別enterprise contract、volume discount、commitment、tax、currency、support、minimum spendを証明しない。
- agent runはstep数とtool callが確率的で、平均値だけではloopやtail costを隠す。
- fixed license/admin/security/observabilityの配賦は組織会計方針に依存する。
- self-hostはGPU時間だけでなくcapex/depreciation、energy、utilization、ops、downtime、network等を含めないとcloud API比較と釣り合わない。
- `OPEN_UNKNOWN`: 個別enterprise discount/commit/tax/currency、実workload trace、acceptance/human correction、tenant billing export semantics、実security/governance/admin cost、benefit realization mechanism。
- provider price、billing unit、free allowance、tool billingは`PRODUCT_VOLATILE`であり、公開直前に再採集する。

NEXT: /agent/start.json
STOP: This is a knowledge projection, not an execution order.