Nippy API Platform

Ejemplos de lo que puedes preguntarle a tu agente

“¿Cuánta gente se inscribió al curso de inducción este mes?”
“¿Quiénes van a la mitad del curso de seguridad? Muéstrame su progreso”
“¿Qué porcentaje de alumnos pasó el examen final?”
“Entrégale su certificado a la sesión de Laura Martínez”
“Crea un curso nuevo de atención al cliente, con examen y certificado”

Learning te deja manejar tu LMS desde el chat. Consultas quién está avanzando, cómo van los exámenes, y emites certificados sin entrar a la plataforma. Igual que en las demás verticales, las operaciones que escriben datos te muestran un preview antes de ejecutarse.

Tools de lectura

`learning_list_courses`

Lista los cursos de este negocio.

limit

integer

predeterminado:"100"

Número máximo de cursos a retornar.

Respuesta incluye: _id, title, slug, description, published, isCertified, examApproveScore, created_at

{
  "name": "learning_list_courses",
  "arguments": {
    "limit": 20
  }
}

`learning_get_enrollment_stats`

Obtiene estadísticas de inscripciones: conteos por estado (in_progress, exam, completed, certified, failed).

course_id

string

ID del curso. Si se omite, retorna estadísticas de todos los cursos.

date_from

string

Fecha de inicio en ISO 8601 para filtrar por startedAt. Opcional.

date_to

string

Fecha de fin en ISO 8601 para filtrar por startedAt. Opcional.

Respuesta: total_enrollments, by_status (objeto con conteos por estado), completion_rate, certification_rate

{
  "name": "learning_get_enrollment_stats",
  "arguments": {
    "course_id": "664f1a2b3c4d5e6f7a8b9c0d",
    "date_from": "2026-01-01",
    "date_to": "2026-05-08"
  }
}

`learning_get_course_progress`

Obtiene el progreso por alumno para un curso específico.

course_id

string

predeterminado:"''"

ID del curso a consultar.

limit

integer

predeterminado:"100"

Número máximo de registros de progreso a retornar.

Respuesta: por cada alumno: status, módulo actual, módulos completados, score, estado de examen, e identidad (fullName, email).

{
  "name": "learning_get_course_progress",
  "arguments": {
    "course_id": "664f1a2b3c4d5e6f7a8b9c0d",
    "limit": 50
  }
}

`learning_get_exam_results`

Obtiene tasas de aprobación/reprobación y puntajes promedio de exámenes.

course_id

string

ID del curso. Si se omite, retorna resultados de todos los cursos.

Respuesta: total_exams_started, total_exams_completed, pass_rate, average_score

{
  "name": "learning_get_exam_results",
  "arguments": {
    "course_id": "664f1a2b3c4d5e6f7a8b9c0d"
  }
}

`learning_get_certificates_issued`

Lista los certificados emitidos por este negocio en un rango de fechas.

date_from

string

Fecha de inicio en ISO 8601. Opcional.

date_to

string

Fecha de fin en ISO 8601. Opcional.

limit

integer

predeterminado:"100"

Número máximo de certificados a retornar.

Respuesta incluye: session_id, info del usuario (fullName, email), info del curso (title, slug), detalles del certificado, y completedAt.

{
  "name": "learning_get_certificates_issued",
  "arguments": {
    "date_from": "2026-01-01",
    "date_to": "2026-05-08",
    "limit": 50
  }
}

Tools de escritura — Cursos

`learning_propose_create_course`

Genera un preview del borrador de curso. No escribe a la base de datos.

title

string

requerido

Título del curso.

slug

string

requerido

Slug único del curso en kebab-case (e.g. "induccion-nippy-2026").

description

string

predeterminado:"''"

Descripción del curso.

exam_approve_score

float

Puntaje mínimo para aprobar el examen (e.g. 70.0). Opcional.

is_certified

boolean

predeterminado:"false"

Si el curso otorga certificado al completarse.

{
  "name": "learning_propose_create_course",
  "arguments": {
    "title": "Inducción Nippy 2026",
    "slug": "induccion-nippy-2026",
    "description": "Curso de inducción para nuevos miembros de la plataforma Nippy. Cubre los fundamentos de operación, seguridad y uso de la consola.",
    "exam_approve_score": 70.0,
    "is_certified": true
  }
}

`learning_approve_create_course`

Crea el borrador del curso en la base de datos. Mismos parámetros que propose_create_course.

Solo llama esta tool después de mostrar al usuario el preview de propose_create_course y recibir confirmación explícita.

