ManagedSkill

El componente ManagedSkill actúa como un “descripto” o plantilla fundamental dentro del sistema de automatización de Nappai. Su propósito principal no es ejecutar una tarea específica por sí mismo, sino definir cómo se presenta y se organiza una habilidad dentro de tu espacio de trabajo.

Piensa en este componente como la tarjeta de presentación de una herramienta: establece el nombre, el icono, la descripción y la documentación asociada a una habilidad. Esto asegura que, cuando uses herramientas en tu dashboard, estas tengan una apariencia consistente y sean fácilmente reconocibles para ti y para el sistema.

¿Cómo funciona?

Internamente, este componente funciona como un contenedor inteligente que hereda reglas estándar de otros componentes base. Cuando agregas una habilidad a tu flujo de trabajo, ManagedSkill se asegura de que esa habilidad tenga:

Identidad Clara: Asigna automáticamente un identificador único y un nombre descriptivo.
Metadatos Estandarizados: Utiliza valores por defecto (como el ícono de “Libro” 📖) para que la habilidad se vea visualmente coherente con el resto de tu biblioteca.
Interfaz Estandarizada: Define qué tipos de datos entran y salen de la habilidad, facilitando la conexión con otros nodos en tu flujo de automatización.

Es importante notar que este componente es una estructura base. La lógica específica de lo que hace la habilidad (por ejemplo, enviar un correo o analizar un dato) la delega a otros componentes que se construyen sobre esta base. Aquí, tu foco está en configurar la identidad de la herramienta.

Conexión y Credenciales

Este componente no requiere la configuración directa de credenciales de API externas (como contraseñas o claves de acceso) en esta etapa, ya que su función es descriptiva y de estructura. Sin embargo, las habilidades que utilicen esta base necesitarán haber sido previamente configuradas en tu panel de Nappai.

Entradas

A continuación, se detallan los campos disponibles para configurar la identidad de este componente. Estos campos permiten al sistema reconocer y catalogar correctamente la habilidad.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Estos campos suelen estar visibles para permitir la personalización de la identidad de la habilidad:

Skill: [Identificador interno para la habilidad (ej. ‘slack’). Se establece automáticamente por el mercado de herramientas, pero puedes verlo aquí para referencia.].
- Visible en: Todas las operaciones

Salidas

Este componente está diseñado para definir la estructura de una habilidad. Dependiendo de la implementación específica de la habilidad que estés utilizando en tu flujo, la salida principal será el resultado de la tarea automatizada.

Ejemplo de Respuesta JSON

Dado que este es un componente de estructura, el “resultado” real depende de la lógica de la habilidad hija. Sin embargo, en un flujo típico, esperarías recibir los datos procesados por esa habilidad. A continuación, se muestra un ejemplo de cómo podría verse la salida de una habilidad que utiliza esta estructura base después de completar una acción: json { “status”: “success”, “data”: { “skill_id”: “managed_skill_base”, “processed_value”: “Example result from the connected automation”, “timestamp”: “2023-10-27T10:00:00Z” } }

Conectividad

Este componente es fundamental para la integración de flujos de trabajo.

Entrada: Recibe conexiones de componentes previos que necesitan proporcionar datos a la habilidad. Dado que este componente define la estructura, cualquier dato que necesites procesar debe venir desde nodos anteriores y conectarse a los inputs definidos por esta estructura.
Salida: Conecta con el siguiente paso en tu flujo de automatización. El resultado de la habilidad (por ejemplo, un archivo procesado o un mensaje generado) se enviará al siguiente nodo para continuar la tarea.

Lógicamente, este componente actúa como el “puente” entre la definición de la herramienta (qué es y cómo se ve) y la ejecución de la tarea (qué hace con los datos).

Ejemplo de Uso

Imagina que estás creando un flujo para automatizar la gestión de tareas.

Selección: Arrastras un componente de habilidad a tu canvas.
Configuración: El sistema utiliza internamente la estructura de ManagedSkill para asegurarse de que esta habilidad tenga un nombre claro y un ícono visible.
Flujo: Conectas los datos de entrada (por ejemplo, una lista de correos electrónicos) a este componente.
Resultado: Una vez procesados los datos por la lógica interna de la habilidad, el componente devuelve un resultado (por ejemplo, “Correo enviado con éxito”) que puedes conectar a un nodo de notificación.

Este componente asegura que, sin importar qué herramienta estés usando, siempre tengas una interfaz clara y consistente para interactuar con ella.

Consejos y Mejores Prácticas

Personalización de Identidad: Asegúrate de que los nombres y descripciones de las habilidades sean claros y descriptivos para facilitar la búsqueda y organización en tu dashboard.
Uso de Metadatos: Utiliza los campos de documentación y descripción para registrar notas útiles sobre cómo usar cada habilidad, ya que esta información puede ser visible para otros miembros de tu equipo.
Consistencia Visual: El uso del ícono predeterminado (Libro 📖) ayuda a mantener un estilo visual uniforme en tu panel de automatización. Evita cambiar esta configuración a menos que sea necesario para diferenciar categorías específicas de herramientas.

Consideraciones de Seguridad

Este componente maneja metadatos de estructura y no contiene lógica de ejecución directa, por lo que los riesgos de seguridad asociados son mínimos y se centran en la correcta configuración de las credenciales en el nivel superior de la habilidad.
Asegúrate de que los identificadores de las habilidades (Skill) sean únicos para evitar conflictos en el sistema de automatización.