基于 Agents API构建的完整应用。每个示例都使用 Project API 密钥连接真实的 Core 安装。
| 示例 | 展示内容 |
|---|---|
| Parsar Agent 工作台 | 产品 UI：模型、Skills、MCP、可复用 Agent，以及在任意 Runtime 上运行的 Session |
Parsar Agent 工作台
基于 Core 构建的小型单用户产品。保存模型提供商、Skills 和 MCP 服务器，将它们组合成 Agent，然后在托管沙箱、无工作区环境或自己的机器上启动 Session。
源码：example/parsar。
按照示例 README运行和配置；该文档也定义其支持的功能、存储和验证方式。
阅读重点
每项功能对应 API 的一个部分。结合指南章节阅读代码：
| 功能 | 使用的 API | 指南 | 代码 |
|---|---|---|---|
| 服务端密钥和请求头 | Bearer 密钥、OpenAI-Beta、路由允许列表 | 开始前 | server.mjs |
| 带 Harness 和模型的 Agent | x_agents_core.harness、model_provider | Core 扩展 | server/sessions.mjs |
| 三种 Runtime 上的 Session | openai_hosted、none、带 workspace_directory 的 self_hosted | 创建 Session | server/sessions.mjs |
| 可在崩溃后恢复的 Session 创建 | Idempotency-Key、响应丢失后的恢复 | 幂等性 | server/sessions.mjs |
| 实时回复 | 事件流、文本增量、重连与状态协调 | 流式事件 | src/lib/live-session.ts |
| 后续输入与取消 | 带幂等键的输入事件 | 发送输入 | src/Composer.tsx |
| 历史 | 分页读取 Turns 和 Items | 分页 | src/lib/api.ts |
| Skills 和版本 | /skills、默认版本 | Skills | src/Skills.tsx |
| 连接自己的机器 | x_agents_core.installation、Environment 状态 | 自托管执行 | src/ConnectMachine.tsx |
添加示例
在 example/ 下创建目录，用 README 说明运行方式及展示的 API 功能，然后在本索引添加一行。遵循应用示例边界。