ForHosting KIT · 開発者向けツール

2人協力ゲームのシャープレイ値計算ツール

2人用シャープレイ値計算ツールは、参加順序が異なる2通りの場合に各プレイヤーが生み出す貢献を基に、協力で得られる価値を配分します。プレイヤー1とプレイヤー2が単独で生み出す価値、および共同で生み出す価値を入力してください。各プレイヤーの配分額、協力による余剰または不足、計算に用いた大提携の価値が表示されます。収益分配、費用配賦、提携分析、交渉準備、協力ゲーム理論の演習に利用できます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

3つの提携価値を同じ基準で定義します

2人の協力ゲームでは、空提携の価値をゼロとするため、3つの価値が必要です。プレイヤー1の価値にはプレイヤー2がいない場合に生み出せる額を入力し、プレイヤー2についても同じ範囲と基準で評価してください。次に、両者が参加したときに生まれる大提携の価値を入力します。3つの数値は、同じ成果、通貨、期間、会計範囲を表す必要があります。たとえば、一方の月間利益と提携全体の年間売上を比較したり、単独価値を総売上、共同価値を純利益で表したりしないでください。正数、ゼロ、負数を入力できるため、符号を一貫して扱えば、便益、費用、損失、債務も表現できます。本ツールは共同価値の全額を2人に配分するものとします。契約、予測、労力、持分、交渉力から価値を推定する機能はありません。分析を行う方が各価値を適切に設定してください。

2人のシャープレイ配分を計算する仕組み

シャープレイ法では、参加者が考えられるすべての順序で提携に加わった場合に、各プレイヤーが追加する限界貢献を求め、その平均を取ります。2人の場合、順序は2通りだけです。プレイヤー1が先に参加すると、その貢献は単独価値 v({1}) です。後から参加すると、共同価値 v({1,2}) からプレイヤー2の単独価値 v({2}) を引いた額になります。この2つの平均がプレイヤー1のシャープレイ値であり、プレイヤー2も対称に計算します。同じ結果を得る簡便な方法では、v({1,2}) - v({1}) - v({2}) により協力余剰を求め、その半分を各プレイヤーの単独価値に加えます。したがって、表示用の数値調整前には、2つの配分の合計が大提携の価値と正確に一致します。協力によって不足が生じる場合も、その負の額を均等に分担します。総価値を単純に半分ずつ分けるのではなく、単独で生み出す価値を保ったうえで、協力による増減だけを等分する方法です。

結果を解釈し、モデルが適切か確認します

各シャープレイ値は、根拠のある配分基準としてお使いください。法的権利を自動的に決めるものでも、交渉の最終結果を示すものでもありません。この方法は2つの配分で大提携の価値を使い切るため効率性を満たし、貢献が同じプレイヤーを対称に扱います。また、単独で価値を生み出す能力も反映されます。単独価値が高い側は一般に多くを受け取りますが、2人ゲームの協力余剰は均等に分けられます。余剰が正なら共同生産が単独生産の合計を上回り、負なら共同成果が下回るため、各配分が不足分の半分を負担します。採用前に、価値を両者間で移転できるか、3つの提携価値に重要な効果がすべて含まれるかを確認してください。最低支払額、所有権、リスク調整、税、その他の契約条件は基本モデルに含まれません。本計算は2人専用であり、3人以上では追加の提携価値と異なる組合せ上の重みが必要です。入力と仮定を記録し、数式上の公平性と価値評価に用いた判断を明確に区別してください。

活用例

提携事業の収益を配分

各パートナーが単独で生み出せる価値を維持しながら、共同プロジェクトの価値を分配します。

協力で生じた節約額を共有

調達、物流、インフラに関する2者間の協力で増えた節約額を公平に分けます。

ゲーム理論の演習を検算

2人の配分、協力余剰、解の効率性をまとめて確認します。

よくある質問

どの計算式を使用しますか？

プレイヤー1の配分は [v({1}) + v({1,2}) - v({2})] / 2、プレイヤー2の配分は [v({2}) + v({1,2}) - v({1})] / 2 です。

協力余剰を均等に分けるのはなぜですか？

2通りの参加順序では、各プレイヤーが1回ずつ先と後になります。限界貢献の平均を取ると、追加価値の半分ずつが配分されます。

協力余剰が負になることはありますか？

はい。大提携の価値が2つの単独価値の合計より小さい場合は負となり、シャープレイ法ではその不足を均等に分担します。

2つの配分の合計は大提携の価値になりますか？

はい。2人のシャープレイ配分は効率性を満たし、入力された共同価値をすべて配分します。

3人以上にも対応していますか？

いいえ。参加者が増えると、追加の提携価値と、より多くの参加順序にわたる限界貢献の平均が必要です。

APIでの計算料金はいくらですか？

APIリクエスト1回の料金は$0.002です。同じ決定論的な計算をブラウザーで無料実行することもできます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/econ/shapley-value-two-player

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/econ/shapley-value-two-player \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"grand_coalition_value":140,"player_one_value":40,"player_two_value":60}'

const res = await fetch("https://api.kit.forhosting.com/econ/shapley-value-two-player", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "grand_coalition_value": 140,
    "player_one_value": 40,
    "player_two_value": 60
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/econ/shapley-value-two-player",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "grand_coalition_value": 140,
    "player_one_value": 40,
    "player_two_value": 60
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/econ/shapley-value-two-player", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"grand_coalition_value":140,"player_one_value":40,"player_two_value":60}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"grand_coalition_value":140,"player_one_value":40,"player_two_value":60}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/econ/shapley-value-two-player", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "grand_coalition_value": 140,
  "player_one_value": 40,
  "player_two_value": 60
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "econ.shapley_value_two_player",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →