Skill de Registros de Conversaciones - Servicio al Cliente Xiao Xin
Skill para consultar y exportar registros de conversaciones del servicio al cliente 'Xiao Xin', y procesarlos para generar una tabla de revisión manual o una tabla detallada de aciertos de conocimiento. Tres flujos pueden ejecutarse de forma independiente o en cadena: consulta/exportación (fuente de datos) -> tabla de revisión manual / tabla detallada de aciertos de conocimiento (basada en los registros exportados).
Escenarios de activación
- "Consultar/exportar registros de conversaciones del servicio al cliente Xiao Xin de X a Y"
- "Generar tabla de revisión manual del servicio al cliente Xiao Xin de X a Y" (consulta y exporta automáticamente los registros primero)
- "Generar detalle de aciertos de conocimiento del servicio al cliente Xiao Xin de X a Y" (consulta y exporta automáticamente los registros primero)
Formato de fecha YYYY-MM-DD. --end incluye el día completo.
Dependencias previas
python3+pandas+openpyxl+pymysql. Si faltan, ejecutarpip3 install pandas openpyxl pymysql(priorizar espejos nacionales).- Variables de entorno
DMS_HOST/DMS_PORT(por defecto 3306) /DMS_DB/DMS_ACCESS_ID/DMS_ACCESS_SECRET(configurar en~/.zshenv, abrir nueva terminal para que surtan efecto). - DMS es una dirección de red interna; se requiere VPN de la empresa activa.
Flujo de ejecución
Los tres scripts generan salida por defecto en el directorio de trabajo actual (cwd). {SKILL_DIR} = ~/.codex/skills/customer-service-records/scripts.
1. Consultar y exportar registros de conversaciones
python3 {SKILL_DIR}/dms_query.py --start 2026-07-03 --end 2026-07-04
# Equivalente para un solo día: --date 2026-07-03
- Conecta a DMS, ejecuta una consulta SQL fija y exporta a xlsx
- Salida:
RegistrosConversaciones_XiaoXin_<inicio>~<fin>.xlsx - La SQL es una plantilla fija interna; solo se permite modificar el rango de tiempo mediante
--start/--end/--date. No se deben alterar las partes SELECT/JOIN/CASE. - Particionamiento automático: El proxy de acceso seguro de DMS limita cada consulta a 3000 filas. El script primero cuenta las filas totales; si supera el umbral (2900 filas), divide automáticamente por días y combina los resultados, realizando una verificación de integridad final. La persona que llama no necesita preocuparse por la lógica de partición; la salida es siempre un único archivo xlsx completo.
2. Generar tabla de revisión manual
Primero ejecutar el flujo 1 para obtener el xlsx de registros de conversaciones, luego:
python3 {SKILL_DIR}/custom_service_data_transfer.py "<ruta_del_xlsx_de_registros>" --start 2026-07-03 --end 2026-07-04
- Divide el campo "conocimiento relacionado" en múltiples filas. Añade columnas: ¿Requiere revisión manual?, contenido del conocimiento, puntuación del conocimiento, fuente del conocimiento.
- Solo conserva las filas que requieren revisión manual (voto negativo / sin conocimiento relevante / conocimiento insuficiente para resumir respuesta, o respuesta correcta con relevancia de conocimiento > 0.25)
- Salida:
RevisionManual_XiaoXin_<inicio>~<fin>.xlsx
3. Generar tabla detallada de aciertos de conocimiento
Primero ejecutar el flujo 1 para obtener el xlsx de registros de conversaciones, luego:
python3 {SKILL_DIR}/process_to_knowledge_detail.py "<ruta_del_xlsx_de_registros>" --start 2026-07-03 --end 2026-07-04
- Divide el campo "conocimiento relacionado" en múltiples filas. Añade columnas: conocimiento, ID del conocimiento, fuente del conocimiento, puntuación del conocimiento, conocimiento-pregunta, conocimiento-respuesta.
- Conserva todas las filas (sin filtro)
- Salida:
DetalleAciertosConocimiento_XiaoXin_<inicio>~<fin>.xlsx
Formato de nombres de archivo
XiaoXin_{RegistrosConversaciones|RevisionManual|DetalleAciertosConocimiento}_<inicio>~<fin>.xlsx, fechas en YYYY-MM-DD, inicio y fin separados por ~.
La barra inclinada
/es un separador de rutas y no puede usarse en nombres de archivo, por lo que las fechas se separan con-y el inicio y fin con~.
Sobre la SQL
dms_query.py contiene una plantilla SQL fija que consulta los detalles de preguntas y respuestas del servicio al cliente Xiao Xin desde aim.custom_service_chat LEFT JOIN company.company. Solo se permite modificar el rango de tiempo (mediante parámetros de línea de comandos); el resto no debe alterarse. Los detalles de la SQL se encuentran en SQL_TEMPLATE dentro del script.
Adicionalmente, el script incluye COUNT_SQL (que utiliza las mismas condiciones WHERE que SQL_TEMPLATE) para contar las filas totales antes de la exportación y decidir si es necesario particionar. Esta consulta COUNT no involucra JOIN, solo cuenta filas de la tabla custom_service_chat.
Límite de 3000 filas de DMS
El proxy de acceso seguro de DMS tiene un límite de 3000 filas por resultado de consulta. dms_query.py garantiza la integridad de los datos mediante la siguiente estrategia:
- Primero usa una consulta COUNT para contar el número total de filas en el rango de tiempo objetivo
- Si el total de filas <= 2900 (dejando un margen de 100 filas), realiza una única consulta de exportación
- Si el total de filas > 2900, divide por día; si algún día aún excede el límite, subdivide por 6 horas -> 1 hora
- Después de combinar los resultados de todas las particiones, realiza una verificación de coherencia de recuento de filas con el resultado de COUNT
Al finalizar
Informar el nombre del archivo generado y su ruta absoluta.