Cómo convertir objetivos de usuario en planes secuenciales de acciones con la API de descomposición de tareas de Aspose.Cells Cloud AI
El endpoint DecomposeUserTask proporciona una API REST para convertir una descripción de tarea en formato libre en un plan de acciones detallado y secuencial que cumple con los criterios SMART. Asigna automáticamente estimaciones de tiempo en horas, formatea la salida para importación compatible con Redmine y crea nodos de hitos del proyecto. Al proporcionar únicamente la lista de tareas en bruto y estimaciones de tiempo opcionales, la API devuelve un archivo listo para usar (CSV, XLSX, etc.) que puede importarse directamente en herramientas de gestión de proyectos, automatizando la descomposición de tareas y reduciendo el esfuerzo manual.
API de descomposición de tareas de usuario
API web
PUT https://api.aspose.cloud/v4.0/cells/ai/task/decompose
Seguridad y autenticación
Las API de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.
Parámetros de solicitud:
| Nombre del parámetro | Tipo | Ubicación | Obligatorio/Opcional | Descripción |
|---|---|---|---|---|
| TaskDescription | string | Cuerpo | Obligatorio | Descripción en texto plano del objetivo general del usuario. El servicio analiza la descripción y genera tareas individuales. Ejemplo: “Lanzar campaña de marketing para el T3, incluyendo creación de contenido, envío masivo de correos y anuncios en redes sociales.” |
Respuesta
Respuesta correcta (200 OK)
Content‑Type: application/octet-stream (flujo binario de archivo)
Encabezados:
Content-Disposition: attachment; filename="DecomposedTaskPlan.xlsx"Content-Length: <tamaño en bytes>
La misma estructura se utiliza para formatos XLSX/ODS, con las columnas colocadas en la primera hoja de cálculo.
Códigos de estado HTTP
| Código | Significado | Descripción |
|---|---|---|
| 200 | OK | Filtro aplicado correctamente; la respuesta contiene detalles de la operación. |
| 400 | Solicitud incorrecta | Parámetros ausentes o inválidos (por ejemplo, tipo de archivo no admitido). |
| 401 | No autorizado | Token JWT inválido o ausente. |
| 413 | Carga demasiado grande | El archivo cargado supera el límite de tamaño. |
| 500 | Error interno del servidor | Error inesperado en el servidor. |
Ejemplo de respuesta de error (400 Solicitud incorrecta)
{
"code": "InvalidParameter",
"message": "El campo 'TaskDescription' es obligatorio y no puede estar vacío."
}
Ejemplo de cuerpo de solicitud (JSON)
{
"TaskDescription": "Desarrollar una API web para una funcionalidad de división de tareas en el sistema existente."
}
Ejemplo de respuesta
La API devuelve un flujo binario que contiene el archivo generado. Para previsualizar las primeras filas de una respuesta en CSV, decodifique el flujo y visualice la fila de encabezados, por ejemplo:
ID,Subject,Trucker,Estimated Duration,Description
1 Recolección de requisitos para la API de división de tareas Analista de negocio 8 Recopilar requisitos funcionales y no funcionales, historias de usuario y criterios de aceptación para el nuevo endpoint de división de tareas.
2 Especificación de la API (OpenAPI) Analista de negocio 6 Definir el contrato OpenAPI para POST /tasks/split, incluyendo esquema de solicitud, formatos de respuesta, códigos de error y requisitos de seguridad.
3 Diseño del algoritmo de división y del modelo de datos Arquitecto de soluciones 5 Diseñar el algoritmo central que divide una tarea principal en subtareas, y ampliar el modelo de datos (tablas/entidades de base de datos) para almacenar la jerarquía y los metadatos.
4 Revisión de integración de arquitectura Arquitecto de soluciones 4 Analizar el impacto en los servicios existentes, flujos de eventos y migraciones de base de datos; producir el plan de integración.
...
¿Dónde debemos utilizar la API de descomposición de tareas de usuario?
- Inicio de proyectos: Convertir un resumen de proyecto de alto nivel en una lista de tareas compatible con Redmine que incluya estimaciones de tiempo, permitiendo una planificación inmediata de sprints.
- Automatización de marketing: Descomponer objetivos de campañas en pasos ejecutables, exportar como CSV e importar en herramientas de gestión de tareas para coordinación entre equipos.
- Asignación de recursos: Generar estimaciones basadas en horas para cada subtarea, permitiendo a los gerentes equilibrar la carga de trabajo entre miembros del equipo antes del inicio del proyecto.
- Seguimiento de hitos: Crear automáticamente nodos de hitos que puedan sincronizarse con herramientas de diagramas de Gantt, garantizando que cada fase tenga un entregable claro.
¿Por qué debería utilizar la API de descomposición de tareas de usuario?
- Salida conforme a SMART asegura que cada tarea generada cumpla con los criterios Específica, Medible, Alcanzable, Relevante y Temporal.
- Estimación de tiempo basada en horas integrada elimina la necesidad de cálculos manuales y mejora la precisión de las proyecciones.
- Formatos de archivo listos para importar (CSV, XLSX, etc.) facilitan la integración con Redmine, Jira, Azure DevOps y otras plataformas de gestión de proyectos.
- Automatización en una sola solicitud permite la descomposición de tareas mediante una única solicitud, acelerando el inicio del proyecto y minimizando el esfuerzo manual.
Cómo utilizar la API de descomposición de tareas de usuario con SDK
Especificación de la API de descomposición de tareas de usuario
La Especificación de la API de descomposición de tareas de usuario proporciona una interfaz de programación accesible públicamente para ejecutar interacciones REST directamente desde un navegador web.
SDK para API de Excel
Uso de los SDK de Aspose.Cells Cloud
Utilizar el SDK es la forma más rápida de desarrollar, ya que abstracte los detalles de bajo nivel y permite invocar el endpoint DecomposeUserTask con código conciso.
Consulte el repositorio de GitHub para obtener una lista completa de los SDK de Aspose.Cells Cloud.
Los siguientes ejemplos de código muestran cómo interactuar con los servicios web de Aspose.Cells mediante diversos SDK: