Context Mode
Inicio seguro con Context Mode: indexar una nota y comprobar sus pasajes
Prueba ctx_index y ctx_search con notas de lanzamiento inventadas, respuestas conocidas y una pregunta sin evidencia antes de conectar datos reales.
Qué aprenderás
- Prueba contenido inventado con respuestas conocidas.
- Usa una etiqueta distintiva y lee el pasaje recuperado.
- Los hechos ausentes deben seguir siendo desconocidos.
Antes de empezar
- JSON y conceptos MCP básicos
- Cliente aislado y datos inventados
Explica el límite real de la implementación y verifícalo con una muestra de evidencia explícita.
Conclusiones clave
- Prueba contenido inventado con respuestas conocidas.
- Usa una etiqueta distintiva y lee el pasaje recuperado.
- Los hechos ausentes deben seguir siendo desconocidos.
Usar una integración aislada ya configurada
Empieza en un cliente de prueba que ya tenga registradas las herramientas de Context Mode; el capítulo de despliegue explica esa frontera. No indexes primero tu directorio personal, credenciales o archivos de registros de producción. La muestra contiene una etiqueta de lanzamiento, un tiempo de espera y una condición de reversión completamente inventados.
Envía la nota como content a ctx_index con una etiqueta source distintiva. El esquema inspeccionado acepta content o path, no ambos, y devuelve metadatos de indexación en lugar del documento completo. Guarda esos metadatos. La operación no se anuncia como idempotente: enviar la misma muestra repetidamente no comprueba de forma fiable una base limpia ni la deduplicación.
Preguntar por respuestas conocidas de antemano
Invoca ctx_search con queries que incluyan términos concretos de la nota y un filtro source correspondiente a la muestra. Busca, por ejemplo, la etiqueta de lanzamiento y el umbral de reversión. Lee el pasaje y verifica simultáneamente valor y condición. Un número sin unidad o condición asociada no basta para justificar una decisión de despliegue.
Pregunta después por una migración de base de datos que la nota no especifica. Una recuperación vacía o irrelevante debe quedar como desconocida, no convertirse en un plan inventado. La ruta inspeccionada admite coincidencia parcial de source: una etiqueta distintiva reduce solapamientos, pero no constituye un control de acceso ni garantiza coincidencia exacta.
Registrar cambios de estado y detenerse en la frontera adecuada
Como segunda práctica, indexa una nota desde un archivo de prueba y modifica su tiempo de espera. La búsqueda comprueba cambios en fuentes de archivo usando la fecha de modificación como filtro previo al hash. Verifica después fuente y valor; no supongas que un content en línea sigue un archivo ni que una página remota se actualiza automáticamente de igual manera.
Son ejercicios propuestos, no resultados de una ejecución completa del proyecto. Registra versiones del cliente y paquete, etiqueta, respuesta esperada y pasaje real. Si falla una llamada, distingue registro ausente, fallo de indexación y recuperación incorrecta. No ejecutes una actualización ni una purga destructiva solo para que la primera demostración parezca funcionar.
Pasos de implementación
- 1
Indexa la muestra con ctx_index en la integración de prueba.
- 2
Consulta lanzamiento, espera y reversión mediante ctx_search.
- 3
Formula una pregunta sin respuesta y registra la falta de evidencia.
- 4
Prueba por separado la edición de una fuente de archivo.
Ejemplo para copiar
{
"tool": "ctx_index",
"arguments": {
"source": "fixture-release-larch-20260907",
"content": "# Lanzamiento LARCH-42\nEspera: 18 segundos.\nRevertir cuando los errores superen el 2 por ciento.\nNo se especifica una decisión de migración."
}
}Preguntas frecuentes
¿Para qué sirve la etiqueta de fuente?
Acota la evidencia prevista y facilita auditar el resultado. La coincidencia parcial inspeccionada no es un mecanismo de autorización.
¿Puedo repetir la indexación para comprobar deduplicación?
No presupongas ese comportamiento: la anotación de ctx_index lo marca explícitamente como no idempotente.
Fuentes
- README.mdFuente verificada 2026-09-07
- package.jsonFuente verificada 2026-09-07
- LICENSEFuente verificada 2026-09-07
- src/store.tsFuente verificada 2026-09-07
- src/search/unified.tsFuente verificada 2026-09-07
- src/server.tsFuente verificada 2026-09-07
- src/executor.tsFuente verificada 2026-09-07
- src/security.tsFuente verificada 2026-09-07
- src/session/purge.tsFuente verificada 2026-09-07
- tests/store-bytecap.test.tsFuente verificada 2026-09-07