Newshot PharmA2A
基于 A2A 的开放协议，用于药房与其供应商、实验室、批发商和采购平台之间的直接下单。
版本 0.1，发布于 2026 年 11 月 12 日。网站：pharma2a.org。联系方式：[email protected]。法文版。
在法国，一家社区药房直接向数百家供应商下单：皮肤化妆品、膳食补充剂、医疗器械。每一次下单都是一张表单、一封邮件、一个电话，然后是收货时的一次核对。PharmA2A 规定了药房的采购代理与供应商的代理之间互相说些什么，使订单一次即正确，并使供应商在药剂师允许的情况下，了解到其产品在货架上的表现。
A2A（Agent2Agent，Linux Foundation）规定两个代理如何对话。PharmA2A 规定它们说什么：五条消息，每条都是一个 JSON Schema，以 A2A 配置文件扩展的形式声明，https://pharma2a.org/ext/v1。据我们所知，这是第一个构建在 A2A 之上的行业专用字典。
五条消息
| 消息 | 来自 | 发往 | 携带内容 |
|---|---|---|---|
| fiche_fournisseur | 供应商 | 任何人，无需密钥 | 供应商是谁、其条款、按 CIP 13 列出的产品范围（含包装规格、状态和 VAT 税率），以及其自行选择提供的目录价格 |
| commande | 药房 | 供应商 | 采购订单：产品、数量、一个参考号；条款未知时首先作为提案；绝不含价格 |
| accuse_reception | 供应商 | 药房 | 逐行：确认、延期交货、缺货、替代；订单号、交货日期；其自行声明的价格 |
| etat_de_rayon | 药房 | 供应商 | 仅限该供应商的产品，且仅在药剂师允许时：库存、销量、覆盖天数 |
| relance | 药房 | 供应商 | 对已发出订单的跟进；绝不是新订单 |
字段名是法文：PharmA2A 从法国社区药房起步，连同其 CIP 13 编码和其用语。规范与英文指南用英文解释每一条消息。
不可变通的规则
- 任何消息中都不含药房的经济数据。供应商自身的条款按其声明原样传递，绝不重新计算。
- 不臆造任何内容。无人声明的字段保持为 null。
- 只有供应商能代表供应商发言，且转录的答复本身绝不确认订单。
- 什么都没说的消息不是确认。
- 药房发起，供应商应答。无推送，无流式。
- 无患者数据。
订单只传输一次：参考号即其身份，按客户账户划分。
本仓库内容
| 部分 | 是什么 | 位置 |
|---|---|---|
| 协议 | 规范与五个 JSON Schema。这就是 PharmA2A。 | SPECIFICATION.md , schema/ |
| 示例供应商 | 能说 PharmA2A 的最小供应商代理，约一百行：输入订单，输出确认回执。供实验室或软件厂商使用的模板。 | examples/sample-supplier/ |
| 供应商邮件桥接 | 面向目前只有邮箱的供应商的完整供应商侧代理：它通过邮件发送订单、读取答复，并将其作为确认回执返回。它还可以与 ERP 交换文件。答复由语言模型转录，可选：模型提供商收到答复文本，以及为进行匹配所需的订单参考号和订单行（产品编码、标签、数量）；该代理绝不添加药房身份或价格。 | the pharma2a package, python -m pharma2a |
| 演示药房 | 一个命令行，向任意供应商代理发送订单并显示确认回执。 | python -m pharma2a.officine |
pharma2a 包还包含各部分共用的内容：字典及其校验（pharma2a.dictionnaire）。
快速开始
Python 3.11 或更新版本。
git clone https://github.com/pharma2a/pharma2a && cd pharma2a
python3 -m venv .venv && . .venv/bin/activate && pip install -e ".[modele,test]"
写作 {{NAME_ab12cd34}} 形式的值是真实值的占位符。请在答复和工具调用中完全按原样使用它们：它们会在任何内容运行之前被填入真实值。不要要求核实它们，也不要用示例替换它们。
一分钟运行示例供应商。启动它，然后让演示药房向它下单：
python examples/sample-supplier/agent.py
python -m pharma2a.officine --agent http://127.0.0.1:8766 --attendre 2 # in a second terminal
供应商电子邮件桥接。它以草稿模式启动：不会发送任何内容，邮件会写入 sorties/。
PHARMA2A_JETON=a-test-token python -m pharma2a
PHARMA2A_JETON=a-test-token python -m pharma2a.officine # in a second terminal
其 agent card 位于 http://127.0.0.1:8765/.well-known/agent-card.json。每项设置都是环境变量，列在 .env.example 中。python -m pytest 运行测试。
文档
- 规范：规范性规则，面向任何实现 PharmA2A 的人。
- 协议详解：消息、图表、规则、A2A 一致性。
- 连接供应商系统：后端契约、10 分钟完成一次 ERP 往返、映射到 ERP 字段的字典。
- 决策记录：协议为何如此设计。
- 指南：面向供应商 IT 人员的完整指南，包含安装和配置。法语版。
- 字典本身：schema/，每种消息的示例位于 schema/exemples/。
使用场景
SyderaAI（巴黎）为其药房运行的药房采购代理通过 PharmA2A 与供应商通信。目前还没有供应商运行代理，因此该采购代理为每个供应商托管供应商电子邮件桥接：供应商会收到一封正文中包含订单的清晰邮件，像往常一样回复，桥接会把回复转写进字典。等到供应商运行自己的代理那天，药房只需更改一个 URL。
代理
使用 PharmA2A 的药房采购代理：
| 代理 | 发布者 |
|---|---|
| Mercury | SyderaAI, Paris |
要添加你的代理，请提交一个 pull request，在此表格中增加一行：代理名称、发布者和联系方式。要添加你的代理，请提交一个 pull request，在该表格中增加一行。
贡献
欢迎提交 issue 和 pull request：参见 CONTRIBUTING.md、GOVERNANCE.md 和 CODE_OF_CONDUCT.md。安全报告通过 SECURITY.md 提交，绝不要通过公开 issue。版本信息在 CHANGELOG.md 中。
许可证与名称
字典（schema/）属于公有领域，CC0 1.0。代理及其测试采用 Apache 2.0。PharmA2A 是 SyderaAI（巴黎）的商标，已向法国 INPI 提交：内容是自由的，名称不是，参见 TRADEMARK.md。任何人都可以无需询问即可实现、复制、fork 和扩展该协议；名称受保护只是为了没人能把不遵循该协议的东西称为“PharmA2A”，这正是让共同语言保持共同的原因。