buybuddy (Relieq)

买伴

购物助手使用ADK + MCP + A2A + AP2

学习四项技术的目标：

• ADK（Agent Development Kit）：用于构建、运行和部署代理的框架（面向Gemini但模型无关）。
• MCP（模型上下文协议）：“USB-C端口”用于大型语言模型（LLM）连接标准化的源和工具。
• A2A（Agent-to-Agent）：用于代理之间进行工作相关交流/合作的标准。
• AP2（代理支付协议）：一种新标准，使代理能够通过“授权/委托”和多种方式安全进行支付。

（卡片、实时转账、稳定币……）。

问题与架构

问题：用户提出需求（“购买200万越南盾以下的机械键盘，快速发货”）。BuyBuddy：

• 查找并比较产品；2) 通过A2A与“VendorAgent”聊天以确定交易；
• 调用MCP工具以访问数据库（价格、库存、交货）、日志和操作（加入购物车、创建草稿订单）；
• 付款时，执行带有明确“授权”的AP2；
• 译文：所有内容均在ADK中作为管弦乐队（管道、状态、重试、评估运行簿）呈现。

目录结构

buybuddy/
  apps/
    buyer_agent/
      __init__.py           
      main.py               # CLI app (entrypoint `buybuddy run`)
      agent_runtime.py      # lõi agent: state, messages, think/act/respond
      tools_local.py        # “tool” nội bộ: search sản phẩm từ catalog.json
      data/
        catalog.json        # dữ liệu mẫu về sản phẩm
  packages/
    contracts/
      __init__.py
      schemas/
        a2a_intents.json    # (placeholder) schema cho thông điệp A2A (sẽ dùng ở Stage 3)
        ap2_objects.json    # (placeholder) schema cho Mandate/Payment/Receipt (Stage 4)
        mcp_tools.json      # (placeholder) schema cho tool MCP (Stage 2/5)
  tests/
    __init__.py             # chỗ để viết test sau này
  pyproject.toml            # cấu hình gói, dep, script CLI
  README.md                 # hướng dẫn chạy nhanh

购买伙伴（第一阶段）

目标语言是中文

• 带有简单运行时代理的状态循环CLI
• 从JSON目录中调用本地工具（搜索产品）
• 清晰的连接线以便日后连接MCP、A2A和AP2

初始化

• 创建文件 pyproject.toml 声明包、依赖项、CLI脚本：

[build-system]
requires = ["setuptools", "wheel"]
build-backend = "setuptools.build_meta"

[project]
name = "buybuddy"
version = "0.1.0"
description = "BuyBuddy — Shopping agent playground (ADK + MCP + A2A + AP2)"
authors = [{name = "Tên bạn"}]
readme = "README.md"
requires-python = ">=3.12"
dynamic = ["dependencies"]

[tool.setuptools.dynamic]
dependencies = {file = ["requirements.txt"]}

[project.scripts]
buybuddy = "apps.buyer_agent.main:app"

[tool.ruff]
line-length = 120

[tool.black]
line-length = 120

• 创建文件 requirements.txt 译文：如在仓库中所示，声明必要的库。
• 安装库：

pip install -e .

创建买家代理

• 创建包 apps/buyer_agent/
• 创建文件 apps/buyer_agent/agent_runtime.py根据上面的信息，执行如下指令：