Skip to main content

​
Linear

Usa Linear cuando quieras que un paso del flujo de trabajo cree issues, liste issues, actualice issues o recupere información de equipos desde un espacio de trabajo de Linear conectado.

​
Configuración

Antes de configurar este paso, conecta Linear en Integrations para tu espacio de trabajo. Si no hay una conexión activa con Linear disponible, el paso muestra una advertencia con un enlace a Integrations en lugar del selector de cuenta.

​
Formulario de Arguments

Cuando seleccionas una acción, la sección Arguments renderiza automáticamente un formulario basado en el esquema de entrada de la acción — no se requiere edición manual de JSON. Cada campo incluye:
  • Una etiqueta y descripción tomadas del esquema de la acción.
  • Un botón Insert Variable junto a la etiqueta que inyecta referencias como {{step_1.output.id}} en la posición del cursor.
  • Retroalimentación de validación en línea si se deja vacío un campo obligatorio.

​
Tipos de campo

Todas las opciones del menú desplegable se obtienen en una sola solicitud cuando seleccionas una cuenta conectada, por lo que abrir el panel de configuración no desencadena múltiples llamadas a la API. Si la búsqueda falla para un campo específico, vuelve a una entrada de texto plano para que aún puedas ingresar un valor manualmente o usar una {{variable}}. Cambia a la pestaña Raw JSON para usuarios avanzados o cuando prefieras escribir manualmente el objeto completo de argumentos. Los cambios en cualquiera de las pestañas se mantienen sincronizados.

​
Acciones

​
Salida

Este paso almacena la respuesta de la API de Linear como salida del paso. La forma de la respuesta depende de la acción. Usa la referencia completa de salida en pasos posteriores:
Por ejemplo, después de un paso Create Issue podrías referenciar el ID del nuevo issue:

​
Ejemplo

  1. Abre Integrations y conecta Linear si aún no lo has hecho.
  2. Agrega un paso Linear a tu flujo de trabajo.
  3. Selecciona una cuenta conectada en Authentication.
  4. Elige Create Issue en Action.
  5. En el formulario Arguments, usa el menú desplegable Team (poblado automáticamente desde tu cuenta de Linear) para seleccionar un equipo, completa Title y opcionalmente Description. Usa Insert Variable junto a la etiqueta de cualquier campo para referenciar la salida de un paso anterior — por ejemplo, {{step_1.output}} como título del issue.
  6. Haz clic en Run en el encabezado del paso para probar la acción y, a continuación, revisa la respuesta devuelta en Output.

​
Notas

  • Este paso depende de una integración de Linear conectada en tu espacio de trabajo.
  • La pestaña Raw JSON en Arguments siempre está disponible si prefieres escribir JSON directamente.
  • Los campos Team, Project e Issue muestran menús desplegables poblados desde tu espacio de trabajo de Linear conectado. Si no se cargan opciones, verifica que la integración esté activa en Integrations.
  • La acción Update Issue proporciona un menú desplegable Issue para que puedas seleccionar un issue existente por título en lugar de ingresar un ID manualmente.

​
Uso de Linear como herramienta de agente

También puedes agregar Linear como herramienta en el Agent Editor. Abre el agente, haz clic en Add tool y selecciona Linear. En el panel de configuración de la herramienta, elige la cuenta de Linear conectada que el agente debe usar. El agente creará, buscará y actualizará issues automáticamente durante las conversaciones cuando sea relevante. Consulta también: Integraciones, Creación y edición y Pruebas e iteración