鉴权与试聊（G2）

拿 Token

测服 / 本地统一：

POST {BASE}/api/auth/login
Content-Type: application/json

{ "username": "你的账号", "password": "你的密码" }

成功时 data.token.access_token 即为 Bearer。
SDK：

from chenyue_flow import ChenyueFlowClient

client = ChenyueFlowClient.login(
    base_url="http://127.0.0.1:8000",
    username="...",
    password="...",
)

常见错误：

现象	处理
401 / 登录失败	核对账号密码；测服找教练开账号
Builder 403	账号需具备沙箱/练习创建权限（如 flow:create_sandbox）或管理员
Token 过期	重新 login；或用 refresh（进阶，见 OpenAPI /api/auth/refresh）

禁止把密码/Token 写进公开仓库或前端 bundle。

---

试聊冒烟

result = client.chat(agent_id, "你好，请用一句话介绍你自己")
print(result.conversation_id, result.reply)

等同：

POST {BASE}/api/agents/{agent_id}/chat
Authorization: Bearer <token>
{ "message": "...", "stream": false }

快速开始完整路径：login → provision → chat。见 快速开始。