> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lasersell.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AI 代理与 LaserSell

> 将 AI 代理连接到 LaserSell 的退出智能引擎，实现自动化 Solana 代币交易、策略管理和实时仓位监控。

与 Solana 代币交互的 AI 代理可以使用 LaserSell 作为其执行和退出管理层。代理无需从零开始构建兑换路由、协议处理和退出逻辑，只需连接到 LaserSell 即可获得预构建的交易、实时盈亏追踪和自动退出功能。

## AI 代理可以用 LaserSell 做什么

**构建和执行交易。** [REST API](/api/overview) 为任何支持的 Solana DEX 或发射台返回未签名的兑换交易。代理发送代币地址和金额，获取交易，签名并提交。无需协议特定的逻辑。

**使用策略自动退出。** [退出智能流](/api/stream/overview)实时监控钱包，并在可配置的阈值满足时提供预构建的退出交易：目标利润、止损、追踪止损、毕业即卖和截止时间。代理连接一次即可自动接收退出信号。

**监控仓位。** 流提供持续的盈亏更新、余额变化、仓位开仓和平仓。代理可以使用这些数据做出决策、向用户展示信息或传入其他系统。

**覆盖每个主要 Solana 协议。** 单次集成覆盖 Pump.fun、PumpSwap、Meteora DBC、Meteora DAMM V2、Raydium Launchpad 和 Raydium CPMM。代理不需要知道代币在哪个协议上。

## 如何连接

AI 代理可以通过三种方式与 LaserSell 协作：

### 1. MCP 服务器（文档访问）

LaserSell MCP 服务器让任何 MCP 兼容的 AI 客户端（Claude、Cursor、Windsurf 等）能够实时搜索和检索 LaserSell 文档。这对需要在工作时查找 API 模式、SDK 模式、代码示例或集成细节的代理很有用。

参见 [MCP 服务器](/ai-agents/mcp-server)了解设置说明。

### 2. 编程技能（嵌入式 SDK 知识）

安装 LaserSell 编程技能，让你的 AI 助手深入了解 SDK 模式、方法签名、示例和故障排除，在编写 LaserSell 代码时直接加载到上下文中。

参见[编程技能](/ai-agents/coding-skills)了解安装说明。

### 3. SDK 和 API（直接集成）

对于需要以编程方式构建交易、管理仓位或执行交易的代理，使用 LaserSell SDK 或 API 直接集成。

* [API 概览](/api/overview)了解完整 API 接口。
* [快速入门](/api/quickstart)构建你的第一笔交易。
* SDK 提供 [TypeScript](/api/sdk/typescript)、[Python](/api/sdk/python)、[Rust](/api/sdk/rust) 和 [Go](/api/sdk/go) 版本。

## 为什么代理应该使用 LaserSell

### 代理集成难题

今天一个想要交易 Solana 代币的 AI 代理需要解决一系列难题：识别代币在哪个 DEX 协议上，反序列化链上池状态，使用协议特定的数学计算兑换金额，构建正确的指令集，管理优先费用，处理滑点重试，以及轮询价格变化以知道何时退出。每个协议（Pump.fun、PumpSwap、Raydium、Meteora）都有不同的程序、不同的账户布局和不同的兑换逻辑。这需要数百小时的集成工作，而且每次新发射台上线时都会出问题。

LaserSell 将所有这些压缩为两个 API 调用：一个用于构建交易，一个 WebSocket 用于接收退出信号。

### 技术优势

| 能力         | 不使用 LaserSell                                                                              | 使用 LaserSell                                             |
| ---------- | ------------------------------------------------------------------------------------------ | -------------------------------------------------------- |
| **协议路由**   | 代理必须检测代币在哪个 DEX 上，反序列化池状态，并为 6 个以上程序构建协议特定的指令                                              | 单次 API 调用。发送代币地址，获取可签名的交易。LaserSell 在服务器端解析协议、池和路由       |
| **退出逻辑**   | 代理必须轮询 RPC 获取价格数据，计算盈亏，追踪追踪止损的峰值利润，管理截止时间计时器，并手动构建卖出交易                                     | 连接退出智能流一次。当策略条件触发时接收包含预构建未签名交易的 `exit_signal_with_tx` 事件 |
| **盈亏追踪**   | 代理必须获取代币余额，解析小数位，查询池储备，计算现货价格，并定期计算盈亏                                                      | 流持续发送 `pnl_update` 事件。无需轮询，无需 RPC 调用，无需价格计算              |
| **新仓位检测**  | 代理必须监控钱包交易历史或订阅链上日志并解析每笔交易以识别买入                                                            | 流在购买落地的瞬间触发 `position_opened`，包含完整上下文（成本基础、代币地址、市场上下文）   |
| **多协议覆盖**  | 分别集成 Pump.fun 联合曲线、PumpSwap AMM、Raydium Launchpad、Raydium CPMM、Meteora DBC、Meteora DAMM V2 | 一次集成覆盖全部六个。添加新协议时代理代码不需要变更                               |
| **交易签名**   | 不适用                                                                                        | 所有交易以未签名形式返回。代理在本地签名。私钥永远不会离开代理的环境                       |
| **滑点处理**   | 代理必须估算滑点，失败时重试，并逐步提高容忍度                                                                    | 服务器计算滑点。SDK 中的客户端重试是自动的，具有可配置的提升逻辑                       |
| **新发射台支持** | 代理必须逆向工程每个新程序，从零构建指令，并维护持续兼容性                                                              | LaserSell 在服务器端添加协议支持。代理零代码更改即可获得覆盖                      |

### 实际意义

**更少的 RPC 调用。** 不使用 LaserSell 的代理需要不断轮询价格数据、获取余额和读取池状态。有了退出智能流，服务器推送一切。代理的 RPC 使用量降低到仅交易提交。

**确定性退出执行。** 策略条件（止盈、止损、追踪止损、截止时间、毕业）在每个价格 tick 上进行服务器端评估。代理不需要持续在线或担心错过价格突变。当阈值满足时，退出交易已经构建好并等待中。

**无需协议特定代码。** 代理发送 `{ mint, user_pubkey, amount }` 到 `/v1/sell` 或 `/v1/buy`。无论该代币是在 Pump.fun 联合曲线、PumpSwap AMM 还是 Raydium CPMM 池上，返回的交易都能直接使用。

**事件驱动架构。** 流天然适合代理。代理无需运行轮询循环，而是订阅并响应：`position_opened` 记录新交易，`pnl_update` 展示数据，`exit_signal_with_tx` 签名并提交。干净的异步模式，无浪费计算。

**4 种语言 SDK 完全对等。** TypeScript、Python、Rust 和 Go SDK 暴露相同的模式、方法名和行为。用 Python 构建的代理和用 Rust 构建的工作方式相同。没有 SDK 是二等公民。