コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

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

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

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

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

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

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

Python
No results
import asyncio
import os
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={
        "actions": {
            "payment_links": {
                "create": True,
            },
            "products": {
                "create": True,
            },
            "prices": {
                "create": True,
            },
        }
    },
)

agent = Agent(
    name="Stripe Agent",
    instructions="Integrate with Stripe effectively to support business needs.",
    tools=stripe_agent_toolkit.get_tools()
)

async def main():
    assignment = "Create a payment link for a new product called \"Test\" with a price of $100."

    result = await Runner.run(agent, assignment)

    print(result.final_output)

if __name__ == "__main__":
    asyncio.run(main())

開発者プレビュー

この 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"),
        },
    ),
)

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

モデルコンテキストプロトコル (MCP) は、アプリケーションが LLM にコンテキストを提供する方法を標準化するためのオープンプロトコルです。Stripe Agent ツールキットは、Cloudflare のエージェント SDK でホストされている MCP サーバーへのツール呼び出しを収益化するためのラッパー関数を提供します。

サンプル全体を表示
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",
});

To search Stripe documentation and query your Stripe data, use the Stripe MCP server.

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

  • Issuing: ビジネスでの購入用に 1 回のみ使用できるバーチャルカードを作成します。これにより、エージェントは資金を使うことができます。Issuing の API を使用すると、プログラムでオーソリを承認または拒否でき、購入の意図が試行されたオーソリと一致していることを確認できます。支出管理により、エージェントの予算を設定し、支出を制限できます。
  • Order Intents: Give your agents commerce capabilities through programmatic execution of purchases online. This agentic API helps facilitate variant and fulfillment selections and manage the order lifecycle. To join the private preview, fill out the form below.

次のステップ

このページはお役に立ちましたか。
はいいいえ