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 run の起動や conversation の作成時に project_id を渡すと、プロジェクトの指示とファイルがサーバー側で注入されます。そのため呼び出しのたびに再送することなく、エージェントはそのコンテキストで推論できます。

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 を使ってください。