API 参考

API 适用于需要将 Agent 写作流程接入现有系统的企业客户。公开站只提供稳定概念与接入边界；认证方式、环境地址和完整字段定义将在开通集成后提供。

核心对象

• Thread：一次可恢复的 Agent 会话。
• Task：当前需要执行或等待确认的工作。
• State：选题、文献、大纲、章节和审阅记录组成的任务状态。
• Checkpoint：可暂停和继续的持久化位置。

典型调用流程

1. 创建 Thread 并提交研究方向。
2. 订阅任务事件或查询状态。
3. 在 waiting_for_human 状态提交选题或大纲确认。
4. 继续执行并接收章节与审阅结果。
5. 保存业务系统中的 Thread ID，用于恢复和审计。

集成要求

• 所有请求必须携带租户与用户身份。
• 客户端需要对重复请求使用幂等键。
• 流式连接中断后应通过状态接口恢复，而不是盲目重建任务。
• 不应在日志中记录完整论文、私有文献或访问凭证。

如需 API 接入，请联系 sales@seelescholar.com。