Fuentes: cómo funciona

Fuentes trae información de la web pública a los documentos de tu espacio, para que Bentho la use al responder. Tiene dos formas de hacerlo:

• Fichas: le das un tema y una plantilla con los datos que quieres. Bentho busca, lee y llena cada campo con el dato, la página de la que sale y la frase literal que lo respalda.
• Fuentes: le das páginas o dominios concretos. Bentho los lee y los publica tal cual, cada vez que la lanzas.

Antes de empezar

• El espacio tiene que tener el módulo Fuentes: fuentes sale en sus módulos en GET /api/companies. Si no, cada ruta responde 403 módulo no habilitado para este espacio.
• Armar fichas y crear, lanzar, cancelar o borrar fuentes cambia los documentos del espacio: pide una clave escribe. Leer vale con cualquier clave.
• Las rutas cuelgan de /api/mod/fuentes/{espacio}/, con la misma clave y los mismos límites que el resto de la API.

Una ficha, paso a paso

1. Ármala con el tema y la plantilla: responde 202 con su id en recibido.
2. Consulta su estado cada 10 a 15 s hasta que sea publicado o fallido. Suele tardar unos minutos.
3. Lee lo que encontró en markdown: el valor, la página y la cita de cada campo, y la traza de la búsqueda.
4. Ya está en los documentos del espacio: Bentho la usa para responder desde ese momento.

Busca por vueltas: cada una busca solo los campos que siguen vacíos, y para cuando los llena todos o llega a sus topes (vueltas, páginas o tiempo). Un dato sin página que lo respalde no se inventa: el campo queda «sin respaldo en las páginas leídas».

Para comprobar un dato, pide el texto de la página de la que sale con página leída: es el que leyó la ficha, no la página de hoy.

El cierre externo

Con como.cierre_externo: true, al terminar las vueltas una búsqueda externa intenta llenar los campos que siguen vacíos:

• Si trae una página de los dominios permitidos y esa página respalda el dato, Bentho la lee y lo cita como cualquier otro.
• Si no, el campo se llena igual, pero sale marcado «completado por búsqueda externa, sin página que lo respalde». Revísalo antes de darlo por bueno.
• Gasta créditos a tarifa externa, aparte de lo que gasta la ficha. Si la búsqueda externa no responde, la ficha se arma sin ella.

La plantilla

Markdown: ## abre una sección y cada línea - Nombre: qué buscar es un campo. La descripción guía la búsqueda: di la unidad o el formato que esperas. El # del título se ignora; el tema llega aparte.

# Suelo

## Físico
- Textura: proporción de arena, limo y arcilla
- Densidad aparente: cifra y unidad

## Químico
- pH: valor y método de medida

Una plantilla sin ninguna sección con campos da 422 La plantilla no tiene secciones con campos.

Qué se publica, y dónde

• La ficha se publica en los documentos del espacio como ficha-<tema>.md, cortada en trozos que se entienden solos. Los campos vacíos no se publican.
• Armar otra ficha con el mismo tema la reemplaza: queda una versión nueva del mismo documento.
• Una fuente publica lo que lee cada vez que la lanzas. Borrarla quita de los documentos lo que publicó. Lo que trajo cada corrida queda en sus capturas.
• Si ningún campo se llenó, la ficha queda publicado pero no publica nada: traza.publicacion.status es sin_datos.
• publicado quiere decir armada. Si su paso a los documentos falla, traza.publicacion.status queda en fallida y se reintenta sola; con rechazada no se publicará, y conviene armarla otra vez.

Para que salga más completa

• Aporta 2 a 4 urls concretas del caso: suben cuántos campos se llenan. Si la ficha llena menos de la mitad sin ellas, traza.sugerencia te lo recuerda.
• Si hay casos parecidos que se mezclan (dos fincas, dos productos), enciende como.coherencia.
• Con como.dominios lee solo de los sitios que confías; con como.instrucciones, dile qué priorizar.

Créditos

• Armar una ficha y lanzar una fuente gastan créditos de la bolsa de tu cuenta. Lo que gasta cada una depende de cuánto tenga que buscar y leer; el cierre externo, si lo pides, se cobra aparte a tarifa externa.
• Con la bolsa agotada, las rutas que crean o lanzan responden 402 (bolsa_agotada). Leer y borrar siguen funcionando.
• El saldo, en la bolsa de créditos.

Rutas