Saltearse al contenido
Nappai Documentation

Trello Label Component

El Trello Label Component te permite crear, leer y eliminar etiquetas en tarjetas de Trello directamente desde tu dashboard de Nappai. Con él puedes automatizar la organización de tus tareas en Trello sin salir de la plataforma.

¿Cómo funciona?

El componente se conecta a la API de Trello usando un token OAuth y una clave de API que ya has configurado en Nappai. Cuando seleccionas una operación, el componente envía la solicitud correspondiente a Trello:

  • Create: añade una etiqueta a la tarjeta indicada.
  • Read All: recupera todas las etiquetas de la tarjeta.
  • Delete: elimina una etiqueta específica de la tarjeta.

El resultado se devuelve como un objeto Data que puedes usar en otros pasos del flujo. Si el componente se usa como herramienta de un agente, también expone un objeto Tool con la información necesaria para que el agente lo invoque.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

  • Create: Añade una etiqueta a la tarjeta especificada.
  • Read All: Obtiene todas las etiquetas asociadas a la tarjeta.
  • Delete: Elimina una etiqueta específica de la tarjeta.

Para usar el componente, primero selecciona la operación que necesitas en el campo “Operation” (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Operation: Selecciona la acción que quieres realizar (Create, Read All, Delete).

    • Visible en: Create, Read All, Delete

  • Card ID: Identificador de la tarjeta de Trello donde se gestionarán las etiquetas.

    • Visible en: Create, Read All, Delete

  • Label ID: Identificador de la etiqueta que se añadirá o eliminará.

    • Visible en: Create, Delete

  • Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.

    • Visible en: Create, Read All, Delete

  • Tool Name: Nombre del tool que se mostrará al agente cuando el componente se use como herramienta.

    • Visible en: Create, Read All, Delete

  • Tool Description: Descripción detallada de lo que hace el tool para que el agente lo entienda.

    • Visible en: Create, Read All, Delete

  • Tools arguments metadata: Metadatos que describen los argumentos del tool.

    • Visible en: Create, Read All, Delete

Credencial
Este componente requiere una credencial de tipo Trello Task API.

  1. Configura la credencial en la sección de credenciales de Nappai.
  2. Selecciona esa credencial en el campo Credential del componente.
    La credencial necesita un Trello Oauth token y un Trello Api Key que puedes obtener en la página de desarrolladores de Trello.

Salidas

  • Data: Devuelve la información obtenida o confirmación de la operación.

    • En Create devuelve los datos de la etiqueta creada.
    • En Read All devuelve una lista de todas las etiquetas de la tarjeta.
    • En Delete devuelve un objeto con el estado "success".

  • Tool: Proporciona la información necesaria para que un agente de IA invoque el componente como herramienta.

Ejemplo de Uso

Crear una etiqueta

  1. Selecciona Operation = Create.
  2. Ingresa el Card ID de la tarjeta.
  3. Ingresa el Label ID de la etiqueta que quieres añadir.
  4. Ejecuta el flujo.
  5. La salida Data mostrará los detalles de la etiqueta creada.

Obtener todas las etiquetas

  1. Selecciona Operation = Read All.
  2. Ingresa el Card ID de la tarjeta.
  3. Ejecuta el flujo.
  4. La salida Data contendrá una lista con todas las etiquetas de la tarjeta.

Componentes Relacionados

  • TrelloApi: Wrapper que gestiona las llamadas a la API de Trello.
  • TrelloCardComponent: Permite crear, leer y actualizar tarjetas de Trello.

Consejos y Mejores Prácticas

  • Usa Mapping Mode cuando necesites procesar varias tarjetas o etiquetas a la vez.
  • Mantén tus credenciales fuera de los flujos visibles; configúralas solo una vez en la sección de credenciales.
  • Prueba cada operación con una tarjeta de prueba antes de aplicarla a datos reales.
  • Si usas el componente como herramienta de un agente, asegúrate de que el Tool Name y Tool Description sean claros y concisos.

Consideraciones de Seguridad

  • La credencial Trello Task API contiene datos sensibles (token y clave). No la compartas ni la expongas en el flujo.
  • Nappai gestiona la encriptación de las credenciales; no es necesario que las incluyas en los campos de entrada.
  • Revisa los permisos de la aplicación OAuth en Trello para limitar el acceso solo a las operaciones necesarias.