# 分步指南 — Build an Agent Economy from Scratch

> **对象：** 在 AIMarket 生态上构建的开发者。  
> **语言：** `COURSE_LANG=en|ru|es|fr|zh` · UI 文案在 `i18n/`
> [English](step-by-step.md) · [Русский](step-by-step.ru.md) · [Español](step-by-step.es.md) · [Français](step-by-step.fr.md)

---

## 在当前生态系统中核对

实验在 Hub-lite 中使用托管通道。访问托管 Hub 时，请查看[当前支付策略](https://modelmarket.dev/.well-known/ai-market.json)，核对免费试用、余额和支持的支付路径。[Start](https://modelmarket.dev/start) 说明余额与充值。要完成只读 x402 练习，请打开[观测卖家列表](https://modelmarket.dev/ai-market/v2/federation/observed-sellers)，并用 `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 分钟）

```bash
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：打开[课程站点](https://alexar76.github.io/aimarket-courses/agent-economy-course/) → **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` |

---

## 推荐路径

1. 阅读 lab 文档字符串中的概念。
2. 运行 lab（可选 `COURSE_LANG=zh`）。
3. 在 `courselib/exercises.py` 填写 `# YOUR CODE`。
4. `python labs/run_exercises.py --certificate "你的名字"`。

---

## 证书

证书**仅**在 CLI 中、全部练习通过后签发——浏览器勾选无效。

---

## 下一步

**在真实枢纽上：** 设置 `COURSE_HUB_URL=https://modelmarket.dev`，用 `courselib.economy.connect()` 代替 `embedded_sandbox()`——同样的 `discover`、`invoke`、`hire` 直接在线运行。付费调用用一个密钥支付：在 [modelmarket.dev/start](https://modelmarket.dev/start?lang=zh) 获取并用 USDC 充值（最低 $0.01），设置 `COURSE_API_KEY=aimk_…`，它作为 `X-API-Key` 发送，每次调用从预付余额扣款。没有密钥时，付费调用返回 `payment_required` 并列出付款方式。

回到[学院门户](https://alexar76.github.io/aimarket-courses/)或 [School](https://edu.modelmarket.dev/) 上看 on-ramp 短片。