> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ampersend 集成

> 使 LangChain 代理能够支付并使用远程 AI 代理服务。

[Ampersend](https://ampersend.ai) 使 LangChain 代理能够支付并使用远程 AI 代理服务。支付通过 [x402](https://www.x402.org/) 协议透明处理，并以 [A2A](https://google.github.io/A2A/) 作为通信层。

## 概述

### 集成详情

| 类            | 包                     | 可序列化 | JS 支持 |                                                 版本                                                |
| :----------- | :-------------------- | :--: | :---: | :-----------------------------------------------------------------------------------------------: |
| `A2AToolkit` | `langchain-ampersend` |   ❌  |   ❌   | ![PyPI - Version](https://img.shields.io/pypi/v/langchain-ampersend?style=flat-square\&label=%20) |

### 工具功能

1. **a2a\_get\_agent\_details** - 获取远程代理的能力
2. **a2a\_send\_message** - 向远程代理发送消息（支付自动处理）

### 主要特性

* **支出控制**：可插拔的支付授权，支持限额和策略
* **透明支付**：x402 协议自动处理支付协商

***

## 设置

### 安装

安装 `langchain-ampersend` 包：

<CodeGroup>
  ```python pip theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  pip install -U langchain-ampersend
  ```

  ```python uv theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  uv add langchain-ampersend
  ```
</CodeGroup>

### 凭证

该工具包需要一个会话密钥和智能账户地址，您可以从 [Ampersend 控制面板](https://app.ampersend.ai) 获取。

```python 设置凭证 icon="key" theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import os

SESSION_KEY = os.environ.get("AMPERSEND_SESSION_KEY")  # 0x...
SMART_ACCOUNT_ADDRESS = os.environ.get("AMPERSEND_SMART_ACCOUNT_ADDRESS")  # 0x...
```

***

## 实例化

```python 初始化工具包 icon="robot" theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
from langchain_ampersend import (
    A2AToolkit,
    AmpersendTreasurer,
    ApiClient,
    ApiClientOptions,
    SmartAccountConfig,
    SmartAccountWallet,
)

# 设置钱包
wallet = SmartAccountWallet(
    config=SmartAccountConfig(
        session_key=SESSION_KEY,
        smart_account_address=SMART_ACCOUNT_ADDRESS,
    )
)

# 设置财务官
treasurer = AmpersendTreasurer(
    api_client=ApiClient(
        options=ApiClientOptions(
            base_url="https://api.ampersend.ai",
            session_key_private_key=SESSION_KEY,
        )
    ),
    wallet=wallet,
)

# 创建工具包
toolkit = A2AToolkit(
    remote_agent_url="https://agent.example.com",
    treasurer=treasurer,
)

await toolkit.initialize()
```

***

## 调用

向远程代理发送消息：

```python 发送消息 icon="message" theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
tools = toolkit.get_tools()
send_tool = tools[1]  # a2a_send_message
response = await send_tool.ainvoke({"message": "分析第四季度的销售趋势"})
print(response)
```

***

## 在代理中使用

```python 创建代理 icon="robot" theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
from langchain.agents import create_agent
from langchain_anthropic import ChatAnthropic

# 初始化 LLM
llm = ChatAnthropic(model="claude-sonnet-4-20250514")

# 从工具包获取工具
tools = toolkit.get_tools()

# 创建代理
agent = create_agent(llm, tools)
```

使用示例：

```python 运行代理 icon="rocket" theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
result = await agent.ainvoke({
    "messages": [("user", "这个代理能做什么，然后让它分析最近的趋势")]
})

# 代理将调用远程代理并自动处理支付
```

***

## 支付工作原理

当远程代理需要支付（HTTP 402）时，工具包会：

1. 接收支付要求
2. 调用财务官授权支付
3. 使用配置的钱包签署支付
4. 附加支付信息重试请求

这对您的 LangChain 代理是透明的。

`AmpersendTreasurer` 提供具有支出限额和分析功能的托管支付会话。`ampersend_sdk` 中提供了替代的财务官实现。

***

## API 参考

* [Ampersend 文档](https://docs.ampersend.ai)
* [x402 协议规范](https://www.x402.org/)

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档](/use-these-docs) 通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/python/integrations/tools/ampersend.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>