Linear

Conecta Linear para que los agentes puedan crear issues a partir de las investigaciones, actualizar estados y mantener tu gestor de issues sincronizado con lo que encuentran.

Configuración

1. En Linear, abre Settings y ve a Security & access.
2. En Personal API keys, crea una clave. Necesita acceso de escritura para que los agentes puedan crear y actualizar issues.
3. Pega la clave en Polylane. Polylane la valida contra tu espacio de trabajo de Linear y conecta.

Tu clave se cifra antes de almacenarse, y el agente nunca la ve.

Qué pueden hacer los agentes

• Listar equipos, estados de flujo de trabajo, miembros y proyectos
• Listar, buscar y leer issues con sus comentarios recientes
• Crear issues a partir de los hallazgos de una investigación, con el rastro de evidencia en la descripción
• Actualizar el estado, la prioridad, la persona asignada, el proyecto, las etiquetas y la fecha de vencimiento de un issue
• Comentar en issues con hallazgos y estado
• Ejecutar GraphQL arbitrario contra la API de Linear para cualquier cosa no cubierta arriba; las mutaciones pasan por la misma puerta de confirmación

Las escrituras en issues siempre piden confirmación antes de ejecutarse.

Webhooks y triaje

Conectar registra un webhook de Polylane en tu espacio de trabajo de Linear, que cubre los issues de todos los equipos públicos. Con el webhook en su sitio:

• Los issues que pasan a ser urgentes llegan como alertas y se triagean en cuanto se disparan; rebajar la urgencia o completar el issue resuelve la alerta.

Crear el webhook requiere que el usuario de la clave de API sea administrador del espacio de trabajo en Linear. Una clave sin permisos de administrador conecta igualmente y todas las herramientas de los agentes funcionan; solo se omite el triaje impulsado por webhook.

Solución de problemas

Error "Invalid API key"

• Usa una clave de API personal de Security & access; los tokens OAuth no son compatibles. Polylane envía la clave tal cual en la cabecera Authorization, sin prefijo Bearer, exactamente como Linear espera para las claves personales.
• Comprueba que la clave no se haya revocado en Linear.

No llegan alertas ni triggers de Linear

• La creación del webhook necesita la clave de un administrador del espacio de trabajo. Reconecta con la clave de un administrador para habilitar el triaje y los triggers impulsados por webhook.

Desconexión

Desconecta Linear en Polylane, lo que también elimina el webhook que registró, y luego revoca la clave de API en Linear.