Projects

Project 将常驻指令和已上传的文件打包为一个具名、可复用的上下文。在 agent 运行或对话中引用某个 Project，该上下文会自动注入。

创建 Project

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 接收到的、组装好的上下文（指令 + 文件摘要）。

使用 Project

在启动 agent 运行或创建对话时传入 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 用于存放你要反复复用的常驻上下文。对于工作区需要跨所有任务记忆的一次性事实，请改用Memory。