Skip to main content

15. 动手运行:先验证机制,再接真实模型

所有配套文件在本教程同目录的 demos/。本地教学 demo 仅使用 Python 标准库和 Node 内置模块;Python 需要 3.11+,本次实际使用 3.14.7。

15.1 本次实测记录

App Server probe 首次在受限沙盒里提前退出,获准在沙盒外重试后初始化成功。探测进程已结束,不会留下后台 Agent 任务。

15.2 真实 App Server 探测

它不会发送 thread/startturn/start。若要做自己的客户端,应先生成当前版本协议:
schema 文件只表示接口约束,还需要把审批、错误、通知和生命周期接完整。

15.3 真实模型 API 示例

先在本机私密环境变量中配置 OPENAI_API_KEY,不要写进教程或 Git。本文没有读取或使用你的 API Key。确认模型和账号支持后,可运行:
WebSocket steering 示例需要 ws
API 示例固定使用截图对应的 Astra 模型 ID gpt-6-astra,不悄悄降级换模型。每种模式单独运行,避免违反 async/PTC、steering/自动 compaction 等组合约束。在线示例均未实测;额度、网络、API 演进可能影响运行。出现不支持字段时先核对官方文档与模型权限,不要猜字段名。

15.4 Demo 与生产系统的差距

本地 Runtime 的 job 表在内存中,事件日志可持久化,但没有实现崩溃后恢复正在运行的任务或跨进程幂等;事件落库与任务派发也不是一个原子事务。生产设计可增加 outbox、持久 job ledger、租约与恢复时的执行状态对账。 取消只对 demo 的 asyncio 协程有效;ThreadPool 中运行的 Python 函数和真实 OS 子进程需要另外的终止设计。API 示例用于展示调用协议,没有完整的流式断线恢复、token 预算管理、分布式重试或生产可观测性。

15.5 一条适合面试准备的学习路线