PaymanAI

PaymanAI 提供代表 AI Agent 发送和接收付款（法定货币和加密货币）的功能。开始之前：

1. 在 app.paymanai.com 注册 以创建 AI Agent 并获取您的 API Key。
2. 设置环境变量（PAYMAN_API_SECRET 用于您的 API Key，PAYMAN_ENVIRONMENT 用于沙盒或生产环境）。

本 Notebook 简要概述了将 PaymanAI 集成到 LangChain 中作为工具。有关完整参考，请参阅 API 文档。

概述

PaymanAI 集成是 langchain-community（或您的自定义）包的一部分。它允许您：

• 向加密货币地址或银行账户发送付款 (send_payment)。
• 搜索收款人 (search_payees)。
• 添加新收款人 (add_payee)。
• 向客户收款，并提供托管的结账链接 (ask_for_money)。
• 查询代理或客户的余额 (get_balance)。

这些可以被包装成LangChain 工具，供基于 LLM 的 Agent 自动调用。

集成详情

Class	Package	Serializable	JS support	Package latest
PaymanAI	langchain-payman-tool	❌	❌	[PyPI Version]

如果您只是调用 PaymanAI SDK，可以直接调用，或者通过 LangChain 中的工具接口进行调用。

设置

1. 安装 PaymanAI 工具包：

pip install langchain-payman-tool

2. 安装 PaymanAI SDK：

pip install paymanai

3. 设置环境变量：

export PAYMAN_API_SECRET="YOUR_SECRET_KEY"
export PAYMAN_ENVIRONMENT="sandbox"

您的 PAYMAN_API_SECRET 应该是来自 app.paymanai.com 的密钥。PAYMAN_ENVIRONMENT 可以是 sandbox 或 production，具体取决于您的使用场景。

实例化

这是一个实例化 PaymanAI 工具的示例。如果您有多个 Payman 方法，可以创建多个工具。

from langchain_payman_tool.tool import PaymanAI

# 实例化 PaymanAI 工具（示例）
tool = PaymanAI(
    name="send_payment",
    description="向指定的收款人发送付款。",
)

调用

直接使用参数调用

您可以调用 tool.invoke(...) 并传递一个与工具预期字段匹配的字典。例如：

response = tool.invoke({
    "amount_decimal": 10.00,
    "payment_destination_id": "abc123",
    "customer_id": "cust_001",
    "memo": "Payment for invoice #XYZ"
})

使用 ToolCall 调用

当在 AI 工作流中使用时，LLM 可能会生成一个 ToolCall 字典。您可以按如下方式模拟它：

model_generated_tool_call = {
    "args": {
        "amount_decimal": 10.00,
        "payment_destination_id": "abc123"
    },
    "id": "1",
    "name": tool.name,
    "type": "tool_call",
}
tool.invoke(model_generated_tool_call)

在 Chain 或 Agent 中使用工具

您可以将 PaymanAI 工具绑定到支持工具调用的 LangChain agent 或 chain。

快速入门摘要

1. 在 app.paymanai.com 注册以获取您的API Key。
2. 安装依赖项：

   pip install paymanai langchain-payman-tool
3. 导出环境变量：

   export PAYMAN_API_SECRET="YOUR_SECRET_KEY"
   export PAYMAN_ENVIRONMENT="sandbox"
4. 实例化一个 PaymanAI 工具，传入您想要的名称/描述。
5. 使用 .invoke(...) 调用该工具，或将其集成到 chain 或 agent 中。