Ir al contenido
HQ Fabric

Lista los nodos de la malla

Devuelve los nodos del workspace que ves por la audiencia de su ámbito: los de un issue, si ves el issue; los de un proyecto, si estás en su audiencia (sus roles y los admins, o todo el workspace si no tiene roles); los del workspace y los de agentes, todo miembro. Los filtros con un valor que no es válido se ignoran (no dan 400): `scope`, `kind` y `slot` sólo cuentan si son de su enumeración, `scope_id` si es un uuid y `verified` si vale `true` o `false`. Sin `state`, quedan fuera los nodos archivados. Como mucho 1000 nodos, primero los fijados y luego por ámbito, sección y título.

GET
/api/w/{ws}/context/nodes

Devuelve los nodos del workspace que ves por la audiencia de su ámbito: los de un issue, si ves el issue; los de un proyecto, si estás en su audiencia (sus roles y los admins, o todo el workspace si no tiene roles); los del workspace y los de agentes, todo miembro.

Los filtros con un valor que no es válido se ignoran (no dan 400): scope, kind y slot sólo cuentan si son de su enumeración, scope_id si es un uuid y verified si vale true o false. Sin state, quedan fuera los nodos archivados. Como mucho 1000 nodos, primero los fijados y luego por ámbito, sección y título.

Autorización

headerAutorizaciónBearer <JWT>

Sesión del navegador: el JWT que devuelve POST /api/auth/verify. Algunas rutas sólo la aceptan a ella (middleware requireSession); un token de API recibe 403 session_required.

Parámetros de ruta

ws*string

Slug del workspace. Hay que ser miembro (si no, 404 workspace_not_found).

Parámetros de consulta

scope?string
Value in"workspace""project""agent""issue"
scope_id?string
Formatuuid
kind?string
Value in"rule""convention""doc""adr""repo""skill""memory""artifact""glossary""plan"
slot?string
Value in"instructions""knowledge""tools""memory""state""query"
state?string

Uno o varios estados separados por comas (p. ej. active,warm). No se valida: un valor que no es un estado no casa con ningún nodo. Sin este parámetro, todos menos archived.

verified?string
Value in"true""false"
q?string

Texto que tiene que aparecer en el título o en el cuerpo (sin distinguir mayúsculas). Se recortan los espacios.

Cuerpo de la respuesta

Los nodos que ves (como mucho 1000).

application/json
  1. response
[index: integer]?

Un nodo de la Malla de Contexto (internal/api/context.go:15).

Petición de ejemplo
curl -X GET 'http://127.0.0.1:8080/api/w/string/context/nodes'
Respuesta de ejemplo
[  {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "short_id": "string",    "scope": "workspace",    "scope_id": "5d3fe357-12dd-4f62-b004-6d1fb3b8454f",    "scope_name": "string",    "slot": "instructions",    "kind": "rule",    "section": "string",    "slug": "string",    "title": "string",    "body": "string",    "uri": "string",    "tags": [      "string"    ],    "weight": 0,    "pinned": true,    "token_count": 0,    "state": "active",    "sensitivity": "low",    "helpful_count": 0,    "harmful_count": 0,    "use_count": 0,    "last_used_at": "2019-08-24T14:15:22Z",    "verified": true,    "source_type": "user",    "source_id": "ae50a35c-df42-4eff-ba26-f8bc28d2af81",    "source_name": "string",    "source_task_id": "b35bfd1f-7440-4b82-b05a-344d469d1482",    "metadata": null,    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z"  }]