PATCH
/api/rag/{espacio}/configAjusta cómo responde el Cerebro
Cambia solo los campos que mandes. Surte efecto en la siguiente pregunta. Los rangos válidos de cada campo te los da el GET de la misma ruta en rangos.
- PERMISOescribe
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
GET /api/rag/{espacio}/config devuelve el mismo sobre sin cambiar nada (vale con una clave lee).
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| temperature | float | no | 0 – 0,5. Más alto, más variación al redactar. |
| relevance_threshold | float | no | 0 – 0,75. Por debajo, un fragmento no cuenta como relevante. |
| citation_max | int | no | 0 – 5 fuentes citadas por respuesta. |
| rerank_top_n | int | no | 1 – 10 fragmentos tras reordenar. |
| bm25_weight · semantic_weight | float | no | 0 – 1 cada uno; no pueden ser los dos 0. |
| system_prompt | string | no | Hasta 8000 caracteres. |
| refusal_message | string | no | Lo que responde con 1001. Hasta 1000 caracteres. |
| citation_label | string | no | El rótulo del pie de fuentes («Referencia»). Hasta 40. |
| strict_source_only | bool | no | Solo contesta con lo que dicen los documentos. |
| nli_entail_min | float | no | 0,4 – 0,85. Cuánto tiene que apoyar el texto a cada frase. |
| cache_threshold | float | no | 0 – 0,1. Parecido mínimo para reusar una respuesta. |
| num_predict | int | no | 512 – 4096. Hasta dónde puede alargarse una respuesta: más alto, más larga. |
| … | no | Y 10 más: la lista completa, con rangos, sale en editables y rangos del GET. |
RESPUESTA 200
El mismo sobre que el GET, con la configuración ya guardada.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| config | object | La configuración del espacio. |
| editables | string[] | Los campos que puede cambiar ESTA clave. Con lee: []. |
| rangos | object | Por campo: { tipo, min?, max?, largo_max?, opciones? }. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | Clave de solo lectura | Tu cuenta es de solo lectura en este espacio. |
| 403 | Un campo que solo cambia Bentho | «<campo>» solo lo puede cambiar un administrador de la plataforma. |
| 422 | Cuerpo vacío | No hay nada que cambiar. |
| 422 | Fuera de rango | «<campo>» tiene que estar entre <min> y <max>. |
| 422 | Campo desconocido | «<campo>» no se puede cambiar desde aquí. |
| 422 | Los dos pesos a 0 | La búsqueda necesita algún peso: no pueden ser los dos 0. |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- No admite
null: cada campo exige su tipo. Un entero vale donde se pide un decimal. - Los demás campos de la configuración solo los cambia Bentho: con una clave responden 403.