Ir al contenido
HQ Fabric

Previsualiza el contexto que recibiría un agente

Responde «¿qué recibiría exactamente este agente para este issue?»: ensambla el paquete de contexto con la misma lógica que al reclamar una tarea (mismo nivel 1 del SDLC del issue), sin guardar nada. Primero se comprueba el issue: si no existe o no lo ves, 404. Después `agent_id`: si no es un uuid, 400 `agent_required`; si no es un agente de este workspace, 404. La rama del paquete es la del SDLC del issue o, si no tiene, `hqf/<prefijo en minúsculas>-<número>-<slug del agente>-preview`; la base, la rama por defecto del proyecto del issue o `main`. `prompt` hace de petición de la tarea.

POST
/api/w/{ws}/context/preview

Responde «¿qué recibiría exactamente este agente para este issue?»: ensambla el paquete de contexto con la misma lógica que al reclamar una tarea (mismo nivel 1 del SDLC del issue), sin guardar nada.

Primero se comprueba el issue: si no existe o no lo ves, 404. Después agent_id: si no es un uuid, 400 agent_required; si no es un agente de este workspace, 404. La rama del paquete es la del SDLC del issue o, si no tiene, hqf/<prefijo en minúsculas>-<número>-<slug del agente>-preview; la base, la rama por defecto del proyecto del issue o main. prompt hace de petición de la tarea.

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).

Cuerpo de la petición

application/json
  1. body

Cuerpo de la vista previa del contexto (struct anónimo, internal/api/context.go:536).

issue_number*integer

Número del issue en el workspace.

agent_id*string
Formatuuid
prompt?string

La petición de la tarea (opcional).

Cuerpo de la respuesta

El paquete de contexto ensamblado.

application/json
  1. response

El paquete de contexto ensamblado para un agente (contextmesh.Bundle, internal/contextmesh/assemble.go:88).

budget_tokens*integer

Ventana nominal del agente (24000 si el agente no tiene una).

target_tokens*integer

Presupuesto × utilización objetivo (0.7 por defecto); tope duro de la selección.

used_tokens*integer
utilization*number
included*array<>
dropped*array<>
clashes*array<>
slots*

Tokens por ranura (instructions, knowledge, tools, memory, state, query).

static_prefix*string

Nivel 1 del prefijo, compartido entre los issues de un agente y proyecto.

issue_prefix*string

Nivel 2, los nodos fijados de la capa issue; va al principio de dynamic_part.

dynamic_part*string
prefix_hash*string
issue_prefix_hash*string
rendered*string

El texto final que recibiría el agente.

skills_mode*string

Con qué modo se ensambló el protocolo de skills.

prefix_tokens*integer

Tokens del nivel 1.

Petición de ejemplo
curl -X POST 'http://127.0.0.1:8080/api/w/string/context/preview' \  -H 'Content-Type: application/json' \  -d '{  "issue_number": 0,  "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978"}'
Respuesta de ejemplo
{  "budget_tokens": 0,  "target_tokens": 0,  "used_tokens": 0,  "utilization": 0,  "included": [    {      "node_id": "6e0bdcac-9717-4a6f-972e-97489dffeb0c",      "short_id": "string",      "title": "string",      "scope": "string",      "slot": "string",      "kind": "string",      "tokens": 0,      "score": 0,      "reason": "string"    }  ],  "dropped": [    {      "node_id": "6e0bdcac-9717-4a6f-972e-97489dffeb0c",      "short_id": "string",      "title": "string",      "scope": "string",      "slot": "string",      "kind": "string",      "tokens": 0,      "score": 0,      "reason": "string"    }  ],  "clashes": [    {      "kept": "string",      "dropped": "string",      "relation": "string"    }  ],  "slots": {    "property1": 0,    "property2": 0  },  "static_prefix": "string",  "issue_prefix": "string",  "dynamic_part": "string",  "prefix_hash": "string",  "issue_prefix_hash": "string",  "rendered": "string",  "skills_mode": "string",  "prefix_tokens": 0}