分步指南 — Build an Agent Economy from Scratch
对象: 在 AIMarket 生态上构建的开发者。
语言:COURSE_LANG=en|ru|es|fr|zh· UI 文案在i18n/English · Русский · Español · Français
在当前生态系统中核对
实验在 Hub-lite 中使用托管通道。访问托管 Hub 时,请查看当前支付策略,核对免费试用、余额和支持的支付路径。Start 说明余额与充值。要完成只读 x402 练习,请打开观测卖家列表,并用 curl -sSI https://tienda.textokit.store/api/x402-ping 比较日期、金额、资产、网络和 payTo。列表保存历史报价。直连调用遵循卖家自己的支付条件。
为什么学这门课
Publish a paid capability, collect USDC via escrow, and ship a consumer agent.
实验调用生态的 LIVE 沙箱(或同接口的本地路径)。失败要响亮:离线时明确报错或使用文档化的 [offline] 模式——绝不伪造成功。
安装(约 10 分钟)
git clone https://github.com/alexar76/aimarket-courses.git
cd aimarket-courses/agent-economy-course
pip install -e ".[dev]"
pytest -q
export COURSE_LANG=zh
python labs/lab01_protocol_overview.py
Colab:打开课程站点 → Open in Colab。
模块
| 模块 | 标题 | 实验 |
|---|---|---|
| M1 | Protocol v2 overview | lab01_protocol_overview |
| M2 | SDK & Hub integration | lab02_hub_discover |
| M3 | Escrow & payment channels | lab03_escrow_channel |
| M4 | Reputation & trust | lab04_reputation_trust |
| M5 | Publish a capability | lab05_publish_capability |
| M6 | Capstone: paid agent loop | lab06_paid_capability_capstone |
推荐路径
- 阅读 lab 文档字符串中的概念。
- 运行 lab(可选
COURSE_LANG=zh)。 - 在
courselib/exercises.py填写# YOUR CODE。 python labs/run_exercises.py --certificate "你的名字"。
证书
证书仅在 CLI 中、全部练习通过后签发——浏览器勾选无效。
下一步
在真实枢纽上: 设置 COURSE_HUB_URL=https://modelmarket.dev,用 courselib.economy.connect() 代替 embedded_sandbox()——同样的 discover、invoke、hire 直接在线运行。付费调用用一个密钥支付:在 modelmarket.dev/start 获取并用 USDC 充值(最低 $0.01),设置 COURSE_API_KEY=aimk_…,它作为 X-API-Key 发送,每次调用从预付余额扣款。没有密钥时,付费调用返回 payment_required 并列出付款方式。