# Context pack: Conceptos básicos Source: https://nordvec.com/es/docs/guides/concepts Pack: https://nordvec.com/es/docs/packs/concepts This pack bundles one Nordvec guide with the guides it builds on and the guides it links to, in reading order, so an assistant reading it meets no reference it cannot follow. ## Contents 1. [Conceptos básicos](https://nordvec.com/es/docs/guides/concepts) (this guide) 2. [Documentos y búsqueda](https://nordvec.com/es/docs/guides/concepts/documents) (linked from this guide) 3. [Conversaciones y citas](https://nordvec.com/es/docs/guides/concepts/conversations) (linked from this guide) --- # Conceptos básicos Source: https://nordvec.com/es/docs/guides/concepts Las dos cosas en las que se basa todo en Nordvec: documentos que puedes buscar y conversaciones que los citan. Cada conector, envío y búsqueda en Nordvec produce o lee un documento, y cada respuesta que da el asistente es una conversación basada en esos documentos. Empieza aquí para aprender qué contiene cada uno y quién puede verlo. - [Documentos y búsqueda](https://nordvec.com/es/docs/guides/concepts/documents): Los documentos son la unidad buscable en Nordvec. Ingiérelos y luego encuéntralos con búsqueda de texto completo a través de la API. - [Conversaciones y citas](https://nordvec.com/es/docs/guides/concepts/conversations): Una conversación es un chat basado en tus documentos, donde cada respuesta se rastrea hasta su fuente. --- # Documentos y búsqueda Source: https://nordvec.com/es/docs/guides/concepts/documents Los documentos son la unidad buscable en Nordvec. Ingiérelos y luego encuéntralos con búsqueda de texto completo a través de la API. Un **documento** es la unidad sobre la que busca Nordvec: un archivo, una página, un mensaje, un correo electrónico, cualquier cosa que ingieras. Una vez procesado, el documento se vuelve buscable y puede citarse en una respuesta. ## Ingesta de documentos [#ingesta-de-documentos] Los documentos llegan a tu espacio de trabajo de tres formas: * **Conectores** sincronizan desde un origen que posees (el propietario del conector). Los documentos nuevos y modificados se recogen automáticamente. Consulta el [catálogo de conectores](/docs/guides/connectors). * **Subidas** de archivos que añades en la aplicación. * **Push** envía un documento a Nordvec directamente desde tu propio sistema. Consulta [Push documents](/docs/guides/how-to/push-documents). Independientemente de cómo llegue, Nordvec procesa el documento, lo divide en pasajes e indexa para su recuperación. Tus documentos se almacenan y buscan en la UE. Un documento tiene un `status`: `processing` mientras se está indexando, `indexed` una vez que se han completado todos los pasos de procesamiento, y `failed` cuando no se pudo procesar. ## Quién ve un documento [#quién-ve-un-documento] Un documento de un conector es privado para la persona que lo conectó hasta que esta lo comparte. Una clave API pertenece al espacio de trabajo, por lo que ve lo que el espacio de trabajo comparte y nunca los documentos no compartidos de una persona. ## Búsqueda [#búsqueda] `/documents/search` es una búsqueda **de texto completo** sobre el título y todo el texto de cada documento que puedes ver, sin importar la longitud del documento. Las palabras coinciden en la forma en que las escribes, en cualquier idioma, y los acentos se ignoran en ambos lados, por lo que `cafe` encuentra `café`. No hay lematización: `invoice` no coincide con `invoices`. La búsqueda se ejecuta de forma independiente, sin contexto de conversación. Devuelve documentos clasificados, cada uno con un fragmento de su pasaje mejor coincidente y una puntuación de relevancia de 0 hasta, pero sin llegar nunca, a 1. ```bash curl https://nordvec.com/api/v1/documents/search \ -H "Authorization: Bearer $NORDVEC_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "renewal terms", "limit": 10 }' ``` También puedes listar documentos (`/documents/list`) o recuperar uno por su id (`/documents/{id}`). Consulta la [referencia de la API](/docs/api) para ver el conjunto completo de parámetros y las formas de respuesta. ### Pruébalo [#pruébalo] Ejecuta una consulta contra un pequeño corpus de demostración. Esto busca en seis documentos de ejemplo en tu navegador, clasificados y con fuente, con la misma forma que devuelve una búsqueda real. La recuperación semántica, que coincide con pasajes por significado en lugar de palabras exactas, es lo que impulsa las respuestas citadas de una [conversación](/docs/guides/concepts/conversations). El propio endpoint de búsqueda coincide con palabras. La búsqueda solo devuelve documentos que el llamante tiene permitido ver. El acceso se aplica en la base de datos, no en el código de la aplicación. ## Tipos de contenido [#tipos-de-contenido] Un documento puede llevar un tipo de conocimiento en `content_type` (por ejemplo, `decision`, `runbook`, `policy` o `faq`). Un documento enviado por push lo establece con el `type` de la API de push; un documento sin tipo tiene `content_type: null`. Tanto la búsqueda como el listado filtran por él con `contentType`. ## Dónde se citan los documentos [#dónde-se-citan-los-documentos] La búsqueda te proporciona pasajes con los que trabajar directamente. Cuando prefieres una respuesta escrita en lugar de pasajes sin procesar, una [conversación](/docs/guides/concepts/conversations) recupera los mismos documentos y los cita en su respuesta. --- # Conversaciones y citas Source: https://nordvec.com/es/docs/guides/concepts/conversations Una conversación es un chat basado en tus documentos, donde cada respuesta se rastrea hasta su fuente. Una **conversación** es un chat basado en tus documentos. Tú formulas una pregunta, Nordvec recupera los pasajes relevantes y responde a partir de ellos, citando los documentos que ha utilizado. Si los documentos no respaldan una respuesta, lo indica en lugar de adivinar. ## Las citas son el punto clave [#las-citas-son-el-punto-clave] Cada respuesta incluye las fuentes de las que se ha generado. Esto es intencional: una respuesta RAG que no puedes rastrear es un riesgo, no una funcionalidad. Las citas permiten que una persona acceda al documento exacto del que proviene una afirmación y lo confirme, que es precisamente lo que necesitan los trabajos regulados y de alto impacto. Las respuestas son generadas por IA. Las citas son lo que las hace verificables, no solo plausibles. ## Las conversaciones pertenecen a una persona [#las-conversaciones-pertenecen-a-una-persona] Una conversación es propiedad de la persona registrada que la inició, por lo que sus puntos finales responden a una **sesión**, nunca a una clave API. Una clave es su propio principal sin historial de chat propio; consulta [Autenticación](/docs/guides/authentication). Con una sesión puedes: * **Crear** una conversación (`POST /conversations`). * **Listar** y **buscar** tus conversaciones (`GET /conversations`, `GET /conversations/search`). * **Recuperar** una conversación con sus mensajes recientes (`GET /conversations/{id}`), y paginar hacia atrás para ver el historial más antiguo (`GET /conversations/{id}/messages`). * **Listar los documentos** que una conversación ha utilizado (`GET /conversations/{id}/documents`). Consulta la [referencia de la API](/docs/api) para ver las formas exactas de solicitud y respuesta. ## Comentarios [#comentarios] Puedes enviar comentarios sobre una respuesta y sobre los pasajes que se recuperaron. Esa señal se utiliza para mejorar la calidad de la recuperación con el tiempo.