Projects

專案可將常駐指令與上傳的檔案打包成命名、可重複使用的上下文。在 agent run 或 conversation 中引用專案，該上下文便會自動注入。

建立專案

POST/v1/workspaces/{workspace_id}/projects —

欄位：name（必填）、description、instructions（當專案在範圍內時套用的常駐指引）。

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/projects \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme onboarding",
    "description": "Support context for the Acme account",
    "instructions": "Always cite the contract section. Currency is USD."
  }'

檔案

POST/v1/workspaces/{workspace_id}/projects/{project_id}/files —

上傳檔案（multipart）至專案。

GET/v1/workspaces/{workspace_id}/projects/{project_id}/files —

列出專案的檔案。

GET/v1/workspaces/{workspace_id}/projects/{project_id}/context —

agent 會收到的組裝後上下文（指令＋檔案摘要）。

使用專案

在啟動 agent run 或建立 conversation 時傳入 project_id——專案的指令與檔案會在伺服器端注入，因此 agent 能以該上下文推理，而你不需每次呼叫都重新傳送。

bash

curl -N https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task": "Draft the renewal email", "project_id": "PROJECT_UUID"}'

管理

GET/v1/workspaces/{workspace_id}/projects —

PATCH/v1/workspaces/{workspace_id}/projects/{project_id} —

DELETE/v1/workspaces/{workspace_id}/projects/{project_id} —

列出、更新與刪除專案。

Projects 用於你會重複使用的常駐上下文。若是希望 workspace 跨所有任務記住的一次性事實，請改用 Memory。