Clusters

RAPTOR clusters referenced by chat responses.

Method	Path
GET	`/api/v1/clusters/{case}/{clusterId}`

Answer cluster

GET /api/v1/clusters/{case}/{clusterId}

A RAPTOR cluster returned in a chat response.

From the API schema: Resolves a RAPTOR summary chunk id (as returned in chat clusters) or a visual cluster number from clusters.json to its member node indices.

Auth: API key (X-API-Key) or user session

curl "https://vol.example.com/api/v1/clusters/papers/c_17" \
  -H "X-API-Key: $VOL_API_KEY"

import { VolClient } from "@vol/sdk";

const vol = new VolClient({ baseUrl: "https://vol.example.com/api", apiKey: process.env.VOL_API_KEY });
await vol.cluster("papers", "c_17");

import os, requests

r = requests.get(
    "https://vol.example.com/api/v1/clusters/papers/c_17",
    headers={"X-API-Key": os.environ["VOL_API_KEY"]},
    timeout=60,
)
r.raise_for_status()
print(r.json())

Response 200

{
  "id": "c_17",
  "title": "Graph-based retrieval",
  "summary": "Methods that use knowledge graphs to ground LLM answers.",
  "nodeIndices": [
    412,
    977,
    1503
  ]
}

Types

interface AnswerCluster { id: string; title: string; summary: string; nodeIndices: number[] }