buscar-recursos

Buscar evidencia y materiales docentes v3

El MCP kg-educacion (serverInfo 3.0.0) expone un KG privado e independiente. Las citas pueden apuntar a fuentes publicadas o distribuidas por MINEDUC, pero el KG y su catálogo no son oficiales ni están afiliados a MINEDUC.

Elegir la tool correcta

• Usa query_curriculum para verdad curricular: OA, indicadores, programas, unidades curriculares, horas, progresiones y evidencia pedagógica.
• Usa query_teaching_materials para materiales: textos del estudiante, guías docentes, cuadernos, actividades, BDA, multimedia, aplicaciones y materiales privados autorizados.
• Usa runtime_status solo para release, capacidades, cobertura o paridad.

Buscar por OA

1. Resuelve el OA con resolve_curricular_targets si el código o el alcance no son ya inequívocos.
2. Consulta query_curriculum para recuperar evidencia curricular citada.
3. Consulta query_teaching_materials con selectors.subject, selectors.grade y selectors.oa_codes. Usa package_id o package_ids solo si el libro ya está activo; si no, recupera ampliamente con esos selectores y filtra conservando procedencia. Para un OA explícito usa limit: 200 y copia paging.next_cursor en cursor hasta que paging.next_cursor sea null.
4. Presenta cada resultado con título, componente, disponibilidad, package_id, estructura interna, resource_ref y cita. No prometas contenido ausente o bloqueado.

Buscar por libro o bundle

1. Busca por asignatura, curso y tipo de componente con query_teaching_materials.
2. Trata package_id como la identidad del libro/bundle completo y mantenla en el contexto de la conversación cuando el docente elija ese material.
3. Trata material_id como una sección o material concreto. No lo uses para representar todo el libro.
4. Para hidratar una cita o recurso exacto, reutiliza el citation_id o resource_ref devuelto; no lo fabriques.

Buscar por "Unidad 1" del material

Con un package_id activo, llama:

{
  "package_id": "<libro activo>",
  "material_unit_number": 1
}

material_unit_kind es opcional. No lo infieras desde la palabra "Unidad"; omitido, admite unidad, lección, capítulo y sección equivalentes y presenta "estructura interna 1". No lo confundas con selectors.unit_number, una unidad curricular canónica.

Sin libro activo, recupera ampliamente por asignatura, curso y número. El modelo filtra o combina la evidencia con procedencia. Dentro del mismo paquete, unidad, lección, capítulo o sección pueden combinarse si la evidencia muestra el mismo alcance conceptual.

Varios paquetes

package_ids permite restringir, comparar o combinar materiales activos. Sin paquetes activos, usa una búsqueda amplia con asignatura, curso y selectors.oa_codes. Mantén la procedencia por paquete y deja que el modelo filtre; resuelve los OA antes de crear y aclara solo incompatibilidades reales.

Límite y paginación

En query_curriculum y query_teaching_materials, limit acepta de 1 a 200. Para una consulta acotada, usa el menor valor suficiente y termina con evidencia suficiente. Para OA explícitos o completitud exhaustiva usa limit: 200 y copia paging.next_cursor en cursor hasta que paging.next_cursor sea null. Nunca uses ni esperes has_more.

Pasar de búsqueda a creación

Resuelve el target con resolve_curricular_targets, conserva los resource_refs seleccionados y sintetiza el artefacto solicitado. La generación y sus validaciones pertenecen al modelo o aplicación consumidora, no al KG.

Reglas

• Cita siempre la fuente y distingue disponibilidad available, partial, metadata_only o blocked.
• Reconstruye o exporta material fuente solo cuando el runtime lo entregue como disponible para el usuario; nunca inventes texto, OA o enlaces ni eludas una restricción de acceso.
• Los ítems fuente y sus claves no son entregables.
• Si el MCP responde 401, usa setup.