Conceptos¶
Seis ideas explican cómo se comporta Renbase. Merecen diez minutos: casi todas las sorpresas vienen de esperar un buscador y encontrarse uno gobernado.
El corpus: dos tipos de contenido¶
El corpus de tu organización guarda dos cosas, y las respuestas beben de ambas a la vez.
Documentos es lo que ya está escrito: manuales, políticas, actas, guías. Los subes, Renbase los procesa e indexa, y su contenido pasa a ser consultable. Ver Documentos.
Definiciones es lo que tu organización ha decidido. No viven en ningún fichero, o viven en cuatro que se contradicen. Una métrica que aquí significa algo concreto, la fuente oficial de «cliente», una regla sobre qué sistema guarda qué registros. Ver Definiciones de negocio.
La distinción importa porque fallan de formas distintas: un documento puede quedarse anticuado; una definición puede estar en disputa. Renbase trata a las dos como contenido de primera clase, y una respuesta puede citar una de cada.
Colecciones¶
Una colección organiza los documentos de una organización: soporte, politicas, legal. Se crea nombrándola al subir un documento, y puedes acotar una pregunta a una colección concreta.
Las colecciones no separan clientes —eso lo hacen las organizaciones—. Dos organizaciones pueden tener ambas una colección soporte, con los mismos nombres de fichero, sin ver nunca el contenido de la otra.
Aprobación: nada se sirve sin revisar¶
Cualquier definición que produce una máquina —una importación desde tus herramientas, una sugerencia automática— nace como borrador. Los borradores son invisibles para las respuestas. Alguien con rol de administrador revisa la cola y aprueba, edita o rechaza.
Esa única regla es lo que hace fiable al corpus: todo lo que rige una respuesta tiene el nombre de una persona detrás.
Editar una definición aprobada no la sobrescribe: crea una versión nueva que reemplaza a la anterior, y el historial queda consultable, porque «esto cambió en marzo» ya es información en sí misma.
Citas y procedencia¶
Cada respuesta lleva citas, y cada cita lleva más que un enlace:
- Qué documento o definición sostiene la afirmación
- En qué versión
- Quién la aprobó, en el caso de las definiciones
- Cuándo se verificó por última vez contra su fuente
Eso es lo que hace defendible una respuesta en una revisión. Cuando alguien pregunta «¿por qué ha dicho esto?», la respuesta está registrada, no hay que reconstruirla.
Abstención, conflicto y caducidad¶
Tres situaciones en las que Renbase renuncia a darte una respuesta limpia, a propósito:
Sin respaldo. Nada en el corpus responde a la pregunta. Recibes una abstención explícita en lugar de una suposición bien redactada. El arreglo es de contenido, no de prompt: sube el documento o añade la definición.
Conflicto. Dos definiciones aprobadas del mismo término se solapan: finanzas cuenta de una manera y producto de otra. Se devuelven las dos, marcadas como conflicto y con su procedencia. Renbase no elige ganador en silencio; lo resuelve tu equipo.
Caducidad. La fuente de una definición desapareció o cambió. La entrada queda marcada como caducada en vez de borrarse, y las respuestas que se apoyan en ella lo advierten. Retirarla es una decisión humana.
Organizaciones, miembros y claves¶
La organización es la entidad dueña: tiene el corpus, los miembros, las claves y el consumo.
Los miembros son personas, con rol admin o read. Entran con un código de un solo uso que reciben por email; no hay contraseñas que gestionar ni que filtrar. Los administradores invitan miembros, aprueban definiciones y emiten claves; quien tiene rol de lectura pregunta.
Las claves de API son credenciales para servicios y agentes, no para personas. Emite una por integración para poder revocarla de forma aislada; la revocación surte efecto al instante.
Toda petición, venga de una persona, de un servicio o de un agente, queda acotada a la organización de su credencial. El contenido de otra organización no es que se filtre de los resultados: está fuera de alcance.