A commerce-centric demo featuring Agent Development Kit with Paypal Agent Toolkit via MCPs

基本能力

产品定位

pp_mcp_adk 是一个商务演示项目，旨在展示如何通过 PayPal 的 Agent Toolkit 和 Google 的 Agent Development Kit (ADK) 实现对话式售前互动。

核心功能

• 通过 PayPal 沙箱环境进行订单创建、捕获和查询。
• 物流跟踪信息的获取。
• 订阅服务的创建、展示和取消。
• 通过 ADK 实现对话式交互，支持自然语言处理和图像识别。

适用场景

• 电子商务平台的售前客服自动化。
• 订单状态查询和物流跟踪。
• 订阅服务的管理。
• 通过自然语言和图像识别推荐商品。

工具列表

• PayPal Agent Toolkit: 提供 PayPal 沙箱环境的 API 调用能力，支持订单、物流和订阅管理。
• Google Agent Development Kit (ADK): 提供对话式交互能力，支持自然语言处理和图像识别。

常见问题解答

• API 依赖关系: 某些 API 调用需要先完成其他操作，例如订单捕获需在消费者完成交易后进行。
• 沙箱环境限制: 例如，争议必须由人工在沙箱环境中创建后才能由商家调用接受争议索赔。
• 延迟问题: 例如，交易列表可能不会立即显示最新交易。

使用教程

使用依赖

1. 创建 Python 虚拟环境并激活：

python3 -m venv ~/.ppmcp_adk
source ~/.ppmcp_adk/bin/activate

1. 安装依赖包：

pip install "google-adk==0.3.0"
pip install "google-cloud-aiplatform==1.90.0"

或使用 poetry：

poetry install

安装教程

1. 复制 env.example 到 .env 并配置：
2. 填写 Google API 密钥或 Google Cloud 项目 ID 和位置。
3. 填写 PayPal 沙箱的 PAYPAL_CLIENT_ID 和 PAYPAL_SECRET。
4. 在 paypal_mcp_agent/util.py 的 load_user_profile() 函数中修改 user_profile 和 orders 字典，以加载实际的 PayPal 沙箱订单信息。

调试方式

1. 运行 ADK 开发者界面：

adk web

1. 访问 http://localhost:8000/dev-ui?app=paypal_mcp_agent 进行交互测试。

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。