Respuesta: {"_id": "...", "title": "Inducción Nippy 2026", "status": "created"}

`learning_propose_update_course`

Genera un preview de los cambios a aplicar sobre un curso existente. No escribe a la base de datos. Solo los campos no-None se aplican.

course_id

string

requerido

ID del curso a actualizar.

title

string

Nuevo título del curso.

description

string

Nueva descripción del curso.

exam_approve_score

float

Nuevo puntaje mínimo de aprobación.

is_certified

boolean

Si el curso otorga certificado.

published

boolean

Si el curso está publicado y visible para alumnos.

{
  "name": "learning_propose_update_course",
  "arguments": {
    "course_id": "664f1a2b3c4d5e6f7a8b9c0d",
    "published": true,
    "exam_approve_score": 80.0
  }
}

`learning_approve_update_course`

Aplica los cambios al curso. Mismos parámetros que propose_update_course.

Solo llama esta tool después de mostrar al usuario el preview de propose_update_course y recibir confirmación explícita.

Respuesta: {"course_id": "664f1a2b3c4d5e6f7a8b9c0d", "updated": true}

Tools de escritura — Certificados

`learning_propose_issue_certificate`

Genera un preview de la emisión de un certificado. No escribe a la base de datos. Verifica que la sesión exista, esté completada y pertenezca al negocio.

session_id

string

requerido

ID de la sesión de curso completada.

{
  "name": "learning_propose_issue_certificate",
  "arguments": {
    "session_id": "665a1b2c3d4e5f6a7b8c9d0e"
  }
}

`learning_approve_issue_certificate`

Fuerza la certificación de una sesión completada. Marca el estado de la sesión como "certified".

session_id

string

requerido

ID de la sesión de curso a certificar.

Solo llama esta tool después de mostrar al usuario el preview de propose_issue_certificate y recibir confirmación explícita. Esta tool no genera el PDF ni envía el email — eso lo maneja whatsapp-platform por separado.

{
  "name": "learning_approve_issue_certificate",
  "arguments": {
    "session_id": "665a1b2c3d4e5f6a7b8c9d0e"
  }
}

Detalles técnicos (avanzado)

Referencias de esquemas para el agente:

URI	Nombre	Descripción
`nippy://learning/schema/schemas`	`learning_schemas`	Campos de cursos, sesiones y perfiles
`nippy://learning/schema/glossary`	`learning_glossary`	Términos de negocio y mapeos
`nippy://learning/skill`	`learning_skill`	Instrucciones para el agente

Notas importantes

Los cursos deben tener published: true antes de que los alumnos puedan acceder a ellos. Usa propose_update_course y approve_update_course para publicarlos.
La emisión de certificados desde MCP solo actualiza el estado de la sesión a "certified". La generación del PDF y el envío por email los maneja whatsapp-platform.

Inicio

SDK

MCP

Learning

Ejemplos de lo que puedes preguntarle a tu agente

Tools de lectura

`learning_list_courses`

`learning_get_enrollment_stats`

`learning_get_course_progress`

`learning_get_exam_results`

`learning_get_certificates_issued`

Tools de escritura — Cursos

`learning_propose_create_course`

`learning_approve_create_course`

`learning_propose_update_course`

`learning_approve_update_course`

Tools de escritura — Certificados

`learning_propose_issue_certificate`

`learning_approve_issue_certificate`

Notas importantes

Inicio

SDK

MCP

Documentation Index

​Ejemplos de lo que puedes preguntarle a tu agente

​Tools de lectura

​learning_list_courses

​learning_get_enrollment_stats

​learning_get_course_progress

​learning_get_exam_results

​learning_get_certificates_issued

​Tools de escritura — Cursos

​learning_propose_create_course

​learning_approve_create_course

​learning_propose_update_course

​learning_approve_update_course

​Tools de escritura — Certificados

​learning_propose_issue_certificate

​learning_approve_issue_certificate

​Notas importantes

Ejemplos de lo que puedes preguntarle a tu agente

Tools de lectura

`learning_list_courses`

`learning_get_enrollment_stats`

`learning_get_course_progress`

`learning_get_exam_results`

`learning_get_certificates_issued`

Tools de escritura — Cursos

`learning_propose_create_course`

`learning_approve_create_course`

`learning_propose_update_course`

`learning_approve_update_course`

Tools de escritura — Certificados

`learning_propose_issue_certificate`

`learning_approve_issue_certificate`

Notas importantes