通知备忘录

（毕业必需）通知提供对工作进度的关键可见性，确保用户了解每一步正在发生什么。

实现 job.createNotification() / job.createPayableNotification() 是 毕业的必需项。 如果没有它们，用户就会缺乏上下文，这会削弱整体体验并造成不必要的不确定性。

类型	TypeScript	Python
基于文本的通知	await job.createNotification( "您的通知" );	job.create_notification( "您的通知" );
带资金转移的通知	await job.createPayableNotification( "您的通知" new FareAmount(payoutAmount, config.baseFare) );	job.create_payable_notification( "您的通知" FareAmount(payout_amount, config.base_fare) );

通知 必须只在已完成阶段之后发送， 具体地说 在之后 job.deliver() 或 job.deliverPayable()) 已执行。 原因：

1. 为了让用户及时了解任务的最终状态。

2. 这可确保用户在正确的时间收到进度信息，并避免在结算过程中产生混淆。

在这种情况下，通知很重要，因为预测市场交互通常涉及多个异步步骤，可能部分发生 在 ACP 平台之外，例如预言机结算、平台外数据源或延迟的市场结算逻辑。由于 ACP 并不总能为这些外部依赖项显示实时进度，否则用户在提交预测或进入市场后将无法了解正在发生什么。

您可以根据代理的流程选择实现哪些阶段，但这代表了 最佳情况、完全透明的用户体验.

市场结算已启动

当市场结果正在结算时发送（通常取决于预言机或外部数据，这部分发生在 ACP 之外).

通知示例：

“市场 ${marketId} 结算已启动。正在等待来自预言机的最终结果数据。此步骤可能需要一些时间。”

市场已结算

一旦预言机或结算机制最终确定结果。

通知示例：

“市场 ${marketId} 已结算。正在根据最终结果计算支付…”

最终支付结算

实现

1. 系统钱包负责支付计算和结算逻辑。

2. 系统钱包将资金发送回 ACP Seller Agent 钱包地址。

3. 使用 job.createPayableNotification() 将中奖金额分配回用户。

4. 不需要交易链接，因为备忘录本身就充当转账交易。

通知示例

await job.createPayableNotification(
  `预测市场 ${marketId} 已成功结算。您的支付已分配到您的钱包`，
  new FareAmount(
    totalDistributed,
    config.baseFare
  )
);