核心 ACP 任务功能与推荐用例

这些是定义代理在整个 ACP 工作生命周期中如何与买方互动的最常用功能。开发者可以参考这些模式以确保行为一致且流程可预测。

核心功能

这些功能由以下双方使用 资金转移代理 和 非资金转移代理 并构成每个 ACP 工作流程的基础。

• job.reject 是 强制性的 用于 非 资金转移代理。

1. job.accept(reason)

2. job.reject(reason)

3. job.createRequirement(content)

4. job.deliver(deliverable)

与资金转移相关的功能

这些功能涉及资金、存款、结算或赔付逻辑。仅适用于 资金转移代理。

• job.rejectPayable 和 job.reject 是 强制性的 用于 资金转移代理。

1. job.createPayableRequirement(content, type, amount, recipient)

2. job.payAndAcceptRequirement(reason)

3. job.deliverPayable(deliverable, amount)

4. job.rejectPayable

通知功能

在传达状态更新、完结后的见解或异步事件时很有用。

• 对资金转移代理是强制性的，因为用户需要对资金流动有明确的可见性。

1. job.createNotification(content)

2. job.createPayableNotification(content, amount)

---

job.accept(reason)

其功能说明	快速示例
接受买方的请求并将工作推进到下一阶段。	交易执行代理 开发者验证输入（交易对、滑点、风险容忍度），确认可执行后接受请求。 示例： “交易对已验证且流动性可用。开始执行。” 桥接代理 开发者在接受之前确认两条网络均受支持。 分析/洞察代理（非资金） 开发者在验证查询参数后接受。

---

job.reject(reason)

要理解何时使用 job.reject() 以及何时使用 job.rejectPayable()，你可以参考说明 此处. 它解析了两者的差异以及各自应何时应用。

其功能说明	快速示例
以可选理由拒绝请求，从而停止流程。	无效的交易参数 示例： “杠杆超出允许范围。最大杠杆为 20 倍。” 不支持的链/代币 示例： “不支持 Avalanche 到 zkSync 的桥接。” 缺少必填字段 示例： “分析请求缺少 timeframe 参数。”

---

job.createRequirement(content)

其功能说明	快速示例
创建一个 不可支付的需求 （不涉及资金）。当需要额外逻辑或输入时使用。	交易策略确认 开发者要求买方在多个策略中进行选择： “您想运行哪个策略？(1) 市价单 (2) 限价单 (3) TWAP” 风险披露 / 确认步骤 “请确认您在继续前接受与高波动性资产相关的风险。” 获取更多参数 “请提供用于历史分析的有效日期范围。”

---

job.createPayableRequirement(content, type, amount, recipient)

其功能说明	快速示例
创建一个 请求资金的需求。当工作在没有资金的情况下无法继续时需要。	交易代理 – 保证金存款 开发者请求 250 USDC 以开立多头头寸。 “请存入 250 USDC 作为交易本金。” 有关完整交易流程可参考 ACP v2 交易用例

---

job.payAndAcceptRequirement(reason)

其功能说明	快速示例
买方支付所请求的资金后，工作会立即继续前进。	自动交易代理 买方存入本金 → 机器人立即开始执行。 NFT 铸造代理 用户批准并直接支付铸造费用。 跟单交易代理 买方批准订阅费 → 机器人开始跟踪主交易者。

---

job.deliver(deliverable)

其功能说明	快速示例
交付最终输出但不退还资金。	分析代理 交付图表分析、情绪报告、交易信号。 无资金流动。 交易执行代理（仅资金服务的工作） 如果买方只支付了 服务，而不是本金： “您的交易执行详情已准备就绪。” 研究代理 / 聊天代理 在对话结束时交付文本或结构化输出。

---

job.deliverPayable(deliverable, amount)

其功能说明	快速示例
交付最终输出 并将资金退还 给买方。	交易代理 – 平仓 退还本金 + 盈利。 示例： “头寸已平。退还 150 USDC（含 5 USDC 盈利）。” 桥接代理 退还剩余的 gas 缓冲。 示例： “桥接完成。将未使用的 1.2 USDC 退还给买方。” 托管代理 买方存入 100 USDC，工作完成后多余资金退款。

---

job.createNotification(content)

其功能：	快速示例
发送不带资金转移的通知（可以在工作完成后）。	交易机器人 “您的追踪止损已触发。” 桥接代理 “资金已抵达 Arbitrum。” 研究代理 “您关于 BTC/ETH 的每日洞察已更新。”

---

job.createPayableNotification(content, amount)

其功能说明	快速示例
发送一条通知 并附带资金转移.	止盈 / 止损 自动化 “您的止盈已触发。退还 12 USDC 盈利。” 费用返还代理 “退还来自昨日交易的 1.2 USDC 返利。” 分利润代理（共享利润） 向多个接收方发送多条可支付通知。

---

job.rejectPayable

要理解何时使用 job.reject() 以及何时使用 job.rejectPayable()，你可以参考说明 此处. 它解析了两者的差异以及各自应何时应用。

其功能说明	快速示例
拒绝该工作并退还资金。	执行在中途失败 “网络拥堵导致无法执行。退还 150 USDC 本金。” 滑点条件不满足 “滑点 > 3%。交易取消并退还资金。”

---

资金转移钱包架构

资金转移代理必须通过 ACP 合约并使用 ACP SDK 提供的函数来路由所有资金流动。这可确保适当的验证、审计记录、费用捕获，使代理的工作和交易安全、可靠且可验证。

切勿使用直接钱包转账。 所有资金流动必须通过 ACP 的可支付函数。

用户、代理和 ACP 合约之间的完整资金流生命周期

资金流向

常见错误： 从代理钱包直接转账到用户钱包会绕过 ACP 验证并破坏可验证性，我们强烈不建议直接钱包转账。

ACP 中的所有资金转移操作通常由提供者代理发起。代理可以（i）向用户/另一代理请求资金或（ii）向用户/另一代理转移资金。

方向	ACP 函数	何时使用
用户 → 代理 （请求资金）	createPayableRequirement()	请求存款、本金、付款
代理 → 用户 （发送资金）	deliverPayable(), rejectPayable(), createPayableNotification()	退还本金、利润、退款

操作	使用此函数
向用户/其他代理请求存款/本金	createPayableRequirement()
随最终交付一起退还资金	deliverPayable()
在拒绝时退款	rejectPayable()
发送利润/返利（异步）	createPayableNotification()

最佳实践说明

• 使用 可支付需求 每当必须在执行前确保资金时使用。

• 使用 deliverPayable 在退还本金或利润时使用。

• 使用 通知 用于异步或完结后的更新（例如止盈/止损触发）。

• 在拒绝或请求更多输入时始终给出明确理由。

• 保持资金流可预测，避免错误地混合本金、利润和费用逻辑。