PaymanAI
PaymanAI 提供代表 AI 代理发送和接收付款（法币和加密货币）的功能。要开始使用
- 在 app.paymanai.com 注册 以创建 AI 代理并获取您的 API 密钥。
- 设置 环境变量（`PAYMAN_API_SECRET` 用于您的 API 密钥，`PAYMAN_ENVIRONMENT` 用于沙盒或生产环境）。
本笔记简要介绍了如何将 PaymanAI 作为工具集成到 LangChain 中。有关完整参考，请参阅 API 文档。
概述
PaymanAI 集成是 `langchain-community`（或您的自定义）包的一部分。它允许您
- 发送付款（`send_payment`）到加密地址或银行账户。
- 搜索收款人（`search_payees`）。
- 添加新收款人（`add_payee`）。
- 通过托管结账链接向客户请求付款（`ask_for_money`）。
- 检查代理或客户余额（`get_balance`）。
这些可以封装成 LangChain 工具，供基于 LLM 的代理自动调用。
集成详情
| 类别 | 包 | 可序列化 | JS 支持 | 最新包版本 |
|---|---|---|---|---|
| PaymanAI | langchain-payman-tool | ❌ | ❌ | [PyPI 版本] |
如果您只是调用 PaymanAI SDK，可以直接或通过 LangChain 中的 Tool 接口进行。
设置
- 安装 PaymanAI 工具包
pip install langchain-payman-tool
- 安装 PaymanAI SDK
pip install paymanai
- 设置 环境变量
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
# Instantiate the PaymanAI tool (example)
tool = PaymanAI(
name="send_payment",
description="Send a payment to a specified payee.",
)
调用
直接使用参数调用
您可以调用 `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)
在链或代理中使用工具
您可以将 PaymanAI 工具绑定到支持工具调用的 LangChain 代理或链。
快速入门总结
- 在 app.paymanai.com 注册 以获取您的 API 密钥。
- 安装 依赖
pip install paymanai langchain-payman-tool - 导出 环境变量
export PAYMAN_API_SECRET="YOUR_SECRET_KEY"
export PAYMAN_ENVIRONMENT="sandbox" - 实例化 PaymanAI 工具，传入您所需的名称/描述。
- 使用 `.invoke(...)` 调用 工具，或将其集成到链或代理中。