Pebbler Human Feedback

Pebbler MCP

エージェントが2枚の画像について人々からフィードバックを集め、結果を説明できるようにします。Pebbler は Pebbler app の参加者を対象に、画像の選好テストを実施します。

テストを作成する前に、エージェントは最新の料金、パッケージの詳細、提供状況を取得します。購入には最新の見積もりが使われ、設定した支出上限を超えることはありません。料金とパッケージのサイズは、このコネクターでは固定されていません。

バージョン 1 では、画像の A/B 選好テストに対応しています。これは、商品のコンバージョンや因果効果ではなく、人々がどちらの画像を好むかを測定するものです。回答数の達成は保証されません。アンケートとテキストのみの比較には対応していません。

エージェントを接続する

ローカルサーバーと Node.js 22 以降に対応した MCP アプリを使用してください。次の設定をアプリに追加します。

{
    "mcpServers": {
        "pebbler": {
            "command": "npx",
            "args": ["-y", "@pebbler/[email protected]"]
        }
    }
}

Pebbler の本番環境の設定が含まれています。支払いを有効にせずに、現在のパッケージを確認したり、下書きを作成したりできます。

購入を有効にする

Base 上のネイティブ USDC で資金を用意した専用ウォレットを使用してください。MCP アプリの環境設定またはシークレット設定で、次の値をローカルに設定します。

設定	指定する値
PEBBLER_ALLOW_PAYMENTS	エージェントに購入させる場合は true に設定します
PEBBLER_WALLET_PRIVATE_KEY	ウォレットの署名キーを、非公開で指定します
PEBBLER_MAX_PURCHASE_USDC	テストごとの希望する最大支出額を、正の小数の USDC 額で指定します
PEBBLER_MAX_TOTAL_USDC	希望する累計支出上限を、正の小数の USDC 額で指定します

支払いを有効にするには、両方の支出上限が必要です。これらは予算であり、テストの価格ではありません。見積もりがいずれかの上限を超えると、コネクターは予算を引き上げるのではなく、処理を停止します。支払いは、明示的に有効にするまで無効のままです。

ウォレットキーはローカルに保持されます。プロンプトに記載したり、会話で共有したりしないでください。価格と見積もりはエージェントが取得するため、設定する必要はありません。

テストを依頼する

例：

現在のパッケージと価格を確認してから、この2つの画像 URL を比較してください。購入前に見積もりを知らせ、設定済みの予算内に収めてください。

一般公開されている HTTPS 画像 URL を2つと、明確な質問を指定してください。自分が所有する画像、または使用許可を得ている画像を使い、回答の収集中は URL にアクセスできる状態にしてください。

エージェントは現在のオファーを表示し、下書きを作成し、テストを購入して進行状況を確認できます。収集の続行中に途中経過を読み取ることも、後で戻って最終的な回答数と投票率を尋ねることもできます。結果の取得は購入に含まれています。

利用可能なツール

ツール	用途
get_catalog	現在のパッケージ、価格、対応する入力、提供状況を取得します
create_study	画像比較を準備し、見積もりを取得します
quote_study	支払いに署名する前に見積もりを更新します
purchase_study	ウォレットの支出上限内で、見積もり済みのテストを購入します
get_study_status	進行状況と次回の確認時期を確認します
get_study_results	集計された A/B 投票数と投票率を取得します
list_local_studies	戻ってきたときや再起動後に、保存済みのテストを探します

接続すると、エージェントは各ツールの入力を自動的に把握します。まずカタログを読み取り、購入には見積もりを使用し、進行状況を確認する際は返されたポーリング間隔に従う必要があります。

結果を再び確認する

コネクターのプライベートなローカル状態フォルダーをバックアップしておいてください。このフォルダーにはテストへのアクセス情報と購入履歴が保持され、再起動後も利用できます。PEBBLER_STATE_DIR でフォルダーを指定できます。既存のテストを再び利用する際は、同じフォルダーを使ってください。

合計支出上限には、未解決の試行を含め、保持されている署名済みの購入がカウントされ、自動ではリセットされません。テストをさらに購入する場合は、意図的に上限を引き上げてください。予算をリセットするために元の状態を削除しないでください。

購入が中断または保留中の場合は、エージェントに同じ購入を再試行するよう依頼してください。コネクターは別の支払いに署名するのではなく、識別子と支払い承認を保持します。進捗や結果の確認に、追加の購入は必要ありません。

例を試す

同梱の examples/run-study.mjs は、検出と画像比較の作成方法を示しています。ライブカタログと見積もりが出力されます。購入には --purchase フラグと、ローカルで設定したウォレットおよび予算が必要です。

ライセンス

MIT。オリジナルのサンプル画像アセットも同じライセンスで提供されています。