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_community	❌	❌	[PyPI Version]

如果你只是简单地调用 PaymanAI SDK，你可以直接或通过 LangChain 中的 Tool 界面进行调用。

设置

1. 安装langchain-community（或同等）软件包：

pip install --quiet -U langchain-community

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_community.tools.langchain_payman_tool.tool import PaymanAI

# Instantiate the PaymanAI tool (example)
tool = PaymanAI(
    name="send_payment",
    description="Send a payment to a specified payee.",
)

调用

使用 args 直接调用

您可以调用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 可能会生成ToolCalldict 中。您可以按如下方式进行模拟：

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 密钥。
2. 安装依赖项：

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

   export PAYMAN_API_SECRET="YOUR_SECRET_KEY"
   export PAYMAN_ENVIRONMENT="sandbox"
4. 实例化 PaymanAI 工具，传递所需的名称/描述。
5. 使用 调用.invoke(...)或将其集成到链或代理中。

API 参考

您可以在以下位置找到 PaymanAI 的完整 API 文档：

• Langchain-Payman Python 参考
• Payman 文档

链接

from langchain_core.prompts import ChatPromptTemplate
from langchain_core.runnables import RunnableConfig, chain
from langchain.chat_models import init_chat_model

# Assume we've imported your PaymanAITool or multiple Payman AI Tools
payman_tool = PaymanAITool(name="send_payment")

# Build a prompt
prompt = ChatPromptTemplate([
    ("system", "You are a helpful AI that can send payments if asked."),
    ("human", "{user_input}"),
    ("placeholder", "{messages}"),
])

llm = init_chat_model(model="gpt-4", model_provider="openai")
llm_with_tools = llm.bind_tools([payman_tool], tool_choice=payman_tool.name)

llm_chain = prompt | llm_with_tools

@chain
def tool_chain(user_input: str, config: RunnableConfig):
    input_ = {"user_input": user_input}
    ai_msg = llm_chain.invoke(input_, config=config)
    tool_msgs = payman_tool.batch(ai_msg.tool_calls, config=config)
    return llm_chain.invoke({**input_, "messages": [ai_msg, *tool_msgs]}, config=config)

# Example usage:
response = tool_chain.invoke("Send $10 to payee123.")
print(response)```

## API reference

You can find full API documentation for PaymanAI at:

- [Python reference](https://python.langchain.com/v0.2/api_reference/community/tools/langchain_community.tools.langchain_payman_tool.tool.PaymanAI.html)
- (Any other relevant references or doc links)


## Related
- Tool [conceptual guide](/docs/concepts/tools)
- Tool [how-to guides](/docs/how_to/#tools)

API 参考：ChatPromptTemplate | RunnableConfig | 链条 | init_chat_model