Appearance
快速开始
用最短路径完成：鉴权 → 创建练习 Agent → 拿到 agent_id。
写法对齐：Trinity「Key → 第一条调用」· 扣子「初始化 → 创建 → 发布 → 对话」。
预计 5～10 分钟（需已有测服/本地 API 账号）。
1. 准备工作
| 项 | 说明 |
|---|---|
| Base URL | 以教练/控制台提供的测服基址为准 |
| 账号 | 测服/本地登录账号（详见 鉴权与试聊） |
| Python 3.10+ | 官方薄 SDK |
安装 Python 包 chenyue-flow（方式见教练说明 / 发版包）。
python
from chenyue_flow import ChenyueFlowClient, ProvisionRequest
client = ChenyueFlowClient.login(
base_url="https://你的测服基址",
username="你的账号",
password="你的密码",
)2. 第一条调用：列出 Recipe
确认鉴权与 Builder 路由可用：
SDK
python
print(client.list_recipes()) # edu_qa_thin / http_call_thin
print(client.list_node_types()[0])3. 创建练习 Agent（provision）
python
result = client.provision(
ProvisionRequest(
agent_name="高中数学答疑助教",
system_prompt="你是高中数学助教，先澄清再给思路，不直接代写完整作业。",
recipe_id="edu_qa_thin",
industry="education",
)
)
print("agent_id =", result.agent_id)
print("entrypoint =", result.entrypoint)同名再次 provision = 幂等更新。
4. 试聊冒烟 + 人审
python
chat = client.chat(result.agent_id, "二次方程求根公式是什么？先给思路不要直接代写作业。")
print(chat.reply)再到 Flow「我的练习」按测题人审（主路径 / 禁区 / 应澄清）。
鉴权细节：鉴权与试聊。
5. 诚实边界（现在就能说清的）
| 事实 | 说明 |
|---|---|
| 默认 Recipe 很薄 | edu_qa_thin = start→llm→end，不是官网小悦全图 |
| API 创建不覆盖一切 | 复杂插件/全量知识库仍可能要在控制台或后续接口补（与扣子「部分配置暂未开放」同类诚实） |
| 不要用 seed | 禁止引导学员自行跑平台初始化脚本 |