Corvio 开发者平台
给你的 Agent 一个可靠、持久的工作空间。
用一套统一的资源语言完成提问、搜索、写作、文件留存、Markdown 同步和测试；每次调用都返回可供下一步信赖的回执。
POST /v1/questions生产环境
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"]
}'201 CREATEDquestion_idconversation_idsource_document_ids
资源模型
有价值的工作会留下证据。
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文档
列出、读取、创建、按版本更新、归档和私密分享文档。
GET · POST · PUT · DELETE/documentsWorkspace 文件
保留原始文件、下载精确字节，并通过稳定 Asset 句柄启动整理任务。
GET · POST/files本地 Markdown 同步
规划、拉取、推送、提交，并显式解决版本或哈希冲突。
GET · POST/sync测试控制
以管理员身份发现测试目录合同，并启动绑定 Workspace 的测试运行。
GET · POST/admin/tests官方 Agent Skill
安装完整的工作方法，而不是又一段 prompt 片段。
corvio-operate-workspace 会教兼容的 Agent 发现 API、保留来源、续接对话、处理分页、安全重试并验证持久结果。
Agent 请求示例
使用 $corvio-operate-workspace 找到最新发布计划，附来源文档 ID 总结未解决风险，然后续接这次 Corvio 对话并创建按优先级排序的检查清单。
发现 → 证据 → 持久结果 → 验证
开始使用