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

# 消息交易助手入门项目

> 一个面向 Business AI 风格消息助手的中立入门项目，强调资料与目录上下文、人工接管和支付交接边界。

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">需要帮助？</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>在 Discord 提问</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>提交 GitHub Issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/zh-Hans/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>支持指南</span>
    </a>
  </div>
</div>

## 摘要

这个入门项目展示了消息界面中的交易助手最小形态：有边界的商家上下文、意图捕获、套餐选择、用户确认和支付交接。

## 状态

`starter`

Source code: [ecosystem/examples/messaging-transaction-assistant-starter](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/ecosystem/examples/messaging-transaction-assistant-starter)

## 为什么存在

消息界面正在成为用户完成实际任务的地方。这个模式不是让模型直接付款，而是让助手收集意图、展示可审阅的选择，并在用户明确确认后交接给可信的支付界面。

Meta 在 2026 年 5 月推出的 `Business AI on WhatsApp` 让这种面向商家的模式更具体：小商家可以把助手建立在自己的资料、目录和支持信息之上，让它在非营业时间回答问题，同时保留人工随时介入的权力。这个入门项目保留这种形状，但不绑定任何单一平台。

## 相关实验室页面

* [生态概览](/zh-Hans/ecosystem)
* 2026 年 5 月 agentic 购物助手观察
* [Source Project Guidelines](/zh-Hans/contributor-kit/source-project-guidelines)

## 文件夹结构

```text theme={null}
messaging-transaction-assistant-starter/
├── README.md
├── SOURCE_NOTES.md
├── index.mdx
└── src/
    ├── run_demo.py
    └── transaction_flow.py
```

## 包含的示例文件

* `src/transaction_flow.py`：用于商家上下文、意图捕获、套餐选择、确认和支付交接的 typed helpers
* `src/run_demo.py`：这个流程的极小命令行 demo
* `SOURCE_NOTES.md`：来源脉络和署名边界

## 流程边界

助手可以：

* 基于本地商家资料、目录和支持说明作答
* 从消息中推断类似充值的意图
* 询问缺失的套餐或收款方细节
* 展示确认摘要
* 在商家希望介入时保留人工接管
* 为支付表面准备交接载荷

助手不能：

* 执行支付
* 保存银行卡或银行凭据
* 绕过用户确认
* 暗示并不存在的供应商集成

## 当前来源信号

这次刷新使用的当前信号是 Meta 在 2026 年 5 月面向印度中小商家的
`Business AI on WhatsApp`。Meta 的 framing 强调基于目录的商品问答、
关键商家信息、非营业时间覆盖以及商家控制权。因此，可复用的实验室经验
并不是“做一个泛聊天机器人”，而是让助手保持在清晰可见的商家上下文边界
内，同时把最终覆盖权和支付权留给人类。

## 下一步

* 为缺失细节添加更丰富的状态机。
* 为不同消息市场添加本地化 fixtures。
* 添加一个只为测试记录交接状态的 fake payment adapter。