Agent Toolkit

🚀 签证受理代理工具包

签证受理代理工具包可与 Vercel 的 AI SDK 以及用于签证受理 API 的模型上下文协议（MCP）实现无缝集成。它提供了一套专门的工具，旨在帮助你管理发票、创建支付链接以及执行其他与签证受理相关的操作。

🚀 快速开始

本工具包可与 Vercel 的 AI SDK 和模型上下文协议（MCP）集成，助力你完成签证受理相关的操作。以下是使用本工具包的相关信息。

✨ 主要特性

• Vercel AI SDK - 与函数调用和工具支持实现全面集成
• 模型上下文协议（MCP） - 完整的 MCP 服务器实现

📦 安装指南

TypeScript

如果你只是想使用该工具包而不修改其源代码，请通过以下命令进行安装：

npm install @visaacceptance/agent-toolkit

要求

• Node 18+

💻 使用示例

基础用法

使用你的签证受理账户凭证配置工具包。这些凭证可以通过环境变量（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 集成

要将此工具包与 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",
    },
  },
});

🔧 技术细节

模型上下文协议

模型上下文协议（MCP） 也受支持。你可以使用以下命令运行签证受理 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 方法

该工具包目前提供以下签证受理操作：

• 发票
  • 创建发票 - 使用客户信息和增强参数创建新发票
  • 更新发票 - 更新现有发票的详细信息，包括客户和发票信息
  • 列出发票 - 使用过滤选项检索分页的发票列表
  • 获取发票 - 检索特定发票的详细信息
  • 发送发票 - 通过电子邮件将发票发送给客户
  • 取消发票 - 取消现有发票
• 支付链接
  • 创建支付链接 - 使用可选的运输信息创建新的支付链接
  • 更新支付链接 - 更新现有支付链接的详细信息
  • 列出支付链接 - 检索分页的支付链接列表
  • 获取支付链接 - 检索特定支付链接的详细信息

📄 许可证

本项目采用 MIT 许可证。

⚠️ 重要提示

AI 生成的内容可能不准确或不完整。用户在依赖任何信息之前，尤其是在进行财务决策时，应完全负责核实信息。签证受理方对因 AI 输出或本工具包导致的任何使用、决策或损害不承担责任。