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 對話並建立依優先順序排列的檢查清單。
探索 → 證據 → 持久結果 → 驗證
開始使用