Projects

Un project agrupa instrucciones permanentes y archivos subidos en un contexto con nombre y reutilizable. Referencia un project desde una agent run o una conversation, y ese contexto se inyecta automáticamente.

Crear un project

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

campos: name (obligatorio), description, instructions (la guía permanente que se aplica siempre que el project esté en alcance).

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."
  }'

Archivos

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

sube un archivo (multipart) al project.

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

lista los archivos del project.

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

el contexto ensamblado (instrucciones + resumen de archivos) que recibe el agent.

Usar un project

Pasa project_id al iniciar una agent run o crear una conversation: las instrucciones y los archivos del project se inyectan en el servidor, así que el agent razona con ese contexto sin que tengas que reenviarlo en cada llamada.

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"}'

Gestión

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

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

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

lista, actualiza y elimina projects.

Los projects sirven para contexto PERMANENTE que reutilizas. Para hechos puntuales que el workspace deba recordar en todas las tareas, usa Memory.