PaymanAI

PaymanAI 提供代表 AI 代理發送和接收付款（法幣和加密貨幣）的功能。若要開始使用

1. 請在 app.paymanai.com 註冊以建立 AI 代理並取得您的 API 金鑰。
2. 設定 環境變數 (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 介面呼叫。

設定

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

# 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 代理或鏈。

快速入門摘要

1. 在 app.paymanai.com 註冊以取得您的 API 金鑰。
2. 安裝 相依性

   pip install paymanai langchain-payman-tool
3. 匯出 環境變數

   export PAYMAN_API_SECRET="YOUR_SECRET_KEY"
   export PAYMAN_ENVIRONMENT="sandbox"
4. 實例化 PaymanAI 工具，傳遞您想要的名稱/描述。
5. 使用 .invoke(...) 呼叫 工具，或將其整合到鏈或代理中。