Projects

Um project agrupa instruções permanentes e arquivos enviados em um contexto nomeado e reutilizável. Referencie um project a partir de um agent run ou de uma conversa, e esse contexto é injetado automaticamente.

Criar um project

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

campos: name (obrigatório), description, instructions (a orientação permanente aplicada sempre que o project está em escopo).

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

Arquivos

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

faz upload de um arquivo (multipart) no project.

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

lista os arquivos do project.

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

o contexto montado (instruções + digest de arquivos) que o agent recebe.

Usando um project

Passe project_id ao iniciar um agent run ou criar uma conversa — as instruções e arquivos do project são injetados no servidor, então o agent raciocina com esse contexto sem você precisar reenviá-lo a cada chamada.

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

Gerenciar

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

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

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

lista, atualiza e exclui projects.

Projects são para contexto PERMANENTE que você reutiliza. Para fatos pontuais que o workspace deva lembrar em todas as tarefas, use Memory.