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

Opción	Requerido	Descripción
Name	No	Etiqueta del paso en el lienzo del flujo de trabajo.
Authentication	Sí	La cuenta de Linear conectada que se usará para este paso.
Action	Sí	La acción de Linear a realizar (Create Issue, List Issues, Update Issue, List Teams).
Arguments	Sí	Campos de formulario por acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón Insert Variable para inyectar valores `{{placeholder}}`. Hay disponible una pestaña Raw JSON para uso avanzado.
When the step fails	No	Controla si el flujo de trabajo debe Terminate Workflow o Continue si este paso falla.

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

Tipo de campo	Cómo se renderiza	Insert Variable disponible
Texto / número	Entrada simple.	Solo en Create Issue y Update Issue
Booleano	Interruptor (etiqueta a la izquierda, interruptor a la derecha).	No
Team (`team_id`)	Menú desplegable poblado desde tu espacio de trabajo de Linear conectado — selecciona tu equipo por nombre.	No
Project (`project_id`)	Menú desplegable poblado desde tu espacio de trabajo de Linear conectado — selecciona tu proyecto por nombre.	No
Issue (`issue_id`)	Menú desplegable poblado desde tu espacio de trabajo de Linear conectado — selecciona un issue por título.	No
Label IDs / arreglos de cadenas	Lista de entradas de texto. El botón Add aparece junto a la etiqueta del arreglo.	No (los elementos de arreglo no admiten inserción de variables)

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

Acción	Descripción
Create Issue	Crea un nuevo issue en un equipo especificado.
List Issues	Busca o lista issues con filtros opcionales.
Update Issue	Modifica un issue existente por ID.
List Teams	Lista todos los equipos en el espacio de trabajo de Linear conectado.

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:

{{STEP_IDENTIFIER.output}}

Por ejemplo, después de un paso Create Issue podrías referenciar el ID del nuevo issue:

{{step_3.output.id}}

Ejemplo

Abre Integrations y conecta Linear si aún no lo has hecho.
Agrega un paso Linear a tu flujo de trabajo.
Selecciona una cuenta conectada en Authentication.
Elige Create Issue en Action.
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.
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

​Linear

​Configuración

​Formulario de Arguments

​Tipos de campo

​Acciones

​Salida

​Ejemplo

​Notas

​Uso de Linear como herramienta de agente