curl https://api.corvio.ai/v1/questions \
-H "Authorization: Bearer $CORVIO_API_KEY" \
-H "Idempotency-Key: launch-risk-review" \
-H "Content-Type: application/json" \
-d '{
"prompt": "还有哪些发布风险没有解决？",
"sources": ["workspace", "memory"]
}'有价值的工作会留下证据。
Corvio 的响应为持续迭代而设计。请沿返回的链接和 ID 继续工作，不要从自然语言中重新拼装状态。
默认持久
回答会返回稳定的问题、对话、文档、来源和产物 ID。
每次重验权限
每次调用都会重新检查密钥所有者、Workspace 成员关系、角色、scope、ACL、有效期和撤销状态。
可安全重试
创建请求支持 Idempotency-Key；文档替换支持预期内容版本。
{
"id": "question_uuid",
"status": "completed",
"conversation_id": "conversation_uuid",
"source_document_ids": ["document_uuid"],
"artifacts": [{
"kind": "document",
"document_id": "artifact_uuid",
"content_revision": 4
}],
"links": {
"self": "/v1/questions/question_uuid",
"conversation": "/v1/conversations/conversation_uuid"
}
}足够精简，容易掌握；足够完整，可以工作。
生成式参考始终是精确的操作 authority；下表只展示持久能力的边界。
问题
向 Corvio 提问、检查持久运行，并通过 conversation_id 继续。
GET · POST/questions对话
获取稳定的续接句柄，无需重放聊天历史。
GET/conversationsWorkspace 搜索
搜索知识，同时保留页面、节点、分块和来源引用。
POST/search文档
列出、读取、创建、按版本更新、归档和私密分享文档。Project 保持在 Workspace 根部；更深结构由分支 Page 与叶子文档承载。
GET · POST · PUT · DELETE/documentsWorkspace 文件
保留原始文件、读取有界且绑定哈希的来源投影、下载精确字节，并通过稳定 Asset 句柄启动整理任务。
GET · POST/files本地 Markdown 同步
规划、拉取、推送、提交，并显式解决版本或哈希冲突。
GET · POST/sync测试控制
以管理员身份发现测试目录合同，并启动绑定 Workspace 的测试运行。
GET · POST/admin/tests安装完整的工作方法，而不是又一段 prompt 片段。
corvio-operate-workspace 明确要求 Agent 在调研、报告、对比、计划、决策、会议纪要、项目、调试、评审和后续任务形成计划或答案前，先通过当前授权的 Corvio 读取一次相关历史资料；同时保留 Agent 原有文件流程，只把值得共享或复用的结果送回 Corvio。跨轮续作中的精确 handle 延续上一轮主题：Agent 先读取该 owner，再做更广搜索；其他 Project 的词面命中只能是候选，不能替换当前语境。handle 是主题证据，不一定是持久写入目标；要把反复出现的模式、偏好、约束、质量标准或方法留给以后复用时，应先在同一 Project 或 Workspace 内窄搜合适的 Memory 或 Skill owner，再决定准入或合并。用户询问从哪里继续时，它会返回由 canonical owner、下一步有用的叶子、相关可复用 Skill、revision 和未决检查点组成的紧凑当前地图，而不是倾倒整个 Project。版权、公开可得性或第三方作者身份本身不等于受限；只有适用条款明确禁止私有 Workspace 留存或处理时才排除。敏感、披露不清、未连接和明确只留本地的工作不进入读取默认；一次性结果通常只是不写入，不能单独成为跳过相关历史的理由。
使用 $corvio-operate-workspace 找到最新发布计划，附来源文档 ID 总结未解决风险，然后续接这次 Corvio 对话并创建按优先级排序的检查清单。