check

Stub レシピ

AI エージェント向けの忠誠性レシートレジストリである Stub の、動作するリファレンス連携です。

各レシピは、ランキングで勝者が決まる行に Stub を組み込んだ、実行可能なエージェントです。どれかをクローンして実行し、生成されるレシートを確認してください。

ここにある各レシピはリファレンスであり、シミュレーションです。実際の加盟店も、実際のお金も、実際のユーザーも関与しません。本番環境で実行している人はおらず、各 README にその旨が記載されています。目的は、皆さんが見覚えのあるコードのどこにレシートを含めるべきかを、正確に示すことです。

レシピ

レシピ	内容	言語
tool-loop	あらゆるフレームワークがラップする基本要素です。モデル、2 つのツール、ループで構成されます。	JavaScript
acp-commerce	忠誠性はチェックアウトの上流、ランキングにあります。	JavaScript
mcp	あらゆるエージェントが追加できる公開チェックサーバーと、オペレーター発行パターンです。	JavaScript
langchain-python	LangChain エージェント内での同じ連携です。	Python
vercel-ai-sdk	JavaScript で最大のエージェント向けインターフェースです。	JavaScript
insurance-advice	コマース以外での基本要素と、現実的な利害です。	Python

すべてのレシピは実際のレジストリを使って実行され、選択したオペレーター ID のもとで実際のレシートを発行します。無料プランでは月に 1,000 件のスタブを利用できるため、6 つすべてを試しても費用はかかりません。オフラインモードもモックレジストリもありません。スタブを発行する唯一の方法は、実際に発行することです。

上のバッジについて

これらのレシピは毎日実際のレジストリを使ってテストされており、バッジにはその実行で生成されたレシートが表示されます。ビルドのステータスではありません。リファレンスエージェントがカタログをランキングし、結果に影響した要因を開示し、誰でも確認できる署名済みレコードを発行したことを示しています。クリックして内容を確認してください。

表示が途切れた場合は、レシピが動作しなくなったことを、このリポジトリがクローンされる前に知らせています。

まずはこちら

初めての場合は、まず tool-loop を読んでください。最も小さなレシピであり、ほかのレシピが繰り返し伝える教訓も示しています。モデルの動作に問題があったのではなく、ランキングが決めたのです。

cd tool-loop
npm install
export STUB_OPERATOR_ID=op_yourname_toolloop
npm run demo

自分のオペレーター ID を選んでください。初回実行時に登録され、キーペアが .stub-keys.json に保存されます。このファイルは gitignore の対象です。以降の実行では、同じ ID が使われます。

デモでは、コードが生成したランキングと各項目の理由が表示され、その後、誰でも開けるレシートリンクが表示されます。

デプロイの準備ができたら

レシピは実行のたびに新しいキーペアを生成します。読み取りには適切ですが、本番環境での利用には適しません。 PRODUCTION.md では、何を変更すべきかを説明しています。ID の永続化方法、レシートを置く場所、フリーテキストに絶対に含めてはいけない情報、そして自分たちのエージェントを本番環境に投入する際に犯した間違いについてです。

スタブとは

エージェントが誰かのために行動するとき、誰が依頼したか、何を行ったか、どのようなお金が動いたか、どのような商業的影響があったかを記録した、小さな署名付きレコードを発行します。サービスを受ける人は、中立的なレジストリでそれを確認します。あなたのサーバー上でも、私たちのサーバー上でもありません。

何かをインストールする前に、実際のレコードをご覧ください。

https://api.getstub.dev/check/72b4baee1719ec34acc5df5c514a12fd2e19b9a6776de4b45706988f765c77d8

連携の全体像

import { Stub, influenced } from '@getstub/agent';

const stub = new Stub({
  operator: 'Your Agent',
  declared: {
    paid_by: 'the user, subscription',
    conflicts: ['commission'],
  },
});

// at the line where your ranker picks a winner:
const inf = [];
if (pick.paid_placement) inf.push(influenced.placement(pick.seller));
if (pick.commission_pct) inf.push(influenced.commission(pick.commission_pct + '%'));

const receipt = await stub.issue({
  principal: user.id,        // hashed on your side, never sent raw
  agent: 'your-agent',
  requested: query,
  done: `booked ${pick.name}`,
  value_moved: { amount: pick.price, currency: 'USD' },
  not_disclosed: inf,        // an empty array is signed proof none applied
});

Python でも同じ形です。

from getstub import Stub, influenced

よくある 2 つのこと

開示情報を手作業で書く必要はありません。 ランキングコードは、コミッションや掲載料が結果に影響したことをすでに把握しています。そうした要因を適用したのがランキングコードだからです。レシートは同じ行で同じフラグを読み取ります。ランキングの規模に合わせて対応できます。

開示情報が空でも、何もないわけではありません。 それは、事業には利益相反が存在するものの、今回の行動にはどれも影響しなかったことを示す署名です。それは沈黙よりも価値があり、誠実なオペレーターにとってここで得られるものがある理由でもあります。

インストール

npm install @getstub/agent
pip install getstub

どちらのクライアントも同じ正規形式に署名します。これは前提ではなく、検証によって確認されます。Python のテストスイートがスタブに署名し、レジストリコードがそれを検証します。

無料プラン

月1,000件のスタブをご利用いただけます。確認は永久に無料です。確認を受ける側に料金を請求しては、本来の目的に反するためです。

リンク

• getstub.dev
• レジストリ：https://api.getstub.dev
• 証明者キー：https://api.getstub.dev/witness
• 運営者一覧：https://api.getstub.dev/directory

Copyright Stub 2026