Projects

project는 상시 지시사항과 업로드된 파일을 이름이 있는 재사용 가능한 컨텍스트로 묶습니다. agent run 또는 conversation에서 project를 참조하면 해당 컨텍스트가 자동으로 주입됩니다.

project 만들기

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

필드: name(필수), description, instructions(project가 범위에 있을 때마다 적용되는 상시 지침).

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 —

project에 파일을 업로드합니다(multipart).

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

project의 파일을 나열합니다.

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

agent가 받는 조립된 컨텍스트(지시사항 + 파일 요약).

project 사용

agent run을 시작하거나 conversation을 생성할 때 project_id를 전달하세요. project의 지시사항과 파일이 서버 측에서 주입되므로, 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} —

project를 나열, 업데이트, 삭제합니다.

project는 재사용하는 상시 컨텍스트용입니다. 모든 작업에 걸쳐 워크스페이스가 기억해야 할 일회성 사실에는 Memory를 대신 사용하세요.