エージェントワークフローに Stripe を追加する

エージェントで金融サービスを使用します。

Stripe を利用してエージェントビジネスを運営し、エージェントの機能を強化します。金融サービスとツールへのアクセスを提供すると、エージェントは資金の獲得と利用をサポートできるようになり、その機能を拡張できます。

Stripe オブジェクトを作成する

関数呼び出しを使用して Stripe オブジェクトを作成し、管理します。たとえば、資金を受け取るための Payment Links を動的に作成し、顧客をサポートするためのサポートワークフローに導入し、テストデータを作成します。

Stripe のエージェントツールキットは、OpenAI の Agents SDK、Vercel の AI SDK、LangChain、CrewAI をサポートしています。関数呼び出しをサポートし、Python および TypeScript と互換性のある任意の LLM プロバイダーで動作します。

開発者プレビュー

この SDK を使用して、Stripe とエージェントワークフローを連携させる方法をご紹介します。エージェントの動作は非決定論的であるため、一度サンドボックスで SDK を使用し、アプリケーションのパフォーマンスを評価します。さらに、制限付き API キーを使用して、エージェントが必要とする機能へのアクセスを制限します。

代理人使用料を請求する

エージェント SDK

従量課金を実装して、使用量を記録します。Stripe のエージェントツールキットは、OpenAI Agents SDK と Vercel AI SDK でのプロンプトと完了トークンによる請求をネイティブでサポートしています。入出力メーターイベントの Customer と event_name を使用して、LLM のコストをユーザーに直接転送できます。

from agents import Agent, Runner
from stripe_agent_toolkit.openai.toolkit import StripeAgentToolkit

stripe_agent_toolkit = StripeAgentToolkit(
    secret_key=os.getenv("STRIPE_SECRET_KEY"),
    configuration={}
)

agent = Agent(
    name="Agent",
    instructions="Integrate with Stripe effectively to support business needs.",
    hooks=stripe_agent_toolkit.billing_hook(
        type="token",
        customer=os.getenv("STRIPE_CUSTOMER_ID"),
        meters={
            "input": os.getenv("STRIPE_METER_INPUT"),
            "output": os.getenv("STRIPE_METER_OUTPUT"),
        },
    ),
)

モデルコンテキストプロトコルサーバー公開プレビュー版

Model Context Protocol(MCP) は、アプリケーションが LLM にコンテキストを提供する方法を標準化するためのオープンプロトコルです。Stripe Agent ツールキットは、ホスティングされた MCP サーバー上のツールコールを収益化するラッパー機能を提供します。

詳細は Cloudflare の Agent SDK ドキュメントを参照してください。

サンプル全体を表示
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";
import { McpAgent } from "agents/mcp";
import { generateImage } from "./imageGenerator";
import { OAuthProvider } from "@cloudflare/workers-oauth-provider";
import {
  PaymentState,
  experimental_PaidMcpAgent as PaidMcpAgent,
} from '@stripe/agent-toolkit/cloudflare';
import app from "./app";

type Bindings = Env;

type Props = {
  // Populate this via OAuth
  userEmail: string;
};

type State = {};

export class MyMCP extends PaidMcpAgent<Bindings, State, Props> {
  server = new McpServer({
    name: "Demo",
    version: "1.0.0",
  });

  initialState: State = {};

  async init() {
    // Usage-based metered payments (Each tool call requires a payment)
    this.paidTool(
      'generate_emoji',
      'Generate an emoji given a single word (the `object` parameter describing the emoji)',
      {
        object: z.string().describe('one word'),
      },
      ({object}) => {
        return {
          content: [{type: 'text', text: generateImage(object)}],
        };
      },
      {
        checkout: {
          success_url: '{{SUCCESS_URL}}',
          line_items: [
            {
              price: '{{PRICE_ID}}'
,
            },
          ],
          mode: 'subscription',
        },
        meterEvent: 'image_generation',
        paymentReason: 'You get 3 free generations, then we charge 10 cents per generation.',
      }
    );
  }
}

export default new OAuthProvider({
  apiRoute: "/sse",
  apiHandler: MyMCP.mount("/sse"),
  defaultHandler: app,
  authorizeEndpoint: "/authorize",
  tokenEndpoint: "/token",
  clientRegistrationEndpoint: "/register",
});

Stripe ドキュメントの検索および Stripe データへのクエリには、Stripe MCP サーバーをご利用ください。

オンラインで商品を購入するプライベートプレビュー版

Issuing: ビジネスでの購入用に 1 回のみ使用できるバーチャルカードを作成します。これにより、エージェントは資金を使うことができます。Issuing の API を使用すると、プログラムでオーソリを承認または拒否でき、購入の意図が試行されたオーソリと一致していることを確認できます。支出管理により、エージェントの予算を設定し、支出を制限できます。