GET/api/rag/{espacio}/config

Lee cómo responde el Cerebro

La configuración del asistente del espacio, qué campos puede cambiar tu clave y dentro de qué rangos. Es el mismo sobre que devuelve PATCH config.

PERMISOlee (vale cualquier clave)
CRÉDITOSno gasta
AUTENTICACIÓNBearer bth_…

Para cambiarla: PATCH config.

PARÁMETROS

CAMPO	TIPO	REQUERIDO	QUÉ ES
espacio	string	SÍ	El id del espacio (sale en GET /api/companies).

RESPUESTA 200

CAMPO	TIPO	QUÉ ES
config	object	La configuración del espacio. Los campos tuyos son los de editables (tabla de abajo).
editables	string[]	Los campos que puede cambiar ESTA clave, por orden alfabético. Con lee: [].
rangos	object	Por campo: { tipo, min?, max?, largo_max?, opciones? }. Valida con esto antes del PATCH.

LOS CAMPOS DE CONFIG QUE PUEDES CAMBIAR

CAMPO	TIPO	QUÉ ES
name	string	El nombre del asistente. Hasta 80 caracteres; no puede quedar vacío.
system_prompt	string	Sus instrucciones: cómo se presenta y cómo responde. Hasta 8000 caracteres.
refusal_message	string	Lo que responde con 1001. Hasta 1000 caracteres.
citation_label	string	El rótulo del pie de fuentes («Referencia»). Hasta 40; no puede quedar vacío.
strict_source_only	bool	Solo contesta con lo que dicen los documentos.
temperature	float	0 – 0,5. Más alto, más variación al redactar.
num_predict	int	512 – 4096. Hasta dónde puede alargarse una respuesta.
relevance_threshold	float	0 – 0,75. Por debajo, un fragmento no cuenta como relevante.
nli_entail_min	float	0,4 – 0,85. Cuánto tiene que apoyar el texto a cada frase.
nli_contradiction_faith_exempt	float	0,5 – 1,01. Si la respuesta está respaldada al menos en esta proporción, una contradicción aislada no la anula: sale con warning. 1,01 = toda contradicción da 1001.
verify_then_release	bool	Verifica la respuesta entera antes de soltarla. En el stream llega en un solo chunk.
numeric_check	bool	Comprueba las cifras de la respuesta contra los documentos.
retry_contradictory_refusal	bool	Si hay material suficiente y aun así contesta que no tiene información, lo intenta una vez más.
bm25_weight · semantic_weight	float	0 – 1 cada uno. Peso de la búsqueda por palabras y por significado; no pueden ser los dos 0.
rerank_top_n	int	1 – 10 fragmentos tras reordenar.
rerank_score_threshold	float	0 – 0,75. Descarta los fragmentos que puntúan menos al reordenar. 0 = ninguno.
condense_questions	bool	Reescribe las preguntas de seguimiento («¿y cuánto cuesta?») como preguntas completas antes de buscar.
query_translation	bool	Traduce la pregunta para buscar en documentos de otro idioma. Tarda algo más.
document_aliases	[{ aliases, source_substr }]	Otros nombres con los que se nombra un documento. Hasta 50, cada uno con hasta 20 nombres de 80 caracteres; source_substr es parte del nombre del archivo.
citation_max	int	0 – 5 fuentes citadas por respuesta.
cache_threshold	float	0 – 0,1. Cuánto puede diferir una pregunta de otra ya respondida para reusar su respuesta: más bajo, más estricto.

ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}

STATUS	CUÁNDO	DETAIL LITERAL
404	El espacio no existe	—
502	El servicio no respondió: reintenta con espera creciente	—

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

config trae también campos que solo ajusta Bentho. No dependas de ellos: pueden cambiar o desaparecer sin aviso. Los tuyos son los de editables.
Vale con una clave lee, pero entonces editables llega vacío.