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 對話並建立依優先順序排列的檢查清單。