Agent Toolkit

🚀 Visa Acceptance Agent Toolkit

Visa Acceptance Agent Toolkitは、VercelのAI SDKとVisa Acceptance API用のModel Context Protocol (MCP) とシームレスに統合されます。このツールキットは、請求書の管理、支払いリンクの作成、およびその他のVisa Acceptance関連の操作を支援するための専用ツールセットを提供します。

🚀 クイックスタート

Visa Acceptance Agent Toolkitは、VercelのAI SDKとModel Context Protocol (MCP) と連携し、Visa Acceptance APIに関する操作を行うためのツールキットです。以下に、このツールキットの使い方を説明します。

✨ 主な機能

• Vercel AI SDKとの完全統合 - 関数呼び出しとツールサポートを備えた完全な統合機能を提供します。
• Model Context Protocol (MCP) のサポート - 完全なMCPサーバー実装を備えています。

📦 インストール

ソースコードを変更せずにツールキットを使用する場合は、以下のコマンドでインストールします。

npm install @visaacceptance/agent-toolkit

必要条件

• Node 18+

💻 使用例

基本的な使用法

Visa Acceptanceアカウントの資格情報を使用してツールキットを構成します。これらの資格情報は、環境変数 (MERCHANT_ID, API_KEY_ID, SECRET_KEY) を使用して設定できます。

import { VisaAcceptanceAgentToolkit } from "@visaacceptance/agent-toolkit/ai-sdk";

const toolkit = new VisaAcceptanceAgentToolkit({
  merchantId: process.env.VISA_ACCEPTANCE_MERCHANT_ID,
  apiKeyId: process.env.VISA_ACCEPTANCE_API_KEY_ID,
  secretKey: process.env.VISA_ACCEPTANCE_SECRET_KEY,
  configuration: {
    actions: {
      invoices: {
        create: true,
        update: true,
        list: true,
        get: true,
        send: true,
        cancel: true
      },
      paymentLinks: {
        create: true,
        update: true,
        list: true,
        get: true,
      },
    },
  },
});

高度な使用法

VercelのAI SDKとこのツールキットを連携させるには、以下のようにします。

import { AI } from "@vercel/ai";
import { VisaAcceptanceAgentToolkit } from "@visaacceptance/agent-toolkit/ai-sdk";

const toolkit = new VisaAcceptanceAgentToolkit({
  merchantId: process.env.MERCHANT_ID,
  apiKeyId: process.env.API_KEY_ID,
  secretKey: process.env.SECRET_KEY,
  configuration: {
    actions: {
      invoices: {
        create: true,
      }
    },
  },
});

const ai = new AI({
  tools: toolkit.getTools(),
});

// サンプルの使用方法:
const response = await ai.run({
  messages: [{ role: "user", content: "Please create an invoice for $200" }],
});

コンテキストの設定

configuration.context ブロックを使用して、デフォルトの動作や環境を設定できます。たとえば、テスト環境を有効にするには、以下のようにします。

const toolkit = new VisaAcceptanceAgentToolkit({
  merchantId: process.env.MERCHANT_ID,
  apiKeyId: process.env.API_KEY_ID,
  secretKey: process.env.SECRET_KEY,
  configuration: {
    context: {
      environment: "SANDBOX",
    },
  },
});

📚 ドキュメント

Model Context Protocolのサポート

Model Context Protocol (MCP) もサポートされています。以下のコマンドでVisa Acceptance MCPサーバーを起動できます。

npx -y @visaacceptance/mcp --tools=all --merchant-id=YOUR_MERCHANT_ID --api-key-id=YOUR_API_KEY_ID --secret-key=YOUR_SECRET_KEY

サポートされているAPIメソッド

このツールキットは、現在以下のVisa Acceptance操作を提供しています。

• 請求書関連

  • 請求書の作成 - 顧客情報と拡張パラメータを使用して新しい請求書を作成します。
  • 請求書の更新 - 顧客情報や請求書情報を含む既存の請求書の詳細を更新します。
  • 請求書の一覧取得 - フィルタリングオプションを使用して、ページングされた請求書の一覧を取得します。
  • 請求書の詳細取得 - 特定の請求書の詳細情報を取得します。
  • 請求書の送信 - 請求書を電子メールで顧客に送信します。
  • 請求書のキャンセル - 既存の請求書をキャンセルします。

• 支払いリンク関連

  • 支払いリンクの作成 - オプションの配送情報を使用して新しい支払いリンクを作成します。
  • 支払いリンクの更新 - 既存の支払いリンクの詳細を更新します。
  • 支払いリンクの一覧取得 - ページングされた支払いリンクの一覧を取得します。
  • 支払いリンクの詳細取得 - 特定の支払いリンクの詳細を取得します。

🔧 注意事項

AIによって生成されたコンテンツは、不正確または不完全な場合があります。ユーザーは、特に財務上の決定に関して、情報を信頼する前に必ず確認する責任があります。Visa Acceptanceは、AIの出力またはこのツールキットに起因するいかなる使用、決定、または損害に対しても責任を負いません。

📄 ライセンス

MIT