开发参考与实时合同
开发参考帮助你理解平台边界。执行创作任务时,实际可用的工具、字段和约束来自当前授权连接返回的合同。
从一个任务开始
完成AI 接入后,助手通过 start_creator_task 获取平台当前任务与要求,再按返回内容读取专业 Skill 和所需合同。
tools/list 描述当前连接实际可用的工具;get_platform_contract_catalog 提供所选任务需要的合同切片。工具是否可用取决于当前授权,不应猜测或改用内部接口。
几个核心概念
| 概念 | 含义 |
|---|---|
| Product | 持续维护的产品身份 |
| Workspace / Build | 当前工作内容及其构建、验证结果 |
| Runtime Snapshot | 验证后用于运行的不可变内容 |
| Version | 正式发布链路形成的版本 |
| Room / Scenario | 参与空间与一次实际运行的体验 |
项目结构与 Schema
平台的 Authoring Contract 提供当前项目结构、Schema 和对应校验器。通过任务返回的入口获取它们,保持合同身份和 Skill 内容一致。
本网站不手写复制完整字段表。以当前合同生成项目,并先使用合同提供的本地校验器检查,再提交平台验证。服务端验证仍是最终依据。
平台和产品的边界
平台处理身份、权限、房间、版本、提交、存储与恢复。产品定义自身的规则、角色、行动、提示词和展示。AI 的输出是候选结果,不能绕过平台对权限、状态和费用的校验。
旧运行内容按其固定合同解释;修改产品时读取当前任务要求,不根据历史对话记忆猜测版本。
可供 AI 阅读的文档
本站文章也提供 Markdown 阅读副本,入口为 文档索引。它用于理解产品和流程;执行时继续读取实时合同与专业 Skill。